appcore-security
Stable 1.0.0 · MSRV Rust 1.89 · crates.io · docs.rs · code source
Guide et exemples maintenus par le crate
Le dépôt Runtime maintient le guide détaillé, exemple débutant et exemple intermédiaire. Le wiki résume la frontière publique ; les détails d’API et d’exécution restent avec le code du crate.
Responsabilité : contrats réutilisables d'authentification, token, secret et policy.
Dépendances internes : appcore-core, appcore-dnt.
API principale : provider HashToken, claims, factory/validator command
token, request hash, SecurityError; références, resolvers, stores, bytes
effacés, file keyring, metadata/rotation, contrat Vault, peer credentials,
adapter key provider DNT, traits authentification et policy.
À utiliser pour authentification infrastructure et indirection des secrets. Les tokens sont signés, pas chiffrés. Ne pas placer autorisation domaine, OAuth, TLS entrant ou vault managé ici.
HashTokenProvider::from_secret, with_secret et with_material retournent
un SecurityResult et appliquent les mêmes invariants minimaux de secret et de
salts. compute_request_hash produit un SHA-256 marqué v2: sur des champs
séparés par domaine, encadrés par leur longueur et avec présence optionnelle
explicite. Les anciens hashes sans version sont rejetés; émetteurs et
validateurs doivent être mis à jour ensemble.
RequestValidationDetailsRef et RequestPayloadRef offrent un chemin additif
emprunté pour les requêtes en cours. compute_borrowed_request_hash conserve
exactement la sortie V2 tout en comptant et hashant directement le JSON structuré
en deux passes, sans garder un payload encodé complet. Le contrat owned reste
disponible pour compatibilité.
AppCore 1.0 ne possède aucun provider TPM ou hardware-backed. L'ADR 0005 décrit une proposition additive 1.1 avec fallback explicite et preuves sur matériel réel; le Runtime actuel ne revendique aucune protection matérielle.
Maturité : contrats stables; la production dépend du backend secret et des contrôles du déploiement.