Expand description
Kerberos / SPNEGO Authentication Protocol Support
Implements Kerberos 5 (RFC 4120) ticket validation and SPNEGO (RFC 4178) negotiation for HTTP-based authentication, enabling seamless SSO with Active Directory and MIT Kerberos environments.
§Supported Encryption Types
- AES256-CTS-HMAC-SHA1-96 (etype 18) — recommended
- AES128-CTS-HMAC-SHA1-96 (etype 17) — fallback
§Architecture
This module operates as a service-side ticket validator:
- Client sends an
Authorization: Negotiate <token>header - Server decodes the SPNEGO wrapper and extracts the Kerberos AP-REQ
- Server decrypts the ticket using keytab keys (AES-CTS-HMAC-SHA1-96)
- Server decrypts and verifies the authenticator using the session key
- On success, extracts the client principal and returns an auth result
§Security Considerations
- Keytab files must be protected with strict filesystem permissions
- Replay protection uses a time-windowed nonce cache
- Clock skew tolerance is configurable (default: 5 minutes per RFC 4120)
- All cryptographic comparisons use constant-time operations
Modules§
- oid
- Kerberos authentication token OID constants.
Structs§
- Kerberos
Auth Result - Result of Kerberos authentication.
- Kerberos
Config - Kerberos / SPNEGO configuration.
- Kerberos
Config Builder - Builder for
KerberosConfig. - Kerberos
Manager - Kerberos / SPNEGO authentication manager.
- Kerberos
Ticket Flags - Kerberos ticket flags (RFC 4120 §5.3).
- Keytab
Entry - Kerberos keytab entry.
- Spnego
Token - Parsed SPNEGO token (simplified).
Enums§
- Spnego
State - SPNEGO negotiation state.