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.
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éfixeKANTAMA_est réservé. - Valeur : une ligne UTF-8, 4 096 octets au plus.
Le lot
{"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
- Il vérifie que le SHA-256 de la pièce jointe est bien le
batchsigné, que le lot vise lui-même et ce service, et quebaseest sa révision actuelle. - Il déchiffre chaque valeur ; une seule valeur invalide fait refuser tout le lot, et rien n'est écrit.
- Il écrit
variables/<env>/<service>.envdans son dossier (fichier 0600), et passe à la révision suivante. - Service
compose: il réécrit sa surcouche compose de l'environnement, puis recrée le service. - Service
app: il remet la version en ligne dans un nouveau conteneur, sans reconstruire.
# é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.
Les propositions de modification de la documentation ne sont pas encore ouvertes au public.