の Amazon SNS通知の設定 CloudTrail

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

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

通知を送信する CloudTrail ように を設定する

Amazon SNSトピックを使用するように証跡を設定できます。 CloudTrail コンソールまたは aws cloudtrail create-trail CLI コマンドを使用して topic を作成できます。 CloudTrail は Amazon SNSトピックを作成し、適切なポリシーをアタッチして、 がそのトピックに発行するアクセス許可 CloudTrail を持つようにします。

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

• 1 ～ 256 文字

• 大文字と小文字ASCII、数字、アンダースコア、またはハイフンを含む

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

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

注記

CloudTrail は、ログファイルが Amazon S3 バケットに書き込まれると通知を送信します。アクティブなアカウントでは、大量の通知が生成されることがあります。E メールまたは でサブスクライブするとSMS、大量のメッセージを受信できます。通知をプログラムで処理できる Amazon Simple Queue Service (Amazon SQS) を使用してサブスクライブすることをお勧めします。詳細については、「Amazon Simple Queue Service デベロッパーガイド」の「Amazon SQSキューを 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 デベロッパーガイド」の「Amazon SQSキューへのファンアウト」を参照してください。 Message フィールドのみが CloudTrail 情報を表示します。他のフィールドには、Amazon SNSサービスからの情報が含まれています。

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

追加リソース

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