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

Glossaire

Les mots de Kantama, dans le sens exact où le code les emploie.

2 minutesMis à jour le 18 novembre 2026

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 par prod est protégé (deux appareils pour les variables).
Service
Ce que l'agent pilote : compose (un service existant de votre docker-compose) ou app (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.