Registro de llamadas a la API de Amazon SNS mediante CloudTrail

Información de Amazon SNS en CloudTrail Eventos del plano de control en CloudTrail Eventos del plano de datos en CloudTrail Ejemplo: entradas del archivo de registros de Amazon SNS

Amazon SNS se integra a AWS CloudTrail, un servicio que proporciona un registro de las medidas adoptadas por un usuario, un rol o un servicio de AWS en Amazon SNS. CloudTrail captura las llamadas a la API de Amazon SNS como eventos. Las llamadas capturadas incluyen las llamadas desde la consola de Amazon SNS y las llamadas desde el código a las operaciones de la API de Amazon SNS. Si crea un registro de seguimiento, puede habilitar la entrega continua de eventos de CloudTrail a un bucket de Amazon S3, incluidos los eventos de Amazon SNS. Si no configura un registro de seguimiento, puede ver los eventos más recientes en la consola de CloudTrail en el Historial de eventos. Mediante la información recopilada por CloudTrail, puede determinar la solicitud que se realizó a Amazon SNS, la dirección IP desde la que se realizó, quién la realizó y cuándo, y otros detalles.

Para obtener más información acerca de CloudTrail, incluso cómo configurarlo y habilitarlo, consulte la Guía del usuario de AWS CloudTrail.

CloudTrail se habilita en su Cuenta de AWS cuando se crea la cuenta. Cuando se produce una actividad de eventos compatible en Amazon SNS, la actividad se registra en un evento de CloudTrail junto con otros eventos de servicios de AWS en Historial de eventos. Puede ver, buscar y descargar eventos recientes en su Cuenta de AWS. Para obtener más información, consulte Ver eventos con el historial de eventos de CloudTrail.

Para mantener un registro continuo de los eventos de la Cuenta de AWS, incluidos los eventos de Amazon SNS, cree un registro de seguimiento. Un registro de seguimiento permite a CloudTrail enviar archivos de registro a un bucket de Amazon S3. De manera predeterminada, cuando se crea un registro de seguimiento en la consola, el registro de seguimiento se aplica a todas las regiones de AWS. El registro de seguimiento registra los eventos de todas las regiones de la partición de AWS y envía los archivos de registro al bucket de Amazon S3 especificado. También es posible configurar otros servicios de AWS para analizar en profundidad y actuar en función de los datos de eventos recopilados en los registros de CloudTrail. Para más información, consulte los siguientes temas:

Amazon SNS admite el registro de las siguientes acciones como eventos en archivos de registros de CloudTrail:

nota

Si no ha iniciado sesión en Amazon Web Services (modo sin autenticar) y se invocan las acciones ConfirmSubscription o Unsubscribe, no se registrarán en CloudTrail. Por ejemplo, al elegir el vínculo proporcionado en una notificación por correo electrónico para confirmar la suscripción pendiente en un tema, se invoca la acción ConfirmSubscription en modo sin autenticar. En este ejemplo, la acción ConfirmSubscription no se registra en CloudTrail.

Cada entrada de registro o evento contiene información sobre quién generó la solicitud. La información de identidad del usuario lo ayuda a determinar lo siguiente:

Si la solicitud se realizó con credenciales de usuario de AWS Identity and Access Management (IAM) o credenciales de usuario raíz.
Si la solicitud se realizó con credenciales de seguridad temporales de un rol o fue un usuario federado.
Si la solicitud la realizó otro servicio de AWS.

Para obtener más información, consulte el Elemento userIdentity de CloudTrail.

Eventos del plano de datos en CloudTrail

Para habilitar el registro de las siguientes acciones de API en los archivos de CloudTrail, debe habilitar el registro de la actividad de la API del plano de datos en CloudTrail. Para obtener más información, consulte Registro de eventos de datos en la Guía del usuario de AWS CloudTrail.

Los eventos del plano de datos se pueden filtrar por tipo de recurso para tener un control pormenorizado de las llamadas a la API de Amazon SNS que desea registrar y pagar de forma selectiva en CloudTrail. Por ejemplo, al especificar AWS::SNS::Topic como tipo de recurso, puede registrar llamadas a Publish y acciones de la API PublishBatch para temas. Del mismo modo, al especificar AWS::SNS::PlatformEndpoint como tipo de recurso, puede registrar las llamadas a la acción de la API de publicación para los puntos de conexión de la plataforma. Para obtener más información consulte AdvancedEventSelector en la Referencia de la API de AWS CloudTrail.

nota

CloudTrail no registra el tipo de recurso AWS::SNS::PhoneNumber de Amazon SNS.

API de planos de datos de Amazon SNS

Ejemplo: entradas del archivo de registros de Amazon SNS

Un registro de seguimiento es una configuración que permite la entrega de eventos como archivos de registros en un bucket de Amazon S3 que especifique. Los archivos de registro de CloudTrail pueden contener una o varias entradas de registro. Un evento representa una solicitud específica realizada desde un origen cualquiera, y contiene información sobre la acción solicitada, la fecha y la hora de la acción, los parámetros de la solicitud, etc. Los archivos de registro de CloudTrail no rastrean el orden en la pila de las llamadas públicas a la API, por lo que estas no aparecen en ningún orden específico.

En el ejemplo siguiente, se muestra una entrada de registro de CloudTrail que ilustra las acciones ListTopics, CreateTopic y DeleteTopic.


{
  "Records": [
    {
      "eventVersion": "1.02",
      "userIdentity": {
       "type":"IAMUser",
       "userName":"Bob"
       "principalId": "EX_PRINCIPAL_ID",
        "arn": "arn:aws:iam::123456789012:user/Bob",
        "accountId": "123456789012",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE"
      },
      "eventTime": "2014-09-30T00:00:00Z",
      "eventSource": "sns.amazonaws.com",
      "eventName": "ListTopics",
      "awsRegion": "us-west-2",
      "sourceIPAddress": "127.0.0.1",
      "userAgent": "aws-sdk-java/unknown-version",
      "requestParameters": {
        "nextToken": "ABCDEF1234567890EXAMPLE=="
      },
      "responseElements": null,
      "requestID": "example1-b9bb-50fa-abdb-80f274981d60",
      "eventID": "example0-09a3-47d6-a810-c5f9fd2534fe",
      "eventType": "AwsApiCall",
      "recipientAccountId": "123456789012"
    },
    {
      "eventVersion": "1.02",
      "userIdentity": {
       "type":"IAMUser",
       "userName":"Bob"
       "principalId": "EX_PRINCIPAL_ID",
        "arn": "arn:aws:iam::123456789012:user/Bob",
        "accountId": "123456789012",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE"
      },
      "eventTime": "2014-09-30T00:00:00Z",
      "eventSource": "sns.amazonaws.com",
      "eventName": "CreateTopic",
      "awsRegion": "us-west-2",
      "sourceIPAddress": "127.0.0.1",
      "userAgent": "aws-sdk-java/unknown-version",
      "requestParameters": {
        "name": "hello"
      },
      "responseElements": {
        "topicArn": "arn:aws:sns:us-west-2:123456789012:hello-topic"
      },
      "requestID": "example7-5cd3-5323-8a00-f1889011fee9",
      "eventID": "examplec-4f2f-4625-8378-130ac89660b1",
      "eventType": "AwsApiCall",
      "recipientAccountId": "123456789012"
    },
    {
      "eventVersion": "1.02",
      "userIdentity": {
       "type":"IAMUser",
       "userName":"Bob"
       "principalId": "EX_PRINCIPAL_ID",
        "arn": "arn:aws:iam::123456789012:user/Bob",
        "accountId": "123456789012",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE"
      },
      "eventTime": "2014-09-30T00:00:00Z",
      "eventSource": "sns.amazonaws.com",
      "eventName": "DeleteTopic",
      "awsRegion": "us-west-2",
      "sourceIPAddress": "127.0.0.1",
      "userAgent": "aws-sdk-java/unknown-version",
      "requestParameters": {
        "topicArn": "arn:aws:sns:us-west-2:123456789012:hello-topic"
      },
      "responseElements": null,
      "requestID": "example5-4faa-51d5-aab2-803a8294388d",
      "eventID": "example8-6443-4b4d-abfd-1b867280d964",
      "eventType": "AwsApiCall",
      "recipientAccountId": "123456789012"
    },
  ]
}

Los siguientes ejemplos muestran entradas de registro de CloudTrail que demuestran las acciones Publish y PublishBatch.

Publicación


{
	"eventVersion": "1.09",
	"userIdentity": {
		"type": "AssumedRole",
		"principalId": "EX_PRINCIPAL_ID",
		"arn": "arn:aws:iam::123456789012:user/Bob",
		"accountId": "123456789012",
		"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
		"sessionContext": {
			"sessionIssuer": {
				"type": "Role",
				"principalId": "AKIAIOSFODNN7EXAMPLE",
				"arn": "arn:aws:iam::123456789012:role/Admin",
				"accountId": "123456789012",
				"userName": "ExampleUser"
			},
			"attributes": {
				"creationDate": "2023-08-21T16:44:05Z",
				"mfaAuthenticated": "false"
			}
		}
	},
	"eventTime": "2023-08-21T16:48:37Z",
	"eventSource": "sns.amazonaws.com",
	"eventName": "Publish",
	"awsRegion": "us-east-1",
	"sourceIPAddress": "192.0.2.0",
	"userAgent": "aws-cli/1.29.16 md/Botocore#1.31.16 ua/2.0 os/linux#5.4.250-173.369.amzn2int.x86_64 md/arch#x86_64 lang/python#3.8.17 md/pyimpl#CPython cfg/retry-mode#legacy botocore/1.31.16",
	"requestParameters": {
		"topicArn": "arn:aws:sns:us-east-1:123456789012:ExampleSNSTopic",
		"message": "HIDDEN_DUE_TO_SECURITY_REASONS",
		"subject": "HIDDEN_DUE_TO_SECURITY_REASONS",
		"messageStructure": "json",
		"messageAttributes": "HIDDEN_DUE_TO_SECURITY_REASONS"
	},
	"responseElements": {
		"messageId": "0787cd1e-d92b-521c-a8b4-90434e8ef840"
	},
	"requestID": "0a8ab208-11bf-5e01-bd2d-ef55861b545d",
	"eventID": "bb3496d4-5252-4660-9c28-3c6aebdb21c0",
	"readOnly": false,
	"resources": [{
		"accountId": "123456789012",
		"type": "AWS::SNS::Topic",
		"ARN": "arn:aws:sns:us-east-1:123456789012:ExampleSNSTopic"
	}],
	"eventType": "AwsApiCall",
	"managementEvent": false,
	"recipientAccountId": "123456789012",
	"eventCategory": "Data",
	"tlsDetails": {
		"tlsVersion": "TLSv1.2",
		"cipherSuite": "ECDHE-RSA-AES128-GCM-SHA256",
		"clientProvidedHostHeader": "sns.us-east-1.amazonaws.com"
	}
}

PublishBatch


{
	"eventVersion": "1.09",
	"userIdentity": {
		"type": "AssumedRole",
		"principalId": "EX_PRINCIPAL_ID",
		"arn": "arn:aws:iam::123456789012:user/Bob",
		"accountId": "123456789012",
		"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
		"sessionContext": {
			"sessionIssuer": {
				"type": "Role",
				"principalId": "AKIAIOSFODNN7EXAMPLE",
				"arn": "arn:aws:iam::123456789012:role/Admin",
				"accountId": "123456789012",
				"userName": "ExampleUser"
			},
			"attributes": {
				"creationDate": "2023-08-21T19:20:49Z",
				"mfaAuthenticated": "false"
			}
		}
	},
	"eventTime": "2023-08-21T19:22:01Z",
	"eventSource": "sns.amazonaws.com",
	"eventName": "PublishBatch",
	"awsRegion": "us-east-1",
	"sourceIPAddress": "192.0.2.0",
	"userAgent": "aws-cli/1.29.16 md/Botocore#1.31.16 ua/2.0 os/linux#5.4.250-173.369.amzn2int.x86_64 md/arch#x86_64 lang/python#3.8.17 md/pyimpl#CPython cfg/retry-mode#legacy botocore/1.31.16",
	"requestParameters": {
		"topicArn": "arn:aws:sns:us-east-1:123456789012:ExampleSNSTopic",
		"publishBatchRequestEntries": [{
				"id": "1",
				"message": "HIDDEN_DUE_TO_SECURITY_REASONS"
			},
			{
				"id": "2",
				"message": "HIDDEN_DUE_TO_SECURITY_REASONS"
			}
		]
	},
	"responseElements": {
		"successful": [{
				"id": "1",
				"messageId": "30d68101-a64a-5573-9e10-dc5c1dd3af2f"
			},
			{
				"id": "2",
				"messageId": "c0aa0c5c-561d-5455-b6c4-5101ed84de09"
			}
		],
		"failed": []
	},
	"requestID": "e2cdf7f3-1b35-58ad-ac9e-aaaea0ace2f1",
	"eventID": "10da9a14-0154-4ab6-b3a5-1825b229a7ed",
	"readOnly": false,
	"resources": [{
		"accountId": "123456789012",
		"type": "AWS::SNS::Topic",
		"ARN": "arn:aws:sns:us-east-1:123456789012:ExampleSNSTopic"
	}],
	"eventType": "AwsApiCall",
	"managementEvent": false,
	"recipientAccountId": "123456789012",
	"eventCategory": "Data",
	"tlsDetails": {
		"tlsVersion": "TLSv1.2",
		"cipherSuite": "ECDHE-RSA-AES128-GCM-SHA256",
		"clientProvidedHostHeader": "sns.us-east-1.amazonaws.com"
	}
}

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Registro y monitorización

Monitoreo de los temas mediante Amazon CloudWatch