Claude Platform Docs
AdminSecurity posture

Memetakan peristiwa Security posture ke OCSF

Petakan setiap aktivitas Security posture di Compliance API ke kelas dan atribut Open Cybersecurity Schema Framework (OCSF)-nya sebelum Anda menyimpannya.

Open Cybersecurity Schema Framework (OCSF) adalah skema terbuka untuk peristiwa keamanan. Terapkan pemetaan ini pada aktivitas Security posture di pipeline Anda sendiri, setelah Anda membacanya dan sebelum Anda menyimpannya. Untuk memasukkannya ke sistem security information and event management (SIEM) Anda, mulailah dari Mengirim peristiwa Security posture ke SIEM Anda.

Versi OCSF

Pemetaan ini menggunakan OCSF 1.6.0. Jika Anda melakukan validasi terhadap versi lain, periksa atribut di halaman ini terhadap versi tersebut. Misalnya, di OCSF 1.7.0, metadata.uid adalah pengidentifikasi dari peristiwa OCSF itu sendiri, dan metadata.original_event_uid menyimpan pengidentifikasi dari sumber. OCSF 1.9.0 menghentikan penggunaan actor.app_name dan menggantinya dengan actor.application.

Atribut untuk setiap aktivitas Security posture

Petakan field berikut pada setiap peristiwa.

Field aktivitasAtribut OCSFCatatan
idmetadata.uidSalin tanpa perubahan.
typemetadata.event_codeSalin tanpa perubahan.
created_attimeKonversikan string RFC 3339 menjadi milidetik sejak epoch Unix, lalu potong menjadi bilangan bulat.
created_atmetadata.original_timeSalin string tanpa perubahan.
Tidak adametadata.logged_timeWaktu saat Anda menyimpan aktivitas (stored_at di Mendeteksi perubahan), dalam milidetik sejak epoch Unix.
organization_uuidmetadata.tenant_uidSalin tanpa perubahan.
organization_idunmapped.organization_idSalin tanpa perubahan.
Tidak adametadata.versionKonstan: 1.6.0.
Tidak adametadata.product.vendor_nameKonstan: Anthropic.
Tidak adametadata.product.nameKonstan: Compliance API.
Tidak adatype_uidclass_uid * 100 + activity_id.
Tidak adaseverity_idSetel ke 1 (Informational) pada setiap peristiwa, dan tetapkan prioritas peringatan di aturan deteksi yang memunculkannya.

Masukkan setiap field yang tidak memiliki atribut OCSF ke dalam objek unmapped dengan nama yang digunakan di Activity Feed, termasuk field yang tidak dikenali oleh handler Anda. Jika sebuah field tidak ada atau bernilai null, hilangkan atribut OCSF-nya.

Petakan objek actor:

Field aktivitasAtribut OCSFCatatan
Tidak adametadata.profilesTambahkan host, yaitu profil OCSF (sekumpulan atribut opsional) yang memuat actor.
actor.typeunmapped.actor.typeSalin tanpa perubahan.
actor.user_idactor.user.uidHanya user_actor.
actor.email_addressactor.user.email_addrHanya user_actor.
actor.ip_addresssrc_endpoint.ipHanya user_actor.
actor.user_agenthttp_request.user_agentHanya user_actor.
actor.serviceactor.app_nameHanya system_actor.

Aktivitas atestasi: Entity Management

Petakan aktivitas org_security_control_attestation_updated ke kelas OCSF Entity Management (3004). Peristiwa Entity Management melaporkan operasi pada entitas yang dikelola, dalam hal ini atestasi organisasi untuk sebuah kontrol keamanan.

Field aktivitasAtribut OCSFCatatan
Tidak adaclass_uidKonstan: 3004 (Entity Management).
Tidak adacategory_uidKonstan: 3 (Identity & Access Management).
actionactivity_idDari tabel nilai action berikut.
actionunmapped.actionSalin tanpa perubahan, karena dua nilai action berbagi satu activity_id.
Tidak adaentity.type_idKonstan: 99 (Other).
Tidak adaentity.typeKonstan: Security control attestation.
controlentity.uidSalin tanpa perubahan.
statusentity.data.statusSalin tanpa perubahan: nilai atestasi.
review_dateentity.data.review_dateSalin tanpa perubahan: tanggal berakhir atestasi.
previous_statusunmapped.previous_statusSalin tanpa perubahan: nilai atestasi sebelum perubahan.

Jangan petakan status ke status_id atau ke nilai lulus atau gagal mana pun: atestasi adalah pernyataan seseorang tentang sebuah kontrol, bukan hasil dari sebuah pemeriksaan.

actionactivity_idtype_uid
attested1 (Create)300401
changed3 (Update)300403
renewed3 (Update)300403
cleared4 (Delete)300404
lapsed11 (Deactivate)300411
Nilai lain mana pun99 (Other)300499

Untuk 99 (Other), setel activity_name ke nilai action.

Aktivitas attested dipetakan ke peristiwa seperti berikut, dengan nilai contoh:

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

Apakah halaman ini membantu?