Vault
Le Backend et le Frontend peuvent lire leur KEK dans un coffre HashiCorp Vault au démarrage, au lieu de SMARTAGT_KEK. La KEK est lue une fois puis conservée en mémoire : un redémarrage relit le coffre.
Prérequis
| Élément | Attendu |
|---|---|
| Moteur de secrets | KV version 2, monté sur secret |
| Secret | Champ kek contenant la KEK, base64 de 32 octets |
| Authentification | Jeton autorisé en lecture sur ce secret, par exemple path "secret/data/smartagt/backend/kek" { capabilities = ["read"] } |
| TLS | Autorité du coffre reconnue par le serveur SmartAGT |
Procédure
1. Écrire la KEK dans le coffre
Une fois par composant :
vault kv put -mount=secret smartagt/backend/kek kek=-
Saisissez la KEK actuelle du composant sur l’entrée standard, puis validez par Ctrl+D.
Résultat attendu : vault kv get -mount=secret smartagt/backend/kek affiche le champ kek.
2. Déclarer le fournisseur
Dans le YAML du composant :
smartagt:
security:
encryption:
kek_provider:
type: vault
config:
url: "https://vault.example.org:8200"
key_path: "smartagt/backend/kek" # chemin sous le montage secret
3. Fournir le jeton
Dans l’environnement du service, un fichier lisible par le compte du service, et l’autorité du coffre si elle est privée :
SMARTAGT_SECURITY_ENCRYPTION_KEK__PROVIDER_CONFIG_TOKEN_FILE=/etc/smartagt/vault-token-backend
VAULT_CACERT=/etc/smartagt/vault-ca.pem
Retirez SMARTAGT_KEK de cet environnement et de toute commande --preserve-env : tant que cette variable existe, elle l’emporte sur le coffre, sans message d’erreur. Sous Windows, ces variables vont dans l’environnement du service. Pour le Frontend, appliquez la même étape à son YAML et à bff.env, avec son propre chemin dans le coffre.
4. Redémarrer les services
Redémarrez les services du composant : Exploitation.
Résultat attendu : le journal du service indique KEK récupérée depuis Vault (len=32).
Cas particuliers
Durée de vie du jeton
SmartAGT ne renouvelle pas le jeton. Choisissez une durée de vie qui couvre les redémarrages, ou renouvelez-le avant son échéance.
Commandes run.bin
Les commandes init et pki lisent la KEK de la même façon. Lancez-les avec le même YAML et le même environnement que le service, par exemple sudo --preserve-env=SMARTAGT_CORE_DATABASE_PASSWORD,SMARTAGT_SECURITY_ENCRYPTION_KEK__PROVIDER_CONFIG_TOKEN_FILE,VAULT_CACERT.
Messages au démarrage
| Message | Cause |
|---|---|
Échec d'authentification auprès de Vault |
Jeton invalide ou expiré |
Lecture KEK depuis Vault échouée |
Chemin erroné, droit de lecture absent, moteur autre que KV version 2 sur secret, ou valeur non base64 |
Champ 'kek' introuvable dans le secret Vault |
Secret présent sans champ kek |
KEK invalide : 32 octets attendus |
Valeur du champ qui n’est pas une KEK base64 de 32 octets |
CERTIFICATE_VERIFY_FAILED |
Autorité du coffre absente de VAULT_CACERT |
Le service refuse alors de démarrer.