Riferimento per i risultati di Security posture

Questo endpoint restituisce una voce per la maggior parte dei controlli di sicurezza di un’organizzazione, valutati al momento della richiesta, con l’attestazione di Security posture che la risposta mostra per ciascun controllo. Ti serve una Compliance Access Key che copra l’organizzazione, con lo scope read:compliance_org_data o read:org_audit; Disponibilità di Security posture indica quali organizzazioni possono essere lette.

Richiesta

Invia una richiesta GET a /v1/compliance/organizations/{organization_id}/security_posture. Ogni chiamata legge una sola organizzazione e la risposta non è impaginata.

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/organizations/91012d09-e48b-438e-a489-1bebfd8fa6f9/security_posture" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  -H "anthropic-version: 2026-10-21"

Risposta

Il seguente esempio abbreviato mostra quattro dei controlli che una risposta può contenere. È la risposta a una chiave che dispone di read:compliance_org_data e read:compliance_user_data.

{
  "type": "security_posture",
  "organization_id": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
  "evaluated_at": "2027-02-09T09:00:02.417305Z",
  "comments_status": "not_enabled",
  "controls": [
    {
      "id": "sso_enabled",
      "display_name": "Single sign-on (SSO)",
      "section": "identity_access",
      "setting_name": "sso_enabled",
      "status": "passed",
      "rating": "passed",
      "current_value": "On",
      "desired_state": "On",
      "attestation": null
    },
    {
      "id": "directory_sync_enabled",
      "display_name": "Directory sync (SCIM)",
      "section": "identity_access",
      "setting_name": "directory_sync_enabled",
      "status": "failed_check_accepted_risk",
      "rating": "passed",
      "current_value": "Off",
      "desired_state": "On",
      "attestation": {
        "state": "in_force",
        "attested_at": "2026-10-20T15:04:00.220114Z",
        "comment": null,
        "attested_by": {
          "type": "user_actor",
          "user_id": "user_01WxYzAbCdEfGhJkMnPqRsTu"
        }
      }
    },
    {
      "id": "allowed_invite_domains",
      "display_name": "Allowed email domains",
      "section": "identity_access",
      "setting_name": "allowed_invite_domains",
      "status": "descriptive",
      "rating": "descriptive",
      "current_value": "example.com",
      "desired_state": null,
      "attestation": null
    },
    {
      "id": "oauth_conditional_access",
      "display_name": "OAuth conditional access on connected SaaS",
      "section": "connectors_integrations",
      "setting_name": null,
      "status": "not_attested",
      "rating": "not_attested",
      "current_value": null,
      "desired_state": "Completed",
      "attestation": {
        "state": "review_due",
        "attested_at": "2026-11-02T09:30:00.008771Z",
        "comment": null,
        "attested_by": {
          "type": "user_actor",
          "user_id": "user_01AbCdEfGhJkLmNpQrStUvWx"
        }
      }
    }
  ]
}

Ogni campo è sempre presente, e un campo senza valore è null, mai omesso. Un orario non ha cifre frazionarie oppure ne ha sei, quindi confronta gli orari come orari, non come stringhe.

Campi di primo livello

Campi di controls[]

section è uno tra identity_access, data_privacy, capabilities, connectors_integrations, chats_desktop_mdm, cowork_admin_console, cowork_desktop_mdm, claude_code_admin_console, claude_code_managed_settings e healthy_adoption.

Per confrontare i valori nel codice, cerca setting_name nelle impostazioni effettive della stessa organizzazione. La ricerca può non trovare nulla, e due controlli possono condividere lo stesso setting_name.

Campi di attestation

Campi di attested_by

Valori di stato

status indica il motivo del risultato di un controllo, e ogni stato ha un solo rating.

Nessun campo indica il tipo di controllo; per failed, un current_value null contraddistingue un controllo manuale. Possono essere aggiunti altri valori, quindi conta un controllo con uno status sconosciuto in base al suo rating, e non considerare Superato un rating sconosciuto. Lo stato review e lo stato dell’attestazione review_due non sono correlati.

Stati dell’attestazione

state indica se l’attestazione che la risposta mostra è in vigore.

Quando si applica più di un motivo, la risposta indica il primo tra check_passing, setting_changed e review_due. A partire dalle 00:00 UTC della sua data di fine, un’attestazione non è in vigore. La risposta non riporta alcuna data di fine, quindi decide state; una data di fine che è stata salvata è il review_date dell’attività di attestazione. Considera uno state sconosciuto come non in vigore.

Come appare un’attestazione nella risposta

La risposta mostra alcune attestazioni e ne omette altre, quindi un attestation null non dimostra che nessuno abbia attestato.

Ogni riga tranne le ultime due vale finché l’attestazione è in vigore. Su un controllo automatico, un’attestazione non è in vigore finché il valore letto dalla verifica differisce da quello su cui è stata salvata. Ogni attestazione che la risposta mostra su un controllo automatico è un rischio accettato. Anche l’Activity Feed registra le attestazioni dei tipi che la risposta omette.

Contare i risultati

Verifica quattro aspetti quando conti i controlli per rating.

Chi ha attestato e i commenti

attested_by viene compilato solo per una chiave che dispone di read:compliance_user_data insieme a read:compliance_org_data, oppure di read:org_audit. Una chiave con solo read:compliance_user_data riceve un 403. Lo user_id in attested_by è lo stesso dello user_id dell’actor nell’attività di attestazione. attested_by contiene solo l’ID utente: Elencare gli utenti dell’organizzazione fornisce il nome e l’indirizzo email di ogni membro attuale. Prima di aggiungere questi scope, consulta Chi può vedere chi ha attestato.

L’endpoint non restituisce commenti, anche quando la pagina Security posture ne mostra uno: ogni comment è null, e comments_status è not_enabled o not_permitted. Quindi not_enabled e un commento null non significano che l’attestazione non abbia un commento. comments_status indica come interpretare un commento null, e lo schema definisce questi valori.

Possono essere aggiunti altri valori; considera un valore sconosciuto come unavailable.

Errori

Gli errori usano lo stesso corpo del resto della Compliance API; questa tabella elenca quelli che questo endpoint restituisce in modo specifico.

Cause di un 404:

• organization_id non è un UUID, non indica alcuna organizzazione, oppure indica un’organizzazione eliminata.
• organization_id indica l’organizzazione padre, un’organizzazione sotto un’altra organizzazione padre, oppure un’organizzazione che una chiave per una singola organizzazione non copre.
• L’organizzazione non è su Claude Enterprise, oppure Security posture non è disponibile per essa, come nel caso di un’organizzazione Claude Console.
• La pagina Security posture è stata disattivata per l’organizzazione (vedi Disponibilità di Security posture).
• Security posture è disponibile per l’organizzazione, ma l’endpoint non la serve.
• Non è stato possibile verificare la disponibilità; una richiesta successiva può riuscire.

Ogni 404 ha lo stesso corpo, così come un percorso che non esiste.

Aggiornamento dei dati ed effetti collaterali

L’endpoint valuta ogni controllo quando lo chiami, e evaluated_at è quel momento.

• Una modifica degli ultimi minuti potrebbe non comparire.
• Un risultato può cambiare senza che sia cambiata alcuna impostazione, ad esempio quando arriva una data di fine o Anthropic modifica un valore consigliato.
• Se Anthropic riformula un valore attuale, un rischio accettato su di esso non è più in vigore.
• Una chiamata non archivia alcun risultato e non fa terminare alcuna attestazione.
• Ogni richiesta che supera le verifiche di chiave, scope e versione senza un parametro di query registra un’attività compliance_api_accessed, sia che riesca sia che fallisca; il suo url indica l’organizzazione letta, e organization_uuid è null per una chiave per l’organizzazione padre.