Struct AzureAdAuth 

pub struct AzureAdAuth { /* private fields */ }

Azure AD authentication provider.

This provider supports Azure AD / Entra ID federated authentication using pre-acquired access tokens (Tier 1) or token acquisition with the azure-identity feature (Tier 2).

Example

use mssql_auth::AzureAdAuth;

// Using a pre-acquired token
let auth = AzureAdAuth::with_token("eyJ0eXAi...");

Implementations

impl AzureAdAuth

pub fn with_token(token: impl Into<Cow<'static, str>>) -> Self

Create an Azure AD authenticator with a pre-acquired token.

This is the simplest form - provide a valid access token obtained from Azure AD / Entra ID via your preferred method.

Arguments

• token - A valid JWT access token for Azure SQL Database

pub fn with_token_expiring( token: impl Into<Cow<'static, str>>, expires_in: Duration, ) -> Self

Create an Azure AD authenticator with a token and expiration.

Providing the expiration time allows the driver to proactively refresh tokens before they expire.

Arguments

• token - A valid JWT access token
• expires_in - Duration until the token expires

pub fn from_credentials(credentials: &Credentials) -> Result<Self, AuthError>

Create from existing credentials.

Returns an error if the credentials are not Azure AD credentials.

pub fn with_library(self, library: FedAuthLibrary) -> Self

Set the library type to report to the server.

pub fn is_expired(&self) -> bool

Check if the token is expired.

pub fn is_expiring_soon(&self, within: Duration) -> bool

Check if the token is expiring soon (within the given duration).

pub fn build_feature_data(&self) -> Bytes

Build the FEDAUTH feature extension data for Login7.

Format:

• 1 byte: Library type (ADAL=1, SecurityToken=2, MSAL=3)
• 1 byte: Workflow (0x00 for pre-acquired token)
• 4 bytes: FedAuth token length (big-endian)
• N bytes: FedAuth token (UTF-16LE encoded)

pub fn build_token_data(&self) -> Bytes

Build the FEDAUTH token packet data.

This is the token data sent in response to FEDAUTHINFO from the server.

Trait Implementations

impl AuthProvider for AzureAdAuth

fn method(&self) -> AuthMethod

Get the authentication method this provider uses.

fn authenticate(&self) -> Result<AuthData, AuthError>

Authenticate and produce authentication data.

fn feature_extension_data(&self) -> Option<Bytes>

Get additional feature extension data for Login7.

fn needs_refresh(&self) -> bool

Check if this provider needs to refresh its authentication.

impl Clone for AzureAdAuth

fn clone(&self) -> AzureAdAuth

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AzureAdAuth

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

Formats the value using the given formatter.