Activer une machine

Mis à jour le 10 novembre 2026

L'activation lie la machine à votre compte, comme Claude Code ou une télévision connectée : la machine affiche un code, vous l'approuvez depuis un appareil où vous êtes déjà connecté. Aucun mot de passe n'est saisi sur la machine, et la machine ne reçoit jamais la clé de votre coffre.

Avant de commencer

  • L'offre Studio (ou son essai) est active sur le compte.
  • La double authentification (TOTP) ou une clé d'accès est activée dans Sécurité : l'approbation d'une machine exige toujours un second facteur. Sans l'un ni l'autre, l'approbation est refusée avec un message qui vous invite à en activer un.
  • Un appareil où le coffre est ouvert : l'app Konsolity (Mac, Windows, Linux, iPhone, iPad, Android) ou la console web app.konsolity.com.

Lancer l'activation

Sur la machine, avec le compte qui utilisera la CLI (pour un service, le même compte que le service) :

konsolity login --name build-01
Option Rôle
--name <nom> Nom affiché dans la liste des machines (par défaut, le nom d'hôte).
--scopes <liste> Portée demandée, parmi hosts, snippets, sessions, mcp, séparés par des virgules.
--read-only Demande un accès en lecture seule (listes et état, aucune commande).

La portée demandée n'est qu'une proposition : c'est vous qui la fixez à l'approbation. La commande affiche :

Activation de cette machine sur https://api.konsolity.com
1. Ouvrez cette adresse sur un appareil connecté à votre compte :
   https://app.konsolity.com/cli/activate?code=WDJB-MJHT
   ou dans l'app Konsolity : Réglages › Machines CLI › Activer une machine
2. Saisissez ce code : WDJB-MJHT
3. Vérifiez que l'empreinte affichée est : 7K3Q-9XAD
En attente d'approbation...

Si le terminal le permet, un QR code du lien complet est aussi affiché, pratique pour approuver depuis un téléphone. Le code reste valable 15 minutes ; la machine attend sans rien faire d'autre.

Comparer l'empreinte

L'empreinte (7K3Q-9XAD dans l'exemple) est calculée à partir de la clé publique que la machine vient de générer. L'écran d'approbation la recalcule lui-même depuis cette clé, sans faire confiance au serveur, et l'affiche avec le nom, le système, l'architecture, le nom d'hôte et l'adresse IP de la machine.

N'approuvez que si vous venez vous-même de lancer konsolity login sur cette machine, et si l'empreinte est la même. Une demande que vous ne reconnaissez pas se refuse d'un clic.

Approuver dans l'app

Dans Konsolity : Réglages › Machines CLI › Activer une machine, puis saisissez le code. Le coffre doit être ouvert.

Approuver dans le navigateur

Ouvrez https://app.konsolity.com/cli/activate (ou le lien complet affiché par la machine), connectez-vous, puis saisissez le code. La page demande votre mot de passe maître pour ouvrir le coffre dans le navigateur : il ne quitte jamais la page et n'est jamais envoyé au serveur.

Choisir la portée et l'expiration

Avant d'approuver, vous choisissez :

  • la portée : hosts, snippets, sessions, mcp, en lecture seule ou complète ;
  • les hôtes et les snippets que la machine pourra utiliser (par défaut : aucun hôte) ;
  • les règles de commande (pour un accès complet) ;
  • l'expiration de la machine.

Par défaut : hosts et snippets, lecture seule, aucun hôte. Le détail est dans Portée et règles.

Expiration Usage typique
1 jour Intervention ponctuelle
7 jours Mission courte, serveur de test
30 jours Projet en cours
90 jours (par défaut) Serveur d'administration
1 an Machine durable, renouvelée chaque année
Jamais À réserver aux machines que vous surveillez de près

Valider avec le second facteur

Le bouton Approuver demande votre code TOTP ou votre clé d'accès (Face ID, Touch ID, Windows Hello, clé de sécurité). Le second facteur est vérifié par le serveur dans la même requête que l'approbation : un code volé ou une session laissée ouverte ne suffit pas.

Ce qui se passe à l'approbation

  1. Votre appareil tire une clé de machine aléatoire et la scelle pour la clé publique de la machine (échange X25519). Le serveur ne transporte qu'un bloc opaque qu'il ne peut pas ouvrir.
  2. Il recopie, chiffrés par cette clé de machine, seulement les hôtes, identités, clés SSH, clés d'hôte épinglées et snippets que la portée autorise, ainsi que les règles. Le reste du coffre ne quitte pas vos appareils (voir Portée et règles).
  3. La machine reçoit son jeton (une seule fois), ouvre la clé de machine, vérifie qu'elle déchiffre bien ses règles, puis range jeton et clé dans son stockage protégé (voir Service et stockage).
  4. Vous recevez un e-mail, une notification de l'app et, si vous l'avez relié, un message Telegram « Nouvelle machine CLI ».

La commande affiche alors le nom de la machine et l'e-mail du compte. Vérifiez l'état à tout moment :

konsolity status

Une machine par empreinte

Chaque machine a une empreinte de machine, calculée à partir de l'identifiant du système (/etc/machine-id sur Linux, IOPlatformUUID sur macOS, MachineGuid sur Windows). Une nouvelle activation sur la même machine remplace l'ancienne : l'ancienne entrée est révoquée automatiquement. Il n'y a donc jamais deux jetons actifs pour un même ordinateur.

Cette empreinte est envoyée à chaque appel. Un jeton copié sur un autre ordinateur est refusé, et l'événement déclenche une alerte.

setup-token : CI et conteneurs

Un exécuteur de CI ou un conteneur est souvent recréé à chaque fois : son identifiant de machine change, et rien ne peut être stocké durablement. Pour ces cas, créez un jeton longue durée :

konsolity setup-token --name ci-deploy

Le flux est le même (code, empreinte, approbation avec second facteur, portée). À la fin, la commande affiche une seule fois un jeton qui commence par ksetup_, et n'écrit rien sur le disque :

Jeton longue durée (affiché une seule fois) :
ksetup_3q2Xk...
Placez-le dans le gestionnaire de secrets de votre CI, puis fournissez-le par KONSOLITY_TOKEN.

Rangez-le dans le gestionnaire de secrets de votre CI, puis fournissez-le à la commande par la variable d'environnement KONSOLITY_TOKEN :

KONSOLITY_TOKEN="$KONSOLITY_TOKEN" konsolity run web-01 -- systemctl status nginx

Un jeton longue durée :

  • n'est pas lié à l'empreinte de machine (il sert sur des machines éphémères) : protégez-le comme un mot de passe ;
  • expire obligatoirement, au plus 1 an après sa création ;
  • n'a pas de rotation automatique ;
  • apparaît dans la liste comme Jeton longue durée, avec la même portée, le même journal et la même révocation qu'une machine.

Si ça bloque

  • Code expiré : relancez konsolity login, un nouveau code est créé.
  • Second facteur requis : activez la double authentification ou une clé d'accès dans Sécurité, puis recommencez.
  • Abonnement requis : l'approbation demande l'offre Studio (ou son essai).
  • Refus : la machine s'arrête sans rien enregistrer.
  • Machine déjà activée : konsolity logout, puis konsolity login.