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 OCSF | Nota |
|---|---|---|
id | metadata.uid | Copia senza modifiche. |
type | metadata.event_code | Copia senza modifiche. |
created_at | time | Converti la stringa RFC 3339 in millisecondi dall’epoca Unix e tronca a un numero intero. |
created_at | metadata.original_time | Copia la stringa senza modifiche. |
| Nessuno | metadata.logged_time | L’ora in cui hai archiviato l’attività (stored_at in Rilevare le modifiche), in millisecondi dall’epoca Unix. |
organization_uuid | metadata.tenant_uid | Copia senza modifiche. |
organization_id | unmapped.organization_id | Copia senza modifiche. |
| Nessuno | metadata.version | Costante: 1.6.0. |
| Nessuno | metadata.product.vendor_name | Costante: Anthropic. |
| Nessuno | metadata.product.name | Costante: Compliance API. |
| Nessuno | type_uid | class_uid * 100 + activity_id. |
| Nessuno | severity_id | Imposta 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 OCSF | Nota |
|---|---|---|
| Nessuno | metadata.profiles | Aggiungi host, il profilo OCSF (un insieme di attributi opzionale) che contiene actor. |
actor.type | unmapped.actor.type | Copia senza modifiche. |
actor.user_id | actor.user.uid | Solo user_actor. |
actor.email_address | actor.user.email_addr | Solo user_actor. |
actor.ip_address | src_endpoint.ip | Solo user_actor. |
actor.user_agent | http_request.user_agent | Solo user_actor. |
actor.service | actor.app_name | Solo 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 OCSF | Nota |
|---|---|---|
| Nessuno | class_uid | Costante: 3004 (Entity Management). |
| Nessuno | category_uid | Costante: 3 (Identity & Access Management). |
action | activity_id | Dalla tabella dei valori di action che segue. |
action | unmapped.action | Copia senza modifiche, perché due valori di action condividono lo stesso activity_id. |
| Nessuno | entity.type_id | Costante: 99 (Other). |
| Nessuno | entity.type | Costante: Security control attestation. |
control | entity.uid | Copia senza modifiche. |
status | entity.data.status | Copia senza modifiche: il valore dell’attestazione. |
review_date | entity.data.review_date | Copia senza modifiche: la data di fine dell’attestazione. |
previous_status | unmapped.previous_status | Copia 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.
action | activity_id | type_uid |
|---|---|---|
attested | 1 (Create) | 300401 |
changed | 3 (Update) | 300403 |
renewed | 3 (Update) | 300403 |
cleared | 4 (Delete) | 300404 |
lapsed | 11 (Deactivate) | 300411 |
| Qualsiasi altro valore | 99 (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?