Security postureのイベントリファレンス
Security postureのページでの変更を記録するアクティビティフィードのアクティビティについて、そのフィールドと値、それぞれの例、およびフィードが記録しない内容を確認します。
アクティビティフィードは、Security postureのページでの表明の変更を、このページで説明するアクティビティとして記録します。これらをセキュリティ情報イベント管理(SIEM)システムに取り込むには、Security postureのイベントをSIEMに送信するから始めてください。このページに記載されていないcontrol、action、その他のフィールドの値はそのまま渡し、想定外のフィールドは無視し、キーがない場合とnull値を同じように扱ってください。標準フィールドと未知のタイプについては、Activityオブジェクトを理解するで説明しています。
組織を対象とし、read:compliance_activitiesまたはread:org_auditのスコープを持つCompliance Access Keyが必要です。
表明のアクティビティ
org_security_control_attestation_updatedアクティビティは、誰かがセキュリティコントロールに対する組織の表明を記録、変更、再保存、または取り消したこと、あるいは表明が自動的に終了したことを記録します。そのcreated_atは人による変更の場合は変更の時刻、または自動的な変更の場合は変更が記録された時刻で、これは変更よりも後になる可能性があります。そのactorは、人による変更の場合はuser_actor、lapsedのような自動的な変更の場合はsystem_actorです。
フィールド
このタイプは以下のフィールドを追加します。statusは表明の値、review_dateはその終了日です。
| フィールド | 型 | 説明 |
|---|---|---|
control | string | 表明が適用されるセキュリティコントロールの識別子(例:oauth_conditional_access)。不透明な文字列として扱ってください。 |
action | string | 何が変更されたか。actionの値のいずれかです。 |
status | string | 表明の値:完了(completed)、リスク受容(accepted_risk)、または不合格として表明(control_failed)。表明が取り消された場合は存在しません。 |
previous_status | string | この変更前の表明の値で、同じ3つのいずれかです。actionがattestedの場合は存在しません。 |
review_date | string | 表明が終了する予定のUTCの日(ISO 8601の日付)。終了日なしで保存された場合、または取り消された場合は存在しません。 |
参考情報コントロールでは、値「確認済み」はcompletedとして記録されます。
actionの値
action | 意味 |
|---|---|
attested | 表明がなかったコントロールに対して表明が記録されました。 |
changed | 表明が別の値で再保存されました。または、statusがprevious_statusと等しい場合は、renewedと同様に同じ値で再保存されました。 |
renewed | 表明が同じ値で再保存されました。 |
cleared | 人が表明を取り消しました。 |
lapsed | 表明が人によってではなく、自動的に終了しました。 |
renewedおよびlapsedアクティビティでは、statusはprevious_statusと等しくなります。lapsedアクティビティの後に同じ値で保存すると、attestedではなくrenewedとして記録されます。
lapsedアクティビティの意味
lapsedアクティビティは、チェック結果またはコントロールの現在の値が、表明の保存時のものと異なることを意味します。現在の値は、設定が何も変更されなくても変わることがあります(たとえば、Anthropicがその文言を変更した場合など)。statusは終了した値で、3つのいずれかです。手動コントロールの表明にlapsedアクティビティが記録されることはありません。このアクティビティは、その原因となった変更よりも後に記録される可能性があります。
例
{
"id": "activity_01Hq7ZtYc4Vb2NmKx8RsPd3W",
"type": "org_security_control_attestation_updated",
"created_at": "2026-10-20T15:04:00.220114Z",
"organization_id": "org_01JuY4bkwkH1x4PodBJaWmh2",
"organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
"actor": {
"type": "user_actor",
"email_address": "jane.doe@example.com",
"user_id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
"ip_address": "192.0.2.34",
"user_agent": "Mozilla/5.0..."
},
"control": "directory_sync_enabled",
"action": "attested",
"status": "accepted_risk"
}フィードが記録しない内容
アクティビティがないことを、何も変更されなかったしるしと解釈しないでください。現在の結果については、Security postureの結果リファレンスを参照してください。そのエンドポイントは、アクティビティで示されたコントロールを省略する可能性があります。
- アクティビティフィードが組織についてこれらのアクティビティの記録を開始する前、またはCompliance APIがオフになっている間の変更。これらが後から追加されることはありません。
- まれに、種類を問わずいずれかの変更。
- 到来したすべての終了日。すべての終了日にアクティビティが記録されるとは限らないため、アクティビティを待たないでください。
- Security postureのページがオフまたはオンにされるたびのこと。これを検出するために検出ルールに頼らないでください。
- 表明とともに保存されたコメント、またはコメントが存在することを示す何らかの情報。コメントを変更するには再保存が必要で、フィードはその再保存を、同じ値での他の再保存と同様に記録します(
actionの値を参照してください)。 - 表明の対象が、自動コントロール、手動コントロール、参考情報コントロールのどの種類のコントロールか。
- 表明を終了させる可能性のあるすべての変更。すべての変更に
lapsedアクティビティが記録されるとは限りません。
このページは役に立ちましたか?