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

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.

2 minutesMis à jour le 18 novembre 2026

Les trois pièces

Kantama sépare celui qui décide, celui qui transporte et celui qui exécute.

PièceCe qu'elle faitCe 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 centralGarde 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

  1. 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.
  2. 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).
  3. Le central transmet les octets tels quels, avec la ou les signatures.
  4. 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.

Terminal
# affiche le projet, ses environnements et la liste fermée qu'en tire l'agent
kantama agent manifeste kantama.yaml

Une 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.

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

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