Securitatea token-urilor și a agenților AI

Bune practici pentru token-uri și asistenți AI: permisiuni minime, rotație, păstrare sigură și ce faceți la o scurgere.

Un token API (bbx_pat_…) este o cheie de acces la contul dvs.: cine îl are poate face, de oriunde, tot ce permit permisiunile lui, până când îl revocați. Aici găsiți regulile de folosire sigură a token-urilor și a asistenților AI conectați prin MCP și pașii de urmat dacă un token a ajuns la altcineva. Token-urile se gestionează pe pagina „Token-uri de acces (API)” (blackbox.md/account/api-tokens, „Contul meu” → „Token-uri API”).

Disponibil pentru: titularul contului blackbox.md care folosește sau vrea să folosească un asistent AI prin MCP.

Regulile pe scurt

Regulă	De ce
Începeți cu un token doar de citire	Un asistent care doar citește nu poate schimba nimic și nu vede parole.
Câte un token pentru fiecare client AI sau dispozitiv	Revocați doar token-ul pierdut, fără să le opriți pe celelalte.
Verificați „Ultima utilizare” și revocați ce nu folosiți	Nu primiți email când un token este creat, folosit sau revocat.
Înlocuiți token-urile periodic	Token-urile nu expiră.
Țineți token-ul departe de conversații, capturi de ecran, tichete și depozite git	Oricine îl vede îl poate folosi.
Lăsați activă aprobarea acțiunilor în clientul AI	Fereastra de aprobare este ultima verificare înainte ca o comandă să ruleze pe server.

Acordați permisiuni minime

Începeți cu cele trei permisiuni de citire, bifate implicit în cardul „Token nou”: „Citește lista și statusul serverelor mele”, „Citește soldul, facturile și comenzile” și „Citește lista cheilor mele SSH”. Ele ajung pentru întrebări despre servere, sold și facturi.
Creați un token separat, cu permisiuni roșii (cele cinci afișate cu roșu), doar când vreți ca asistentul să vă administreze serverele. Butonul „AI-administrator — acces complet” bifează toate cele opt permisiuni: debifați apoi ce nu este necesar pentru sarcina respectivă.
Nu bifați „Plasează și modifică comenzi în numele meu” (orders:write) dacă asistentul nu trebuie să cheltuie bani: cu ea plasează și plătește comenzi din sold, face upgrade și anulează comenzi.
Permisiunile unui token nu se pot extinde după creare. Când aveți nevoie de mai mult, creați un token nou și revocați-l pe cel vechi.

Ce permite fiecare permisiune: Permisiunile token-urilor (scopes). Ce permisiuni cere o anumită sarcină: Exemple de sarcini pentru asistentul AI și permisiunile necesare.

Risc „Vizualizează parolele/accesul serverelor” (servers:credentials) și „Rulează orice comandă ca root pe serverele mele” (servers:exec) înseamnă acces root pe toate serverele pe care le administrați din cont. Token-ul nu este legat de un calculator sau de o adresă IP: dacă ajunge la altcineva, funcționează de oriunde, până îl revocați.

Câte un token pentru fiecare client și dispozitiv

Creați câte un token pentru fiecare client AI și fiecare dispozitiv. În „Nume token” scrieți un nume clar, de exemplu „Claude Desktop (laptop)” sau „Cursor (birou)”.
Verificați periodic tabelul de pe pagina „Token-uri de acces (API)”. Coloana „Ultima utilizare” arată când a fost folosit ultima dată fiecare token sau „niciodată”; se actualizează cel mult o dată pe minut.
Pentru token-urile pe care nu le mai folosiți sau nu le recunoașteți, apăsați „Revocă” și confirmați cu „Revocă” în fereastra „Revocați token-ul?”. Accesul se oprește imediat.

Nu se trimite niciun email la crearea sau revocarea unui token, așa că lista de pe această pagină este singurul loc unde vă vedeți token-urile. Pașii detaliați: Token-uri API: creare, copiere și revocare.

Cum înlocuiți periodic un token

Token-urile nu expiră, iar pagina nu vă lasă să setați o dată de expirare. Înlocuiți-le periodic și ori de câte ori schimbați dispozitivul sau când cineva care a văzut token-ul nu mai lucrează cu dvs.

În cardul „Token nou”, creați un token cu un nume nou și cu aceleași permisiuni ca cel vechi (coloana „Permisiuni” le arată prin coduri, de exemplu servers:read).
Copiați-l cu „Copiază” (se afișează o singură dată) și puneți-l în clientul AI în locul celui vechi.
Cereți asistentului să apeleze whoami. Dacă token-ul nou funcționează, răspunsul arată permisiunile lui (scopes) și pe cele care lipsesc (missing_scopes).
Pe rândul token-ului vechi apăsați „Revocă” și confirmați.

Unde păstrați token-ul

Puneți token-ul direct în setările clientului AI, într-un manager de parole sau într-o variabilă de mediu.
Nu îl lipiți în conversații (nici în cea cu asistentul AI), în capturi de ecran, în emailuri sau în tichete, nici măcar pentru suportul BLACKBOX.
Nu îl scrieți în fișiere care ajung într-un depozit git. Dacă fișierul de configurare stă în proiect, folosiți o variabilă de mediu. De exemplu, în fișierul .mcp.json al Claude Code:

{
  "mcpServers": {
    "blackbox": {
      "type": "http",
      "url": "https://api.app.blackbox.md/mcp",
      "headers": {
        "Authorization": "Bearer ${BBX_PAT}"
      }
    }
  }
}

Token-ul stă în variabila de mediu BBX_PAT, nu în fișier. Setările pentru fiecare client: Conectarea din Claude Code, Cursor, VS Code și alți clienți.

Dacă token-ul a ajuns totuși într-un depozit git, revocați-l. Nu este suficient să ștergeți fișierul sau commit-ul: istoria depozitului îl păstrează.

Ce vede furnizorul AI

Tot ce întorc uneltele MCP ajunge la clientul AI și la furnizorul care rulează modelul: lista serverelor și adresele IP, soldul și facturile, rezultatul comenzilor rulate pe server și, cu servers:credentials, parola root și cheia privată SSH pe care BLACKBOX o emite pentru asistent. Asistentul este instruit să nu afișeze secretele în conversație dacă nu i le cereți, dar ele ajung oricum la model.

Folosiți un furnizor AI în care aveți încredere și citiți-i condițiile despre păstrarea datelor.
Dacă nu vreți ca o parolă root văzută de asistent să rămână valabilă, resetați-o după ce terminați lucrul: Resetarea parolei root.

Aprobarea acțiunilor în clientul AI

Serverul MCP BLACKBOX marchează uneltele care schimbă ceva sau dezvăluie secrete, ca clientul AI să vă ceară aprobarea înainte de a le rula. Fereastra de aprobare o afișează însă clientul AI, nu BLACKBOX. Dacă alegeți aprobarea automată („always allow”, rulare automată sau o opțiune similară, în funcție de client), confirmările dispar.

Asistentul este instruit să vă ceară acordul doar înainte de a cheltui bani (plasarea și plata unei comenzi, upgrade), de a anula o comandă, de a șterge o cheie SSH de pe server, de a dezactiva autentificarea cu parolă și de a înlocui cheia agentului. Celelalte acțiuni (comenzi pe server, instalări, reporniri, resetarea parolei root, adăugarea cheilor SSH) este instruit să le facă direct, fără să întrebe. Pentru acestea, fereastra de aprobare a clientului este singura verificare.

Unelte	Aprobare automată
Doar citire: `whoami`, `list_vm_plans`, `list_servers`, `get_server`, `get_server_resize_options`, `get_balance`, `list_transactions`, `list_orders`, `list_invoices`, `list_ssh_keys`, `list_server_ssh_keys`	se poate permite
Bani și comenzi: `create_order`, `pay_order`, `cancel_order`, `resize_server`	nu
Server: `run_server_command`, `power_server`, `reveal_server_credentials`, `reset_server_password`, `get_server_ssh_access`, `add_server_ssh_key`, `remove_server_ssh_key`, `set_server_password_auth`	nu
Cheile din cont: `add_ssh_key`, `delete_ssh_key`	nu

Când folosiți MCP din propriul cod (prin API-urile furnizorilor AI), nu apare nicio fereastră de aprobare: uneltele rulează imediat ce modelul le apelează, dacă nu ați programat dvs. o confirmare. Acolo folosiți un token doar de citire sau limitați uneltele permise: Folosirea MCP din cod (API-uri AI și HTTP).

Atenție Nu activați aprobarea automată pentru uneltele care cheltuiesc bani sau modifică serverele. Aceste confirmări vă protejează soldul și datele. De exemplu, anularea unei comenzi cu server activ șterge serverul imediat, cu toate datele.

Instrucțiuni ascunse în conținut (prompt injection)

Un asistent AI urmează instrucțiuni scrise în text. Conținutul dintr-o sursă necontrolată (o pagină web, un fișier de log, un email, un fișier dintr-un proiect străin, chiar rezultatul unei comenzi) poate conține instrucțiuni puse acolo de altcineva. Un asistent cu servers:exec sau servers:credentials poate fi păcălit astfel să ruleze comenzi ca root sau să transmită parole.

Nu folosiți un token cu permisiuni roșii într-o sesiune în care asistentul navighează pe web, citește emailuri sau prelucrează fișiere primite de la alții.
Citiți fiecare comandă înainte să o aprobați. Opriți-vă dacă asistentul propune ceva ce nu ați cerut: să descarce și să ruleze un script de pe internet, să adauge o cheie SSH sau un utilizator, să trimită date către o adresă necunoscută ori să afișeze parole.
După ce asistentul a citit log-uri sau pagini web, verificați cu și mai multă atenție comenzile pe care le propune.

Cum ajunge asistentul pe server

Asistentul nu are nevoie de parola root sau de cheia dvs. SSH. BLACKBOX păstrează pe fiecare server VPS o cheie de administrare, afișată în panou ca „Cheie de administrare (blackbox.md)” în lista „Chei instalate”. Comenzile rulate prin run_server_command trec, ca root, prin această conexiune BLACKBOX. De aceea, un token cu servers:exec este tot ce îi trebuie cuiva ca să ruleze comenzi pe serverele dvs. Detalii: Cheile BLACKBOX de pe serverul dvs..

Accesul asistentului îl opriți revocând token-ul, nu ștergând cheia de administrare. Fără ea nu mai funcționează nici funcții ale panoului, de exemplu „Resetează parola”.
Cu servers:credentials, asistentul poate primi parola root sau o cheie privată SSH proprie (cheia agentului, cu comentariul blackbox-agent-…). Acestea rămân valabile și după revocarea token-ului, până când resetați parola sau ștergeți cheia de pe server.

Dacă un token a ajuns la altcineva

Revocați token-ul: „Contul meu” → „Token-uri API” → „Revocă” pe rândul lui, apoi confirmați cu „Revocă”. Clientul care îl folosea pierde accesul la următoarea cerere.
Dacă nu știți ce token a scăpat, opriți-le pe toate deodată schimbând parola contului blackbox.md (nu pe cea din panou): „Contul meu” → „Profil” → „Schimbă parola”. Token-urile create înainte nu mai funcționează, dar rămân în listă fără niciun marcaj, așa că revocați-le și pe ele. Pașii: Schimbarea parolei contului.
Uitați-vă la coloanele „Permisiuni” și „Ultima utilizare” ale token-ului. Dacă a fost folosit după ce l-ați pierdut, faceți verificările din tabelul de mai jos.
Creați token-uri noi doar pentru clienții AI pe care îi folosiți în continuare.
Scrieți-ne la support@blackbox.md sau deschideți un tichet (Deschiderea unui tichet de suport). Indicați numele token-ului și ora din „Ultima utilizare”, fără token-ul însuși.

Permisiunea token-ului	Ce verificați și ce faceți
`servers:credentials`	În panou („Infrastructură” → „Serverele mele”), pe fiecare server: apăsați „Resetează parola”; la „Adaugă cheie SSH” → „Chei instalate” ștergeți cheile necunoscute și cheia `blackbox-agent-…`; verificați dacă insigna arată „Doar cheie” sau „Parolă + cheie”, cum ați lăsat-o.
`servers:exec`	Aceleași verificări, plus o verificare completă a serverului: Serverul a fost spart sau este atacat: ce faceți.
`orders:write`	În „Comenzi” și „Sold” căutați comenzi, plăți, upgrade-uri sau anulări pe care nu le-ați făcut și scrieți-ne.
`ssh_keys:write`	În „Contul meu” → „Chei SSH” ștergeți cheile pe care nu le recunoașteți.
`servers:power`	Verificați că serverele sunt pornite.
doar permisiuni de citire	Nimic de reparat; lista serverelor, adresele IP, soldul, facturile, comenzile și lista cheilor SSH au fost însă vizibile.

Dacă după ștergerea cheii blackbox-agent-… mai folosiți acces SSH prin AI, cereți asistentului o cheie nouă cu regenerate=true; altfel se reinstalează cheia veche. Detalii: Acces SSH și chei SSH prin asistentul AI.

Important Dacă v-ați creat contul cu Google sau GitLab, el nu are parolă pe blackbox.md: pe pagina „Profil” lipsește secțiunea „Parolă”, iar pasul 2 nu se poate face. Revocați atunci fiecare token cu „Revocă”.

Răspunderea pentru token-uri

Conform Termenilor și condițiilor (§3), răspundeți pentru securizarea parolelor, cheilor SSH, token-urilor API și a factorului de autentificare secundar. Ce face un asistent AI sau oricine altcineva cu token-ul dvs. se face în numele contului dvs., inclusiv plățile din sold. BLACKBOX nu răspunde pentru folosirea contului de către terți dacă nu există o breșă dovedită a sistemelor sale. Rezumatul termenilor: Termenii și condițiile pe scurt.

Întrebări frecvente

Deconectarea de pe blackbox.md oprește token-urile? Nu. Nici deconectarea, nici „Deconectare de peste tot” sau schimbarea parolei din panou nu ating token-urile. Le opresc doar „Revocă” și schimbarea parolei contului blackbox.md.

Am lipit din greșeală token-ul în conversația cu asistentul. Ce fac? Conversația ajunge la furnizorul AI și poate rămâne în istoricul clientului. Creați un token nou, puneți-l în client și revocați-l pe cel vechi.

Trebuie să trimit token-ul suportului ca să verifice o problemă? Nu. Pentru diagnosticare ajung numele token-ului, permisiunile lui și mesajul de eroare din clientul AI.