Nouveau · l'app mobile, second appareil pour relire et signer chaque ordre
kantamaSe connecterCréer un espace

Lots de changements

Les changements de variables s'accumulent dans un lot, se relisent par noms et opérations, puis s'appliquent par un seul ordre signé. Le central ne voit jamais une valeur.

3 minutesMis à jour le 18 novembre 2026

Le principe

Sur la page Variables d'un projet, chaque changement (définir ou retirer une variable) rejoint un lot pour un environnement et un service. Quand le lot est prêt, un seul ordre core.secrets.apply l'applique. Cet ordre ne porte que l'empreinte SHA-256 du lot (batch), jamais les valeurs.

Chiffré dans le navigateur

Chaque valeur est chiffrée dans votre navigateur (WebCrypto) pour la clé P-256 de l'agent du projet : ECDH éphémère, HKDF-SHA256, AES-256-GCM. Seul l'agent peut la déchiffrer.

Le chiffré est attaché à sa variable (agent, projet, environnement, service, nom) : déplacé ailleurs, il ne s'ouvre pas. Aucun appareil ne peut relire une valeur ensuite : on la remplace.

  • Nom : [A-Za-z_][A-Za-z0-9_]{0,127}, le préfixe KANTAMA_ est réservé.
  • Valeur : une ligne UTF-8, 4 096 octets au plus.

Le lot

lot · v1
{"v":1,"agent":"<empreinte>","project":"cas-market","env":"production","service":"api_payment","key_id":"<16 hex>","base":3,
 "changes":[{"name":"DATABASE_URL","op":"set","value":"<valeur scellée>"},{"name":"ANCIENNE","op":"unset"}]}

base est la révision du fichier de variables que la console a vue. Un lot compte 1 à 100 changements, aux noms uniques, 128 Kio au plus.

Les variables déjà définies

Pour chaque service compose, la page montre aussi les noms des variables que le service reçoit déjà de son compose et de .env.prod. L'agent les lit avec docker compose config et n'en garde que les noms : aucune valeur ne quitte le serveur.

Cliquez un nom pour le gérer dans Kantama : le formulaire s'ouvre avec ce nom, vous saisissez la valeur, elle rejoint le lot. Une fois appliquée, elle remplace celle du compose, et la page l'indique.

Relire et signer

Sur chaque appareil, le tiroir de confiance décode l'ordre, relit le lot joint, recalcule son SHA-256 et le compare à batch. Il vérifie que le lot vise le même agent, projet, environnement et service, et qu'il est chiffré pour la clé annoncée par l'agent dont l'empreinte est dans l'ordre. Il n'affiche que des noms et des opérations.

Ce que fait l'agent

  1. Il vérifie que le SHA-256 de la pièce jointe est bien le batch signé, que le lot vise lui-même et ce service, et que base est sa révision actuelle.
  2. Il déchiffre chaque valeur ; une seule valeur invalide fait refuser tout le lot, et rien n'est écrit.
  3. Il écrit variables/<env>/<service>.env dans son dossier (fichier 0600), et passe à la révision suivante.
  4. Service compose : il réécrit sa surcouche compose de l'environnement, puis recrée le service.
  5. Service app : il remet la version en ligne dans un nouveau conteneur, sans reconstruire.
kantama.compose.yml
# écrite par l'agent, jamais par vous
{
  "services": {
    "api_payment": {
      "environment": {
        "LOG_LEVEL": "DEBUG",
        "DJOMY_CLIENT_SECRET": "a$$b"
      }
    }
  }
}

La surcouche est un fichier compose que l'agent garde dans son dossier (0600). Il l'ajoute en dernier -f à ses commandes docker compose (déploiement, recréation, démarrage, mise à l'échelle). Compose fusionne les fichiers dans l'ordre : une variable gérée par Kantama l'emporte sur celle de vos fichiers compose, de leur environment:, de leurs env_file: et de .env.prod, sans que vous changiez une ligne de votre compose. Les $ sont doublés : la valeur arrive telle quelle dans le conteneur.

Cette page vous a-t-elle aidé ?Modifier cette page

Les propositions de modification de la documentation ne sont pas encore ouvertes au public.