Team, ruoli e registri di audit
In questa pagina
Quando una singola chiave non basta più
In una grande organizzazione, non tutti gli utenti hanno le stesse esigenze o gli stessi diritti. Uno sviluppatore deve chiamare l’API, un responsabile finanziario deve visualizzare la fatturazione e un amministratore deve gestire tutto. Finché tre persone condividono una singola chiave, il problema rimane teorico e tutti riescono a cavarsela. Ma quando trenta persone in cinque progetti diversi chiamano la stessa API, la mancanza di struttura genera incidenti difficili da attribuire e fatture che nessuno sa spiegare. L’offerta Enterprise di xAI struttura questo accesso attraverso un sistema di team e ruoli.
Cosa copre un team
Un team in xAI rappresenta un gruppo di utenti che condividono risorse comuni: chiavi API, pool di capacità provisionata, fatturazione e limiti di spesa. Ogni team dispone delle proprie chiavi con ACL specifiche, limiti di spesa indipendenti, metriche di utilizzo separate e una fatturazione tracciabile. Nella pratica, un team che esaurisce il budget mensile non blocca gli altri, e la direzione finanziaria può rispondere alla domanda «quanto ci costa il progetto chatbot?» senza dover ricostruire manualmente i dati in un foglio di calcolo.
Tre strutture ricorrono spesso e la scelta giusta dipende da come la tua organizzazione prende le decisioni di budget. La suddivisione per dipartimento—equipe-engineering, equipe-data, equipe-support—funziona quando ogni servizio possiede il proprio budget e rende conto dei propri consumi. La suddivisione per progetto—projet-chatbot, projet-analyse, projet-recherche—ha senso quando le iniziative sono trasversali e finanziate separatamente, con contributori provenienti da più servizi. La suddivisione per ambiente—team-production, team-staging, team-dev—protegge al meglio la produzione: un esperimento che va in loop infinito un venerdì sera consumerà il budget di sviluppo, non quello del servizio clienti.
Ruoli e principio del minimo privilegio
I ruoli definiscono cosa può fare ciascun membro all’interno di un team. L’amministratore gestisce tutto: chiavi, membri, fatturazione, limiti. Lo sviluppatore crea e usa le chiavi API e visualizza le metriche, senza toccare le impostazioni del team. Il lettore visualizza metriche e fatturazione senza poteri di modifica, ruolo adatto a profili di pilotaggio e reporting. Il ruolo di fatturazione, infine, gestisce i metodi di pagamento e visualizza le fatture, senza alcun accesso tecnico.
Assegna a ogni utente solo i diritti necessari alla sua missione. Questo principio fondamentale di sicurezza limita l’impatto di un account compromesso e la sua applicazione quotidiana è diretta: uno sviluppatore frontend ha bisogno solo dei modelli chat, non di quelli per la generazione di immagini; un data scientist non ha motivo di accedere alla fatturazione; uno stagista dovrebbe lavorare in modalità sola lettura. Applicare questa griglia a un elenco utenti esistente rivela quasi sempre due o tre persone con diritti di amministrazione, perché era la soluzione più veloce alla data del loro ingresso e nessuno l’ha più rivista da allora.
Blindare ogni chiave con le ACL
L’API di Management ti permette di definire controlli di accesso granulari (ACL) su ciascuna chiave API:
{
"name": "cle-chatbot-support",
"acls": [
"api-key:endpoint:chat",
"api-key:model:grok-4.3"
],
"qps": 10,
"qpm": 100,
"tpm": 500000,
"expireTime": "2026-12-31T23:59:59Z"
}
Questa chiave illustra esattamente il principio precedente: chiama solo l’endpoint chat, esclusivamente con grok-4.3, entro un limite di 10 richieste al secondo e smette di funzionare alla fine dell’anno. Se viene compromessa, un attaccante non può né generare immagini né interrogare un modello più costoso, e la sua finestra di sfruttamento è limitata nel tempo senza alcun intervento da parte tua. Le ACL coprono quattro dimensioni: gli endpoint autorizzati tra chat, embed, image, tts, tokenize e documents; i modelli accessibili, con restrizione a uno o più modelli specifici; i limiti di velocità espressi in richieste al secondo (QPS), al minuto (QPM) e token al minuto (TPM); e la data di scadenza della chiave.
La memoria del tuo account
I registri di audit registrano tutte le azioni significative eseguite sul tuo account Enterprise: login e logout degli utenti, creazione, modifica ed eliminazione delle chiavi API, cambiamenti di ruoli e permessi, modifiche alla fatturazione e ai limiti di spesa, rotazione delle chiavi. Costituiscono un elemento essenziale sia per la conformità che per il rilevamento degli incidenti.
La loro utilità si manifesta in quattro aree. Per la conformità, dimostrano agli auditor che l’accesso è controllato e tracciato, alimentando direttamente la documentazione SOC 2 e HIPAA. Per l’indagine, permettono di ricostruire le azioni durante un incidente: sapere quale chiave è stata creata, da chi e quando trasforma un’ipotesi in un fatto accertato e accorcia considerevolmente le riunioni di crisi. Per l’ottimizzazione, rivelano chiavi inutilizzate e pattern anomali, ad esempio una chiave di test ancora attiva sei mesi dopo l’abbandono del prototipo. Infine, per la governance, verificano che le politiche di accesso siano effettivamente rispettate, non solo scritte in una nota interna.
Punti chiave
- I team permettono di segmentare accessi, fatturazione e limiti per dipartimento o progetto
- I ruoli applicano il principio del minimo privilegio a ogni utente
- Le ACL delle chiavi API controllano endpoint, modelli, limiti di velocità e scadenza
- I registri di audit tracciano tutte le azioni significative per conformità e indagini
- Struttura i tuoi team fin dall’inizio per evitare debiti di governance