Enum AutoStrategy 

pub enum AutoStrategy {
    AccessKey(AccessKeyStrategy),
    OAuth(OAuthStrategy),
}

An AuthStrategy that automatically detects available credentials and delegates to the appropriate inner strategy.

Detection order

1. If the CS_CLIENT_ACCESS_KEY environment variable is set, an AccessKeyStrategy is created. The region is extracted from the CS_WORKSPACE_CRN environment variable.
2. If a token store file exists at the default location (~/.cipherstash/auth.json), an OAuthStrategy is created from it.
3. Otherwise, AuthError::NotAuthenticated is returned.

Example

use stack_auth::{AuthStrategy, AutoStrategy};

let strategy = AutoStrategy::new()?;
let token = (&strategy).get_token().await?;
println!("Authenticated! token={:?}", token);

Variants

AccessKey(AccessKeyStrategy)

Authenticated via a static access key.

OAuth(OAuthStrategy)

Authenticated via OAuth tokens persisted on disk.

Implementations

impl AutoStrategy

pub fn new() -> Result<Self, AuthError>

Detect available credentials and build the appropriate strategy.

See the type-level docs for the detection order.

impl AutoStrategy

pub fn workspace_crn(&self) -> Result<Crn, AuthError>

Return the workspace CRN from the inner strategy.

For AccessKeyStrategy, this is the CRN parsed from the CS_WORKSPACE_CRN environment variable. For OAuthStrategy, this is extracted from the stored token’s claims.

Trait Implementations

impl AuthStrategy for &AutoStrategy

async fn get_token(self) -> Result<ServiceToken, AuthError>

Retrieve a valid access token, refreshing or re-authenticating as needed.