footing 0.5.1

Feature-gated foundations for Rust backend services
Documentation
//! Authentication and authorization primitives.
//!
//! The module models the generic parts of an authenticated caller: principal
//! identity, roles, scopes, permission decisions, and local guards. It does not
//! know about application-specific users, sessions, tenants, or protocols.
//!
//! With `password-policy`, `PasswordPolicy` validates prospective passwords
//! when they are set, changed, or reset. `password-common` additionally makes an
//! offline common-password list available, explicitly enabled on each policy.
//! Neither feature requires Argon2 or an async runtime. The separate `password`
//! feature provides `PasswordService` for storage and login verification;
//! admission rules are never applied by that service.
//!
//! ```rust
//! use footing::auth::{Principal, PrincipalRequirement};
//!
//! let principal = Principal::service_account("svc_audit")
//!     .unwrap()
//!     .with_roles(["operator"])
//!     .unwrap()
//!     .with_scopes(["audit:read", "users:read"]);
//! let principal = principal.unwrap();
//! let policy = PrincipalRequirement::all_scopes(["audit:read", "users:read"]).unwrap();
//!
//! policy.check(&principal).unwrap();
//! ```
//!
#[cfg(feature = "password")]
mod password;
#[cfg(feature = "password-policy")]
mod password_policy;
#[cfg(feature = "password-tokio")]
mod password_tokio;
mod principal;

#[cfg(feature = "password")]
pub use password::{
    ARGON2_VERSION_13, Argon2idProfile, PasswordError, PasswordHashAlgorithm,
    PasswordHashAssessment, PasswordHashMetadata, PasswordLimits, PasswordService,
    PasswordVerification, PasswordVerificationLimits,
};
#[cfg(feature = "password-policy")]
#[cfg_attr(docsrs, doc(cfg(feature = "password-policy")))]
pub use password_policy::{PasswordPolicy, PasswordPolicyError};
#[cfg(feature = "password-tokio")]
#[cfg_attr(docsrs, doc(cfg(feature = "password-tokio")))]
pub use password_tokio::{
    PasswordRehash, PasswordWorkLimits, TokioPasswordError, TokioPasswordService,
};
pub use principal::{
    AuthorityKind, PermissionChecker, PermissionDecision, PermissionError, PermissionRequest,
    Principal, PrincipalKind, PrincipalRequirement, RequirementMatch,
};