本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用主控台建立與 CloudTrail 合作夥伴的整合
<a name="query-event-data-store-integration-partner"></a>

當您在外部建立與事件來源的整合時 AWS，您可以選擇其中一個合作夥伴做為您的事件來源。當您在 CloudTrail 中與合作夥伴應用程式建立整合時，合作夥伴需要您在此工作流程中所建立通道的 Amazon Resource Name (ARN)，才能將事件傳送至 CloudTrail。建立整合之後，您可以依照合作夥伴的指示，將所需的通道 ARN 提供給合作夥伴，以完成整合的設定。合作夥伴在整合的通道上呼叫 `PutAuditEvents` 之後，整合就會開始將合作夥伴事件擷取到 CloudTrail 中。

1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/cloudtrail/](https://console.aws.amazon.com/cloudtrail/) 的 CloudTrail 主控台。

1.  在導覽窗格中，選擇 **Lake** 下方的**整合**。

1. 在 **Add integration** (新增整合) 頁面上，輸入通道的名稱。名稱長度範圍是 3-128 個字元。只能使用字母、數字、句號、底線和破折號。

1. 選擇您要從中取得事件的合作夥伴應用程式來源。如果您要與內部部署或雲端中託管的自有應用程式的事件整合，請選擇 **My custom integration** (我的自訂整合)。

1. 在 **Event delivery location** (事件傳送位置) 中，選擇將相同的活動事件記錄到現有事件資料存放區，或建立新的事件資料存放區。

   如果您選擇建立新的事件資料存放區，請輸入事件資料存放區的名稱，選擇定價選項，並指定保留期間 (以天為單位)。事件資料存放區會在指定的天數內保留事件資料。

   如果您選擇將活動事件記錄到一或多個現有事件資料存放區，請從清單中選擇事件資料存放區。事件資料存放區只能包含活動事件。主控台中的事件類型必須是 **Events from integrations** (來自整合的事件)。在 API 中，`eventCategory` 值必須是 `ActivityAuditLog`。

1. 在 **Resource policy** (資源政策) 中，為整合的通道設定資源政策。資源政策是 JSON 政策文件，這些文件會指出指定的主體可對資源執行哪些動作以及相關條件。在資源政策中定義為主體的帳戶可以呼叫 `PutAuditEvents` API，將事件傳送至您的通道。如果資源擁有者的 IAM 政策允許 `cloudtrail-data:PutAuditEvents` 動作，則資源擁有者對資源具有隱含存取權。

   政策所需的資訊取決於整合類型。對於方向整合，CloudTrail 會自動新增合作夥伴 AWS 的帳戶 IDs，並要求您輸入合作夥伴提供的唯一外部 ID。對於解決方案整合，您必須指定至少一個 AWS 帳戶 ID 作為委託人，並且可以選擇輸入外部 ID 以防止混淆代理人。
**注意**  
如果您沒有為通道建立資源政策，則只有通道擁有者可以在通道上呼叫 `PutAuditEvents` API。

   1. 對於直接整合，請輸入合作夥伴提供的外部 ID。整合合作夥伴提供唯一外部 ID，例如帳戶 ID 或隨機產生的字串，以供整合用於預防混淆代理人。合作夥伴負責建立並提供唯一外部 ID。

       您可以選擇 **How to find this?** (如何尋找此資訊？) 以檢視合作夥伴有關描述如何尋找外部 ID 的文件。  
![外部 ID 的合作夥伴文件](http://docs.aws.amazon.com/zh_tw/awscloudtrail/latest/userguide/images/integration-external-id.png)
**注意**  
如果資源政策包含外部 ID，則對 `PutAuditEvents` API 的所有呼叫都必須包含外部 ID。不過，如果政策未定義外部 ID，合作夥伴仍可呼叫 `PutAuditEvents` API 並指定 `externalId` 參數。

   1.  針對解決方案整合，選擇**新增 AWS 帳戶**以指定 AWS 帳戶 ID，以在政策中新增為委託人。

1. (選用) 在 **Tags** (標籤) 區域中，您最多可以新增 50 個標籤索引鍵和值組，以協助您識別、排序和控制對事件資料存放區及通道的存取權限。如需使用 IAM 政策，對以標籤為基礎的事件資料存放區授與存取權限的詳細資訊，請參閱[範例：拒絕以標籤為基礎建立或刪除事件資料存放區的存取權限](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-eds-tags)。如需如何在 中使用標籤的詳細資訊 AWS，請參閱《》中的[標記 AWS 資源](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)*AWS 一般參考*。

1. 當您準備好建立新整合時，請選擇 **Add integration** (新增整合)。沒有檢閱頁面。CloudTrail 會建立整合，但您必須提供通道 Amazon Resource Name (ARN) 給合作夥伴應用程式。如需將通道 ARN 提供給合作夥伴應用程式的說明，請參閱合作夥伴文件網站。如需詳細資訊，請在 **Integrations** (整合) 頁面的 **Available sources** (可用來源) 索引標籤中選擇合作夥伴的 **Learn more** (進一步了解) 連結，以在 AWS Marketplace中開啟合作夥伴的頁面。

若要完成整合的設定，請將通道 ARN 提供給合作夥伴或來源應用程式。視整合類型而定，您、合作夥伴或應用程式會執行 `PutAuditEvents` API，將活動事件傳送至您 AWS 帳戶的事件資料存放區。活動事件傳送後，您可以使用 CloudTrail Lake 來搜尋、查詢和分析從應用程式記錄的資料。您的事件資料包含與 CloudTrail 事件承載相符的欄位，例如 `eventVersion`、`eventSource` 和 `userIdentity`。