Administración de identidades en Amazon SES - AWS SDK for JavaScript
El escenarioTareas previas necesariasConfiguración del SDKGeneración de un listado de entidadesVerificación de una identidad de dirección de correo electrónicoComprobación de una identidad de dominioEliminación de identidades

Anunciamos el próximo fin del soporte para AWS SDK for JavaScript v2. Se recomienda que migre a AWS SDK for JavaScript v3. Para ver las fechas, los detalles adicionales y la información sobre cómo realizar la migración, consulte el anuncio enlazado.

Administración de identidades en Amazon SES

JavaScript code example that applies to Node.js execution

Este ejemplo de código de Node.js muestra:

  • Cómo verificar las direcciones de correo electrónico y los dominios que se usan con Amazon SES.

  • Cómo asignar una política de IAM a sus identidades de Amazon SES.

  • Cómo generar una lista de todas las identidades de Amazon SES para su cuenta de AWS.

  • Cómo eliminar identidades que se usan con Amazon SES.

En Amazon SES, una identidad es una dirección de correo electrónico o dominio que se utiliza para enviar correos electrónicos. Amazon SES requiere que verifique su dirección de correo electrónico o dominio para confirmar que es de su propiedad e impedir que otras personas los utilicen.

Para obtener información detallada acerca de cómo verificar direcciones de correo electrónico y dominios en Amazon SES, consulte Verificación de direcciones de correo electrónico y dominios en Amazon SES en la Guía para desarrolladores de Amazon Simple Email Service. Para obtener información acerca de cómo enviar autorizaciones en Amazon SES, consulte Información general sobre el envío de autorizaciones en Amazon SES.

El escenario

En este ejemplo, va a utilizar una serie de módulos de Node.js para verificar y administrar identidades de Amazon SES. Los módulos de Node.js utilizan el SDK para JavaScript para verificar las direcciones de correo electrónico y los dominios, por medio de los métodos siguientes de la clase de cliente de Amazon SES:

Tareas previas necesarias

Para configurar y ejecutar este ejemplo, primero debe completar estas tareas:

Configuración del SDK

Configure el SDK para JavaScript creando un objeto de configuración global y luego configurando la región para su código. En este ejemplo, la región está establecida en us-west-2.

// Load the SDK for JavaScript
var AWS = require('aws-sdk');

// Set the Region 
AWS.config.update({region: 'us-west-2'});

Generación de un listado de entidades

En este ejemplo, utilice un módulo de Node.js para obtener una lista de direcciones de correo electrónico y dominios que se usarán con Amazon SES. Cree un módulo de Node.js con el nombre de archivo ses_listidentities.js. Configure el SDK como le hemos mostrado anteriormente.

Cree un objeto para transferir el parámetro IdentityType y otros parámetros para el método listIdentities de la clase de cliente de Amazon SES. Para llamar al método listIdentities, cree una promesa para invocar un objeto de servicio de Amazon SES transfiriendo el objeto de parámetros.

Luego gestione la response en la devolución de llamada de la promesa. Los data que la promesa devuelve contienen una matriz de identidades de dominio tal y como se especifica con el parámetro IdentityType.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set region
AWS.config.update({ region: "REGION" });

// Create listIdentities params
var params = {
  IdentityType: "Domain",
  MaxItems: 10,
};

// Create the promise and SES service object
var listIDsPromise = new AWS.SES({ apiVersion: "2010-12-01" })
  .listIdentities(params)
  .promise();

// Handle promise's fulfilled/rejected states
listIDsPromise
  .then(function (data) {
    console.log(data.Identities);
  })
  .catch(function (err) {
    console.error(err, err.stack);
  });

Para ejecutar el ejemplo, escriba lo siguiente en la línea de comandos.

node ses_listidentities.js

Este código de ejemplo se puede encontrar aquí en GitHub.

Verificación de una identidad de dirección de correo electrónico

En este ejemplo, utilice un módulo de Node.js para comprobar los remitentes de direcciones de correo electrónico que se usarán con Amazon SES. Cree un módulo de Node.js con el nombre de archivo ses_verifyemailidentity.js. Configure el SDK como le hemos mostrado anteriormente. Para obtener acceso a Amazon SES, cree un objeto de servicio AWS.SES.

Cree un objeto para transferir el parámetro EmailAddress para el método verifyEmailIdentity de la clase de cliente de Amazon SES. Para llamar al método verifyEmailIdentity, cree una promesa para invocar un objeto de servicio de Amazon SES transfiriendo los parámetros. Luego gestione la response en la devolución de llamada de la promesa.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set region
AWS.config.update({ region: "REGION" });

// Create promise and SES service object
var verifyEmailPromise = new AWS.SES({ apiVersion: "2010-12-01" })
  .verifyEmailIdentity({ EmailAddress: "ADDRESS@DOMAIN.EXT" })
  .promise();

// Handle promise's fulfilled/rejected states
verifyEmailPromise
  .then(function (data) {
    console.log("Email verification initiated");
  })
  .catch(function (err) {
    console.error(err, err.stack);
  });

Para ejecutar el ejemplo, escriba lo siguiente en la línea de comandos. El dominio se añade a Amazon SES para que se compruebe.

node ses_verifyemailidentity.js

Este código de ejemplo se puede encontrar aquí en GitHub.

Comprobación de una identidad de dominio

En este ejemplo, utilice un módulo de Node.js para comprobar los dominios de correo electrónico que se usarán con Amazon SES. Cree un módulo de Node.js con el nombre de archivo ses_verifydomainidentity.js. Configure el SDK como le hemos mostrado anteriormente.

Cree un objeto para transferir el parámetro Domain para el método verifyDomainIdentity de la clase de cliente de Amazon SES. Para llamar al método verifyDomainIdentity, cree una promesa para invocar un objeto de servicio de Amazon SES transfiriendo el objeto de parámetros. Luego gestione la response en la devolución de llamada de la promesa.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set region
AWS.config.update({ region: "REGION" });

// Create the promise and SES service object
var verifyDomainPromise = new AWS.SES({ apiVersion: "2010-12-01" })
  .verifyDomainIdentity({ Domain: "DOMAIN_NAME" })
  .promise();

// Handle promise's fulfilled/rejected states
verifyDomainPromise
  .then(function (data) {
    console.log("Verification Token: " + data.VerificationToken);
  })
  .catch(function (err) {
    console.error(err, err.stack);
  });

Para ejecutar el ejemplo, escriba lo siguiente en la línea de comandos. El dominio se añade a Amazon SES para que se compruebe.

node ses_verifydomainidentity.js

Este código de ejemplo se puede encontrar aquí en GitHub.

Eliminación de identidades

En este ejemplo, utilice un módulo de Node.js para eliminar direcciones de correo electrónico o dominios que se usan con Amazon SES. Cree un módulo de Node.js con el nombre de archivo ses_deleteidentity.js. Configure el SDK como le hemos mostrado anteriormente.

Cree un objeto para transferir el parámetro Identity para el método deleteIdentity de la clase de cliente de Amazon SES. Para llamar al método deleteIdentity, cree una request para invocar un objeto de servicio de Amazon SES transfiriendo los parámetros. Luego gestione la response en la devolución de llamada de la promesa.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set region
AWS.config.update({ region: "REGION" });

// Create the promise and SES service object
var deletePromise = new AWS.SES({ apiVersion: "2010-12-01" })
  .deleteIdentity({ Identity: "DOMAIN_NAME" })
  .promise();

// Handle promise's fulfilled/rejected states
deletePromise
  .then(function (data) {
    console.log("Identity Deleted");
  })
  .catch(function (err) {
    console.error(err, err.stack);
  });

Para ejecutar el ejemplo, escriba lo siguiente en la línea de comandos.

node ses_deleteidentity.js

Este código de ejemplo se puede encontrar aquí en GitHub.