Concepts
Trois pièces et une règle : vos appareils signent, le serveur central transporte, l'agent vérifie avant d'agir. Personne ne peut agir seul sur votre production, pas même Kantama.
Les trois pièces
Kantama sépare celui qui décide, celui qui transporte et celui qui exécute.
| Pièce | Ce qu'elle fait | Ce qu'elle ne peut pas faire |
|---|---|---|
| Vos appareils console web, app mobile | Signent chaque ordre avec une passkey (Windows Hello, Touch ID, Face ID, empreinte). Chiffrent chaque secret dans le navigateur, pour la clé de l'agent. | Relire un secret après l'avoir écrit : l'écriture est à sens unique. |
| Le serveur central | Garde les comptes, les projets, les alertes et le journal chaîné. Prépare les ordres et les transmet tels quels à l'agent. | Fabriquer ou modifier un ordre, signer à votre place, lire une valeur de secret. |
| L'agent un binaire Go par serveur | Génère son identité Ed25519 sur place, garde sa propre liste de passkeys de confiance, vérifie chaque ordre, puis exécute. | Exécuter une action absente de sa liste fermée, ou passer par un shell. |
Le chemin d'un ordre
- La console prépare l'ordre en JSON : agent, projet, environnement, action, paramètres, date d'émission, date d'expiration (5 minutes au plus), nonce.
- Votre appareil affiche un résumé lu dans ces octets-là, puis demande la passkey. Le défi est
SHA-256("kantama/ordre/v1" ‖ 0x00 ‖ octets). - Le central transmet les octets tels quels, avec la ou les signatures.
- L'agent recalcule le défi, vérifie chaque signature contre sa liste de confiance, puis analyse les octets. Il n'analyse que ce qui a été signé.
Le détail est dans Ordres et sceaux.
La liste fermée
L'agent n'exécute que deux sortes d'actions : celles du socle (identifiants en core., comme core.service.restart ou core.deploy) et celles que votre dépôt déclare dans kantama.yaml. Tout le reste est refusé, et un kantama.yaml ne peut pas déclarer d'action en core..
Une action déclarée s'exécute en argv, dans son service : chaque paramètre occupe un argument entier. ; rm -rf / reste un seul argument littéral.
# affiche le projet, ses environnements et la liste fermée qu'en tire l'agent
kantama agent manifeste kantama.yamlUne connexion sortante
L'agent ouvre lui-même une connexion WebSocket vers le central (/v1/agents/connexion, wss:// en production) et prouve son identité en signant un défi. Il envoie un battement toutes les 15 secondes ; sans nouvelle depuis trois battements, il est signalé « muet ».
Aucun port n'est ouvert sur votre serveur : les ordres arrivent par cette connexion, les reçus repartent par elle.
Si le central est compromis
Un central compromis peut refuser de transmettre, ou rejouer un ordre déjà vu : l'agent le refuse (anti-rejeu). Il ne peut ni modifier un ordre, ni en fabriquer un, ni lire vos secrets.
Les propositions de modification de la documentation ne sont pas encore ouvertes au public.