Skip to content
javtlPublic

About

Secure Identity Bridge for local AI agents using Kotlin 2.0, Ktor, and Auth0. Delegated authorization to act without exposing user credentials.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Nexus.kt 🛡️ | The Secure AI Agent Bridge

Kotlin Ktor Auth0

Nexus.kt is a high-performance, asynchronous middleware designed to bridge the gap between Sovereign Local AI Agents and real-world actions.

Built for the "Authorized to Act: AI Agents with Auth0" hackathon (Devpost/Okta).


⚠️ The Problem: Credential Exposure in AI

As local LLMs and autonomous agents gain the ability to perform actions (booking flights, accessing private data), we face a critical security flaw: The "Over-Privileged Agent".

  • Giving a local agent plain-text API keys or passwords creates a massive attack surface.
  • If the agent's environment is compromised, the user's entire digital identity is exposed.

✅ The Solution: Identity Delegation Layer

Nexus.kt implements a Delegated Identity Pattern. Instead of sharing master secrets, the user delegates specific, time-bound authority to the Bridge.

  1. User Authentication: The user logs in via Auth0 (OIDC), granting Nexus.kt permission to act.
  2. Token Vaulting: Nexus.kt securely manages and rotates scoped JWT Tokens in a private vault using MongoDB Atlas.
  3. Scoped Execution: The Bridge executes agent requests using Minimal Necessary Permissions (Principle of Least Privilege).

"In the era of autonomous agents, Identity is the new Perimeter."


🛠️ Tech Stack

  • Kotlin 2.0: Leveraging Structured Concurrency and Coroutines.
  • Ktor 3.0: Asynchronous, non-blocking microservices architecture.
  • Auth0 (Okta): Handling M2M (Machine-to-Machine) and Authorization Code flows.
  • MongoDB Atlas: Asynchronous persistence layer via the official Kotlin driver.

🚀 Roadmap & Progress

  • Sprint 1: The Vault Logic. M2M Handshake with Auth0 & Async MongoDB connection.
  • Sprint 2: User Gateway. Implementing OIDC Login for end-users.
  • Sprint 3: Scoped Execution. Validation engine for agent requests.

🛠️ Building & Running

To run the server locally:

Task Description
./gradlew run Run the server (Default: http://0.0.0.0:8080)
./gradlew build Build the project
./gradlew test Run the test suite
./gradlew buildImage Build the Docker image

Created with ❤️ for the Auth0 AI Agents Hackathon.

About

Secure Identity Bridge for local AI agents using Kotlin 2.0, Ktor, and Auth0. Delegated authorization to act without exposing user credentials.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages