Aller au contenu

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.