Expand description
Pure Rust Kerberos protocol engine + krb5 GSS-API mechanism (initiator).
This crate provides two major capabilities, both independent of any specific service (e.g. Kafka), and can be used standalone in any Kerberos KDC scenario:
§1. Kerberos KDC Protocol Engine
KerberosCredentials: Pure Rust credential model (principal / service_name / keytab).KerberosClient: KDC protocol state machine that communicates with KDC viaKdcTransportto perform AS-REQ → AS-REP → TGS-REQ → TGS-REP, producingAcquiredTicket(service ticket + session key).Krb5Client: High-level KDC client facade that holds credentials + transport for direct KDC access without needing to inject transport on every call.KdcTransport: KDC transport contract; integrators implement it, or use the built-inTokioKdcTransport.TokioKdcTransport: Out-of-the-box KDC transport based on tokioTcpStream.
§2. krb5 GSS-API Mechanism (initiator)
gssmodule: Implements krb5 GSS context (AP-REQ / AP-REP construction, GSS token wrapping, RFC 4121 WRAP, multi-round handshake) based onAcquiredTicket, compatible with any SASL/GSSAPI server-first service (Kafka, LDAP, etc.).gss::GssClient: High-level GSS facade combining KDC ticket acquisition + GSS context for single-call access. Pair withgss::GssContext::stepfor the standard GSS handshake loop compatible with any acceptor.
Cryptography is built on RustCrypto primitives (aes / cipher / hmac / sha1 / sha2)
with zero FFI, enabling cross-compilation to any target. Network I/O is abstracted
via the KdcTransport trait; the built-in TokioKdcTransport (tokio-based) can
connect to a KDC directly, or integrators may implement the trait themselves.
Re-exports§
pub use client::Krb5Client;pub use credentials::KerberosCredentials;pub use error::KerberosError;pub use error::Result;pub use gss::GssClient;pub use kerberos::client::AcquiredTicket;pub use kerberos::client::KerberosClient;pub use kerberos::crypto::Etype;pub use kerberos::transport::TokioKdcTransport;pub use kerberos::transport::KdcBoxFuture;pub use kerberos::transport::KdcTransport;
Modules§
- client
- High-level krb5 client: holds credentials + KDC transport, accesses the KDC directly.
- credentials
- error
- gss
- GSS-API layer (krb5 mechanism): SASL/GSSAPI client authentication based on Kerberos service tickets.
- kerberos
- Kerberos protocol and cryptography layer (built on RustCrypto primitives).