Struct TokenOperations 

pub struct TokenOperations<'a> { /* private fields */ }

Focused token-management operations exposed from AuthFramework::tokens.

Example

// Issue a JWT token
let token = auth.tokens().create("user-123", &["read"], "jwt", None).await?;

// Validate
assert!(auth.tokens().validate(&token).await?);

// Refresh
let new_token = auth.tokens().refresh(&token).await?;

// Revoke
auth.tokens().revoke(&new_token).await?;

Implementations

impl TokenOperations<'_>

pub async fn create<I, S>( &self, user_id: impl Into<String>, scopes: I, method_name: impl Into<String>, lifetime: Option<Duration>, ) -> Result<AuthToken>

where I: IntoIterator<Item = S>, S: AsRef<str>,

Create a new authentication token for a user.

scopes accepts any iterator of string-like values, so all of these work:

// Vec<String>
tokens.create("uid", vec!["read".into()], "jwt", None).await?;
// Slice of &str
tokens.create("uid", &["read", "write"], "jwt", None).await?;
// Empty
tokens.create("uid", std::iter::empty::<&str>(), "jwt", None).await?;

Arguments

• user_id — the user to issue a token for
• scopes — permission scopes to embed in the token
• method_name — the auth method that authenticated the user (e.g. "jwt")
• lifetime — custom lifetime, or None for the configured default

pub async fn create_token(&self, req: TokenCreateRequest) -> Result<AuthToken>

Create a token from a TokenCreateRequest.

This is the preferred entry point — it replaces positional Option parameters with a self-documenting builder.

Example

let token = auth.tokens().create_token(
    TokenCreateRequest::new("user-123", "jwt")
        .scope("read")
        .scope("write")
).await?;

pub async fn validate(&self, token: &AuthToken) -> Result<bool>

Validate an authentication token.

pub async fn refresh(&self, token: &AuthToken) -> Result<AuthToken>

Refresh an authentication token.

pub async fn revoke(&self, token: &AuthToken) -> Result<()>

Revoke an authentication token.

pub async fn list_for_user(&self, user_id: &str) -> Result<Vec<AuthToken>>

List all tokens belonging to a user.

pub async fn create_api_key( &self, user_id: &str, expires_in: Option<Duration>, ) -> Result<String>

Create an API key for a user.

pub async fn validate_api_key(&self, api_key: &str) -> Result<UserInfo>

Validate an API key and return the associated user info.

pub async fn revoke_api_key(&self, api_key: &str) -> Result<()>

Revoke an API key.