아마존 SES 아이덴티티 관리 - AWS SDK for JavaScript
시나리오사전 필수 작업자격 증명 나열이메일 주소 자격 증명 확인도메인 자격 증명 확인자격 증명 삭제

AWS SDK for JavaScript V3 API 참조 안내서는 AWS SDK for JavaScript 버전 3(V3)의 모든 API 작업을 자세히 설명합니다.

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

아마존 SES 아이덴티티 관리

JavaScript code example that applies to Node.js execution

이 Node.js 코드 예제는 다음을 보여 줍니다.

  • SESAmazon에서 사용하는 이메일 주소 및 도메인을 확인하는 방법

  • Amazon SES ID에 AWS Identity and Access Management (IAM) 정책을 할당하는 방법.

  • AWS 계정의 모든 Amazon SES ID를 나열하는 방법

  • SESAmazon에서 사용하는 ID를 삭제하는 방법.

Amazon SES ID는 Amazon이 이메일을 보내는 데 SES 사용하는 이메일 주소 또는 도메인입니다. Amazon은 이메일 ID를 확인하여 이메일 ID를 소유하고 있음을 확인하고 다른 사람이 사용하지 못하도록 SES 요구합니다.

Amazon에서 이메일 주소 및 도메인을 확인하는 방법에 대한 자세한 내용은 Amazon SES Simple Email Service 개발자 안내서의 SESAmazon의 이메일 주소 및 도메인 확인을 참조하십시오. Amazon에서의 전송 승인에 대한 자세한 내용은 Amazon SES SES 전송 승인 개요를 참조하십시오.

시나리오

이 예시에서는 일련의 Node.js 모듈을 사용하여 Amazon SES ID를 확인하고 관리합니다. Node.js 모듈은 SES 클라이언트 클래스의 다음 메서드를 사용하여 양식을 사용하여 이메일 주소와 도메인을 확인합니다. SDK JavaScript

사전 필수 작업

이 예제를 설정하고 실행하려면 먼저 이러한 작업들을 완료해야 합니다.

  • 이러한 노드 TypeScript 예제를 실행하도록 프로젝트 환경을 설정하고 필수 AWS SDK for JavaScript 모듈과 타사 모듈을 설치합니다. 의 지침을 따르십시오 GitHub.

  • 사용자 자격 증명을 사용하여 공유 구성 파일을 생성합니다. 공유 자격 증명 파일을 제공하는 방법에 대한 자세한 내용은 및 도구 참조 안내서의 공유 구성AWS SDKs 및 자격 증명 파일을 참조하십시오.

중요

이 예제는 () 를 사용하여 ECMAScript6 클라이언트 서비스 개체 및 명령을 가져오거나 내보내는 방법을 보여줍니다. ES6

  • 따라서 Node.js 버전 13.x 이상이 필요합니다. 최신 버전의 Node.js를 다운로드하여 설치하려면 Node.js downloads를 참조하세요.

  • CommonJS 구문을 사용하려는 경우 JavaScript ES6/CommonJS 구문 단원을 참조하세요.

자격 증명 나열

이 예시에서는 Node.js 모듈을 사용하여 Amazon에서 사용할 이메일 주소와 도메인을 SES 나열합니다.

libs 디렉터리를 생성하고 파일 이름이 sesClient.js인 Node.js 모듈을 생성합니다. 아래 코드를 복사하여 붙여넣으면 Amazon SES 클라이언트 객체가 생성됩니다. Replace REGION 해당 AWS 지역과 함께.

import { SESClient } from "@aws-sdk/client-ses";
// Set the AWS Region.
const REGION = "us-east-1";
// Create SES service object.
const sesClient = new SESClient({ region: REGION });
export { sesClient };

이 예제 코드는 여기 에서 찾을 수 GitHub 있습니다.

파일 이름이 ses_listidentities.js인 Node.js 모듈을 생성합니다. 필수 클라이언트 및 패키지 설치를 포함하여 위에 표시된 SDK 대로 구성합니다.

SES 클라이언트 클래스의 ListIdentitiesCommand 메서드에 대한 IdentityType 및 기타 파라미터를 전달할 객체를 생성합니다. ListIdentitiesCommand메서드를 호출하려면 Amazon SES 서비스 객체를 호출하고 매개변수 객체를 전달하십시오.

반환된 data에는 IdentityType 파라미터로 지정된 도메인 자격 증명 배열이 포함되어 있습니다.

참고

Replace IdentityType ID 유형을 사용할 수 있으며, ID 유형은 "EmailAddress" 또는 “도메인”일 수 있습니다.

import { ListIdentitiesCommand } from "@aws-sdk/client-ses";
import { sesClient } from "./libs/sesClient.js";

const createListIdentitiesCommand = () =>
  new ListIdentitiesCommand({ IdentityType: "EmailAddress", MaxItems: 10 });

const run = async () => {
  const listIdentitiesCommand = createListIdentitiesCommand();

  try {
    return await sesClient.send(listIdentitiesCommand);
  } catch (err) {
    console.log("Failed to list identities.", err);
    return err;
  }
};

예를 실행하려면 명령 프롬프트에서 다음을 입력합니다.

node ses_listidentities.js

이 예제 코드는 여기 에서 찾을 수 GitHub 있습니다.

이메일 주소 자격 증명 확인

이 예시에서는 Node.js 모듈을 사용하여 SES Amazon에서 사용할 이메일 발신자를 확인합니다.

libs 디렉터리를 생성하고 파일 이름이 sesClient.js인 Node.js 모듈을 생성합니다. 아래 코드를 복사하여 붙여넣으면 Amazon SES 클라이언트 객체가 생성됩니다. Replace REGION 해당 AWS 지역과 함께.

import { SESClient } from "@aws-sdk/client-ses";
// Set the AWS Region.
const REGION = "us-east-1";
// Create SES service object.
const sesClient = new SESClient({ region: REGION });
export { sesClient };

이 예제 코드는 여기 에서 찾을 수 GitHub 있습니다.

파일 이름이 ses_verifyemailidentity.js인 Node.js 모듈을 생성합니다. 필요한 클라이언트 및 패키지 다운로드를 포함하여 위에 표시된 SDK 대로 구성합니다.

SES 클라이언트 클래스의 VerifyEmailIdentityCommand 메서드에 대한 EmailAddress 파라미터를 전달할 객체를 생성합니다. VerifyEmailIdentityCommand메서드를 호출하려면 파라미터를 전달하여 Amazon SES 클라이언트 서비스 객체를 호출하십시오.

참고

Replace EMAIL_ADDRESS 이메일 주소를 입력하세요 (예: name@example.com).

// Import required AWS SDK clients and commands for Node.js
import { VerifyEmailIdentityCommand } from "@aws-sdk/client-ses";
import { sesClient } from "./libs/sesClient.js";

const EMAIL_ADDRESS = "name@example.com";

const createVerifyEmailIdentityCommand = (emailAddress) => {
  return new VerifyEmailIdentityCommand({ EmailAddress: emailAddress });
};

const run = async () => {
  const verifyEmailIdentityCommand =
    createVerifyEmailIdentityCommand(EMAIL_ADDRESS);
  try {
    return await sesClient.send(verifyEmailIdentityCommand);
  } catch (err) {
    console.log("Failed to verify email identity.", err);
    return err;
  }
};

예를 실행하려면 명령 프롬프트에서 다음을 입력합니다. 도메인은 검증을 SES 위해 Amazon에 추가됩니다.

node ses_verifyemailidentity.js

이 예제 코드는 여기에서 찾을 수 있습니다 GitHub.

도메인 자격 증명 확인

이 예시에서는 Node.js 모듈을 사용하여 Amazon에서 사용할 이메일 도메인을 확인합니다SES.

libs 디렉터리를 생성하고 파일 이름이 sesClient.js인 Node.js 모듈을 생성합니다. 아래 코드를 복사하여 붙여넣으면 Amazon SES 클라이언트 객체가 생성됩니다. Replace REGION 해당 AWS 지역과 함께.

import { SESClient } from "@aws-sdk/client-ses";
// Set the AWS Region.
const REGION = "us-east-1";
// Create SES service object.
const sesClient = new SESClient({ region: REGION });
export { sesClient };

이 예제 코드는 여기 에서 찾을 수 GitHub 있습니다.

파일 이름이 ses_verifydomainidentity.js인 Node.js 모듈을 생성합니다. 필수 클라이언트 및 패키지 설치를 포함하여 위에 표시된 SDK 대로 구성합니다.

SES 클라이언트 클래스의 VerifyDomainIdentityCommand 메서드에 대한 Domain 파라미터를 전달할 객체를 생성합니다. VerifyDomainIdentityCommand메서드를 호출하려면 Amazon SES 클라이언트 서비스 객체를 호출하고 매개변수 객체를 전달하십시오.

참고

이 예제에서는 필수 AWS Service V3 패키지 클라이언트, V3 명령을 가져와서 사용하고 send 메서드를 async/await 패턴으로 사용합니다. 대신 몇 가지 사소한 변경을 통해 V2 명령을 사용하여 이 예를 생성할 수 있습니다. 세부 정보는 v3 명령 사용을 참조하세요.

참고

Replace DOMAIN_NAME 도메인 이름과 함께.

import { VerifyDomainIdentityCommand } from "@aws-sdk/client-ses";
import {
  getUniqueName,
  postfix,
} from "@aws-doc-sdk-examples/lib/utils/util-string.js";
import { sesClient } from "./libs/sesClient.js";

/**
 * You must have access to the domain's DNS settings to complete the
 * domain verification process.
 */
const DOMAIN_NAME = postfix(getUniqueName("Domain"), ".example.com");

const createVerifyDomainIdentityCommand = () => {
  return new VerifyDomainIdentityCommand({ Domain: DOMAIN_NAME });
};

const run = async () => {
  const VerifyDomainIdentityCommand = createVerifyDomainIdentityCommand();

  try {
    return await sesClient.send(VerifyDomainIdentityCommand);
  } catch (err) {
    console.log("Failed to verify domain.", err);
    return err;
  }
};

예를 실행하려면 명령 프롬프트에서 다음을 입력합니다. 도메인은 검증을 SES 위해 Amazon에 추가됩니다.

node ses_verifydomainidentity.js

이 예제 코드는 여기에서 찾을 수 있습니다 GitHub.

자격 증명 삭제

이 예시에서는 Node.js 모듈을 사용하여 Amazon에서 사용하는 이메일 주소 또는 도메인을 삭제합니다SES.

libs 디렉터리를 생성하고 파일 이름이 sesClient.js인 Node.js 모듈을 생성합니다. 아래 코드를 복사하여 붙여넣으면 Amazon SES 클라이언트 객체가 생성됩니다. Replace REGION 해당 AWS 지역과 함께.

import { SESClient } from "@aws-sdk/client-ses";
// Set the AWS Region.
const REGION = "us-east-1";
// Create SES service object.
const sesClient = new SESClient({ region: REGION });
export { sesClient };

이 예제 코드는 여기 에서 찾을 수 GitHub 있습니다.

파일 이름이 ses_deleteidentity.js인 Node.js 모듈을 생성합니다. 필수 클라이언트 및 패키지 설치를 포함하여 위에 표시된 SDK 대로 구성합니다.

SES 클라이언트 클래스의 DeleteIdentityCommand 메서드에 대한 Identity 파라미터를 전달할 객체를 생성합니다. DeleteIdentityCommand메서드를 호출하려면 Amazon SES 클라이언트 서비스 객체를 호출하기 request 위한 를 생성하여 파라미터를 전달하십시오.

참고

이 예제에서는 필수 AWS Service V3 패키지 클라이언트와 V3 명령을 가져와서 사용하고 send 메서드를 async/await 패턴으로 사용합니다. 대신 몇 가지 사소한 변경을 통해 V2 명령을 사용하여 이 예를 생성할 수 있습니다. 세부 정보는 v3 명령 사용을 참조하세요.

참고

Replace IDENTITY_EMAIL 삭제하려는 ID의 이메일과 함께.

import { DeleteIdentityCommand } from "@aws-sdk/client-ses";
import { sesClient } from "./libs/sesClient.js";

const IDENTITY_EMAIL = "fake@example.com";

const createDeleteIdentityCommand = (identityName) => {
  return new DeleteIdentityCommand({
    Identity: identityName,
  });
};

const run = async () => {
  const deleteIdentityCommand = createDeleteIdentityCommand(IDENTITY_EMAIL);

  try {
    return await sesClient.send(deleteIdentityCommand);
  } catch (err) {
    console.log("Failed to delete identity.", err);
    return err;
  }
};

예를 실행하려면 명령 프롬프트에서 다음을 입력합니다.

node ses_deleteidentity.js

이 예제 코드는 여기에서 찾을 수 있습니다 GitHub.