使用 AWS Systems Manager 記錄 AWS CloudTrail API 呼叫 - AWS Systems Manager

使用 AWS Systems Manager 記錄 AWS CloudTrail API 呼叫

AWS Systems Manager 整合了 AWS CloudTrail,這種服務提供由使用者、角色或 Systems Manager 中 AWS 服務所採取之行動的記錄。CloudTrail 將 Systems Manager 的所有 API 呼叫擷取為事件,包括來自 Systems Manager 主控台的呼叫以及來自對 Systems Manager API 發出的程式碼呼叫。若您建立追蹤,便可將 CloudTrail 事件持續交付至 S3 儲存貯體,包括 Systems Manager 的事件。即使您未設定追蹤,依然可以透過 CloudTrail 主控台中的 Event history (事件歷史記錄) 檢視最新事件。您可以利用 CloudTrail 所收集的資訊來判斷向 Systems Manager 發出的請求,以及發出請求的 IP 地址、人員、時間和其他詳細資訊。

若要進一步了解 CloudTrail,請參閱 AWS CloudTrail 使用者指南

CloudTrail 中的 Systems Manager 資訊

當您建立帳戶時,系統即會在 AWS 帳戶 中啟用 CloudTrail。此外,Systems Manager 發生活動時,系統便會將該活動記錄至 CloudTrail 事件,並將其他 AWS 服務事件記錄到事件歷史記錄中。您可以檢視、搜尋和下載 AWS 帳戶 的最新事件。如需詳細資訊,請參閱使用 CloudTrail 事件歷史記錄檢視事件

若要持續記錄您 AWS 帳戶 帳戶中正在進行的事件 (包括 Systems Manager 的事件),請建立追蹤。追蹤可讓 CloudTrail 將日誌檔案傳送至 S3 儲存貯體。依預設,當您在主控台中建立追蹤時,該追蹤會套用至所有的 AWS 區域。該追蹤會記錄來自 AWS 分割區中所有區域的事件,並將日誌檔案交付到您指定的 S3 儲存貯體。此外,您可以設定其他 AWS 服務,以進一步分析和處理 CloudTrail 日誌中所收集的事件資料。如需詳細資訊,請參閱:

CloudTrail 會記錄所有 Systems Manager 動作,列在 AWS Systems Manager API 參考中。例如,對 CreateMaintenanceWindowsPutInventorySendCommand 以及 StartSession 動作發出的呼叫會在 CloudTrail 日誌檔案中產生項目。(如需設定 CloudTrail 以監控 Systems Manager API 呼叫的範例,請參閱 使用 Amazon EventBridge (主控台) 監控工作階段活動 。)

每一筆事件或日誌項目都會包含產生請求者的資訊。身分資訊可協助您判斷下列事項:

  • 該請求是否使用根或 IAM 使用者登入資料提出。

  • 提出該要求時,是否使用了特定角色或聯合身分使用者的暫時安全登入資料.

  • 該請求是否由另一項 AWS 服務提出。

如需詳細資訊,請參閱 CloudTrail userIdentity 元素

了解 Systems Manager 日誌檔案項目

追蹤是一種組態,允許事件以日誌檔案的形式交付至您指定的 S3 儲存貯體。CloudTrail 日誌檔案包含一個或多個日誌項目。一個事件代表任何來源提出的單一請求,並包含所請求之操作的相關資訊、操作的日期和時間、請求參數等等。CloudTrail 日誌檔案並非依公有 API 呼叫的堆疊追蹤排序,因此不會以任何特定順序出現。

以下範例顯示的是對 美國東部 (俄亥俄) 區域 (us-east-2) 中名為 example-Document 的文件進行 DeleteDocuments 動作的 CloudTrail 日誌項目。

{ "eventVersion": "1.04", "userIdentity": { "type": "AssumedRole", "principalId": "AKIAI44QH8DHBEXAMPLE:203.0.113.11", "arn": "arn:aws:sts::123456789012:assumed-role/example-role/203.0.113.11", "accountId": "123456789012", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2018-03-06T20:19:16Z" }, "sessionIssuer": { "type": "Role", "principalId": "AKIAI44QH8DHBEXAMPLE", "arn": "arn:aws:iam::123456789012:role/example-role", "accountId": "123456789012", "userName": "example-role" } } }, "eventTime": "2018-03-06T20:30:12Z", "eventSource": "ssm.amazonaws.com", "eventName": "DeleteDocument", "awsRegion": "us-east-2", "sourceIPAddress": "203.0.113.11", "userAgent": "example-user-agent-string", "requestParameters": { "name": "example-Document" }, "responseElements": null, "requestID": "86168559-75e9-11e4-8cf8-75d18EXAMPLE", "eventID": "832b82d5-d474-44e8-a51d-093ccEXAMPLE", "resources": [ { "ARN": "arn:aws:ssm:us-east-2:123456789012:document/example-Document", "accountId": "123456789012" } ], "eventType": "AwsApiCall", "recipientAccountId": "123456789012" }