Claude Platform Docs
AdministraciónSecurity posture

Mapear eventos de Security posture a OCSF

Mapea cada actividad de Security posture de la Compliance API a su clase y sus atributos de Open Cybersecurity Schema Framework (OCSF) antes de almacenarla.

Open Cybersecurity Schema Framework (OCSF) es un esquema abierto para eventos de seguridad. Aplica este mapeo a las actividades de Security posture en tu propio pipeline, después de leerlas y antes de almacenarlas. Para ingerirlas en tu sistema de “security information and event management” (gestión de información y eventos de seguridad), o SIEM, comienza en Enviar eventos de Security posture a tu SIEM.

Versión de OCSF

Este mapeo usa OCSF 1.6.0. Si validas contra otra versión, comprueba los atributos de esta página con esa versión. Por ejemplo, en OCSF 1.7.0, metadata.uid es el identificador del propio evento de OCSF, y metadata.original_event_uid contiene el identificador de la fuente. OCSF 1.9.0 declara obsoleto actor.app_name en favor de actor.application.

Atributos para cada actividad de Security posture

Mapea estos campos en cada evento.

Campo de la actividadAtributo de OCSFNota
idmetadata.uidCopia sin cambios.
typemetadata.event_codeCopia sin cambios.
created_attimeConvierte la cadena RFC 3339 a milisegundos desde la época Unix y trúncala a un número entero.
created_atmetadata.original_timeCopia la cadena sin cambios.
Ningunometadata.logged_timeEl momento en que almacenaste la actividad (stored_at en Detectar cambios), en milisegundos desde la época Unix.
organization_uuidmetadata.tenant_uidCopia sin cambios.
organization_idunmapped.organization_idCopia sin cambios.
Ningunometadata.versionConstante: 1.6.0.
Ningunometadata.product.vendor_nameConstante: Anthropic.
Ningunometadata.product.nameConstante: Compliance API.
Ningunotype_uidclass_uid * 100 + activity_id.
Ningunoseverity_idEstablécelo en 1 (Informational) en cada evento, y establece la prioridad de una alerta en la regla de detección que la genera.

Coloca cada campo que no tenga un atributo de OCSF en el objeto unmapped con su nombre en el Activity Feed, incluidos los campos que tu controlador no reconozca. Cuando un campo esté ausente o sea null, omite el atributo de OCSF.

Mapea el objeto actor:

Campo de la actividadAtributo de OCSFNota
Ningunometadata.profilesAgrega host, el perfil de OCSF (un conjunto opcional de atributos) que contiene actor.
actor.typeunmapped.actor.typeCopia sin cambios.
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.

Actividades de atestación: Entity Management

Mapea una actividad org_security_control_attestation_updated a la clase Entity Management de OCSF (3004). Los eventos de Entity Management informan de una operación sobre una entidad gestionada, en este caso la atestación de la organización para un control de seguridad.

Campo de la actividadAtributo de OCSFNota
Ningunoclass_uidConstante: 3004 (Entity Management).
Ningunocategory_uidConstante: 3 (Identity & Access Management).
actionactivity_idSegún la tabla de valores de action que sigue.
actionunmapped.actionCopia sin cambios, porque dos valores de action comparten un mismo activity_id.
Ningunoentity.type_idConstante: 99 (Other).
Ningunoentity.typeConstante: Security control attestation.
controlentity.uidCopia sin cambios.
statusentity.data.statusCopia sin cambios: el valor de la atestación.
review_dateentity.data.review_dateCopia sin cambios: la fecha de finalización de la atestación.
previous_statusunmapped.previous_statusCopia sin cambios: el valor de la atestación antes del cambio.

No mapees status a status_id ni a ningún valor de aprobado o fallo: una atestación es la declaración de una persona sobre un control, no el resultado de una verificación.

actionactivity_idtype_uid
attested1 (Create)300401
changed3 (Update)300403
renewed3 (Update)300403
cleared4 (Delete)300404
lapsed11 (Deactivate)300411
Cualquier otro valor99 (Other)300499

Para 99 (Other), establece activity_name en el valor de action.

Una actividad attested se mapea a un evento como este, con valores de ejemplo:

{
  "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"
  }
}

¿Te resultó útil esta página?