Permisiunile token-urilor (scopes)

Ce permite fiecare dintre cele 8 permisiuni, ce unelte deblochează și ce combinații vă recomandăm.

Permisiunile (în engleză, scopes) stabilesc ce poate face un asistent AI cu un token API. Le alegeți o singură dată, la crearea token-ului, în cardul „Token nou” de pe pagina „Token-uri de acces (API)” (blackbox.md/account/api-tokens, „Contul meu” → „Token-uri API”).

Disponibil pentru: orice client autentificat pe blackbox.md. Un token acționează doar asupra contului care l-a creat.

Cum funcționează permisiunile

Există 8 permisiuni. Primele trei sunt doar de citire și sunt bifate implicit. Celelalte cinci sunt afișate cu roșu și nu sunt bifate implicit.
Asistentul vede numai uneltele permise de token. O unealtă nepermisă este ascunsă; dacă asistentul o apelează totuși, primește eroarea missing_scope: this token does not have 'orders:write' (cu numele permisiunii care lipsește).
Două unelte nu cer nicio permisiune: whoami (confirmă contul și arată permisiunile primite și pe cele lipsă) și list_vm_plans (catalogul planurilor VPS, cu prețuri).
Permisiunile unui token nu se mai pot schimba după creare. Dacă aveți nevoie de o permisiune în plus, creați un token nou.
În lista token-urilor, coloana „Permisiuni” arată codurile (de exemplu servers:read), nu textul bifelor.

Cele 8 permisiuni

Cod	Bifa de pe pagină	Risc	Unelte deblocate
`servers:read`	„Citește lista și statusul serverelor mele”	doar citire, bifată implicit	`list_servers`, `get_server`, `get_server_resize_options`
`billing:read`	„Citește soldul, facturile și comenzile”	doar citire, bifată implicit	`get_balance`, `list_transactions`, `list_orders`, `list_invoices`
`ssh_keys:read`	„Citește lista cheilor mele SSH”	doar citire, bifată implicit	`list_ssh_keys`
`servers:power`	„Controlează alimentarea serverelor (repornire/oprire/pornire)”	roșie: întrerupe funcționarea serverului	`power_server`
`servers:credentials`	„Vizualizează parolele/accesul serverelor”	roșie: acces root la servere	`reveal_server_credentials`, `reset_server_password`, `add_server_ssh_key`, `set_server_password_auth`, `list_server_ssh_keys`, `remove_server_ssh_key`, `get_server_ssh_access`
`orders:write`	„Plasează și modifică comenzi în numele meu”	roșie: cheltuie din sold, poate șterge un server	`create_order`, `pay_order`, `cancel_order`, `resize_server`
`ssh_keys:write`	„Adaugă și șterge cheile mele SSH”	roșie: modifică cheile din cont	`add_ssh_key`, `delete_ssh_key`
`servers:exec`	„Rulează orice comandă ca root pe serverele mele”	roșie, cea mai periculoasă: orice comandă ca root	`run_server_command`

Ce face fiecare unealtă aflați din Lista uneltelor MCP.

Important Textul bifelor nu descrie tot ce permit de fapt permisiunile. „Vizualizează parolele/accesul serverelor” (servers:credentials) permite și resetarea parolei root, instalarea și ștergerea cheilor SSH de pe server, activarea sau dezactivarea autentificării cu parolă și emiterea unei chei SSH pentru asistent. „Plasează și modifică comenzi în numele meu” (orders:write) permite și upgrade-ul serverului (plata din sold și repornirea serverului) și anularea comenzilor; anularea unei comenzi cu server activ șterge serverul imediat, cu toate datele.

Avertismentele permisiunilor roșii

Sub fiecare permisiune roșie bifată apare textul „Atenție: cu această permisiune asistentul AI va putea ACȚIUNE. Acordați-o doar clienților în care aveți încredere — token-ul poate fi revocat oricând.” În locul cuvântului ACȚIUNE apare:

Permisiune	Acțiunea din avertisment
`servers:power`	„porni și opri serverele dvs.”
`servers:credentials`	„vedea parolele și cheile de acces ale serverelor dvs.”
`orders:write`	„cheltui bani și plasa comenzi în numele dvs.”
`ssh_keys:write`	„adăuga și șterge chei SSH din contul dvs.”
`servers:exec`	„rula orice comandă ca root pe serverele dvs.”

Cum alegeți permisiunile la crearea token-ului

Pe blackbox.md apăsați „Cont client”, apoi în meniul din stânga „Token-uri API” (pe telefon, deschideți mai întâi „Meniu cont”).
În cardul „Token nou”, completați „Nume token”.
La „Permisiuni”, debifați permisiunile de citire de care asistentul nu are nevoie.
Bifați permisiunile roșii doar dacă asistentul trebuie să schimbe ceva. Citiți avertismentul care apare sub fiecare.
Pentru acces complet, apăsați „AI-administrator — acces complet”: butonul bifează toate cele 8 permisiuni și afișează „Acces complet: asistentul va putea rula orice comandă ca root pe serverele dvs., vedea parole și chei și cheltui din sold. Exact ce are nevoie un administrator AI — nu trebuie să îi mai dați nimic în afară de token.” Ca să renunțați la o permisiune, o debifați separat.
Apăsați „Creează token”. Copierea și păstrarea token-ului sunt descrise în Token-uri API: creare, copiere și revocare.

După creare, formularul revine la cele trei permisiuni de citire.

Combinații recomandate

Profil	Permisiuni	Asistentul poate	Asistentul nu poate
Monitorizare, doar citire	`servers:read`, `billing:read`, `ssh_keys:read` (bifele implicite)	vedea serverele și starea lor, opțiunile de upgrade cu prețuri, soldul, tranzacțiile, comenzile, facturile și cheile din cont	schimba ceva, vedea parole, cheltui bani
Operator de servere, fără acces la bani	cele 3 de citire + `servers:power` + `servers:credentials`; opțional `servers:exec`	reporni, opri și porni serverele, vedea și reseta parola root, gestiona cheile de pe server; cu `servers:exec`, și rula comenzi ca root	plasa, plăti sau anula comenzi, face upgrade
Agent cu acces complet	toate cele 8, cu butonul „AI-administrator — acces complet”	tot ce permit uneltele MCP, inclusiv plăți din sold	alimenta soldul sau plăti cu cardul

Pentru un token cu permisiuni roșii, păstrați activă confirmarea acțiunilor în clientul AI. Recomandările complete sunt în Securitatea token-urilor și a agenților AI. Exemple de sarcini cu permisiunile necesare găsiți în Exemple de sarcini pentru asistentul AI și permisiunile necesare.

Securitate Tratați servers:credentials ca acces root, chiar și fără servers:exec. Cu ea asistentul vede parola root și poate obține o cheie SSH de acces (get_server_ssh_access), iar un client AI care poate rula comenzi pe calculatorul dvs. (de exemplu Claude Code) se poate conecta singur la server prin SSH.

Când asistentului îi lipsește o permisiune

Cereți asistentului să apeleze whoami. Răspunsul arată permisiunile token-ului și lista celor care lipsesc (missing_scopes).
Pe pagina „Token-uri de acces (API)”, creați un token nou cu permisiunea care lipsește și cu cele pe care le folosiți deja.
Înlocuiți token-ul vechi în clientul AI: Conectarea în aplicația Claude (connector personalizat) sau Conectarea din Claude Code, Cursor, VS Code și alți clienți.
Revocați token-ul vechi cu „Revocă”.

Întrebări frecvente

Pot adăuga o permisiune unui token existent? Nu. Creați un token nou cu permisiunile dorite și revocați-l pe cel vechi.

Asistentul îmi recomandă presetul „AI agent — full access”. Unde îl găsesc? Pe pagina „Token-uri de acces (API)”, butonul se numește „AI-administrator — acces complet”. Bifează toate cele 8 permisiuni.

Cu orders:write, asistentul poate plăti cu cardul sau alimenta soldul? Nu. Poate plăti doar din soldul existent. Detalii în Comenzi, plăți, anulări și upgrade prin AI.

Cu ssh_keys:write, asistentul instalează cheile pe servere? Nu. Permisiunea schimbă doar cheile salvate în cont. Instalarea sau ștergerea unei chei de pe server cere servers:credentials.

Pot crea un token fără nicio permisiune? Da, dacă debifați toate permisiunile. Asistentul va avea atunci doar whoami și list_vm_plans.