翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

「CloudTrail の Amazon SNS 通知の設定」

CloudTrail が、新しいログファイルを Amazon S3 バケットに発行するときに通知を受け取ることができます。Amazon Simple Notification Service (Amazon SNS) を使用して、通知を管理します。

通知はオプションです。通知が必要な場合は、新しいログファイルが送信されるたびに Amazon SNS トピックに更新情報を送信するよう CloudTrail を設定します。これらの通知を受け取るには、Amazon SNS を使用してトピックを受信することができます。受信者として、アップデートを Amazon Simple Queue Service (Amazon SQS) キューに送信できます。これにより、これらの通知をプログラムで処理できます。

通知を送信するための CloudTrail の設定

CloudTrail コンソールでは、証跡を作成または更新するときに Amazon SNS SNS トピックを使用するように証跡を設定できます。新しいトピックを使用することを選択した場合、CloudTrail は Amazon SNS トピックを作成し、適切なポリシーをアタッチして、CloudTrail がそのトピックに発行するアクセス許可を持つようにします。

では AWS CLI、 --sns-topic-nameパラメータの値を指定することで、Amazon SNS トピックを使用するように証跡を作成または更新できます。Amazon SNS トピックの名前または ARN を指定できます。

SNS トピック名を作成する際には、名前が次の要件を満たしている必要があります。

マルチリージョン証跡の通知を設定すると、すべてのリージョンからの通知が、指定した Amazon SNS トピックに送信されます。リージョン固有の証跡が 1 つ以上ある場合は、リージョンごとに個別のトピックを作成し、各トピックを個別にサブスクライブする必要があります。

通知を受信するには、Amazon SNS トピックか、CloudTrail によって使用されるトピックをサブスクライブします。これを行うには、Amazon SNS コンソールまたは Amazon SNS CLI コマンドを使用します。詳細については、「Amazon Simple 通知サービス デベロッパーガイド」の「Amazon SNS トピックのサブスクライブ」を参照してください。

Amazon SNS 通知は、Message フィールドを含んだ JSON オブジェクトで構成されます。Message フィールドには、次の例のように、ログファイルへのフルパスがリストされます。

{
    "s3Bucket": "amzn-s3-demo-bucket","s3ObjectKey": ["AWSLogs/123456789012/CloudTrail/us-east-2/2013/12/13/123456789012_CloudTrail_us-west-2_20131213T1920Z_LnPgDQnpkSKEsppV.json.gz"]
}

Amazon S3 バケットに複数のログファイルが配信された場合は、次の例のように、複数のログが通知に含まれている可能性があります。

{
    "s3Bucket": "amzn-s3-demo-bucket",
    "s3ObjectKey": [
        "AWSLogs/123456789012/CloudTrail/us-east-2/2016/08/11/123456789012_CloudTrail_us-east-2_20160811T2215Z_kpaMYavMQA9Ahp7L.json.gz",
        "AWSLogs/123456789012/CloudTrail/us-east-2/2016/08/11/123456789012_CloudTrail_us-east-2_20160811T2210Z_zqDkyQv3TK8ZdLr0.json.gz",
        "AWSLogs/123456789012/CloudTrail/us-east-2/2016/08/11/123456789012_CloudTrail_us-east-2_20160811T2205Z_jaMVRa6JfdLCJYHP.json.gz"
    ]
}

E メールで通知を受け取る場合、E メールの本文は、Message フィールドの内容で構成されます。JSON 構造の詳細については、「Amazon Simple Notification Service Developer Guide」の「Fanout to Amazon SQS queues」を参照してください。CloudTrail 情報は Message フィールドにのみ表示されます。その他のフィールドには、Amazon SNS サービスからの情報が記載されます。

CloudTrail API を使用して証跡を作成する場合は、CreateTrail または UpdateTrail オペレーションを使用して、CloudTrail から通知を送信する既存の Amazon SNS トピックを指定できます。その場合は、そのトピックが存在することと、CloudTrail からの通知の送信を許可するアクセス許可がそのトピックにあることを確認する必要があります。「CloudTrail の Amazon SNS トピックポリシー」を参照してください

追加リソース

Amazon SNS トピックおよびそのサブスクライブの詳細については、「Amazon Simple Notification Service デベロッパーガイド」を参照してください。