neuron-auth

Authentication provider traits for neuron

Overview

neuron-auth defines the AuthProvider trait that the neuron secret and environment system uses to obtain bearer tokens for authenticating outbound requests (e.g., to a Vault instance, a k8s cluster, or a private API). Auth tokens are consumed by secret resolvers that need to authenticate before they can fetch secrets.

This crate contains no implementations — for concrete providers see the backend crates:

Usage

[dependencies]
neuron-auth = "0.4"

Implementing a custom auth provider

use neuron_auth::{AuthProvider, AuthToken};
use async_trait::async_trait;

pub struct MyAuthProvider;

#[async_trait]
impl AuthProvider for MyAuthProvider {
    async fn token(&self) -> Result<AuthToken, neuron_auth::AuthError> {
        // fetch a fresh token
        todo!()
    }
}

Part of the neuron workspace

neuron is a composable async agentic AI framework for Rust. See the book for architecture and guides.