--- title: Security posture nella Compliance API url: https://platform.claude.com/docs/it/manage-claude/compliance-security-posture/overview description: Scopri cosa espone la Compliance API sulla pagina Security posture (Security Center) in claude.ai e da dove iniziare. --- Per abilitare la Compliance API, consulta [Configura la Compliance API](https://platform.claude.com/docs/it/manage-claude/compliance-api-access). La pagina **Security posture** nelle **Impostazioni organizzazione** di claude.ai confronta le impostazioni di Claude della tua organizzazione con i controlli di sicurezza consigliati da Anthropic. Tramite la Compliance API, i tuoi strumenti di sicurezza possono leggere le modifiche che la pagina registra. Possono anche leggere i risultati attuali. Security posture riporta lo stato delle tue impostazioni e non le modifica. La voce della barra laterale è **Security posture** e la pagina che apre ha come intestazione **Security Center**. ## Scegli il tuo percorso Per far arrivare le modifiche della pagina nel tuo sistema “security information and event management” (gestione delle informazioni e degli eventi di sicurezza), o SIEM, inizia da [Inviare gli eventi di Security posture al tuo SIEM](https://platform.claude.com/docs/it/manage-claude/compliance-security-posture/send-events). Se acquisisci già l’intero Activity Feed, li hai già; [verifica due cose](https://platform.claude.com/docs/it/manage-claude/compliance-security-posture/send-events#if-you-already-ingest-the-full-feed). * Per generare alert sulle modifiche rischiose, consulta [Rilevare le modifiche in Security posture](https://platform.claude.com/docs/it/manage-claude/compliance-security-posture/detect-changes). * Per normalizzare secondo l’“Open Cybersecurity Schema Framework” (framework di schemi per la cybersicurezza), o OCSF, consulta [Mappare gli eventi di Security posture su OCSF](https://platform.claude.com/docs/it/manage-claude/compliance-security-posture/ocsf-mapping). * Per scoprire chi ha accettato quale rischio, quando e fino a quando, consulta [Riferimento per gli eventi di Security posture](https://platform.claude.com/docs/it/manage-claude/compliance-security-posture/events-reference); per i rischi in vigore, consulta [Risultati attuali](https://platform.claude.com/docs/it/manage-claude/compliance-security-posture/overview#current-results). Per lavorare con i risultati attuali dell’endpoint, usa queste pagine: * Per le dashboard, consulta [Riferimento per i risultati di Security posture](https://platform.claude.com/docs/it/manage-claude/compliance-security-posture/results-reference). * Per verificare gli eventi archiviati, consulta [Verificare gli eventi archiviati di Security posture rispetto ai risultati attuali](https://platform.claude.com/docs/it/manage-claude/compliance-security-posture/check-events-against-results). * Se l’endpoint e la pagina non concordano, consulta [Come appare un’attestazione nella risposta](https://platform.claude.com/docs/it/manage-claude/compliance-security-posture/results-reference#how-an-attestation-shows-in-the-response). Per comprendere i dati, continua a leggere. ## Cosa valuta Security posture Security posture valuta un elenco di controlli e assegna a ciascuno un risultato. ### Controlli Un controllo è un’impostazione o una pratica consigliata, come il single sign-on. Ogni controllo ha un nome visualizzato e un identificatore. L’identificatore è lo stesso per tutte le organizzazioni. Un controllo può anche avere un valore attuale (`current_value`) e un valore consigliato (`desired_state`). I controlli sono di tre tipi: | Tipo | Cosa determina il suo risultato | Esempio | | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | -------------------------- | | Controllo automatico | Una verifica automatica del valore attuale rispetto al valore consigliato, a meno che non sia in vigore un’attestazione. | `sso_enabled` | | Controllo manuale | Una persona, perché Anthropic non può leggere l’impostazione, ad esempio quando si trova nella console di un altro fornitore. | `oauth_conditional_access` | | Controllo solo informativo | Niente: non c’è un valore consigliato, quindi il controllo viene riportato e non classificato. | `allowed_invite_domains` | ### Attestazioni Un’attestazione è una dichiarazione registrata da una persona su come l’organizzazione si posiziona rispetto a un controllo; non è il risultato di una verifica. La maggior parte dei controlli può avere un’attestazione, compresi quelli automatici, qualunque sia l’esito della loro verifica. Un’attestazione ha uno di tre valori: * Completato (`completed`): il controllo è in atto. * Rischio accettato (`accepted_risk`): il controllo non è in atto e l’organizzazione accetta il rischio. * Non superato (`control_failed`): il controllo non è in atto. Chi può attestare lo fa sulla pagina. L’API legge le attestazioni e non può crearle. La pagina può porre una domanda quando qualcuno attesta, talvolta richiedendo una risposta, e archivia la risposta con l’attestazione come relativo [commento](https://platform.claude.com/docs/it/manage-claude/compliance-security-posture/overview#what-anthropic-stores-when-someone-attests), di al massimo 2.000 caratteri. Un’attività dell’Activity Feed non include mai il commento né mostra che ne esista uno. Nemmeno l’endpoint restituisce commenti. ### Risultati Ogni controllo ha uno di quattro risultati. | Risultato | Significato | | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | Superato (`passed`) | Soddisfa il valore consigliato, oppure è in vigore un’attestazione di Completato o Rischio accettato. | | Non superato (`failed`) | Non soddisfa il valore consigliato, oppure è attestato come Non superato (`control_failed`). | | Non attestato (`not_attested`) | Un controllo manuale senza alcuna attestazione in vigore. | | Descrittivo (`descriptive`) | Non classificato, anche quando attestato; comprende i controlli solo informativi e i controlli che non si applicano o che non è stato possibile leggere. | Un rischio accettato in vigore conta come Superato su un controllo automatico o manuale, anche se il controllo non è in atto. Nella risposta, un controllo automatico [attestato come Completato mentre la sua verifica ha esito negativo](https://platform.claude.com/docs/it/manage-claude/compliance-security-posture/results-reference#how-an-attestation-shows-in-the-response) è `failed`. ### Cosa fa terminare un’attestazione Un’attestazione resta in vigore finché non si verifica una di tre cose: * Qualcuno la cancella o la modifica. * Arriva la sua data di fine (`review_date`). La persona che attesta sceglie 90 giorni oppure nessuna. * Su un controllo automatico o solo informativo, cambia il valore attuale oppure, per un rischio accettato su alcuni controlli automatici, la verifica automatica ha esito positivo. Senza un’attestazione in vigore, il risultato di un controllo automatico segue la sua verifica, e un controllo manuale è Non attestato. ## Modifiche nel tempo: l’Activity Feed L’Activity Feed risponde a cosa è cambiato, quando e chi l’ha cambiato. Registra un’attività quando qualcuno attesta un controllo, modifica un’attestazione o ne cancella una, e talvolta quando un’attestazione termina automaticamente. I titoli di queste pagine chiamano eventi le attività. Per leggerle serve lo scope `read:compliance_activities` o `read:org_audit`. [Riferimento per gli eventi di Security posture](https://platform.claude.com/docs/it/manage-claude/compliance-security-posture/events-reference) ne elenca i campi. Per raccoglierle, consulta [Inviare gli eventi di Security posture al tuo SIEM](https://platform.claude.com/docs/it/manage-claude/compliance-security-posture/send-events). ## Risultati attuali: l’endpoint L’endpoint risponde a quale sia il risultato di un controllo al momento della richiesta. Usalo per produrre report sulle organizzazioni della tua [organizzazione padre](https://platform.claude.com/docs/it/manage-claude/compliance-api#how-the-compliance-api-works). Ogni chiamata legge una sola organizzazione e non restituisce alcuno storico. Per ogni controllo che elenca, la risposta fornisce l’`id`, il `display_name` e il risultato in `rating`, usando gli identificatori della [tabella dei risultati](https://platform.claude.com/docs/it/manage-claude/compliance-security-posture/overview#results). Per chiamarlo serve lo scope `read:compliance_org_data` o `read:org_audit`. La pagina, l’endpoint e il feed non mostrano sempre la stessa cosa, perché la risposta esclude alcuni controlli e alcune attestazioni. Consulta [Come appare un’attestazione nella risposta](https://platform.claude.com/docs/it/manage-claude/compliance-security-posture/results-reference#how-an-attestation-shows-in-the-response) e [Verificare gli eventi archiviati di Security posture rispetto ai risultati attuali](https://platform.claude.com/docs/it/manage-claude/compliance-security-posture/check-events-against-results). ## Disponibilità Security posture è in beta. **Se la tua organizzazione è su Claude Enterprise, Security posture è disponibile per essa e la sua organizzazione padre ha la Compliance API abilitata,** l’Activity Feed registra le attività di attestazione per essa, e l’endpoint restituisce i risultati della tua organizzazione. Ti serve anche una Compliance Access Key con lo scope corrispondente. Queste pagine presuppongono che tu abbia letto [Configurare la Compliance API](https://platform.claude.com/docs/it/manage-claude/compliance-api-access) e [Interrogare l’Activity Feed](https://platform.claude.com/docs/it/manage-claude/compliance-activity-feed). **Se la tua organizzazione è su un altro piano, o è un’organizzazione Claude Console,** l’Activity Feed non registra attività di Security posture per essa, e l’endpoint restituisce 404. **Se la pagina Security posture è stata disattivata per la tua organizzazione,** l’endpoint restituisce 404 per la tua organizzazione finché la pagina non viene attivata. Anche una chiave per l’organizzazione padre riceve quel 404. Per alcune organizzazioni, l’endpoint restituisce 404 anche quando tutte e tre le condizioni sono soddisfatte e la pagina non è stata disattivata. ## Chi può vedere chi ha attestato Ogni attività di attestazione causata da una persona registra il suo ID utente, il suo indirizzo email al momento dell’attività, e l’indirizzo IP e lo user agent della richiesta. Qualsiasi chiave che copre l’organizzazione e dispone di `read:compliance_activities` o `read:org_audit` può leggerli, anche dopo che la persona ha lasciato l’organizzazione o il suo account è stato eliminato. L’eliminazione dell’organizzazione non rimuove queste attività dall’Activity Feed, che conserva le attività per 6 anni. Le chiavi proprie dell’organizzazione smettono di funzionare quando questa viene eliminata. Qualsiasi chiave con sia `read:compliance_org_data` sia `read:compliance_user_data`, oppure con `read:org_audit`, può leggere, nel campo `attested_by` dell’endpoint, l’ID utente della persona che ha attestato, laddove l’endpoint lo restituisca, anche per le attestazioni effettuate prima che tu avessi accesso. Questi valori sono dati personali; le tue copie sopravvivono all’appartenenza della persona all’organizzazione. Prima di raccogliere questi dati, informa le persone che attestano. ## Cosa archivia Anthropic quando qualcuno attesta Anthropic archivia un’attestazione per controllo, che comprende, tra l’altro, il valore, il momento in cui è stata effettuata, l’eventuale data di fine e l’account della persona che ha attestato. Attestare di nuovo la sostituisce. Anthropic continua ad archiviare un’attestazione dopo che arriva la sua data di fine o dopo che [termina automaticamente](https://platform.claude.com/docs/it/manage-claude/compliance-security-posture/overview#what-ends-an-attestation), finché qualcuno non la cancella oppure finché Anthropic non la elimina al momento dell’eliminazione dell’organizzazione. Se l’account della persona che ha attestato viene eliminato, Anthropic continua ad archiviare l’attestazione, che non indica più chi ha attestato. Le eventuali attività dell’Activity Feed causate da questa persona indicano ancora questa persona. Cancellare o sostituire l’attestazione non rimuove nulla dall’Activity Feed (consulta [Chi può vedere chi ha attestato](https://platform.claude.com/docs/it/manage-claude/compliance-security-posture/overview#who-can-see-who-attested)). Le [chiavi di crittografia gestite dal cliente (CMEK)](https://platform.claude.com/docs/it/manage-claude/cmek), la [conservazione zero dei dati (ZDR) per Claude Code](https://code.claude.com/docs/en/zero-data-retention) e un [piano Enterprise pronto per HIPAA](https://support.claude.com/en/articles/13296973-hipaa-ready-enterprise-plans) non cambiano cosa Anthropic archivia del controllo, del valore, delle date e dell’account di un’attestazione. Nessuno dei tre riduce il tempo per cui Anthropic li archivia. CMEK non crittografa questi campi. Anthropic archivia il commento di un’attestazione finché qualcuno non cancella l’attestazione oppure finché Anthropic non elimina il commento al momento dell’eliminazione dell’organizzazione. Attestare di nuovo può sostituire o rimuovere il commento. Per tutto il tempo in cui Security posture non è disponibile per un’organizzazione, Anthropic continua ad archiviare le attestazioni e i commenti di tale organizzazione, e nessuno può vederli o cancellarli nella pagina Security posture. Un periodo di conservazione personalizzato delle conversazioni non riduce il tempo per cui Anthropic archivia l’attestazione o il commento. Le attività dell’Activity Feed non includono mai il commento (consulta [Ciò che il feed non registra](https://platform.claude.com/docs/it/manage-claude/compliance-security-posture/events-reference#what-the-feed-does-not-record)).