--- title: Configurare la Compliance API url: https://platform.claude.com/docs/it/manage-claude/compliance-api-access description: Abilita la Compliance API per la tua organizzazione, quindi crea una Compliance Access Key (con autorizzazioni limitate) o una chiave Admin API, e scopri quale usare. --- Le organizzazioni Claude Enterprise e le organizzazioni Claude Console autonome idonee hanno accesso self-service alla Compliance API. Questa pagina descrive come abilitare la Compliance API per la tua organizzazione e creare chiavi API. **Ruolo richiesto:** amministratore dell'organizzazione (Claude Console), oppure proprietario principale o proprietario dell'organizzazione (claude.ai). La Compliance API utilizza due tipi di chiave, e quale creare dipende da quale prodotto Claude utilizza la tua organizzazione. I proprietari principali e i proprietari dell'organizzazione creano Compliance Access Key in claude.ai; queste chiavi sbloccano l'intera Compliance API. La chiave di un proprietario principale può coprire ogni organizzazione sotto l'organizzazione padre; la chiave di un proprietario dell'organizzazione copre solo la propria organizzazione. Gli amministratori dell'organizzazione creano chiavi Admin API in Claude Console; queste chiavi sbloccano solo l'[Activity Feed](https://platform.claude.com/docs/it/manage-claude/compliance-activity-feed) (feed delle attività). ## Di quale chiave hai bisogno? | Tipo di chiave | Creata in | Usata per | Funziona con la Compliance API? | | ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- | | **Compliance Access Key** (`sk-ant-api01-...`) | [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) | Activity Feed, chat, file, progetti, sessioni (in app come Cowork e Claude Code), utenti, metadati dell'organizzazione e impostazioni dell'organizzazione | Sì (tutti gli endpoint) | | **Chiave Admin API** (`sk-ant-admin01-...`) | Pagina [Admin keys](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) in Claude Console | L'[Admin API](https://platform.claude.com/docs/it/manage-claude/admin-api) e l'Activity Feed della Compliance API | Solo Activity Feed | | **Chiave Analytics API** | [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) | La Claude Enterprise Analytics API (vedi [Analytics API](https://platform.claude.com/docs/it/manage-claude/analytics-api)) | No | | **Chiave Claude API** (`sk-ant-api03-...`) | Pagina [API keys](https://platform.claude.com/settings/keys) (`platform.claude.com/settings/keys`) in Claude Console | Chiamare i modelli Claude tramite la [Claude API](https://platform.claude.com/docs/it/api/overview) | No | Un tenant Claude Enterprise ha una **organizzazione padre** che centralizza identità, SSO e SCIM per ogni organizzazione di carico di lavoro al di sotto di essa. Queste organizzazioni di carico di lavoro sono le **organizzazioni collegate** dell'organizzazione padre. **Le organizzazioni padre Claude Enterprise non compaiono in Claude Console (`platform.claude.com`).** L'organizzazione padre non ha carichi di lavoro, né chiavi Claude API, né chiavi Admin API. Crea le Compliance Access Key in **Organization settings** di claude.ai, non in Claude Console. ## Configurare la Compliance API La configurazione è un unico flusso: abilita la Compliance API per la tua organizzazione, quindi crea una Compliance Access Key in claude.ai. Un'organizzazione Claude Console invece [crea una chiave Admin API](https://platform.claude.com/docs/it/manage-claude/compliance-api-access#create-an-admin-api-key) dopo l'abilitazione; le chiavi Admin API raggiungono solo l'[Activity Feed](https://platform.claude.com/docs/it/manage-claude/compliance-activity-feed). Una Compliance Access Key con `read:compliance_user_data` può leggere ogni chat, file, progetto e trascrizione di sessione in ogni organizzazione collegata, inclusi contenuti che il proprietario principale non ha visto. Una chiave con `delete:compliance_user_data` può eliminare definitivamente chat, file e progetti. Tratta le Compliance Access Key come credenziali di database di produzione: conservale in un gestore di segreti, mai nel controllo del codice sorgente o nella configurazione di un forwarder SIEM. Dove abiliti la Compliance API dipende da come è configurata la tua organizzazione: * **Organizzazioni Claude Enterprise:** Il proprietario principale abilita la Compliance API in [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access). L'abilitazione avviene a livello di organizzazione padre e si propaga a ogni organizzazione collegata, sia claude.ai che Claude Console. * **Organizzazioni Claude Console autonome:** Un amministratore dell'organizzazione attiva l'interruttore **Compliance API** nella pagina [Compliance](https://platform.claude.com/settings/security) (`platform.claude.com/settings/security`) in Claude Console. L'abilitazione è self-service per le organizzazioni idonee e la modifica ha effetto immediato. Se la pagina mostra un errore di pagina non trovata, o non mostra la sezione **Compliance API**, non hai il ruolo di amministratore, la tua organizzazione è collegata a un'organizzazione padre (in tal caso la Compliance API viene abilitata dall'organizzazione padre) oppure la tua organizzazione non è idonea all'abilitazione self-service; contatta il tuo team account o il [supporto Anthropic](https://support.claude.com) se non sei sicuro di quale caso si applichi. * **Organizzazioni Claude Console collegate a un'organizzazione padre:** Non c'è nulla da attivare in Claude Console. Chiedi al proprietario principale della tua organizzazione padre di abilitare la Compliance API in claude.ai, oppure contatta il tuo team account. **Disattivare la Compliance API interrompe la registrazione delle attività.** Un amministratore dell'organizzazione può disattivare la Compliance API in qualsiasi momento con lo stesso interruttore **Compliance API** che la attiva. Mentre la Compliance API è disattivata, nessun evento di attività viene registrato per la tua organizzazione, quindi l'[Activity Feed](https://platform.claude.com/docs/it/manage-claude/compliance-activity-feed) non riceve nuovi eventi. Se la tua organizzazione è iscritta ad [Access Transparency](https://platform.claude.com/docs/it/manage-claude/access-transparency), disattivare la Compliance API interrompe anche la consegna degli eventi di Access Transparency. Le attività non registrate mentre la Compliance API è disattivata non possono essere recuperate in seguito. Riattivare la Compliance API riprende la registrazione da quel momento in poi; le attività già registrate non vengono eliminate. Per le organizzazioni Claude Enterprise, l'impostazione Compliance API in claude.ai governa anche l'acquisizione delle trascrizioni per le [sessioni locali](https://platform.claude.com/docs/it/manage-claude/compliance-sessions#retrieve-local-sessions) (sessioni sulle macchine degli utenti): l'acquisizione inizia quando la Compliance API viene abilitata e si interrompe mentre è disattivata, e il contenuto delle trascrizioni delle sessioni eseguite mentre è disattivata non viene acquisito e non può essere recuperato in seguito. Un'organizzazione Claude Console autonoma utilizza chiavi Admin API anziché Compliance Access Key: dopo l'abilitazione, salta i passaggi rimanenti e [crea una nuova chiave Admin API](https://platform.claude.com/docs/it/manage-claude/compliance-api-access#create-an-admin-api-key). I passaggi rimanenti forniscono Compliance Access Key, disponibili solo per le organizzazioni che fanno parte di un tenant Claude Enterprise. L'accesso di una chiave viene impostato al momento della creazione. Decidi quali organizzazioni copre la chiave: * Una chiave per l'**organizzazione padre** può accedere a ogni organizzazione sotto l'organizzazione padre. * Una chiave per una **singola organizzazione** può accedere solo a quell'organizzazione. Accedi a claude.ai. Il proprietario principale dell'organizzazione padre può creare una chiave con entrambi gli ambiti. Un proprietario dell'organizzazione può creare una chiave limitata solo alla propria organizzazione. Se la pagina **API** descritta nel passaggio successivo non è visibile, o gli scope di compliance non sono disponibili durante la creazione di una chiave, o il tuo ruolo non può creare Compliance Access Key, oppure la Compliance API non è ancora stata abilitata per la tua organizzazione (torna al primo passaggio). Vai a [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) e trova la sezione **Keys**. Fai clic su **Create key**, assegna un nome alla chiave e seleziona uno o più scope dalla tabella seguente. Fai clic su **Create**. | Scope | Concede | | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `read:compliance_activities` | Leggere l'Activity Feed. Una chiave che copre l'organizzazione padre legge gli eventi per l'organizzazione padre e tutte le organizzazioni collegate. | | `read:compliance_user_data` | Leggere chat, messaggi, file, progetti, metadati e trascrizioni delle sessioni degli utenti, utenti dell'organizzazione, preferenze utente e membri dei gruppi | | `delete:compliance_user_data` | Eliminare chat, file e progetti degli utenti | | `read:compliance_org_data` | Leggere i metadati dell'organizzazione (nomi, tipi, ruoli e gruppi) e le impostazioni effettive in vigore per le organizzazioni sotto l'organizzazione padre. Gli elenchi degli utenti e l'appartenenza ai gruppi richiedono `read:compliance_user_data`. | Con la Plugins API, `read:compliance_org_data` legge anche l'inventario dei plugin e dei marketplace di plugin della tua organizzazione tramite l'Admin API, inclusi i plugin personali dei membri e i relativi file. Tale inventario identifica i membri: contiene l'ID utente di ogni membro che possiede o ha creato un plugin, o con cui un plugin è stato condiviso individualmente, e l'indirizzo email del creatore di un plugin finché è ancora membro; vedi [Leggere plugin e marketplace di plugin](https://platform.claude.com/docs/it/manage-claude/compliance-org-data#read-plugins-and-plugin-marketplaces). Scegli l'insieme di scope più ristretto di cui la tua integrazione ha bisogno: * Una pipeline di audit che legge solo l'Activity Feed ha bisogno solo di `read:compliance_activities`. * Uno strumento di eDiscovery che legge chat e file ma non li elimina mai non ha bisogno di `delete:compliance_user_data`. * Se il tuo flusso di lavoro legge ed elimina, usa **due chiavi** con scope separati in modo che una chiave di lettura trapelata non possa eliminare dati. Gli scope delle Compliance Access Key sono immutabili dopo la creazione. Per modificare gli scope, crea una nuova chiave con gli scope desiderati, quindi elimina quella vecchia. Copia la chiave segreta visualizzata (che inizia con `sk-ant-api01-`) e conservala nel tuo gestore di segreti. Il segreto completo viene visualizzato una sola volta. Imposta la chiave come variabile d'ambiente in modo che gli esempi shell di questa guida possano leggerla: ```bash export ANTHROPIC_COMPLIANCE_ACCESS_KEY=sk-ant-api01-... ``` ## Creare una chiave Admin API La Compliance API deve essere già [abilitata per la tua organizzazione Claude Console](https://platform.claude.com/docs/it/manage-claude/compliance-api-access#set-up-the-compliance-api) prima che una chiave Admin API possa chiamare l'Activity Feed. Segui i passaggi in [Creare una chiave Admin API](https://platform.claude.com/docs/it/manage-claude/admin-api-keys#create-a-key-for-a-claude-console-organization), quindi imposta la chiave come variabile d'ambiente: ```bash export ANTHROPIC_ADMIN_KEY=sk-ant-admin01-... ``` Il nome di variabile distinto impedisce alla chiave Admin API di sovrascrivere una Compliance Access Key se le fornisci entrambe. Gli esempi cURL di questa guida leggono la chiave da `$ANTHROPIC_COMPLIANCE_ACCESS_KEY`; sostituisci con `$ANTHROPIC_ADMIN_KEY` quando chiami l'[Activity Feed](https://platform.claude.com/docs/it/manage-claude/compliance-activity-feed) con una chiave Admin API. Le chiavi Admin API hanno lo scope `read:compliance_activities` solo se la Compliance API era abilitata per l'organizzazione al momento della creazione della chiave; vedi [Configurare la Compliance API](https://platform.claude.com/docs/it/manage-claude/compliance-api-access#set-up-the-compliance-api). Non possono ricevere nessun altro scope della Compliance API, quindi le chiamate a qualsiasi endpoint diverso dall'Activity Feed restituiscono [403 Forbidden](https://platform.claude.com/docs/it/manage-claude/compliance-errors#403-forbidden). Per il ruolo della stessa chiave nella gestione della tua organizzazione Claude Console, vedi [Admin API](https://platform.claude.com/docs/it/manage-claude/admin-api). ## Verificare gli scope della tua chiave Per ispezionare gli scope di una chiave che già possiedi, usa uno dei seguenti segnali. * **Prefisso della chiave.** `sk-ant-admin01-` indica una chiave Admin API (ha solo `read:compliance_activities`, in base alla tempistica di abilitazione descritta nella sezione precedente). `sk-ant-api01-` indica una Compliance Access Key; i suoi ambiti sono il sottoinsieme che hai selezionato al momento della creazione. * **Interfaccia delle impostazioni.** Per una Compliance Access Key, apri la sezione **Keys** in [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) e leggi la colonna **Scopes** relativa alla chiave. Le chiavi Admin API, elencate nella pagina [Admin keys](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) in Claude Console, non hanno scope selezionabili. * **Risposte di errore.** Una chiamata che eccede gli ambiti della chiave restituisce un 403 con un messaggio nel formato `Missing required scopes. Got: [] Needed one of: []` (`Needed: [...]` sugli endpoint di eliminazione). Vedi [Gestisci gli errori della Compliance API](https://platform.claude.com/docs/it/manage-claude/compliance-errors#403-forbidden) per il catalogo completo degli errori. ```json { "error": { "type": "permission_error", "message": "Missing required scopes. Got: ['read:compliance_activities'] Needed one of: ['read:compliance_user_data', 'read:org_audit']" } } ``` ## Gestire e ruotare le chiavi Elimina una Compliance Access Key dalla stessa tabella **Keys** in cui l'hai creata: vai a [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access). Elimina una chiave Admin API dalla pagina [Admin keys](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) in Claude Console. L'eliminazione di una chiave ha effetto alla richiesta successiva: non c'è alcun periodo di tolleranza. Le Compliance Access Key non scadono da sole. Per ruotare una chiave senza interruzioni: 1. Crea una nuova chiave con gli stessi scope. 2. Aggiorna la tua integrazione per usare la nuova chiave. 3. Verifica che l'integrazione funzioni con la nuova chiave. 4. Elimina la vecchia chiave. I cursori di paginazione memorizzati prima di una rotazione rimangono validi: i cursori sono legati all'organizzazione, non alla chiave. Se una Compliance Access Key trapela, eliminala immediatamente, controlla l'[Activity Feed](https://platform.claude.com/docs/it/manage-claude/compliance-activity-feed) per le attività `compliance_api_accessed` della chiave compromessa e ruota tutte le credenziali a valle che la chiave trapelata poteva raggiungere. Passa `activity_types[]=compliance_api_accessed` per limitare la query, quindi nel tuo client mantieni le attività il cui `actor.type` è `api_actor` e il cui `actor.api_key_id` corrisponde alla chiave compromessa; vedi [Comprendere l'oggetto Activity](https://platform.claude.com/docs/it/manage-claude/compliance-activity-feed#understand-the-activity-object) per lo schema dell'attore. ## Passaggi successivi Leggi gli eventi di attività a livello di organizzazione con qualsiasi chiave che abbia `read:compliance_activities`. Usa una Compliance Access Key con `read:compliance_user_data` per recuperare chat, file e progetti di claude.ai, e `delete:compliance_user_data` per eliminarli. Usa una Compliance Access Key con `read:compliance_user_data` per elencare le sessioni che i tuoi utenti eseguono nelle app e negli agenti Claude, come Cowork e Claude Code, e recuperarne le trascrizioni.