Struct ApiToken 

pub struct ApiToken {
    pub id: Uuid,
    pub org_id: Uuid,
    pub user_id: Option<Uuid>,
    pub name: String,
    pub token_prefix: String,
    pub hashed_token: String,
    pub scopes: Vec<String>,
    pub last_used_at: Option<DateTime<Utc>>,
    pub expires_at: Option<DateTime<Utc>>,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
}

API Token model

Fields

id: Uuid

org_id: Uuid

user_id: Option<Uuid>

name: String

token_prefix: String

hashed_token: String

scopes: Vec<String>

last_used_at: Option<DateTime<Utc>>

expires_at: Option<DateTime<Utc>>

created_at: DateTime<Utc>

updated_at: DateTime<Utc>

Implementations

impl ApiToken

pub async fn create( pool: &Pool<Postgres>, org_id: Uuid, user_id: Option<Uuid>, name: &str, scopes: &[TokenScope], expires_at: Option<DateTime<Utc>>, ) -> Result<(String, ApiToken), Error>

Create a new API token Returns the full token (only shown once) and the ApiToken record

pub async fn find_by_prefix( pool: &Pool<Postgres>, org_id: Uuid, prefix: &str, ) -> Result<Option<ApiToken>, Error>

Find token by prefix (for listing)

pub async fn find_by_id( pool: &Pool<Postgres>, token_id: Uuid, ) -> Result<Option<ApiToken>, Error>

Find token by ID

pub async fn find_by_org( pool: &Pool<Postgres>, org_id: Uuid, ) -> Result<Vec<ApiToken>, Error>

Get all tokens for an organization

pub async fn verify_token( pool: &Pool<Postgres>, token: &str, ) -> Result<Option<ApiToken>, Error>

Verify token and return the token record if valid

pub async fn delete(pool: &Pool<Postgres>, token_id: Uuid) -> Result<(), Error>

Delete token

pub async fn rotate( pool: &Pool<Postgres>, token_id: Uuid, new_name: Option<&str>, delete_old: bool, ) -> Result<(String, ApiToken, Option<ApiToken>), Error>

Rotate a token (create new token with same scopes, optionally delete old) Returns the new full token (only shown once) and the new ApiToken record

pub async fn find_tokens_needing_rotation( pool: &Pool<Postgres>, org_id: Option<Uuid>, days_old: i64, ) -> Result<Vec<ApiToken>, Error>

Find tokens that need rotation (older than N days)

impl ApiToken

pub fn has_scope(&self, scope: &TokenScope) -> bool

Check if token has a specific scope

pub fn needs_rotation(&self, days_old: i64) -> bool

Check if token needs rotation (older than N days)

pub fn age_days(&self) -> i64

Get age of token in days

Trait Implementations

impl Clone for ApiToken

fn clone(&self) -> ApiToken

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ApiToken

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ApiToken

fn deserialize<__D>( __deserializer: __D, ) -> Result<ApiToken, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'a, R> FromRow<'a, R> for ApiToken

where R: Row, &'a str: ColumnIndex<R>, Uuid: Decode<'a, <R as Row>::Database> + Type<<R as Row>::Database>, Option<Uuid>: Decode<'a, <R as Row>::Database> + Type<<R as Row>::Database>, String: Decode<'a, <R as Row>::Database> + Type<<R as Row>::Database>, Vec<String>: Decode<'a, <R as Row>::Database> + Type<<R as Row>::Database>, Option<DateTime<Utc>>: Decode<'a, <R as Row>::Database> + Type<<R as Row>::Database>, DateTime<Utc>: Decode<'a, <R as Row>::Database> + Type<<R as Row>::Database>,

fn from_row(__row: &'a R) -> Result<ApiToken, Error>

impl Serialize for ApiToken

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.