Aktiver en maskin

Oppdatert 10. november 2026

Aktiveringen knytter maskinen til kontoen din, slik som med Claude Code eller en smart-TV: maskinen viser en kode, og du godkjenner den fra en enhet der du allerede er logget inn. Det skrives aldri inn noe passord på maskinen, og maskinen mottar aldri nøkkelen til hvelvet ditt.

Før du begynner

  • Studio-planen (eller prøveperioden) er aktiv på kontoen.
  • Tofaktorautentisering (TOTP) eller en passnøkkel er slått på under Sikkerhet: å godkjenne en maskin krever alltid en andre faktor. Uten noen av dem avvises godkjenningen med en melding som ber deg slå på en av dem.
  • En enhet der hvelvet er åpent: Konsolity-appen (Mac, Windows, Linux, iPhone, iPad, Android) eller nettkonsollen app.konsolity.com.

Start aktiveringen

På maskinen, med kontoen som skal bruke CLI-en (for en tjeneste, samme konto som tjenesten):

konsolity login --name build-01
Alternativ Funksjon
--name <name> Navnet som vises i maskinlisten (standard: vertsnavnet).
--scopes <list> Ønsket omfang, blant hosts, snippets, sessions, mcp, atskilt med komma.
--read-only Ber om skrivebeskyttet tilgang (lister og status, ingen kommandoer).

Det ønskede omfanget er bare et forslag: du fastsetter det når du godkjenner. Kommandoen viser:

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...

Når terminalen tillater det, vises også en QR-kode med hele lenken, praktisk for å godkjenne fra en telefon. Koden er gyldig i 15 minutter; maskinen venter og gjør ingenting annet.

Sammenlign fingeravtrykket

Fingeravtrykket (7K3Q-9XAD i eksempelet) beregnes fra den offentlige nøkkelen maskinen nettopp har generert. Godkjenningsskjermen beregner det selv på nytt fra denne nøkkelen, uten å stole på serveren, og viser det sammen med maskinens navn, system, arkitektur, vertsnavn og IP-adresse.

Godkjenn bare hvis du selv nettopp har kjørt konsolity login på denne maskinen, og fingeravtrykket er det samme. En forespørsel du ikke kjenner igjen, avviser du med ett klikk.

Godkjenn i appen

I Konsolity: Innstillinger › CLI-maskiner › Aktiver en maskin, og skriv deretter inn koden. Hvelvet må være åpent.

Godkjenn i nettleseren

Åpne https://app.konsolity.com/cli/activate (eller hele lenken som maskinen viser), logg inn, og skriv deretter inn koden. Siden ber om hovedpassordet ditt for å åpne hvelvet i nettleseren: det forlater aldri siden og sendes aldri til serveren.

Velg omfang og utløp

Før du godkjenner, velger du:

  • omfanget: hosts, snippets, sessions, mcp, skrivebeskyttet eller full;
  • vertene og snuttene maskinen kan bruke (standard: ingen vert);
  • kommandoreglene (for full tilgang);
  • maskinens utløp.

Standard: hosts og snippets, skrivebeskyttet, ingen vert. Detaljene står i Omfang og regler.

Utløp Typisk bruk
1 dag Engangsinngrep
7 dager Kort oppdrag, testserver
30 dager Pågående prosjekt
90 dager (standard) Administrasjonsserver
1 år Langvarig maskin, fornyes hvert år
Aldri Bare for maskiner du følger nøye med på

Bekreft med den andre faktoren

Knappen Godkjenn ber om TOTP-koden din eller passnøkkelen din (Face ID, Touch ID, Windows Hello, sikkerhetsnøkkel). Serveren kontrollerer den andre faktoren i samme forespørsel som godkjenningen: en stjålet kode eller en økt som er latt være åpen, er ikke nok.

Hva som skjer ved godkjenning

  1. Enheten din trekker en tilfeldig maskinnøkkel og forsegler den for maskinens offentlige nøkkel (X25519-utveksling). Serveren frakter bare en ugjennomsiktig blob den ikke kan åpne.
  2. Den kopierer, kryptert med denne maskinnøkkelen, bare vertene, identitetene, SSH-nøklene, de festede vertsnøklene og snuttene som omfanget tillater, sammen med reglene. Resten av hvelvet forlater ikke enhetene dine (se Omfang og regler).
  3. Maskinen mottar tokenet sitt (én gang), åpner maskinnøkkelen, kontrollerer at den dekrypterer reglene sine, og lagrer deretter token og nøkkel i sin beskyttede lagring (se Tjeneste og lagring).
  4. Du får en e-post, et varsel i appen og, hvis du har koblet den til, en Telegram-melding «Ny CLI-maskin».

Kommandoen viser deretter maskinens navn og kontoens e-postadresse. Sjekk statusen når som helst:

konsolity status

Én maskin per fingeravtrykk

Hver maskin har et maskinfingeravtrykk, beregnet fra systemidentifikatoren (/etc/machine-id på Linux, IOPlatformUUID på macOS, MachineGuid på Windows). En ny aktivering på samme maskin erstatter den forrige: den gamle oppføringen tilbakekalles automatisk. Det finnes derfor aldri to aktive tokener for samme datamaskin.

Dette fingeravtrykket sendes ved hvert kall. Et token som er kopiert til en annen datamaskin, avvises, og hendelsen utløser et varsel.

setup-token: CI og containere

En CI-runner eller en container blir ofte opprettet på nytt hver gang: maskinidentifikatoren endres, og ingenting kan lagres varig. For slike tilfeller oppretter du et langvarig token:

konsolity setup-token --name ci-deploy

Flyten er den samme (kode, fingeravtrykk, godkjenning med andre faktor, omfang). Til slutt viser kommandoen én gang et token som begynner med ksetup_, og skriver ingenting til disk:

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

Lagre det i hemmelighetsbehandleren i CI-en din, og gi det deretter til kommandoen via miljøvariabelen KONSOLITY_TOKEN:

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

Et langvarig token:

  • er ikke knyttet til maskinfingeravtrykket (det brukes på kortlivede maskiner): beskytt det som et passord;
  • må utløpe, senest 1 år etter at det ble opprettet;
  • har ingen automatisk rotasjon;
  • vises i listen som Langvarig token, med samme omfang, samme logg og samme tilbakekalling som en maskin.

Hvis det stopper opp

  • Koden er utløpt: kjør konsolity login på nytt, så opprettes en ny kode.
  • Andre faktor kreves: slå på tofaktorautentisering eller en passnøkkel under Sikkerhet, og start på nytt.
  • Abonnement kreves: godkjenning krever Studio-planen (eller prøveperioden).
  • Avvist: maskinen stopper uten å lagre noe.
  • Maskinen er allerede aktivert: konsolity logout, deretter konsolity login.