Ottenere l'accesso alla Compliance API

La Compliance API utilizza due tipi di chiave, e quale creare dipende dal prodotto Claude utilizzato dalla tua organizzazione. I proprietari principali creano le Compliance Access Key in claude.ai; queste chiavi sbloccano l'intera Compliance API. Gli amministratori dell'organizzazione creano le chiavi Admin API in Claude Console; queste chiavi sbloccano solo l'Activity Feed.

Quale chiave ti serve?

Un tenant Claude Enterprise ha una organizzazione padre che centralizza identità, SSO e SCIM per ogni organizzazione di lavoro sottostante. Queste organizzazioni di lavoro sono le organizzazioni collegate dell'organizzazione padre.

Richiedere l'accesso alla Compliance API

Contatta il tuo referente Anthropic per richiedere l'accesso. L'abilitazione avviene a livello di organizzazione padre e si propaga a ogni organizzazione collegata, sia claude.ai che Claude Console. Ciò che cambia dopo l'abilitazione dipende dal prodotto Claude utilizzato dalla tua organizzazione.

Dopo l'abilitazione: organizzazioni claude.ai

Dopo che Anthropic ha abilitato la Compliance API per la tua organizzazione padre, il proprietario principale può creare Compliance Access Key dalla sezione Keys in claude.ai > Organization settings > API.

Dopo l'abilitazione: organizzazioni Claude Console

Dopo che Anthropic ha abilitato la Compliance API per la tua organizzazione padre, le chiavi Admin API create da quel momento in poi includono l'ambito read:compliance_activities. Le chiavi Admin API create prima dell'abilitazione continuano a funzionare con l'Admin API, ma chiamare l'Activity Feed con una di esse restituisce 403 Forbidden; crea una nuova chiave Admin API per ottenere l'ambito.

Creare una Compliance Access Key

Creare una chiave Admin API

Le chiavi Admin API includono l'ambito read:compliance_activities solo se la Compliance API era abilitata per l'organizzazione prima della creazione della chiave; vedi Dopo l'abilitazione: organizzazioni Claude Console. Non è possibile concedere loro alcun altro ambito della Compliance API, quindi le chiamate a qualsiasi endpoint diverso dall'Activity Feed restituiscono 403 Forbidden.

Per il ruolo della stessa chiave nella gestione della tua organizzazione Claude Console, consulta Admin API.

Verificare gli ambiti della tua chiave

Per ispezionare gli ambiti di una chiave già in tuo possesso, usa uno dei seguenti indicatori.

• Prefisso della chiave. sk-ant-admin01- è una chiave Admin API (include solo read:compliance_activities, in base alla tempistica di abilitazione descritta nella sezione precedente). sk-ant-api01- è una Compliance Access Key; i suoi ambiti sono il sottoinsieme selezionato al momento della creazione.
• Interfaccia delle impostazioni. Apri la sezione Keys in claude.ai > Organization settings > API, oppure la sezione Admin keys in Claude Console > Settings > Admin keys, e leggi la colonna Scopes relativa alla chiave.
• Risposte di errore. Una chiamata che eccede gli ambiti della chiave restituisce un 403 con un messaggio nel formato Missing required scopes. Got: [<scopes the key carries>] Needed: [<scopes the endpoint requires>]. Consulta Gestire gli errori della Compliance API per il catalogo completo degli errori.

{
  "error": {
    "type": "permission_error",
    "message": "Missing required scopes. Got: ['read:compliance_activities'] Needed: ['read:compliance_user_data']"
  }
}

Gestire e ruotare le chiavi

Elimina una Compliance Access Key dalla stessa tabella Keys in cui l'hai creata: vai su claude.ai > Organization settings > API. Elimina una chiave Admin API da Claude Console > Settings > Admin keys.

L'eliminazione di una chiave ha effetto alla richiesta successiva: non esiste un periodo di tolleranza. Le Compliance Access Key non scadono autonomamente.

Per ruotare una chiave senza interruzioni di servizio:

1. Crea una nuova chiave con gli stessi ambiti.
2. Aggiorna la tua integrazione per utilizzare la nuova chiave.
3. Verifica che l'integrazione funzioni correttamente con la nuova chiave.
4. Elimina la vecchia chiave.

I cursori di paginazione memorizzati prima di una rotazione rimangono validi: i cursori sono associati all'organizzazione, non alla chiave.

Se una Compliance Access Key viene compromessa, eliminala immediatamente, esamina l'Activity Feed alla ricerca di attività compliance_api_accessed effettuate dalla chiave compromessa e ruota tutte le credenziali a valle a cui la chiave compromessa poteva accedere. Passa activity_types[]=compliance_api_accessed per limitare la query, quindi nel tuo client conserva le attività il cui actor.type è api_actor e il cui actor.api_key_id corrisponde alla chiave compromessa; consulta Comprendere l'oggetto Activity per lo schema dell'actor.

Passaggi successivi