Een machine activeren

Bijgewerkt op 10 november 2026

Activering koppelt de machine aan je account, zoals bij Claude Code of een smart-tv: de machine toont een code en je keurt die goed vanaf een apparaat waarop je al bent ingelogd. Er wordt geen wachtwoord ingetypt op de machine, en de machine ontvangt nooit de sleutel van je kluis.

Voordat je begint

  • Het abonnement Studio (of de proefperiode daarvan) is actief op het account.
  • Tweestapsverificatie (TOTP) of een passkey staat aan onder Beveiliging: het goedkeuren van een machine vereist altijd een tweede factor. Zonder een van beide wordt de goedkeuring geweigerd met een melding die vraagt er een in te schakelen.
  • Een apparaat waarop de kluis open is: de Konsolity-app (Mac, Windows, Linux, iPhone, iPad, Android) of de webconsole app.konsolity.com.

De activering starten

Op de machine, met het account dat de CLI gaat gebruiken (voor een service hetzelfde account als de service):

konsolity login --name build-01
Optie Functie
--name <name> Naam in de lijst met machines (standaard: de hostnaam).
--scopes <list> Gevraagd bereik, uit hosts, snippets, sessions, mcp, gescheiden door komma's.
--read-only Vraagt alleen-lezentoegang (lijsten en status, geen opdrachten).

Het gevraagde bereik is slechts een voorstel: jij legt het vast bij de goedkeuring. De opdracht toont:

Activating this machine on https://api.konsolity.com
1. Open this address on a device signed in to your account:
   https://app.konsolity.com/cli/activate?code=WDJB-MJHT
   or in the Konsolity app: Settings › CLI machines › Activate a machine
2. Enter this code: WDJB-MJHT
3. Check that the fingerprint shown is: 7K3Q-9XAD
Waiting for approval...

Als de terminal het toelaat, wordt ook een QR-code van de volledige link getoond, handig om vanaf een telefoon goed te keuren. De code blijft 15 minuten geldig; de machine wacht en doet verder niets.

De vingerafdruk vergelijken

De vingerafdruk (7K3Q-9XAD in het voorbeeld) wordt berekend uit de publieke sleutel die de machine zojuist heeft gegenereerd. Het goedkeuringsscherm berekent hem zelf opnieuw uit die sleutel, zonder de server te vertrouwen, en toont hem samen met de naam, het systeem, de architectuur, de hostnaam en het IP-adres van de machine.

Keur alleen goed als je zelf zojuist konsolity login op deze machine hebt uitgevoerd en de vingerafdruk gelijk is. Een verzoek dat je niet herkent, weiger je met één klik.

Goedkeuren in de app

In Konsolity: Instellingen › CLI-machines › Een machine activeren, en voer daarna de code in. De kluis moet open zijn.

Goedkeuren in de browser

Open https://app.konsolity.com/cli/activate (of de volledige link die de machine toont), log in en voer daarna de code in. De pagina vraagt je hoofdwachtwoord om de kluis in de browser te openen: het verlaat de pagina nooit en wordt nooit naar de server gestuurd.

Het bereik en de vervaldatum kiezen

Voordat je goedkeurt, kies je:

  • het bereik: hosts, snippets, sessions, mcp, alleen lezen of volledig;
  • de hosts en snippets die de machine mag gebruiken (standaard: geen host);
  • de regels voor opdrachten (bij volledige toegang);
  • de vervaldatum van de machine.

Standaard: hosts en snippets, alleen lezen, geen host. De details staan in Bereik en regels.

Geldigheidsduur Typisch gebruik
1 dag Eenmalige ingreep
7 dagen Korte opdracht, testserver
30 dagen Lopend project
90 dagen (standaard) Beheerserver
1 jaar Machine voor de lange termijn, elk jaar verlengd
Nooit Alleen voor machines die je nauwlettend in de gaten houdt

Bevestigen met de tweede factor

De knop Goedkeuren vraagt je TOTP-code of je passkey (Face ID, Touch ID, Windows Hello, beveiligingssleutel). De server controleert de tweede factor in hetzelfde verzoek als de goedkeuring: een gestolen code of een open gelaten sessie is niet genoeg.

Wat er gebeurt bij goedkeuring

  1. Je apparaat genereert een willekeurige machinesleutel en verzegelt die voor de publieke sleutel van de machine (X25519-uitwisseling). De server vervoert alleen een ondoorzichtig blok dat hij niet kan openen.
  2. Het kopieert, versleuteld met deze machinesleutel, alleen de hosts, identiteiten, SSH-sleutels, vastgelegde hostsleutels en snippets die het bereik toestaat, samen met de regels. De rest van de kluis verlaat je apparaten niet (zie Bereik en regels).
  3. De machine ontvangt haar token (één keer), opent de machinesleutel, controleert dat ze haar regels kan ontsleutelen en bewaart token en sleutel daarna in haar beveiligde opslag (zie Service en opslag).
  4. Je ontvangt een e-mail, een melding in de app en, als je die hebt gekoppeld, een Telegram-bericht "Nieuwe CLI-machine".

De opdracht toont daarna de naam van de machine en het e-mailadres van het account. Controleer de status op elk moment:

konsolity status

Eén machine per vingerafdruk

Elke machine heeft een machinevingerafdruk, berekend uit de systeemidentificatie (/etc/machine-id op Linux, IOPlatformUUID op macOS, MachineGuid op Windows). Een nieuwe activering op dezelfde machine vervangt de vorige: de oude vermelding wordt automatisch ingetrokken. Er zijn dus nooit twee actieve tokens voor dezelfde computer.

Deze vingerafdruk wordt bij elke aanroep meegestuurd. Een token dat naar een andere computer is gekopieerd, wordt geweigerd en de gebeurtenis activeert een waarschuwing.

setup-token: CI en containers

Een CI-runner of een container wordt vaak elke keer opnieuw aangemaakt: de machine-identificatie verandert en er kan niets duurzaam worden opgeslagen. Maak voor deze gevallen een langlevend token aan:

konsolity setup-token --name ci-deploy

Het verloop is hetzelfde (code, vingerafdruk, goedkeuring met een tweede factor, bereik). Aan het eind toont de opdracht één keer een token dat begint met ksetup_, en schrijft niets naar de schijf:

Long-lived token (shown once):
ksetup_3q2Xk...
Store it in your CI secret manager, then provide it through KONSOLITY_TOKEN.

Bewaar het in de geheimenbeheerder van je CI en geef het daarna aan de opdracht door via de omgevingsvariabele KONSOLITY_TOKEN:

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

Een langlevend token:

  • is niet gebonden aan de machinevingerafdruk (het dient voor kortstondige machines): bescherm het als een wachtwoord;
  • moet verlopen, uiterlijk 1 jaar na het aanmaken;
  • wordt niet automatisch vernieuwd;
  • verschijnt in de lijst als Langlevend token, met hetzelfde bereik, hetzelfde logboek en dezelfde intrekking als een machine.

Als het vastloopt

  • Code verlopen: voer konsolity login opnieuw uit, er wordt een nieuwe code aangemaakt.
  • Tweede factor vereist: schakel tweestapsverificatie of een passkey in onder Beveiliging en begin opnieuw.
  • Abonnement vereist: goedkeuring vereist het abonnement Studio (of de proefperiode daarvan).
  • Geweigerd: de machine stopt zonder iets op te slaan.
  • Machine al geactiveerd: konsolity logout, daarna konsolity login.