Skip to main content

Module kerberos

Module kerberos 

Source
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:

  1. Client sends an Authorization: Negotiate <token> header
  2. Server decodes the SPNEGO wrapper and extracts the Kerberos AP-REQ
  3. Server decrypts the ticket using keytab keys (AES-CTS-HMAC-SHA1-96)
  4. Server decrypts and verifies the authenticator using the session key
  5. 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§

KerberosAuthResult
Result of Kerberos authentication.
KerberosConfig
Kerberos / SPNEGO configuration.
KerberosConfigBuilder
Builder for KerberosConfig.
KerberosManager
Kerberos / SPNEGO authentication manager.
KerberosTicketFlags
Kerberos ticket flags (RFC 4120 §5.3).
KeytabEntry
Kerberos keytab entry.
SpnegoToken
Parsed SPNEGO token (simplified).

Enums§

SpnegoState
SPNEGO negotiation state.