계정 수준 금지 목록 사용 - Amazon Simple Email Service

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

계정 수준 금지 목록 사용

Amazon SES에는 현재 리전의 계정에 적용되는 AWS계정 수준 금지 목록AWS이 포함되어 있습니다. 이 금지 목록은 이전에 반송 또는 수신 거부 이벤트가 발생한 주소로 이메일을 보내지 못하도록 합니다. 계정 수준 금지 목록을 구성할 때 하드 바운스가 발생하거나 수신 거부가 발생하거나 또는 둘 모두 발생하는 경우 주소를 목록에 추가해야 하는지 여부를 지정합니다. API v2를 사용하여 계정 수준 금지 목록에서 개별 또는 대량 주소를 수동으로 추가하거나 제거할 수 있습니다.Amazon SES

참고

주소를 대량으로 추가 또는 제거하려면 프로덕션 액세스 권한이 있어야 합니다. 샌드박스에 대한 자세한 내용은 단원을 참조하십시오.Amazon SES 샌드박스 환경에서 나가기.

Amazon SES에는 전역 금지 목록도 포함되어 있습니다. 자세한 내용은 단원을 참조하십시오.Amazon SES 전역 금지 목록 사용.

계정 수준 금지 목록 고려 사항

계정 수준 금지 목록을 사용하는 경우 다음 요소를 고려해야 합니다.

  • 2019년 11월 25일 이후에 Amazon SES를 사용하기 시작한 경우 계정은 반송 및 수신 거부 모두에 기본적으로 계정 수준 금지 목록을 사용합니다. 이 날짜 이전에 Amazon SES를 사용하기 시작한 경우 PutAccountSuppressionAttributes API의 Amazon SES 작업을 사용하여 이 기능을 활성화해야 합니다.

  • 계정 수준 금지 목록에 있는 주소로 메시지를 보내려고 시도하면 Amazon SES에서 메시지를 수락하지만 보내지는 않습니다.

  • Amazon SES는 계정 수준 금지 목록에 있는 주소로 보내는 메시지를 계정의 반송률로 계산하지 않습니다.

  • Amazon SES는 계정 수준 금지 목록에 있는 주소로 보내는 메시지를 일일 전송 할당량으로 계산합니다.

  • 계정 수준 금지 목록에 있는 이메일 주소는 API v2의 DeleteSuppressedDestinationAmazon SES 작업을 사용하여 제거할 때까지 목록에 남아 있습니다.

  • 계정의 이메일 전송 기능이 일시 중지되면 Amazon SES는 90일 후에 계정 수준 금지 목록에 있는 주소를 자동으로 삭제합니다. 이 90일 기간이 끝나기 전에 계정의 이메일 전송 기능이 복원되면 계정 수준 금지 목록에 있는 주소가 삭제되지 않습니다.

  • Gmail은 에 수신 거부 데이터를 제공하지 않습니다.Amazon SES. 수신자가 Gmail 웹 클라이언트의 Spam 버튼을 사용하여 사용자로부터 스팸으로 수신한 메시지를 보고하는 경우 계정 수준 금지 목록에 추가되지 않습니다.

  • 계정이 Amazon SES 샌드박스에 있는 경우 계정 수준 금지 목록을 활성화할 수 있습니다. 그러나 계정이 샌드박스에서 제거될 때까지 PutSuppressedDestination 또는 CreateImportJob 작업을 사용할 수 없습니다. 샌드박스에 대한 자세한 내용은 단원을 참조하십시오.Amazon SES 샌드박스 환경에서 나가기.

  • 계정 수준 금지 목록을 사용하는 경우 Amazon SES는 하드 바운스가 발생하는 주소도 전역 금지 목록에 추가합니다.

계정 수준 금지 목록 활성화

API v2에서 PutAccountSuppressionAttributes 작업을 사용하여 계정 수준 금지 목록을 활성화하고 설정할 수 있습니다.Amazon SES 를 사용하여 이 설정을 쉽고 빠르게 구성할 수 있습니다.AWS CLI. AWS CLI 설치 및 구성에 대한 자세한 내용은 AWS Command Line Interface 사용 설명서.를 참조하십시오.

를 사용하여 계정 수준 금지 목록을 구성하려면AWS CLI

  • 명령줄에 다음 명령을 입력합니다.

    Linux, macOS, or Unix
    aws sesv2 put-account-suppression-attributes \ --suppressed-reasons BOUNCE COMPLAINT
    Windows
    aws sesv2 put-account-suppression-attributes ` --suppressed-reasons BOUNCE COMPLAINT

    계정 수준 금지 목록을 활성화하려면 suppressed-reasons 파라미터에 대한 이유를 하나 이상 지정해야 합니다. 앞의 예와 같이 BOUNCE 또는 COMPLAINT 중 하나를 지정하거나 둘 모두 지정할 수 있습니다.

구성 세트에 대해 계정 수준 금지 목록 활성화

특정 구성 세트.에만 적용되도록 계정 수준 금지를 구성할 수도 있습니다. 이렇게 하면, 반송 또는 수신 거부 이벤트가 발생한 이메일을 보냈을 때 구성 세트를 지정한 경우에만 주소가 금지 목록에 추가됩니다.

참고

다음 절차에서는 를 이미 설치했다고 가정합니다.AWS CLI. AWS CLI 설치 및 구성에 대한 자세한 내용은 AWS Command Line Interface 사용 설명서.를 참조하십시오.

를 사용하여 구성 세트에 대한 계정 수준 금지 목록을 구성하려면AWS CLI

  • 명령줄에 다음 명령을 입력합니다.

    Linux, macOS, or Unix
    aws sesv2 put-configuration-set-suppression-options \ --configuration-set-name configSet \ --suppressed-reasons BOUNCE COMPLAINT
    Windows
    aws sesv2 put-configuration-set-suppression-options ` --configuration-set-name configSet ` --suppressed-reasons BOUNCE COMPLAINT

    이전 예제에서 을 바꿉니다.configSet 계정 수준 금지 목록을 사용해야 하는 구성 세트의 이름을 가진 .

계정 수준 금지 목록에 개별 이메일 주소 수동 추가

API v2의 PutSuppressedDestination 작업을 사용하여 계정 수준 금지 목록에 개별 주소를 수동으로 추가할 수 있습니다.Amazon SES 계정 수준 금지 목록에 추가할 수 있는 주소 수에는 제한이 없습니다.

참고

다음 절차에서는 를 이미 설치했다고 가정합니다.AWS CLI. AWS CLI 설치 및 구성에 대한 자세한 내용은 AWS Command Line Interface 사용 설명서.를 참조하십시오.

를 사용하여 계정 수준 금지 목록에 주소를 수동으로 추가하려면AWS CLI

  • 명령줄에 다음 명령을 입력합니다.

    Linux, macOS, or Unix
    aws sesv2 put-suppressed-destination \ --email-address recipient@example.com \ --reason BOUNCE
    Windows
    aws sesv2 put-suppressed-destination ` --email-address recipient@example.com ` --reason BOUNCE

    이전 예제에서 을 바꿉니다.recipient@example.com 계정 수준 금지 목록에 추가할 이메일 주소와 함께 BOUNCE 금지 목록에 주소를 추가하는 이유(허용되는 값은 BOUNCECOMPLAINT)를 가진 .

계정 수준 금지 목록에 대량으로 이메일 주소 추가

먼저 연락처 목록을 Amazon S3 객체에 업로드한 다음 API v2에서 CreateImportJob 작업을 사용하여 대량으로 주소를 수동으로 추가할 수 있습니다.Amazon SES

참고

계정 수준 금지 목록에 추가할 수 있는 주소 수에는 제한이 없지만 API 호출당 Amazon S3 객체에 있는 주소 수는 100,000개로 대량으로 제한됩니다.

계정 수준 금지 목록에 대량으로 이메일 주소를 추가하려면 다음 단계를 완료하십시오.

  • 주소 목록을 CSV 또는 JSON 형식의 Amazon S3 객체에 업로드합니다.

    주소 추가를 위한 CSV 형식의 예:

    recipient1@example.com,BOUNCE

    recipient2@example.com,COMPLAINT

    줄 바꿈으로 구분된 JSON 파일만 지원됩니다. 이 형식에서 각 줄은 개별 주소 정의가 포함된 완전한 JSON 객체입니다.

    주소 추가를 위한 JSON 형식의 예:

    {"emailAddress":"recipient1@example.com","reason":"BOUNCE"}

    {"emailAddress":"recipient2@example.com","reason":"COMPLAINT"}

    이전 예제에서 을 바꿉니다.recipient1@example.comrecipient2@example.com 계정 수준 금지 목록에 추가하려는 이메일 주소와 함께 . 금지 목록에 주소를 추가하는 경우 허용되는 이유는 BOUNCECOMPLAINT입니다.

  • 객체를 읽을 수 있는 권한을 Amazon SES에 부여합니다.Amazon S3

    버킷에 적용되는 경우 다음 정책은 해당 버킷을 읽을 수 있는 권한을 Amazon S3에 부여합니다.Amazon SES 버킷에 정책을 연결하는 방법에 대한 자세한 내용은 Amazon S3버킷 정책 및 사용자 정책 사용을 참조하십시오.Amazon Simple Storage Service 개발자 가이드

    { "Version": "2012-10-17", "Statement": [ { "Sid": "AllowSESGet", "Effect": "Allow", "Principal": { "Service": "ses.amazonaws.com" }, "Action": "s3:GetObject", "Resource": "arn:aws:s3:::BUCKET-NAME/OBJECT-NAME", "Condition": { "StringEquals": { "aws:Referer": "AWSACCOUNTID" } } } ] }
  • 에 AWS KMS 마스터 키를 사용할 권한을 부여합니다.Amazon SES

    객체가 AWS KMS 키로 암호화된 경우 Amazon S3Amazon SES Amazon SES 는 기본 마스터 키가 아닌 사용자 지정 마스터 키의 권한만 얻을 수 있습니다.Amazon SES 키의 정책에 문을 추가하여 사용자 지정 마스터 키를 사용할 수 있는 권한을 Amazon SES에 부여해야 합니다.

    다음 정책 설명을 키 정책에 붙여 넣어 Amazon SES가 사용자 지정 마스터 키를 사용하도록 허용합니다.

    { "Sid": "AllowSESToDecrypt", "Effect": "Allow", "Principal": { "Service":"ses.amazonaws.com" }, "Action": [ "kms:Decrypt", ], "Resource": "*" }
  • API v2에서 CreateImportJob 작업을 사용합니다.Amazon SES

참고

다음 절차에서는 를 이미 설치했다고 가정합니다.AWS CLI. AWS CLI 설치 및 구성에 대한 자세한 내용은 AWS Command Line Interface 사용 설명서.를 참조하십시오.

를 사용하여 계정 수준 금지 목록에 대량 주소를 수동으로 추가하려면AWS CLI

  • 명령줄에 다음 명령을 입력합니다.

    Linux, macOS, or Unix
    aws sesv2 create-import-job \ --import-destination "{\"SuppressionListDestination\": {\"SuppressionListImportAction\":\"PUT\"}}" \ --import-data-source "{\"S3Url\": \"s3://s3bucket/s3object\",\"DataFormat\": \"CSV\"}"
    Windows
    aws sesv2 create-import-job ` --import-destination "{\"SuppressionListDestination\": {\"SuppressionListImportAction\":\"PUT\"}}" ` --import-data-source "{\"S3Url\": \"s3://s3bucket/s3object\",\"DataFormat\": \"CSV\"}"

    이전 예제에서 을 바꿉니다.s3buckets3object 를 Amazon S3 버킷 이름과 Amazon S3 객체 이름으로 바꿉니다.

계정 수준 금지 목록에 있는 주소 목록 보기

API v2의 ListSuppressedDestinations 작업을 사용하여 계정의 계정 수준 금지 목록에 있는 모든 이메일 주소 목록을 볼 수 있습니다.Amazon SES

참고

다음 절차에서는 를 이미 설치했다고 가정합니다.AWS CLI. AWS CLI 설치 및 구성에 대한 자세한 내용은 AWS Command Line Interface 사용 설명서.를 참조하십시오.

계정 수준 금지 목록에 있는 모든 이메일 주소 목록을 보려면

  • 명령줄에 다음 명령을 입력합니다.

    aws sesv2 list-suppressed-destinations

위의 명령은 계정의 계정 수준 금지 목록에 있는 모든 이메일 주소를 반환합니다. 출력은 다음 예제와 같이 유사합니다.

{ "SuppressedDestinationSummaries": [ { "EmailAddress": "recipient2@example.com", "Reason": "COMPLAINT", "LastUpdateTime": 1586552585.077 }, { "EmailAddress": "recipient0@example.com", "Reason": "COMPLAINT", "LastUpdateTime": 1586552666.613 }, { "EmailAddress": "recipient1@example.com", "Reason": "BOUNCE", "LastUpdateTime": 1586556479.141 } ] }

옵션을 사용하여 특정 날짜 StartDate이후 목록에 추가된 이메일 주소만 표시할 수 있습니다.

특정 날짜 이후 계정 수준 금지 목록에 추가된 주소 목록을 보려면

  • 명령줄에 다음 명령을 입력합니다.

    aws sesv2 list-suppressed-destinations --start-date 1604394130

    위의 명령에서 를 바꿉니다.1604394130 을 시작 날짜의 Unix 타임스탬프로 바꿉니다.

옵션을 사용하여 특정 날짜 EndDate이전 목록에 추가된 이메일 주소만 표시할 수도 있습니다.

특정 날짜 이전 계정 수준 금지 목록에 추가된 주소 목록을 보려면

  • 명령줄에 다음 명령을 입력합니다.

    aws sesv2 list-suppressed-destinations --end-date 1611126000

    위의 명령에서 를 바꿉니다.1611126000 를 종료 날짜의 Unix 타임스탬프로 바꿉니다.

Linux, macOS, or Unix 명령줄에서 기본 제공 grep 유틸리티를 사용하여 특정 주소 또는 도메인을 검색할 수도 있습니다.

계정 수준 금지 목록에서 특정 주소를 검색하려면

  • 명령줄에 다음 명령을 입력합니다.

    aws sesv2 list-suppressed-destinations | grep -A2 'example.com'

    위의 명령에서 를 바꿉니다.example.com 을 검색할 텍스트 문자열(예: 주소 또는 도메인)로 바꿉니다.

계정 수준 금지 목록에서 이메일 주소 제거

주소가 계정에 대한 금지 목록에 있지만 주소가 목록에 없어야 한다는 것을 알고 있는 경우 API v2의 DeleteSuppressedDestinationAmazon SES 작업을 사용하여 수동으로 제거할 수 있습니다.

참고

다음 절차에서는 를 이미 설치했다고 가정합니다.AWS CLI. AWS CLI 설치 및 구성에 대한 자세한 내용은 AWS Command Line Interface 사용 설명서.를 참조하십시오.

를 사용하여 계정 수준 금지 목록에서 주소를 제거하려면AWS CLI

  • 명령줄에 다음 명령을 입력합니다.

    Linux, macOS, or Unix
    aws sesv2 delete-suppressed-destination \ --email-address recipient@example.com
    Windows
    aws sesv2 delete-suppressed-destination ` --email-address recipient@example.com

    이전 예제에서 을 바꿉니다.recipient@example.com 계정 수준 금지 목록에서 제거할 이메일 주소를 가진 .

계정 수준 금지 목록에서 대량으로 이메일 주소 제거

먼저 연락처 목록을 Amazon S3 객체에 업로드한 다음 API v2에서 CreateImportJobAmazon SES 작업을 사용하여 대량으로 주소를 수동으로 제거할 수 있습니다.

참고

계정 수준 금지 목록에서 제거할 수 있는 주소 수에는 제한이 없지만 API 호출당 Amazon S3 객체에 있는 주소의 대량 삭제 한도는 10,000개입니다.

계정 수준 금지 목록에서 대량으로 이메일 주소를 제거하려면 다음 단계를 완료하십시오.

  • 주소 목록을 CSV 또는 JSON 형식의 Amazon S3 객체에 업로드합니다.

    주소를 제거하는 CSV 형식의 예:

    recipient3@example.com

    줄 바꿈으로 구분된 JSON 파일만 지원됩니다. 이 형식에서 각 줄은 개별 주소 정의가 포함된 완전한 JSON 객체입니다.

    주소 추가를 위한 JSON 형식의 예:

    {"emailAddress":"recipient3@example.com"}

    이전 예제에서 을 바꿉니다.recipient3@example.com 계정 수준 금지 목록에서 제거하려는 이메일 주소를 포함하는 .

  • 객체를 읽을 수 있는 권한을 Amazon SES에 부여합니다.Amazon S3

    버킷에 적용되는 경우 다음 정책은 해당 버킷을 읽을 수 있는 권한을 Amazon S3에 부여합니다.Amazon SES 버킷에 정책을 연결하는 방법에 대한 자세한 내용은 Amazon S3버킷 정책 및 사용자 정책 사용을 참조하십시오.Amazon Simple Storage Service 개발자 가이드

    { "Version": "2012-10-17", "Statement": [ { "Sid": "AllowSESGet", "Effect": "Allow", "Principal": { "Service": "ses.amazonaws.com" }, "Action": "s3:GetObject", "Resource": "arn:aws:s3:::BUCKET-NAME/OBJECT-NAME", "Condition": { "StringEquals": { "aws:Referer": "AWSACCOUNTID" } } } ] }
  • 에 AWS KMS 마스터 키를 사용할 권한을 부여합니다.Amazon SES

    객체가 AWS KMS 키로 암호화된 경우 Amazon S3Amazon SES Amazon SES 는 기본 마스터 키가 아닌 사용자 지정 마스터 키의 권한만 얻을 수 있습니다.Amazon SES 키의 정책에 문을 추가하여 사용자 지정 마스터 키를 사용할 수 있는 권한을 Amazon SES에 부여해야 합니다.

    다음 정책 설명을 키 정책에 붙여 넣어 Amazon SES가 사용자 지정 마스터 키를 사용하도록 허용합니다.

    { "Sid": "AllowSESToDecrypt", "Effect": "Allow", "Principal": { "Service":"ses.amazonaws.com" }, "Action": [ "kms:Decrypt", ], "Resource": "*" }
  • API v2에서 CreateImportJob 작업을 사용합니다.Amazon SES

참고

다음 절차에서는 를 이미 설치했다고 가정합니다.AWS CLI. AWS CLI 설치 및 구성에 대한 자세한 내용은 AWS Command Line Interface 사용 설명서.를 참조하십시오.

를 사용하여 계정 수준 금지 목록에서 대량 주소를 수동으로 제거하려면AWS CLI

  • 명령줄에 다음 명령을 입력합니다.

    Linux, macOS, or Unix
    aws sesv2 create-import-job \ --import-destination "{\"SuppressionListDestination\": {\"SuppressionListImportAction\":\"DELETE\"}}" \ --import-data-source "{\"S3Url\": \"s3://s3bucket/s3object\",\"DataFormat\": \"CSV\"}"
    Windows
    aws sesv2 create-import-job ` --import-destination "{\"SuppressionListDestination\": {\"SuppressionListImportAction\":\"DELETE\"}}" ` --import-data-source "{\"S3Url\": \"s3://s3bucket/s3object\",\"DataFormat\": \"CSV\"}"

    이전 예제에서 을 바꿉니다.s3buckets3object 를 Amazon S3 버킷 이름과 Amazon S3 객체 이름으로 바꿉니다.

계정에 대한 가져오기 작업 목록 보기

API v2의 ListImportJobs 작업을 사용하여 계정의 계정 수준 금지 목록에 있는 모든 이메일 주소 목록을 볼 수 있습니다.Amazon SES

참고

다음 절차에서는 를 이미 설치했다고 가정합니다.AWS CLI. AWS CLI 설치 및 구성에 대한 자세한 내용은 AWS Command Line Interface 사용 설명서.를 참조하십시오.

계정에 대한 모든 가져오기 작업의 목록을 보려면

  • 명령줄에 다음 명령을 입력합니다.

    aws sesv2 list-import-jobs

위의 명령은 계정에 대한 모든 가져오기 작업을 반환합니다. 출력은 다음 예제와 같이 유사합니다.

{ "ImportJobs": [ { "CreatedTimestamp": 1596175615.804, "ImportDestination": { "SuppressionListDestination": { "SuppressionListImportAction": "PUT" } }, "JobStatus": "COMPLETED", "JobId": "755380d7-fbdb-4ed2-a9a3-06866220f5b5" }, { "CreatedTimestamp": 1596134732.398, "ImportDestination": { "SuppressionListDestination": { "SuppressionListImportAction": "DELETE" } }, "JobStatus": "COMPLETED", "JobId": "076683bd-a7ee-4a40-9754-4ad1161ba8b6" }, { "CreatedTimestamp": 1596645918.134, "ImportDestination": { "SuppressionListDestination": { "SuppressionListImportAction": "PUT" } }, "JobStatus": "COMPLETED", "JobId": "6e261869-bd30-4b33-b1f2-9e035a83a395" } ] }

계정의 가져오기 작업에 대한 정보 가져오기

API v2의 GetImportJob 작업을 사용하여 계정의 가져오기 작업에 대한 정보를 가져올 수 있습니다.Amazon SES

참고

다음 절차에서는 를 이미 설치했다고 가정합니다.AWS CLI. AWS CLI 설치 및 구성에 대한 자세한 내용은 AWS Command Line Interface 사용 설명서.를 참조하십시오.

계정의 가져오기 작업에 대한 정보를 가져오려면

  • 명령줄에 다음 명령을 입력합니다.

    aws sesv2 get-import-job --job-id JobId

위의 명령은 계정의 가져오기 작업에 대한 정보를 반환합니다. 출력은 다음 예제와 같이 유사합니다.

{ "ImportDataSource": { "S3Url": "s3://bucket/object", "DataFormat": "CSV" }, "ProcessedRecordsCount": 2, "FailureInfo": { "FailedRecordsS3Url": "s3presignedurl" }, "JobStatus": "COMPLETED", "JobId": "jobid", "CreatedTimestamp": 1597251915.243, "FailedRecordsCount": 1, "ImportDestination": { "SuppressionListDestination": { "SuppressionListImportAction": "PUT" } }, "CompletedTimestamp": 1597252002.583 }

계정 수준 금지 목록 비활성화

API v2에서 PutAccountSuppressionAttributes 작업을 사용하여 Amazon SES 속성에서 값을 제거하여 계정 수준 금지 목록을 효과적으로 비활성화할 수 있습니다.suppressed-reasons

참고

다음 절차에서는 를 이미 설치했다고 가정합니다.AWS CLI. AWS CLI 설치 및 구성에 대한 자세한 내용은 AWS Command Line Interface 사용 설명서.를 참조하십시오.

를 사용하여 계정 수준 금지 목록을 비활성화하려면AWS CLI

  • 명령줄에 다음 명령을 입력합니다.

    aws sesv2 put-account-suppression-attributes --suppressed-reasons