---
title: Security posture 事件參考資料
url: https://platform.claude.com/docs/zh-TW/manage-claude/compliance-security-posture/events-reference
description: 查詢記錄 Security posture 頁面上變更的 Activity Feed 活動：其欄位與值、每項活動的範例，以及 Activity Feed 未記錄的內容。
---

<Note>
  若要啟用 Compliance API，請參閱[設定 Compliance API](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-api-access)。
</Note>

[Activity Feed](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-activity-feed) 會將 [Security posture](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-security-posture/overview) 頁面上聲明的變更，記錄為本頁所描述的活動。若要將這些活動匯入「security information and event management」（安全資訊與事件管理），即 SIEM 系統，請從[將 Security posture 事件傳送至您的 SIEM](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-security-posture/send-events) 開始。對於 `control`、`action` 或其他欄位中本頁未列出的任何值，請原樣傳遞；忽略非預期的欄位；並將缺少的鍵與 `null` 值視為相同。[了解 Activity 物件](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-activity-feed#understand-the-activity-object)說明了標準欄位與未知類型。

您需要一把涵蓋該組織的 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` 為其結束日期。

| 欄位                | 類型     | 說明                                                                                                                                         |
| ----------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `control`         | string | 該聲明所適用之安全控制措施的識別碼，例如 `oauth_conditional_access`；請將其視為不透明字串。                                                                                |
| `action`          | string | 變更的內容，為其中一個 [`action` 值](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-security-posture/events-reference#action-values)。 |
| `status`          | string | 聲明的值：「已完成」（`completed`）、「已接受風險」（`accepted_risk`）或被聲明為「未通過」（`control_failed`）；清除聲明時則不存在。                                                    |
| `previous_status` | string | 此次變更前聲明的值，為上述三者之一；當 `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` 活動之後以相同的值儲存，會記錄為 `renewed`，而非 `attested`。

### `lapsed` 活動的意義

`lapsed` 活動表示檢查結果或控制措施的目前值與儲存聲明時所依據的不同；目前值可能在沒有任何設定變更的情況下改變，例如 Anthropic 調整其措辭時。`status` 是已終止的值：三者中的任一個。手動控制措施的聲明永遠不會產生 `lapsed` 活動。此活動可能晚於導致它的變更才出現。

### 範例

```json
{
  "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 結果參考資料](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-security-posture/results-reference)；其端點可能會省略活動中所指名的控制措施。

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