AWSCloudTrail でのエンドユーザーメッセージング SMS データイベント AWSCloudTrail でのエンドユーザーメッセージング SMS 管理イベント AWSエンドユーザーメッセージング SMS イベントの例

を使用したAWSエンドユーザーメッセージング SMS API コールのログ記録AWS CloudTrail

AWSエンドユーザーメッセージング SMS は、ユーザーAWS CloudTrail、ロール、またはによって実行されたアクションを記録するサービスであると統合されていますAWS のサービス。CloudTrail は、AWSエンドユーザーメッセージング SMS のすべての API コールをイベントとしてキャプチャします。キャプチャされた呼び出しには、AWSエンドユーザーメッセージング SMS コンソールからの呼び出しとAWS、エンドユーザーメッセージング SMS API オペレーションへのコード呼び出しが含まれます。CloudTrail で収集された情報を使用して、AWSエンドユーザーメッセージング SMS に対するリクエスト、リクエスト元の IP アドレス、リクエスト日時などの詳細を確認できます。

各イベントまたはログエントリには、誰がリクエストを生成したかという情報が含まれます。アイデンティティ情報は、以下を判別するのに役立ちます。

ルートユーザーまたはユーザー認証情報のどちらを使用してリクエストが送信されたか。
リクエストが IAM Identity Center ユーザーに代わって行われたかどうか。
リクエストがロールまたはフェデレーションユーザーのテンポラリなセキュリティ認証情報を使用して行われたかどうか。
リクエストが、別の AWS のサービスによって送信されたかどうか。

CloudTrail は、アカウントを作成するAWS アカウントとでアクティブになり、CloudTrail イベント履歴に自動的にアクセスできます。CloudTrail の [イベント履歴] では、AWS リージョンで過去 90 日間に記録された管理イベントの表示、検索、およびダウンロードが可能で、変更不可能な記録を確認できます。詳細については、「AWS CloudTrail ユーザーガイド」の「CloudTrail イベント履歴の使用」を参照してください。[イベント履歴] の閲覧には CloudTrail の料金はかかりません。

AWS アカウント過去 90 日間のイベントの継続的な記録については、証跡または CloudTrail Lake イベントデータストアを作成します。

CloudTrail 証跡

証跡により、CloudTrail はログファイルを Amazon S3 バケットに配信できます。を使用して作成された証跡はすべてマルチリージョンAWS マネジメントコンソールです。AWS CLI を使用する際は、単一リージョンまたは複数リージョンの証跡を作成できます。アカウントAWS リージョン内のすべてのでアクティビティをキャプチャするため、マルチリージョン証跡を作成することをお勧めします。単一リージョンの証跡を作成する場合、証跡の AWS リージョンに記録されたイベントのみを表示できます。証跡の詳細については、「AWS CloudTrail ユーザーガイド」の「AWS アカウントの証跡の作成」および「組織の証跡の作成」を参照してください。

証跡を作成すると、進行中の管理イベントのコピーを 1 つ無料で CloudTrail から Amazon S3 バケットに配信できますが、Amazon S3 ストレージには料金がかかります。CloudTrail の料金の詳細については、「AWS CloudTrail の料金」を参照してください。Amazon S3 の料金に関する詳細については、「Amazon S3 の料金」を参照してください。

CloudTrail Lake イベントデータストア

[CloudTrail Lake] を使用すると、イベントに対して SQL ベースのクエリを実行できます。CloudTrail Lake は、行ベースの JSON 形式の既存のイベントを Apache ORC 形式に変換します。ORC は、データを高速に取得するために最適化された単票ストレージ形式です。イベントは、イベントデータストアに集約されます。イベントデータストアは、高度なイベントセレクタを適用することによって選択する条件に基づいた、イベントのイミュータブルなコレクションです。どのイベントが存続し、クエリに使用できるかは、イベントデータストアに適用するセレクタが制御します。CloudTrail Lake の詳細については、 AWS CloudTrailユーザーガイドのAWS CloudTrail「Lake の使用」を参照してください。

CloudTrail Lake のイベントデータストアとクエリにはコストがかかります。イベントデータストアを作成する際に、イベントデータストアに使用する料金オプションを選択します。料金オプションによって、イベントの取り込みと保存にかかる料金、および、そのイベントデータストアのデフォルトと最長の保持期間が決まります。CloudTrail の料金の詳細については、「AWS CloudTrail の料金」を参照してください。

AWSCloudTrail でのエンドユーザーメッセージング SMS データイベント

データイベントでは、リソース上またはリソース内で実行されるリソースオペレーション (Amazon S3 オブジェクトの読み取りまたは書き込みなど) についての情報が得られます。これらのイベントは、データプレーンオペレーションとも呼ばれます。データイベントは、多くの場合、高ボリュームのアクティビティです。デフォルトでは、CloudTrail はデータイベントをログ記録しません。CloudTrail [イベント履歴] にはデータイベントは記録されません。

追加の変更がイベントデータに適用されます。CloudTrail の料金の詳細については、「AWS CloudTrail の料金」を参照してください。

CloudTrail コンソール、または CloudTrail CloudTrail API オペレーションを使用してAWS CLI、AWSエンドユーザーメッセージング SMS リソースタイプのデータイベントを記録できます。データイベントをログに記録する方法の詳細については、「AWS CloudTrail ユーザーガイド」の「AWS マネジメントコンソールを使用したデータイベントのログ記録」および「AWS Command Line Interface を使用したデータイベントのログ記録」を参照してください。

次の表に、データイベントを記録できるAWSエンドユーザーメッセージング SMS リソースタイプを示します。データイベントタイプ (コンソール) 列には、CloudTrail コンソールの[データイベントタイプ]リストから選択する値が表示されます。resources.type 値列には、 AWS CLIまたは CloudTrail APIs を使用して高度なイベントセレクタを設定するときに指定する resources.type値が表示されます。CloudTrail に記録されたデータ API 列には、リソースタイプの CloudTrail にログ記録された API コールが表示されます。

データイベントタイプ (コンソール)	resources.type 値	CloudTrail にログ記録されたデータ API
[SMS Voice 発信元 ID]	`AWS::SMSVoice::OriginationIdentity`	SendTextMessage SendVoiceMessage SendMediaMessage
SMS Voice Notify の設定	`AWS::SMSVoice::NotifyConfiguration`	SendNotifyTextMessage SendNotifyVoiceMessage

eventName、readOnly、および resources.ARN フィールドでフィルタリングして、自分にとって重要なイベントのみをログに記録するように高度なイベントセレクタを設定できます。オブジェクトの詳細については、「AWS CloudTrail API リファレンス」の「AdvancedFieldSelector」を参照してください。

AWSCloudTrail でのエンドユーザーメッセージング SMS 管理イベント

管理イベントは、のリソースで実行される管理オペレーションに関する情報を提供しますAWS アカウント。これらのイベントは、コントロールプレーンオペレーションとも呼ばれます。CloudTrail は、デフォルトで管理イベントをログ記録します。

AWSエンドユーザーメッセージング SMS は、すべてのAWSエンドユーザーメッセージング SMS コントロールプレーンオペレーションを管理イベントとしてログに記録します。AWSエンドユーザーメッセージング SMS が CloudTrail に記録するAWSエンドユーザーメッセージング SMS コントロールプレーンオペレーションのリストについては、AWS「エンドユーザーメッセージング SMS および音声 V2 API リファレンス」を参照してください。

AWSエンドユーザーメッセージング SMS イベントの例

各イベントは任意の送信元からの単一のリクエストを表し、リクエストされた API オペレーション、オペレーションの日時、リクエストパラメータなどに関する情報を含みます。CloudTrail ログファイルは、パブリック API コールの順序付けられたスタックトレースではないため、イベントは特定の順序で表示されません。

CreateConfigurationSet と CreateEventDestination のアクションを示す CloudTrail ログ入力の例を次に示します。


{
  "Records": [
    {
      "eventVersion":"1.05",
      "userIdentity":{
        "type":"IAMUser",
        "principalId":"AIDAIHTHRCDA62EXAMPLE",
        "arn":"arn:aws:iam::111122223333:user/SampleUser",
        "accountId":"111122223333",
        "accessKeyId":"AKIAIOSFODNN7EXAMPLE",
        "userName":"SampleUser"
      },
      "eventTime":"2018-11-06T21:45:55Z",
      "eventSource":"sms-voice.amazonaws.com",
      "eventName":"CreateConfigurationSet",
      "awsRegion":"us-east-1",
      "sourceIPAddress":"192.0.0.1",
      "userAgent":"PostmanRuntime/7.3.0",
      "requestParameters":{
        "ConfigurationSetName":"MyConfigurationSet"
      },
      "responseElements":null,
      "requestID":"56dcc091-e20d-11e8-87d2-9994aexample",
      "eventID":"725843fc-8846-41f4-871a-7c52dexample",
      "readOnly":false,
      "eventType":"AwsApiCall",
      "recipientAccountId":"123456789012"
    },
    {
      "eventVersion":"1.05",
      "userIdentity":{
        "type":"IAMUser",
        "principalId":"AIDAIHTHRCDA62EXAMPLE",
        "arn":"arn:aws:iam::111122223333:user/SampleUser",
        "accountId":"111122223333",
        "accessKeyId":"AKIAIOSFODNN7EXAMPLE",
        "userName":"SampleUser"
      },
      "eventTime":"2018-11-06T21:47:08Z",
      "eventSource":"sms-voice.amazonaws.com",
      "eventName":"CreateEventDestination",
      "awsRegion":"us-east-1",
      "sourceIPAddress":"192.0.0.1",
      "userAgent":"PostmanRuntime/7.3.0",
      "requestParameters":{
        "EventDestinationName":"CloudWatchEventDestination",
        "ConfigurationSetName":"MyConfigurationSet",
        "EventDestination":{
          "Enabled":true,
          "MatchingEventTypes":[
            "INITIATED_CALL",
            "INITIATED_CALL"
          ],
          "CloudWatchLogsDestination":{
            "IamRoleArn":"arn:aws:iam::111122223333:role/iamrole-01",
            "LogGroupArn":"arn:aws:logs:us-east-1:111122223333:log-group:clientloggroup-01"
          }
        }
      },
      "responseElements":null,
      "requestID":"81de1e73-e20d-11e8-b158-d5536example",
      "eventID":"fcafc21f-7c93-4a3f-9e72-fca2dexample",
      "readOnly":false,
      "eventType":"AwsApiCall",
      "recipientAccountId":"111122223333"
    }
  ]
}

以下の例は、SendTextMessage アクションを示す CloudTrail ログエントリです。


{
        "eventVersion": "1.10",
        "userIdentity": {
            "type": "AssumedRole",
            "principalId": "QWERTYUIOPASDFGHJKLZXCVBNM:EXAMPLE",
            "arn": "arn:aws:sts::111122223333:assumed-role/ASDFGHJKL/QWERTYUIOP",
            "accountId": "111122223333",
            "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
            "sessionContext": {
                "sessionIssuer": {
                    "type": "Role",
                    "principalId": "ASDFGHJKLQWERTYUIOP",
                    "arn": "arn:aws:iam::123456789123:role/QWERTYUIOP",
                    "accountId": "111122223333",
                    "userName": "QWERTYUIOP"
                },
                "attributes": {
                    "creationDate": "2024-10-02T22:39:11Z",
                    "mfaAuthenticated": "false"
                }
            }
        },
        "eventTime": "2024-10-02T23:52:08Z",
        "eventSource": "sms-voice.amazonaws.com",
        "eventName": "SendTextMessage",
        "awsRegion": "us-east-1",
        "sourceIPAddress": "192.0.2.1",
        "userAgent": "aws-cli/1.18.147 Python/2.7.18 Linux/5.10.218-186.862.amzn2int.x86_64 botocore/1.18.6",
        "requestParameters": {
            "destinationPhoneNumber": "+11235550123",
            "originationIdentity": "phone-aa012345678901234567890123456789",
            "messageBody": "HIDDEN_DUE_TO_SECURITY_REASONS",
        },
        "responseElements": {
            "messageId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
        },
        "requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
        "eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
        "readOnly": false,
        "resources": [{
            "accountId": "111122223333",
            "type": "AWS::SMSVoice::OriginationIdentity",
            "ARN": "arn:aws:sms-voice:us-east-1:111122223333:phone-number/phone-aa012345678901234567890123456789"
        }],
        "eventType": "AwsApiCall",
        "managementEvent": false,
        "recipientAccountId": "111122223333",
        "eventCategory": "Data",
        "tlsDetails": {
            "clientProvidedHostHeader": "sms-voice.us-east-1.amazonaws.com"
        }
}

以下の例は、SendVoiceMessage アクションを示す CloudTrail ログエントリです。


{
        "eventVersion": "1.10",
        "userIdentity": {
            "type": "AssumedRole",
            "principalId": "QWERTYUIOPASDFGHJKLZXCVBNM:EXAMPLE",
            "arn": "arn:aws:sts::111122223333:assumed-role/ASDFGHJKL/QWERTYUIOP",
            "accountId": "111122223333",
            "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
            "sessionContext": {
                "sessionIssuer": {
                    "type": "Role",
                    "principalId": "ASDFGHJKLQWERTYUIOP",
                    "arn": "arn:aws:iam::123456789123:role/QWERTYUIOP",
                    "accountId": "111122223333",
                    "userName": "QWERTYUIOP"
                },
                "attributes": {
                    "creationDate": "2024-10-02T22:39:11Z",
                    "mfaAuthenticated": "false"
                }
            }
        },
        "eventTime": "2024-10-02T23:52:08Z",
        "eventSource": "sms-voice.amazonaws.com",
        "eventName": "SendVoiceMessage",
        "awsRegion": "us-east-1",
        "sourceIPAddress": "192.0.2.1",
        "userAgent": "aws-cli/1.18.147 Python/2.7.18 Linux/5.10.218-186.862.amzn2int.x86_64 botocore/1.18.6",
        "requestParameters": {
            "destinationPhoneNumber": "+11235550123",
            "originationIdentity": "phone-aa012345678901234567890123456789",
            "messageBody": "HIDDEN_DUE_TO_SECURITY_REASONS",
        },
        "responseElements": {
            "messageId": "a1b2c3d4-5678-90ab-cdef-EXAMPLEaaaaa"
        },
        "requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLEbbbbb",
        "eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "readOnly": false,
        "resources": [{
            "accountId": "111122223333",
            "type": "AWS::SMSVoice::OriginationIdentity",
            "ARN": "arn:aws:sms-voice:us-east-1:111122223333:phone-number/phone-aa012345678901234567890123456789"
        }],
        "eventType": "AwsApiCall",
        "managementEvent": false,
        "recipientAccountId": "111122223333",
        "eventCategory": "Data",
        "tlsDetails": {
            "clientProvidedHostHeader": "sms-voice.us-east-1.amazonaws.com"
        }
}

以下の例は、SendMediaMessage アクションを示す CloudTrail ログエントリです。


{
        "eventVersion": "1.10",
        "userIdentity": {
            "type": "AssumedRole",
            "principalId": "QWERTYUIOPASDFGHJKLZXCVBNM:EXAMPLE",
            "arn": "arn:aws:sts::111122223333:assumed-role/ASDFGHJKL/QWERTYUIOP",
            "accountId": "111122223333",
            "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
            "sessionContext": {
                "sessionIssuer": {
                    "type": "Role",
                    "principalId": "ASDFGHJKLQWERTYUIOP",
                    "arn": "arn:aws:iam::377392627227:role/QWERTYUIOP",
                    "accountId": "111122223333",
                    "userName": "QWERTYUIOP"
                },
                "attributes": {
                    "creationDate": "2024-10-02T22:39:11Z",
                    "mfaAuthenticated": "false"
                }
            }
        },
        "eventTime": "2024-10-02T23:52:08Z",
        "eventSource": "sms-voice.amazonaws.com",
        "eventName": "SendMediaMessage",
        "awsRegion": "us-east-1",
        "sourceIPAddress": "192.0.2.1",
        "userAgent": "aws-cli/1.18.147 Python/2.7.18 Linux/5.10.218-186.862.amzn2int.x86_64 botocore/1.18.6",
        "requestParameters": {
            "destinationPhoneNumber": "+11235550123",
            "originationIdentity": "phone-aa012345678901234567890123456789",
            "messageBody": "HIDDEN_DUE_TO_SECURITY_REASONS",
        },
        "responseElements": {
            "messageId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
        },
        "requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
        "eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLEaaaaa",
        "readOnly": false,
        "resources": [{
            "accountId": "111122223333",
            "type": "AWS::SMSVoice::OriginationIdentity",
            "ARN": "arn:aws:sms-voice:us-east-1:111122223333:phone-number/phone-aa012345678901234567890123456789"
        }],
        "eventType": "AwsApiCall",
        "managementEvent": false,
        "recipientAccountId": "111122223333",
        "eventCategory": "Data",
        "tlsDetails": {
            "clientProvidedHostHeader": "sms-voice.us-east-1.amazonaws.com"
        }
}

CloudTrail レコードの内容については、「AWS CloudTrail ユーザーガイド」の「CloudTrail record contents」を参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

使用量のモニタリング

EventBridge の使用