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

# 이메일 검증 API
<a name="email-validation-api"></a>

API 검증을 사용하면 API 직접 호출을 통해 개별 이메일 주소를 검증하여 주소 유효성, 전달 가능성 및 위험 요인에 대한 즉각적인 피드백을 제공할 수 있습니다. 이 기능은 사용자 등록, 구독 양식 또는 적시에 검증 결과가 필요한 기타 시나리오와 같이 수집 시점의 주소를 검증하도록 설계되었습니다.

API 검증은 구문 검증, 도메인 확인, 사서함 존재 확인 등을 포함하여 각 이메일 주소에 대해 여러 검사를 수행합니다. 검증 결과에는 전체 유효성 및 개별 평가에 대한 신뢰도 결정(HIGH, MEDIUM 또는 LOW)이 포함됩니다.

**검증 검사 수행**  
API 검증은 각 이메일 주소에 대해 다음 평가를 수행합니다.
+ **구문 검증('HasValidSyntax')** - 이메일 주소가 적절한 RFC 표준을 따르고 올바른 형식의 유효한 문자를 포함하는지 확인합니다.
+ **DNS 레코드('HasValidDnsRecords')** - 도메인이 존재하는지, 유효한 DNS 레코드가 있는지, 이메일을 수신하도록 구성되어 있는지 확인합니다.
+ **사서함 존재('MailboxExists')** - 사서함이 존재하는지 확인하고 실제로 이메일을 보내지 않고도 메시지를 수신할 수 있습니다.
+ **역할 주소('IsRoleAddress')** - 참여율이 낮을 수 있는 역할 기반 주소(예: admin@, support@ 또는 info@)를 식별합니다.
+ **일회용 도메인('IsDisposable')** - 발신자 평판에 부정적인 영향을 미칠 수 있는 일회용 또는 임시 이메일 주소를 확인합니다.
+ **임의 문자열 패턴('IsRandomInput')** - 무작위로 생성된 패턴을 확인합니다.

## Amazon SES 콘솔에서 API 검증 사용
<a name="email-validation-api-console"></a>

다음 절차에서는 Amazon SES 콘솔을 사용하여 이메일 주소를 검증하는 방법을 보여줍니다.

**Amazon SES 콘솔을 사용하여 이메일 주소를 검증하려면**

1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/) Amazon SES 콘솔을 엽니다.

1. 왼쪽 탐색 창의 **이메일 검증에서 이메일 주소** **검증**을 선택합니다.

1. **이메일 주소 확인** 섹션의 이메일 주소 필드에 확인하려는 **이메일 주소를** 입력합니다.

1. **검증**을 선택합니다.

   검증 결과는 **검증 결과** 패널에 나타나며 다음을 보여줍니다.
   + **IsValid** - 신뢰도 결정(HIGH, MEDIUM 또는 LOW)이 포함된 전체 유효성.
   + **평가** - 구문, DNS 레코드, 메일박스 존재 및 위에 나열된 위험 요인에 대한 신뢰도 판단이 포함된 개별 평가 결과입니다.

## 에서 API 검증 사용 AWS CLI
<a name="email-validation-api-cli"></a>

다음 예제에서는를 사용하여 이메일 주소를 검증하는 방법을 보여줍니다 AWS CLI.

**를 사용하여 이메일 주소를 검증하려면 AWS CLI**  
Amazon SES API v2에서 [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetEmailAddressInsights.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetEmailAddressInsights.html) 작업을 사용하여 이메일 주소를 검증할 수 있습니다. 다음 예제와 AWS CLI같이에서이 작업을 호출할 수 있습니다.
+ 단일 이메일 주소를 검증합니다.

  ```
  aws --region us-east-1 sesv2 get-email-address-insights --email-address user@example.com
  ```
+ 다음과 비슷한 응답이 반환됩니다.

  ```
  {
      "MailboxValidation": {
          "IsValid": {
              "ConfidenceVerdict": "HIGH"
          },
          "Evaluations": {
              "HasValidSyntax": {
                  "ConfidenceVerdict": "HIGH"
              },
              "HasValidDnsRecords": {
                  "ConfidenceVerdict": "MEDIUM"
              },
              "MailboxExists": {
                  "ConfidenceVerdict": "MEDIUM"
              },
              "IsRoleAddress": {
                  "ConfidenceVerdict": "LOW"
              },
              "IsDisposable": {
                  "ConfidenceVerdict": "LOW"
              },
              "IsRandomInput": {
                  "ConfidenceVerdict": "LOW"
              }
          }
      }
  }
  ```
+ 응답 값 및 데이터 형식에 대한 자세한 내용은 Amazon SES API v2 참조의 [https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MailboxValidation.html](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_MailboxValidation.html) 데이터 형식을 참조하세요.
+ IAM 자격 증명에 이메일 검증 API 호출 및 CloudWatch 지표 게시에 필요한 권한이 있는지 확인합니다.

  ```
  {
    "Version": "2012-10-17		 	 	 ",
    "Statement": [
      {
        "Sid": "EmailValidationPermissions",
        "Effect": "Allow",
        "Action": [
          "ses:GetEmailAddressInsights",
          "iam:CreateServiceLinkedRole"
        ],
        "Resource": "*"
      }
    ]
  }
  ```

  API 검증 호출에는 `GetEmailAddressInsights` 권한이 필요하며 검증 활동을 위해 CloudWatch 지표 게시를 `CreateServiceLinkedRole` 활성화합니다.

**검증 결과 해석**  
검증 응답에는 이메일 주소에 대한 결정을 내리는 데 도움이 되는 신뢰도 판단이 포함되어 있습니다.
+ `IsValid` - 신뢰도가 HIGH, MEDIUM 또는 LOW인 전체 유효성 평가. 높은 유효성 신뢰도는 이메일 주소의 높은 전송 가능성을 나타내고, 중간은 중간 수준의 전송 가능성을 나타내며, 낮음은 낮은 전송 가능성을 나타냅니다.
+ `Evaluations` - 개별 평가 결과, 각각 신뢰도 결정:
  + `HIGH` - 특정 검사를 강력하게 나타냅니다(예: HIGH for IsRandomInput은 이메일이 무작위로 생성될 가능성이 높음을 의미함).
  + `MEDIUM` - 특정 검사의 중간 표시(예: IsRandomInput용 MEDIUM은 이메일 주소가 무작위로 생성될 가능성이 있음을 의미함).
  + `LOW` - 특정 검사가 약하거나 표시되지 않음(예: IsRandomInput의 경우 LOW는 이메일 주소가 무작위로 생성될 가능성이 낮음).