Activarea unei mașini

Actualizat pe 10 noiembrie 2026

Activarea leagă mașina de contul dumneavoastră, la fel ca pentru Claude Code sau un televizor inteligent: mașina afișează un cod, iar dumneavoastră îl aprobați de pe un dispozitiv pe care sunteți deja conectat. Nicio parolă nu se tastează pe mașină, iar mașina nu primește niciodată cheia seifului.

Înainte de a începe

  • Planul Studio (sau perioada sa de probă) este activ pe cont.
  • Autentificarea în doi pași (TOTP) sau o cheie de acces (passkey) este activată în Securitate: aprobarea unei mașini cere întotdeauna un al doilea factor. Fără niciuna dintre ele, aprobarea este refuzată cu un mesaj care vă cere să activați una.
  • Un dispozitiv cu seiful deschis: aplicația Konsolity (Mac, Windows, Linux, iPhone, iPad, Android) sau consola web app.konsolity.com.

Pornirea activării

Pe mașină, cu contul care va folosi CLI (pentru un serviciu, același cont ca serviciul):

konsolity login --name build-01
Opțiune Rol
--name <name> Numele afișat în lista mașinilor (implicit: numele gazdei).
--scopes <list> Domeniul cerut, dintre hosts, snippets, sessions, mcp, separate prin virgule.
--read-only Cere acces doar în citire (liste și stare, nicio comandă).

Domeniul cerut este doar o propunere: îl stabiliți dumneavoastră la aprobare. Comanda afișează:

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

Când terminalul permite, se afișează și un cod QR al linkului complet, util pentru a aproba de pe telefon. Codul rămâne valabil 15 minute; mașina așteaptă și nu face nimic altceva.

Compararea amprentei

Amprenta (7K3Q-9XAD în exemplu) este calculată din cheia publică pe care mașina tocmai a generat-o. Ecranul de aprobare o recalculează singur din această cheie, fără a se baza pe server, și o afișează împreună cu numele, sistemul, arhitectura, numele gazdei și adresa IP a mașinii.

Aprobați doar dacă tocmai ați rulat chiar dumneavoastră konsolity login pe această mașină și dacă amprenta este aceeași. O cerere pe care nu o recunoașteți se refuză cu un clic.

Aprobarea în aplicație

În Konsolity: Setări › Mașini CLI › Activează o mașină, apoi introduceți codul. Seiful trebuie să fie deschis.

Aprobarea în browser

Deschideți https://app.konsolity.com/cli/activate (sau linkul complet afișat de mașină), conectați-vă, apoi introduceți codul. Pagina vă cere parola principală pentru a deschide seiful în browser: aceasta nu părăsește niciodată pagina și nu este trimisă niciodată serverului.

Alegerea domeniului și a expirării

Înainte de aprobare, alegeți:

  • domeniul: hosts, snippets, sessions, mcp, doar în citire sau complet;
  • gazdele și fragmentele pe care mașina le poate folosi (implicit: nicio gazdă);
  • regulile de comenzi (pentru accesul complet);
  • expirarea mașinii.

Implicit: hosts și snippets, doar în citire, nicio gazdă. Detaliile se află în Domeniu și reguli.

Expirare Utilizare tipică
1 zi Intervenție punctuală
7 zile Misiune scurtă, server de test
30 de zile Proiect în desfășurare
90 de zile (implicit) Server de administrare
1 an Mașină de lungă durată, reînnoită în fiecare an
Niciodată Doar pentru mașinile pe care le supravegheați îndeaproape

Confirmarea cu al doilea factor

Butonul Aprobă vă cere codul TOTP sau cheia de acces (Face ID, Touch ID, Windows Hello, cheie de securitate). Serverul verifică al doilea factor în aceeași cerere cu aprobarea: un cod furat sau o sesiune lăsată deschisă nu sunt suficiente.

Ce se întâmplă la aprobare

  1. Dispozitivul dumneavoastră generează aleatoriu o cheie de mașină și o sigilează pentru cheia publică a mașinii (schimb X25519). Serverul transportă doar un bloc opac pe care nu îl poate deschide.
  2. Copiază, criptate cu această cheie de mașină, doar gazdele, identitățile, cheile SSH, cheile de gazdă fixate și fragmentele permise de domeniu, împreună cu regulile. Restul seifului nu părăsește dispozitivele dumneavoastră (vezi Domeniu și reguli).
  3. Mașina își primește tokenul (o singură dată), deschide cheia de mașină, verifică faptul că îi decriptează regulile, apoi stochează tokenul și cheia în spațiul său de stocare protejat (vezi Serviciu și stocare).
  4. Primiți un e-mail, o notificare în aplicație și, dacă l-ați conectat, un mesaj Telegram „Mașină CLI nouă”.

Comanda afișează apoi numele mașinii și adresa de e-mail a contului. Verificați starea oricând:

konsolity status

O mașină per amprentă

Fiecare mașină are o amprentă de mașină, calculată din identificatorul sistemului (/etc/machine-id pe Linux, IOPlatformUUID pe macOS, MachineGuid pe Windows). O nouă activare pe aceeași mașină o înlocuiește pe cea anterioară: vechea intrare este revocată automat. Astfel nu există niciodată două tokenuri active pentru același computer.

Această amprentă este trimisă la fiecare apel. Un token copiat pe alt computer este refuzat, iar evenimentul declanșează o alertă.

setup-token: CI și containere

Un runner CI sau un container este adesea recreat de fiecare dată: identificatorul său de mașină se schimbă și nimic nu poate fi stocat durabil. Pentru aceste cazuri, creați un token de lungă durată:

konsolity setup-token --name ci-deploy

Fluxul este același (cod, amprentă, aprobare cu al doilea factor, domeniu). La final, comanda afișează o singură dată un token care începe cu ksetup_ și nu scrie nimic pe disc:

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

Păstrați-l în managerul de secrete al CI, apoi furnizați-l comenzii prin variabila de mediu KONSOLITY_TOKEN:

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

Un token de lungă durată:

  • nu este legat de amprenta mașinii (servește pe mașini efemere): protejați-l ca pe o parolă;
  • trebuie să expire, cel mult la 1 an de la creare;
  • nu are rotație automată;
  • apare în listă ca Token de lungă durată, cu același domeniu, același jurnal și aceeași revocare ca o mașină.

Dacă se blochează

  • Cod expirat: rulați din nou konsolity login, se creează un cod nou.
  • Al doilea factor necesar: activați autentificarea în doi pași sau o cheie de acces în Securitate, apoi reluați.
  • Abonament necesar: aprobarea necesită planul Studio (sau perioada sa de probă).
  • Refuzat: mașina se oprește fără a salva nimic.
  • Mașină deja activată: konsolity logout, apoi konsolity login.