Struct SqlServerAuth 

pub struct SqlServerAuth { /* private fields */ }

SQL Server authenticator for username/password authentication.

This provider handles traditional SQL Server authentication where credentials are sent via the Login7 packet with password obfuscation.

Security Note

The password is obfuscated (XOR + nibble swap), not encrypted. Always use TLS encryption for the connection.

Example

use mssql_auth::SqlServerAuth;

let auth = SqlServerAuth::new("sa", "Password123!");

Implementations

impl SqlServerAuth

pub fn new( username: impl Into<Cow<'static, str>>, password: impl Into<Cow<'static, str>>, ) -> Self

Create a new SQL Server authenticator with credentials.

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

Create from existing credentials.

Returns an error if the credentials are not SQL Server credentials.

pub fn username(&self) -> &str

Get the username.

pub fn encode_password(password: &str) -> Vec<u8>

Encode a password for SQL Server Login7 packet.

SQL Server uses a simple XOR-based obfuscation for passwords in Login7 packets. This is NOT encryption - it’s just obfuscation. The connection should always be encrypted via TLS.

Algorithm

For each UTF-16 code unit:

1. XOR each byte with 0xA5
2. Swap the high and low nibbles

Trait Implementations

impl AuthProvider for SqlServerAuth

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 SqlServerAuth

fn clone(&self) -> SqlServerAuth

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SqlServerAuth

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

Formats the value using the given formatter.