Claude Platform Docs
管理Security posture

Security posture 事件參考資料

查詢記錄 Security posture 頁面上變更的 Activity Feed 活動:其欄位與值、每項活動的範例,以及 Activity Feed 未記錄的內容。

Activity Feed 會將 Security posture 頁面上聲明的變更,記錄為本頁所描述的活動。若要將這些活動匯入「security information and event management」(安全資訊與事件管理),即 SIEM 系統,請從將 Security posture 事件傳送至您的 SIEM 開始。對於 control、action 或其他欄位中本頁未列出的任何值,請原樣傳遞;忽略非預期的欄位;並將缺少的鍵與 null 值視為相同。了解 Activity 物件說明了標準欄位與未知類型。

您需要一把涵蓋該組織的 Compliance Access Key,並具備 read:compliance_activities 或 read:org_audit 範圍。

聲明活動

org_security_control_attestation_updated 活動記錄有人為某項安全控制措施記錄、變更、再次儲存或清除了組織的聲明,或該聲明已自動終止。其 created_at 在由人員進行變更時為變更發生的時間;在自動變更時則為記錄該變更的時間,可能晚於變更發生的時間。其 actor 在由人員進行變更時為 user_actor,在自動變更(例如 lapsed)時為 system_actor。

欄位

此類型新增下列欄位,其中 status 為聲明的值,review_date 為其結束日期。

欄位類型說明
controlstring該聲明所適用之安全控制措施的識別碼,例如 oauth_conditional_access;請將其視為不透明字串。
actionstring變更的內容,為其中一個 action 值。
statusstring聲明的值:「已完成」(completed)、「已接受風險」(accepted_risk)或被聲明為「未通過」(control_failed);清除聲明時則不存在。
previous_statusstring此次變更前聲明的值,為上述三者之一;當 action 為 attested 時不存在。
review_datestring聲明預計終止的 UTC 日期(ISO 8601 日期);若儲存時未設定結束日期,或已清除聲明,則不存在。

在僅供參考的控制措施上,「已檢閱」這個值會記錄為 completed。

action 值

action意義
attested為尚無聲明的控制措施記錄了聲明。
changed聲明以另一個值再次儲存;或在 status 等於 previous_status 時,以相同的值再次儲存,如同 renewed。
renewed聲明以相同的值再次儲存。
cleared有人員清除了聲明。
lapsed聲明自動終止,而非由人員終止。

在 renewed 與 lapsed 活動中,status 等於 previous_status。在 lapsed 活動之後以相同的值儲存,會記錄為 renewed,而非 attested。

lapsed 活動的意義

lapsed 活動表示檢查結果或控制措施的目前值與儲存聲明時所依據的不同;目前值可能在沒有任何設定變更的情況下改變,例如 Anthropic 調整其措辭時。status 是已終止的值:三者中的任一個。手動控制措施的聲明永遠不會產生 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"
}

Activity Feed 未記錄的內容

請勿將沒有活動解讀為沒有任何變更的跡象。如需目前結果,請參閱 Security posture 結果參考資料;其端點可能會省略活動中所指名的控制措施。

  • 在 Activity Feed 開始為該組織記錄這些活動之前,或在 Compliance API 關閉期間所發生的變更,之後永遠不會補上。
  • 極少數情況下,任何類型的變更。
  • 所有到來的結束日期:並非全部都會產生活動,因此請勿等待活動。
  • 每次關閉或開啟 Security posture 頁面時:請勿依賴偵測規則來偵測。
  • 與聲明一同儲存的備註,或任何表示備註存在的標記。變更備註需要再次儲存,而 Activity Feed 會將此次儲存視同任何其他以相同的值進行的儲存來記錄(請參閱action 值)。
  • 聲明所針對的控制措施類型:自動、手動或僅供參考。
  • 所有可能使聲明終止的變更:並非全部都會產生 lapsed 活動。

這個頁面有幫助嗎?