를 사용하여 Amazon SNS API 통화 로깅 CloudTrail - Amazon Simple Notification Service
의 Amazon SNS 정보 CloudTrail의 제어 영역 이벤트 CloudTrail의 데이터 영역 이벤트 CloudTrail예: Amazon SNS 로그 파일 항목

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

를 사용하여 Amazon SNS API 통화 로깅 CloudTrail

AmazonSNS은 사용자 AWS CloudTrail, 역할 또는 서비스가 Amazon 에서 수행한 작업의 레코드를 제공하는 AWS 서비스인 와 통합됩니다SNS. 는 Amazon에 대한 API 호출을 이벤트SNS로 CloudTrail 캡처합니다. 캡처된 호출에는 Amazon SNS 콘솔의 호출과 Amazon SNS API 작업에 대한 코드 호출이 포함됩니다. 추적을 생성하는 경우 Amazon 에 CloudTrail 대한 이벤트를 포함하여 Amazon S3 버킷으로 이벤트를 지속적으로 전송할 수 있습니다SNS. Amazon S3 추적을 구성하지 않은 경우에도 CloudTrail 콘솔의 이벤트 기록 에서 최신 이벤트를 볼 수 있습니다. 에서 수집한 정보를 사용하여 Amazon 에 수행된 요청 CloudTrail, 요청이 수행된 SNSIP 주소, 요청을 수행한 사람, 요청이 수행된 시간 및 추가 세부 정보를 확인할 수 있습니다.

구성 및 활성화 방법을 CloudTrail포함하여 에 대한 자세한 내용은 AWS CloudTrail 사용 설명서 섹션을 참조하세요.

의 Amazon SNS 정보 CloudTrail

CloudTrail 계정을 생성할 AWS 계정 때 에서 가 활성화됩니다. Amazon 에서 지원되는 이벤트 활동이 발생하면 SNS해당 활동은 CloudTrail 이벤트 기록 의 다른 AWS 서비스 이벤트와 함께 이벤트에 기록됩니다. 에서 최근 이벤트를 보고 검색하고 다운로드할 수 있습니다 AWS 계정. 자세한 내용은 이벤트 기록을 사용하여 CloudTrail 이벤트 보기를 참조하세요.

Amazon 에 대한 이벤트를 AWS 계정포함하여 에서 이벤트의 지속적인 기록을 위해 추적을 SNS생성합니다. 추적을 사용하면 CloudTrail 가 Amazon S3 버킷에 로그 파일을 전달할 수 있습니다. 기본적으로 콘솔에서 추적을 생성하면 추적이 모든 AWS 리전에 적용됩니다. 추적은 AWS 파티션의 모든 리전에서 이벤트를 기록하고 지정한 Amazon S3 버킷에 로그 파일을 전달합니다. 또한 CloudTrail 로그에서 수집된 이벤트 데이터를 추가로 분석하고 이에 따라 작업하도록 다른 AWS 서비스를 구성할 수 있습니다. 자세한 내용은 다음 자료를 참조하십시오.

의 제어 영역 이벤트 CloudTrail

Amazon은 다음 작업을 CloudTrail 로그 파일에 이벤트로 로깅할 수 있도록 SNS 지원합니다.

참고

Amazon Web Services(인증되지 않은 모드)에 로그인하지 않고 ConfirmSubscription 또는 구독 취소 작업이 호출되면 에 로깅되지 않습니다 CloudTrail. 따라서 주제에 대해 대기 중인 구독을 확인하기 위해 이메일 알림에 포함된 링크를 선택하면 ConfirmSubscription 작업이 비인증 모드에서 호출됩니다. 이 예제에서는 ConfirmSubscription 작업이 에 기록되지 않습니다 CloudTrail.

모든 이벤트 및 로그 항목에는 요청을 생성한 사용자에 대한 정보가 들어 있습니다. 보안 인증 정보를 이용하면 다음을 쉽게 판단할 수 있습니다.

  • 요청이 루트 또는 AWS Identity and Access Management (IAM) 사용자 자격 증명으로 이루어졌는지 여부.

  • 역할 또는 페더레이션 사용자에 대한 임시 보안 보안 인증을 사용하여 요청이 생성되었는지 여부.

  • 다른 AWS 서비스에서 요청을 했는지 여부.

자세한 내용은 CloudTrail userIdentity 요소를 참조하세요.

의 데이터 영역 이벤트 CloudTrail

CloudTrail 파일에서 다음 API 작업의 로깅을 활성화하려면 에서 데이터 영역 API 활동 로깅을 활성화해야 합니다 CloudTrail. 자세한 내용을 알아보려면 AWS CloudTrail 사용 설명서의 데이터 이벤트 로깅을 참조하십시오.

또한 데이터 영역 이벤트를 리소스 유형별로 필터링하여 에서 선택적으로 로그하고 지불하려는 Amazon SNS API 호출을 세부적으로 제어할 수 있습니다 CloudTrail. 예를 들어 를 리소스 유형AWS::SNS::Topic으로 지정하여 주제에 대한 및 Publish PublishBatch API 작업을 에 로깅할 수 있습니다. 마찬가지로 를 리소스 유형AWS::SNS::PlatformEndpoint으로 지정하여 플랫폼 엔드포인트에 대한 게시 API 작업에 호출을 로깅할 수 있습니다. 자세한 내용은 참조AdvancedEventSelector의 섹션을 참조하세요 AWS CloudTrail API.

참고

Amazon SNS 리소스 유형은 에서 기록AWS::SNS::PhoneNumber하지 않습니다 CloudTrail.

Amazon SNS 데이터 영역 APIs

예: Amazon SNS 로그 파일 항목

추적은 사용자가 지정한 Amazon S3 버킷에 로그 파일로 이벤트를 전달할 수 있도록 하는 구성입니다. CloudTrail 로그 파일에는 하나 이상의 로그 항목이 포함됩니다. 이벤트는 모든 소스로부터의 단일 요청을 나타내며 요청 작업, 작업 날짜와 시간, 요청 파라미터 등에 대한 정보가 들어 있습니다. CloudTrail 로그 파일은 퍼블릭 API 호출의 순서가 지정된 스택 추적이 아니므로 특정 순서로 표시되지 않습니다.

다음 예제에서는 ListTopics, CreateTopic및 DeleteTopic 작업을 보여주는 CloudTrail 로그 항목을 보여줍니다.

{
  "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"
    },
  ]
}

다음 예제에서는 Publish 및 PublishBatch 작업을 보여주는 CloudTrail 로그 항목을 보여줍니다.

게시

{
	"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"
	}
}