Nous avons annoncé la sortie end-of-support de la AWS SDK for JavaScript v2. Nous vous recommandons de migrer vers la AWS SDK for JavaScript version 3. Pour les dates, les détails supplémentaires et les informations sur la façon de migrer, reportez-vous à l'annonce associée.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Gestion des identités Amazon SES

Cet exemple de code Node.js présente :

Une identité Amazon SES est une adresse e-mail ou un domaine qu'Amazon SES utilise pour envoyer des e-mails. Amazon SES vous demande de vérifier votre identité e-mail, de confirmer que vous en êtes le propriétaire et d'empêcher les autres de les utiliser.

Pour en savoir plus sur la façon de vérifier les adresses e-mail et les domaines dans Amazon SES, consultez la section Vérification des adresses e-mail et des domaines dans Amazon SES dans le manuel Amazon Simple Email Service Developer Guide. Pour plus d'informations sur l'envoi d'autorisations dans Amazon SES, consultez Présentation de l'autorisation d'envoi Amazon SES.

Scénario

Dans cet exemple, vous utilisez une série de modules Node.js pour vérifier et gérer les identités Amazon SES. Les modules Node.js utilisent le SDK JavaScript pour vérifier les adresses e-mail et les domaines, en utilisant les méthodes suivantes de la classe AWS.SES client :

Tâches prérequises

Pour configurer et exécuter cet exemple, vous devez d'abord :

Configuration du kit SDK

Configurez le SDK pour JavaScript en créant un objet de configuration global, puis en définissant la région pour votre code. Dans cet exemple, la région est us-west-2.

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

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

Liste de vos identités

Dans cet exemple, utilisez un module Node.js pour répertorier les adresses e-mail et les domaines à utiliser avec Amazon SES. Créez un module Node.js nommé ses_listidentities.js. Configurez le kit SDK comme illustré précédemment.

Créez un objet pour transmettre le paramètre IdentityType ainsi que les autres paramètres de la méthode listIdentities de la classe client AWS.SES. Pour appeler la listIdentities méthode, créez une promesse pour appeler un objet de service Amazon SES, en transmettant l'objet de paramètres.

Traitez ensuite l'élément response dans le rappel de promesse. Les data retournées par la promesse contiennent un tableau des identités de domaine comme spécifié par le paramètre 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);
  });

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande.

node ses_listidentities.js

Cet exemple de code se trouve ici sur GitHub.

Vérification d'une identité d'adresse e-mail

Dans cet exemple, utilisez un module Node.js pour vérifier les expéditeurs d'e-mails à utiliser avec Amazon SES. Créez un module Node.js nommé ses_verifyemailidentity.js. Configurez le kit SDK comme illustré précédemment. Pour accéder à Amazon SES, créez un objet AWS.SES de service.

Créez un objet pour transmettre le paramètre EmailAddress ainsi que les autres paramètres de la méthode verifyEmailIdentity de la classe client AWS.SES. Pour appeler la méthode verifyEmailIdentity, créez une promesse pour appeler un objet de service Amazon SES, en transmettant les paramètres. Traitez ensuite l'élément response dans le rappel de promesse.

// 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);
  });

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. Le domaine est ajouté à Amazon SES pour être vérifié.

node ses_verifyemailidentity.js

Cet exemple de code se trouve ici sur GitHub.

Vérification d'une identité de domaine

Dans cet exemple, utilisez un module Node.js pour vérifier les domaines de messagerie à utiliser avec Amazon SES. Créez un module Node.js nommé ses_verifydomainidentity.js. Configurez le kit SDK comme illustré précédemment.

Créez un objet pour transmettre le paramètre Domain ainsi que les autres paramètres de la méthode verifyDomainIdentity de la classe client AWS.SES. Pour appeler la verifyDomainIdentity méthode, créez une promesse pour appeler un objet de service Amazon SES, en transmettant l'objet de paramètres. Traitez ensuite l'élément response dans le rappel de promesse.

// 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);
  });

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande. Le domaine est ajouté à Amazon SES pour être vérifié.

node ses_verifydomainidentity.js

Cet exemple de code se trouve ici sur GitHub.

Suppression des identités

Dans cet exemple, utilisez un module Node.js pour supprimer les adresses e-mail ou les domaines utilisés avec Amazon SES. Créez un module Node.js nommé ses_deleteidentity.js. Configurez le kit SDK comme illustré précédemment.

Créez un objet pour transmettre le paramètre Identity ainsi que les autres paramètres de la méthode deleteIdentity de la classe client AWS.SES. Pour appeler la deleteIdentity méthode, créez un request pour appeler un objet de service Amazon SES en transmettant les paramètres. Traitez ensuite l'élément response dans le rappel de promesse.

// 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);
  });

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande.

node ses_deleteidentity.js

Cet exemple de code se trouve ici sur GitHub.