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

Une sécurité que l'agent vérifie, pas une promesse.

Kantama est conçu pour qu'une compromission de nos propres serveurs ne suffise pas à toucher votre production. Voici qui détient quoi, ce qui se passe quand ça tourne mal, et comment nous écrire.

Qui détient quoi — et surtout ce que personne ne détient seul.

Trois acteurs, aucun tout-puissant : vos appareils signent, le serveur central relaie, l'agent vérifie avant d'agir.

Vos appareilsPC, iPhone, Android, clé de sécurité
Détient
  • les clés privées des passkeys
  • le choix du nombre affiché
Ne détient jamais
  • vos secrets de production
  • un accès direct aux serveurs
Serveur central Kantamarelais, file d'ordres, console
Détient
  • les clés publiques des passkeys
  • les ordres et leurs signatures
  • les reçus de l'agent
Ne détient jamais
  • une clé privée de passkey
  • vos secrets en clair
  • un port ouvert chez vous
L'agent, sur votre serveurbinaire Go, connexion sortante
Détient
  • la liste des passkeys acceptées
  • la clé Ed25519 de ses reçus
  • les déclarations de kantama.yaml
Ne détient jamais
  • le pouvoir de signer à votre place
  • une commande hors kantama.yaml et du socle

Modèle de menace — si ça tourne mal, alors…

Nous partons du principe que chaque maillon peut tomber, y compris Kantama. Voici ce qui se passe dans chaque cas.

SiKantama est compromis
alors

L'attaquant peut fabriquer des ordres, mais pas les signer : il n'a aucune clé privée. L'agent vérifie chaque signature contre sa propre liste de passkeys et refuse l'ordre.

refusé par l'agent
SiUn appareil est volé
alors

Une seule passkey ne suffit pas pour une action de niveau double : il faut un second appareil, et le nombre affiché sur l'autre. Retirez la passkey volée avec deux autres appareils ; chaque agent l'oublie quand vous signez core.trust.remove.

un appareil ne suffit pas
SiUn membre devient malveillant
alors

Il ne signe seul aucune action de niveau double : il faut une seconde passkey distincte. Ajouter une passkey chez les agents demande deux appareils déjà connus ; en retirer une, deux autres appareils.

borné par les signatures
SiUn ordre est rejoué
alors

Chaque ordre porte un identifiant unique et expire au plus 5 minutes après son émission. L'agent retient chaque identifiant jusqu'à son expiration, refuse tout doublon, tout ordre expiré et tout ordre émis avant son démarrage.

refusé : déjà joué
SiQuelqu'un s'interpose sur le réseau
alors

Les octets exacts de l'ordre sont hachés dans le défi signé. Modifier un paramètre en route change le défi : la signature ne correspond plus et l'agent refuse.

signature invalide
SiUn secret apparaît dans un journal
alors

L'agent masque secrets et jetons avant l'envoi, selon les valeurs des variables qu'il a écrites et des motifs connus. La console ne reçoit que la version masquée.

masqué à la source
SiL'agent est hors ligne
alors

Aucun ordre ne peut être exécuté : il n'y a personne pour vérifier la signature. La console date l'état connu et l'indique clairement ; rien ne part « plus tard » sans nouvelle signature.

rien ne passe

Signatures — ce qui est signé, par qui, et pour combien de temps.

Un ordre de production n'est exécuté qu'avec des signatures valides, sur le bon ordre, dans le délai.

01

Passkey WebAuthn

Windows Hello, Face ID, empreinte ou clé de sécurité. La clé privée ne quitte jamais l'appareil.

02

Deux appareils quand il le faut

Pour une action double : un ordinateur et un téléphone, ou deux ordinateurs. Un seul appareil volé ne suffit pas.

03

Le nombre à choisir

Le téléphone propose trois nombres ; seul celui affiché par la console est juste. Aucun n'est présélectionné.

04

Expiration en 5 minutes

Passé ce délai, l'ordre ne peut plus être signé. Il faut le préparer à nouveau : il aura un nouveau sceau.

05

Reçu Ed25519, journal chaîné

L'agent signe un reçu pour chaque ordre, puis un résultat. Le central les inscrit au journal chaîné : l'Activité ne peut pas être réécrite en silence.

Le sceau de l'ordre

Une empreinte que l'on peut comparer d'un coup d'œil, sur l'ordinateur et sur le téléphone.

ord_0f6c…45e1
  1. L'ordre est fixé en octets. Le central écrit l'ordre en JSON compact : agent, projet, environnement, action, paramètres, dates, nonce. Ces octets ne changent plus.
  2. On en calcule le défi SHA-256. Préfixé de « kantama/ordre/v1 », c'est lui que vos passkeys signent, pas un texte affiché par la page.
  3. Les 16 premiers bits de SHA-256(id) dessinent le sceau. Chaque bit allume ou éteint un des 16 secteurs de l'ellipse. Un autre ordre donne un autre motif.
  4. Le même sceau sur chaque appareil. Le PC et le téléphone le calculent chacun de leur côté : s'ils diffèrent, ce n'est pas le même ordre.

Le reçu de l'agent

Pour chaque ordre, l'agent signe un reçu avec sa propre clé, puis un résultat après l'exécution. Le central les inscrit au journal chaîné : modifier un ordre passé casserait la chaîne visible dans l'Activité.

exécuté · 2 sur 2
# reçu signé par l'agent c41e 9a07 5d2f 7be0 (kantama/recu/v1)
order_id      ord_0f6c1d2e8b7a45e1
order_sha256  0f6c1d2e…  # octets exacts de l'ordre
agent         c41e9a075d2f7be0
status        accepted
at            1794300012
signature     Ed25519, vérifiée par le central

Divulgation responsable — vous avez trouvé une faille ? Merci.

▸ Écrire à[email protected]

Décrivez la faille, comment la reproduire et son impact. Le même contact est publié dans /.well-known/security.txt, ci-dessous.

  • Réponse sous 72 haccusé de réception, puis un point au moins chaque semaine jusqu'à la correction.
  • Périmètreconsole, serveur central, agent, applications mobiles. Hors périmètre : attaques par déni de service, ingénierie sociale, comptes d'autrui.
  • Pas de poursuites de bonne foisi vous testez sur votre propre espace, sans exfiltrer de données ni dégrader le service.
  • Créditavec votre accord, votre nom figure dans le journal des versions qui publie la correction.
# https://kantama.app/.well-known/security.txt
Contact: mailto:[email protected]
Expires: 2027-11-12T00:00:00.000Z
Preferred-Languages: fr, en
Canonical: https://kantama.app/.well-known/security.txt
Policy: https://kantama.app/securite#divulgation

Une signature par geste, vérifiée chez vous.

Lisez la documentation, puis installez l'agent en dix minutes.