Verwalten von Amazon-SES-Identitäten - AWS SDK for JavaScript

Das AWS SDK for JavaScriptV3-API-Referenzhandbuch beschreibt detailliert alle API-Operationen fürAWS SDK for JavaScript Version 3 (V3).

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwalten von Amazon-SES-Identitäten

JavaScript code example that applies to Node.js execution

Dieses Node.js-Codebeispiel zeigt:

  • So verifizieren Sie E-Mail-Adressen und Domains, die mit Amazon SES verwendet werden.

  • So weisen Sie Ihren Amazon SES SES-Identitäten eineAWS Identity and Access Management (IAM-) Richtlinie zu.

  • So listen Sie alle Amazon SES SES-Identitäten für IhrAWS Konto auf.

  • So löschen Sie Identitäten, die mit Amazon SES verwendet wurden.

Eine Amazon-SES-Identität ist eine E-Mail-Adresse oder Domäne, die Amazon SES zum Senden von E-Mails verwendet. Amazon SES verlangt von Ihnen, Ihre E-Mail-Identitäten zu verifizieren, um zu bestätigen, dass Sie deren Eigentümer sind, und zu verhindern, dass andere sie verwenden.

Einzelheiten zur Verifizierung von E-Mail-Adressen und Domänen in Amazon SES finden Sie unter Verifizieren von E-Mail-Adressen und Domänen in Amazon SES im Entwicklerhandbuch für Amazon Simple Email Service. Informationen zur Sendeautorisierung in Amazon SES finden Sie unter Überblick über die Amazon SES-Versandautorisierung.

Das Szenarios

In diesem Beispiel verwenden Sie eine Reihe von Node.js, um Amazon-SES-Identitäten zu überprüfen und zu verwalten. Die Module Node.js verwenden das SDK für, JavaScript um E-Mail-Adressen und Domänen zu überprüfen, indem sie die folgenden Methoden derSES Client-Klasse verwenden:

Erforderliche Aufgaben

Zum Einrichten und Ausführen dieses Beispiels müssen Sie zunächst diese Aufgaben abschließen:

Wichtig

Diese Beispiele zeigen, wie Sie Clientservice-Objekte und Befehle mithilfe von ECMAScript6 (ES6) importieren/exportieren.

Deine Identitäten auflisten

Verwenden Sie in diesem Beispiel ein Modul Node.js, um E-Mail-Adressen und Domänen aufzulisten, die mit Amazon SES verwendet werden sollen.

Erstellen Sie einlibs Verzeichnis und erstellen Sie ein Modul Node.js mit dem DateinamensesClient.js. Kopieren Sie den folgenden Code und fügen Sie ihn ein, wodurch das Amazon SES-Client-Objekt erstellt wird. Ersetze REGION durch deineAWS Region.

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

Diesen Beispielcode finden Sie hier auf GitHub.

Erstellen Sie ein Node.js-Modul mit dem Dateinamen ses_listidentities.js. Konfigurieren Sie das SDK wie zuvor gezeigt, einschließlich der Installation der erforderlichen Clients und Pakete.

Erstellen Sie ein Objekt, um den IdentityType und andere Parameter für die ListIdentitiesCommand-Methode der SES-Client-Klasse zu übergeben. Um dieListIdentitiesCommand Methode aufzurufen, rufen Sie ein Amazon SES-Serviceobjekt auf und übergeben Sie das Parameterobjekt.

Diedata zurückgegebene Datei enthält ein Array von Domänenidentitäten, wie imIdentityType Parameter angegeben.

Anmerkung

Ersetzen Sie IDENTITY_TYPE durch den Identitätstyp, der "EmailAddress" oder „Domain“ sein kann.

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

Um das Beispiel auszuführen, geben Sie Folgendes an der -Eingabeaufforderung Folgendes ein, um das Beispiel zu verwenden.

node ses_listidentities.js

Diesen Beispielcode finden Sie hier auf GitHub.

Verifizieren der Identität einer E-Mail-Adresse

Verwenden Sie in diesem Beispiel ein Modul Node.js, um E-Mail-Absender zu verifizieren, die mit Amazon SES verwendet werden sollen.

Erstellen Sie einlibs Verzeichnis und erstellen Sie ein Modul Node.js mit dem DateinamensesClient.js. Kopieren Sie den folgenden Code und fügen Sie ihn ein, wodurch das Amazon SES-Client-Objekt erstellt wird. Ersetze REGION durch deineAWS Region.

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

Diesen Beispielcode finden Sie hier auf GitHub.

Erstellen Sie ein Node.js-Modul mit dem Dateinamen ses_verifyemailidentity.js. Konfigurieren Sie das SDK wie zuvor gezeigt, einschließlich des Herunterladens der erforderlichen Clients und Pakete.

Erstellen Sie ein Objekt mit dem sie den EmailAddress-Parameter an die VerifyEmailIdentityCommand-Methode der SES-Client-Klasse übergeben. Um dieVerifyEmailIdentityCommand Methode aufzurufen, rufen Sie ein Amazon SES-Clientservice-Objekt auf und übergeben Sie die Parameter.

Anmerkung

Ersetzen Sie ADDRESS@DOMAIN.EXT durch die E-Mail-Adresse, z. B. 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; } };

Um das Beispiel auszuführen, geben Sie Folgendes an der -Eingabeaufforderung Folgendes ein, um das Beispiel zu verwenden. Die Domain wird zu Amazon SES hinzugefügt, um verifiziert zu werden.

node ses_verifyemailidentity.js

Diesen Beispielcode finden Sie hier auf GitHub.

Verifizieren einer Domänenidentität

Verwenden Sie in diesem Beispiel das Modul Node.js, um E-Mail-Domänen zu verifizieren, die mit Amazon SES verwendet werden sollen.

Erstellen Sie einlibs Verzeichnis und erstellen Sie ein Modul Node.js mit dem DateinamensesClient.js. Kopieren Sie den folgenden Code und fügen Sie ihn ein, wodurch das Amazon SES-Client-Objekt erstellt wird. Ersetze REGION durch deineAWS Region.

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

Diesen Beispielcode finden Sie hier auf GitHub.

Erstellen Sie ein Node.js-Modul mit dem Dateinamen ses_verifydomainidentity.js. Konfigurieren Sie das SDK wie zuvor gezeigt, einschließlich der Installation der erforderlichen Clients und Pakete.

Erstellen Sie ein Objekt mit dem sie den Domain-Parameter an die VerifyDomainIdentityCommand-Methode der SES-Client-Klasse übergeben. Um dieVerifyDomainIdentityCommand Methode aufzurufen, rufen Sie ein Amazon SES-Clientservice-Objekt auf und übergeben Sie das Parameterobjekt.

Anmerkung

In diesem Beispiel werden die erforderlichenAWS Service V3-Paketclients und V3-Befehle importiert und verwendet. Diesend Methode wird in einem async/await-Muster verwendet. Sie können dieses Beispiel stattdessen mit V2-Befehlen erstellen, indem Sie einige geringfügige Änderungen vornehmen. Details hierzu finden Sie unter Verwenden von V3-Befehlen.

Anmerkung

Ersetzen Sie AMI_ID durch die ID des auszuführenden Amazon Machine Images (AMI) und KEY_PAIR_NAME des key pair, das der AMI-ID zugewiesen werden soll.

import { VerifyDomainIdentityCommand } from "@aws-sdk/client-ses"; import { getUniqueName, postfix } from "../../libs/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; } };

Um das Beispiel auszuführen, geben Sie Folgendes an der -Eingabeaufforderung Folgendes ein, um das Beispiel zu verwenden. Die Domain wird zu Amazon SES hinzugefügt, um verifiziert zu werden.

node ses_verifydomainidentity.js

Diesen Beispielcode finden Sie hier auf GitHub.

Löschen von Identitä

Verwenden Sie in diesem Beispiel ein Modul Node.js, um E-Mail-Adressen oder Domains zu löschen, die mit Amazon SES verwendet werden.

Erstellen Sie einlibs Verzeichnis und erstellen Sie ein Modul Node.js mit dem DateinamensesClient.js. Kopieren Sie den folgenden Code und fügen Sie ihn ein, wodurch das Amazon SES-Client-Objekt erstellt wird. Ersetze REGION durch deineAWS Region.

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

Diesen Beispielcode finden Sie hier auf GitHub.

Erstellen Sie ein Node.js-Modul mit dem Dateinamen ses_deleteidentity.js. Konfigurieren Sie das SDK wie zuvor gezeigt, einschließlich der Installation der erforderlichen Clients und Pakete.

Erstellen Sie ein Objekt mit dem sie den Identity-Parameter an die DeleteIdentityCommand-Methode der SES-Client-Klasse übergeben. Um dieDeleteIdentityCommand Methode aufzurufen, erstellen Sie einerequest zum Aufrufen eines Amazon SES-Clientservice-Objekts, wobei die Parameter übergeben werden.

Anmerkung

In diesem Beispiel werden die erforderlichenAWS Service V3-Paketclients und V3-Befehle importiert und verwendet. Diesend Methode wird in einem async/await-Muster verwendet. Sie können dieses Beispiel stattdessen mit V2-Befehlen erstellen, indem Sie einige geringfügige Änderungen vornehmen. Details hierzu finden Sie unter Verwenden von V3-Befehlen.

Anmerkung

Ersetzen Sie IDENTITY_TYPE durch den zu löschenden Identitätstyp und IDENTITY_NAME durch den Namen der zu löschenden Identität.

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

Um das Beispiel auszuführen, geben Sie Folgendes an der -Eingabeaufforderung Folgendes ein, um das Beispiel zu verwenden.

node ses_deleteidentity.js

Diesen Beispielcode finden Sie hier auf GitHub.