Glossaire
Les mots de Kantama, dans le sens exact où le code les emploie.
Les pièces
- Espace
- Votre compte dans Kantama : ses membres, ses passkeys, ses agents, ses projets et son journal chaîné.
- Projet
- Une application en production, décrite par son
kantama.yaml(nom en minuscules, ex.cas-market). - Environnement
- Une cible déclarée du projet :
production,preproduction… Un nom qui commence parprodest protégé (deux appareils pour les variables). - Service
- Ce que l'agent pilote :
compose(un service existant de votre docker-compose) ouapp(construit et déployé par l'agent). - Agent
- Le binaire Go installé sur chaque serveur. Il se connecte en sortie, vérifie chaque ordre et exécute.
- Serveur central
- Le service Kantama qui relaie et mémorise. Il est « aveugle » : il ne peut rien ordonner seul.
- Empreinte
- 16 caractères hexadécimaux : les 8 premiers octets du SHA-256 de la clé publique de l'agent, affichés par groupes de 4 (
c41e 9a07 5d2f 7be0).
La signature
- Passkey
- Une clé WebAuthn rangée sur votre appareil (Windows Hello, Touch ID, Face ID, empreinte). Kantama n'en connaît que la clé publique.
- Liste de confiance
- Les passkeys qu'un agent accepte, gardées sur son serveur (
confiance.json). Elle ne change que par ordre signé. - Ordre
- Action + projet + environnement + paramètres, valable 5 minutes au plus. Ses octets exacts sont signés.
- Niveau
single: une passkey.double: deux passkeys distinctes.- Brouillon
- Un ordre préparé qui attend ses signatures (
draft). Il expire au bout de 5 minutes. - Sceau
- Un motif de 16 cases tiré des 16 premiers bits du SHA-256 de l'identifiant de l'ordre : le même sur chaque appareil, comparable d'un coup d'œil.
- Nombre de l'ordre
- Un nombre de 10 à 99 tiré de l'identifiant de l'ordre. Sur le téléphone, on choisit celui qu'affiche la console parmi trois.
- Garde « montant inhabituel »
- Au-delà d'un seuil, la case « J'ai vérifié ce montant » fait partie de l'ordre signé, et l'agent l'exige.
- Code de secours
- Ouvre une session sans passkey, une seule fois, pour ajouter un appareil. Il ne signe rien.
L'exécution
- Liste fermée
- Les actions qu'un agent accepte : celles du socle et celles de
kantama.yaml. Rien d'autre. - Socle
- Les actions réservées, en
core.: confiance, redémarrage, déploiement, variables, sauvegardes, pause du projet. - Reçu
- La réponse signée de l'agent à chaque ordre : accepté ou refusé, avec la raison.
- Résultat signé
- Ce que l'agent signe après l'exécution : statut, code de sortie, durée, dernières lignes masquées.
- Avis signé
- Ce que l'agent signe quand il agit sans ordre : retrait d'une prévisualisation échue, sauvegarde planifiée.
- Lot de changements
- Plusieurs changements de variables, chiffrés, appliqués ensemble par un seul ordre
core.secrets.apply. - Prévisualisation
- Une autre branche que celle de production, mise en ligne sur sa propre adresse par un ordre signé.
L'exploitation
- Journal chaîné
- Les événements de l'espace, chacun lié au précédent par son empreinte SHA-256. Modifier une ligne casse la chaîne.
- Sonde
- Une requête HTTP faite par l'agent depuis le serveur, toutes les 30 secondes, sans suivre les redirections.
- Alerte
- Ouverte par une règle du central (sonde, agent muet, certificat, exécution, sauvegarde, tâche, erreur, signalement). Elle ne déclenche rien sur un serveur.
- Connecteur
- Le lien d'un projet avec Vercel, Cloudflare, Supabase, EAS ou GitHub, lu par l'agent avec un jeton chiffré pour lui seul.
- Jeton d'assistant
- Un jeton
kmcp_…qui ouvre le serveur MCP à un assistant : il peut consulter et préparer, jamais signer.
Cette page vous a-t-elle aidé ?Modifier cette page
Les propositions de modification de la documentation ne sont pas encore ouvertes au public.