Security postureのイベントをOCSFにマッピングする
Compliance APIのSecurity postureの各アクティビティを、保存する前に、そのアクティビティに対応するOpen Cybersecurity Schema Framework(OCSF)のクラスと属性にマッピングします。
Open Cybersecurity Schema Framework(OCSF)は、セキュリティイベント向けのオープンなスキーマです。このマッピングは、Security postureのアクティビティを読み取った後、保存する前に、独自のパイプライン内で適用します。アクティビティをセキュリティ情報イベント管理(SIEM)システムに取り込むには、Security postureのイベントをSIEMに送信するから始めてください。
OCSFのバージョン
このマッピングはOCSF 1.6.0を使用します。別のバージョンに対して検証する場合は、このページの属性をそのバージョンと照らし合わせて確認してください。たとえば、OCSF 1.7.0では、metadata.uidはOCSFイベント自体の識別子であり、metadata.original_event_uidがソースからの識別子を保持します。OCSF 1.9.0では、actor.app_nameが非推奨となり、代わりにactor.applicationが使用されます。
すべてのSecurity postureのアクティビティに共通する属性
すべてのイベントで、これらのフィールドをマッピングします。
| アクティビティのフィールド | OCSF属性 | 注記 |
|---|---|---|
id | metadata.uid | そのままコピーします。 |
type | metadata.event_code | そのままコピーします。 |
created_at | time | RFC 3339の文字列をUnixエポックからのミリ秒に変換し、整数に切り捨てます。 |
created_at | metadata.original_time | 文字列をそのままコピーします。 |
| なし | metadata.logged_time | アクティビティを保存した時刻(変更を検出するのstored_at)(Unixエポックからのミリ秒)。 |
organization_uuid | metadata.tenant_uid | そのままコピーします。 |
organization_id | unmapped.organization_id | そのままコピーします。 |
| なし | metadata.version | 定数:1.6.0。 |
| なし | metadata.product.vendor_name | 定数:Anthropic。 |
| なし | metadata.product.name | 定数:Compliance API。 |
| なし | type_uid | class_uid * 100 + activity_id。 |
| なし | severity_id | すべてのイベントで1(Informational)に設定し、アラートの優先度は、そのアラートを発生させる検出ルールで設定します。 |
OCSF属性がないフィールドは、ハンドラーが認識しないフィールドも含め、すべてアクティビティフィードでの名前のままunmappedオブジェクトに入れます。フィールドが存在しないかnullの場合は、OCSF属性を省略します。
actorオブジェクトを次のようにマッピングします。
| アクティビティのフィールド | OCSF属性 | 注記 |
|---|---|---|
| なし | metadata.profiles | hostを追加します。これはactorを含むOCSFプロファイル(オプションの属性セット)です。 |
actor.type | unmapped.actor.type | そのままコピーします。 |
actor.user_id | actor.user.uid | user_actorのみ。 |
actor.email_address | actor.user.email_addr | user_actorのみ。 |
actor.ip_address | src_endpoint.ip | user_actorのみ。 |
actor.user_agent | http_request.user_agent | user_actorのみ。 |
actor.service | actor.app_name | system_actorのみ。 |
表明のアクティビティ:Entity Management
org_security_control_attestation_updatedアクティビティを、OCSFのEntity Managementクラス(3004)にマッピングします。Entity Managementのイベントは管理対象エンティティに対する操作を報告します。ここでのエンティティは、セキュリティコントロールに対する組織の表明です。
| アクティビティのフィールド | OCSF属性 | 注記 |
|---|---|---|
| なし | class_uid | 定数:3004(Entity Management)。 |
| なし | category_uid | 定数:3(Identity & Access Management)。 |
action | activity_id | 後述のactionの値の表に従います。 |
action | unmapped.action | 2つのactionの値が1つのactivity_idを共有するため、そのままコピーします。 |
| なし | entity.type_id | 定数:99(Other)。 |
| なし | entity.type | 定数:Security control attestation。 |
control | entity.uid | そのままコピーします。 |
status | entity.data.status | そのままコピーします。表明の値です。 |
review_date | entity.data.review_date | そのままコピーします。表明の終了日です。 |
previous_status | unmapped.previous_status | そのままコピーします。変更前の表明の値です。 |
statusをstatus_idや、成功または失敗を表すいずれの値にもマッピングしないでください。表明はコントロールについての人による記述であり、チェックの結果ではありません。
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 |
| その他の値 | 99(Other) | 300499 |
99(Other)の場合は、activity_nameにactionの値を設定します。
attestedアクティビティは、次のようなイベントにマッピングされます(値はサンプルです)。
{
"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"
}
}このページは役に立ちましたか?