Claude Platform Docs
AmministrazioneSecurity posture

Mappare gli eventi di Security posture su OCSF

Mappa ogni attività di Security posture della Compliance API sulla relativa classe e sui relativi attributi dell’Open Cybersecurity Schema Framework (OCSF) prima di archiviarla.

L’Open Cybersecurity Schema Framework (OCSF) è uno schema aperto per gli eventi di sicurezza. Applica questa mappatura alle attività di Security posture nella tua pipeline, dopo averle lette e prima di archiviarle. Per importarle nel tuo sistema di “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.

Versione di OCSF

Questa mappatura usa OCSF 1.6.0. Se esegui la convalida rispetto a un’altra versione, verifica gli attributi di questa pagina rispetto a quella versione. Ad esempio, in OCSF 1.7.0, metadata.uid è l’identificatore dell’evento OCSF stesso, e metadata.original_event_uid contiene l’identificatore proveniente dalla sorgente. OCSF 1.9.0 depreca actor.app_name a favore di actor.application.

Attributi per ogni attività di Security posture

Mappa questi campi su ogni evento.

Campo dell’attivitàAttributo OCSFNota
idmetadata.uidCopia senza modifiche.
typemetadata.event_codeCopia senza modifiche.
created_attimeConverti la stringa RFC 3339 in millisecondi dall’epoca Unix e tronca a un numero intero.
created_atmetadata.original_timeCopia la stringa senza modifiche.
Nessunometadata.logged_timeL’ora in cui hai archiviato l’attività (stored_at in Rilevare le modifiche), in millisecondi dall’epoca Unix.
organization_uuidmetadata.tenant_uidCopia senza modifiche.
organization_idunmapped.organization_idCopia senza modifiche.
Nessunometadata.versionCostante: 1.6.0.
Nessunometadata.product.vendor_nameCostante: Anthropic.
Nessunometadata.product.nameCostante: Compliance API.
Nessunotype_uidclass_uid * 100 + activity_id.
Nessunoseverity_idImposta su 1 (Informational) in ogni evento e imposta la priorità di un alert nella regola di rilevamento che lo genera.

Inserisci ogni campo che non ha un attributo OCSF nell’oggetto unmapped con il suo nome dell’Activity Feed, inclusi i campi che il tuo handler non riconosce. Dove un campo è assente o null, ometti l’attributo OCSF.

Mappa l’oggetto actor:

Campo dell’attivitàAttributo OCSFNota
Nessunometadata.profilesAggiungi host, il profilo OCSF (un insieme di attributi opzionale) che contiene actor.
actor.typeunmapped.actor.typeCopia senza modifiche.
actor.user_idactor.user.uidSolo user_actor.
actor.email_addressactor.user.email_addrSolo user_actor.
actor.ip_addresssrc_endpoint.ipSolo user_actor.
actor.user_agenthttp_request.user_agentSolo user_actor.
actor.serviceactor.app_nameSolo system_actor.

Attività di attestazione: Entity Management

Mappa un’attività org_security_control_attestation_updated sulla classe OCSF Entity Management (3004). Gli eventi Entity Management riportano un’operazione su un’entità gestita, in questo caso l’attestazione dell’organizzazione per un controllo di sicurezza.

Campo dell’attivitàAttributo OCSFNota
Nessunoclass_uidCostante: 3004 (Entity Management).
Nessunocategory_uidCostante: 3 (Identity & Access Management).
actionactivity_idDalla tabella dei valori di action che segue.
actionunmapped.actionCopia senza modifiche, perché due valori di action condividono lo stesso activity_id.
Nessunoentity.type_idCostante: 99 (Other).
Nessunoentity.typeCostante: Security control attestation.
controlentity.uidCopia senza modifiche.
statusentity.data.statusCopia senza modifiche: il valore dell’attestazione.
review_dateentity.data.review_dateCopia senza modifiche: la data di fine dell’attestazione.
previous_statusunmapped.previous_statusCopia senza modifiche: il valore dell’attestazione prima della modifica.

Non mappare status su status_id né su qualsiasi valore di superamento o di mancato superamento: un’attestazione è una dichiarazione di una persona su un controllo, non l’esito di una verifica.

actionactivity_idtype_uid
attested1 (Create)300401
changed3 (Update)300403
renewed3 (Update)300403
cleared4 (Delete)300404
lapsed11 (Deactivate)300411
Qualsiasi altro valore99 (Other)300499

Per 99 (Other), imposta activity_name sul valore di action.

Un’attività attested viene mappata su un evento come questo, con valori di esempio:

{
  "class_uid": 3004,
  "category_uid": 3,
  "activity_id": 1,
  "type_uid": 300401,
  "severity_id": 1,
  "time": 1794495872517,
  "metadata": {
    "version": "1.6.0",
    "profiles": ["host"],
    "uid": "activity_01Kp5RvNd8Wc3TgMy6BxQf4Z",
    "event_code": "org_security_control_attestation_updated",
    "original_time": "2026-11-12T15:04:32.517208Z",
    "logged_time": 1794495910000,
    "tenant_uid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
    "product": { "vendor_name": "Anthropic", "name": "Compliance API" }
  },
  "actor": {
    "user": {
      "uid": "user_01TuVwXyZaBcDeFgH2JkLmN4",
      "email_addr": "admin@example.com"
    }
  },
  "src_endpoint": { "ip": "192.0.2.34" },
  "http_request": { "user_agent": "ExampleBrowser/1.0" },
  "entity": {
    "type_id": 99,
    "type": "Security control attestation",
    "uid": "mdm_chat_required_organization",
    "data": { "status": "completed" }
  },
  "unmapped": {
    "action": "attested",
    "actor": { "type": "user_actor" },
    "organization_id": "org_01JuY4bkwkH1x4PodBJaWmh2"
  }
}

Questa pagina ti è stata utile?