Wie integriere ich Amazon SES in einen Amazon Cognito-Benutzerpool?
Ich möchte Amazon Simple Email Service (Amazon SES) in einen Amazon Cognito-Benutzerpool integrieren.
Lösung
Hinweis: Wenn du beim Ausführen von Befehlen der AWS Command Line Interface (AWS CLI) Fehler erhältst, lies Beheben von Fehlern für den AWS CLI. Stelle außerdem sicher, dass du die neueste Version der AWS CLI verwendest.
Voraussetzungen
Amazon Cognito und Amazon SES unterstützen keine kontoübergreifenden Integrationen. Du kannst einen Amazon Cognito-Benutzerpool nicht in einem Konto konfigurieren und den Benutzerpool dann in eine Amazon SES-E-Mail-Adresse in einem anderen Konto integrieren.
Konfigurieren deines Amazon SES-Kontos
Um Betrug und Missbrauch zu verhindern, platziert Amazon SES alle neuen Amazon SES-Konten in der Amazon SES-Sandbox. Wenn du eine Amazon SES-Sandbox verwendest, lies die Einschränkungen. Führe dann die folgenden Schritte aus, um dein Konto aus der Amazon SES-Sandbox zu entfernen:
- Überprüfe die AWS-Regionszuordnungstabelle in der E-Mail-Konfiguration von Amazon SES. Die Zuordnungstabelle zeigt die Regionen, in denen du Amazon SES-Identitäten in Amazon Cognito-Benutzerpools integrieren kannst. Stelle sicher, dass du kompatible Regionen verwendest, bevor du das Amazon SES-Konto aus der Sandbox verschiebst.
- Fordere Produktionszugriff an für dein Amazon SES-Konto. Das AWS Support-Team gibt innerhalb von 24 Stunden eine erste Antwort auf die Anfrage.
Hinweis: Du musst zur neuen Konsolenumgebung von Amazon Cognito wechseln, um Amazon Cognito mit Amazon SES in derselben Region zu integrieren.
Du musst auch deine Domain-Identitäten verifizieren und E-Mail-Adressen verifizieren in Amazon SES.
Den Benutzerpool mit einer verifizierten Identität integrieren
Führe die folgenden Schritte aus:
- Melde dich in der Amazon Cognito-Konsole an und wähle dann User Pools (Benutzerpools) aus.
- Wähle den Benutzerpool aus.
- Wähle im Menü Authentication methods (Authentifizierungsmethoden) die Option Email configuration (E-Mail-Konfiguration) aus. Wähle dann Edit (Bearbeiten) aus.
- Wähle für FROM email address (ABSENDER-E-Mail-Adresse) die in Amazon SES verifizierte Domain-Identität aus. Zum Beispiel example.com.
- Gib für FROM sender name (ABSENDER-Sendername) deine E-Mail-Adresse ein. Zum Beispiel admin@example.com.
Du kannst eine benutzerdefinierte E-Mail-Adresse für die Domain-Identität hinzufügen. Die UpdateUserPool-API konfiguriert den Amazon Cognito-Benutzerpool mit einer Amazon SES-Identität.
Beispielbefehl für update-user-pool:
$ aws cognito-idp update-user-pool --user-pool-id example_pool_id --email-configuration SourceArn=arn:aws:ses:example_region:example_account_number:identity/example_domain,EmailSendingAccount=DEVELOPER,From=user@example.com --region example_region
Wichtig: Die API UpdateUserPool setzt die bestehende Konfiguration des Benutzerpools zurück. Um die Konfiguration zurückzusetzen, musst du die API DescribeUserPool aufrufen und dann alle vorhandenen Benutzerpool-Parameter an die API UpdateUserPool senden.
Nachfolgend findest du Beschreibungen für den Befehl „update-user-pool“:
- example_pool_id entspricht der Amazon Cognito-Benutzerpool-ID. Beispiel: ap-southeast-1_xxxxxxxx.
- arn:aws:ses:example_region:example_account_number:identity/example_domain ist der Amazon-Ressourcenname (ARN) der Amazon SES-Domain-Identität.
- Ersetze user@example.com durch deine E-Mail-Identität.
- example_region steht für die Region, in der sich der Amazon Cognito-Benutzerpool befindet. Beispiel: ap-southeast-1.
Fehler beheben
Führe je nach Problem die folgenden Aufgaben aus.
Fehler durch nicht verifizierte E-Mail-Adressen beheben
Wenn du versuchst, eine E-Mail von einem Amazon SES-Sandbox-Konto an eine nicht verifizierte E-Mail-Adresse zu senden, erhältst du möglicherweise die folgende Fehlermeldung:
„Email address is not verified. The following identities failed the check in region AP-SOUTHEAST-1: user@example.com.“
Um diesen Fehler zu beheben, verschiebe das Amazon SES-Konto aus der Sandbox oder überprüfe die E-Mail-Adresse des Empfängers in Amazon SES.
Fehlende E-Mail-Nachrichten
Wenn Benutzer keine E-Mails von deinem Amazon Cognito-Benutzerpool erhalten, führe die folgenden Aufgaben aus:
- Verwende die Standard-E-Mail-Konfiguration von Amazon Cognito oder die Amazon SES-E-Mail-Konfiguration, um E-Mail-Nachrichten zu senden.
- Überprüfe die Updates über die AWS-Managementkonsole. Oder führe den API-Aufruf DescribeUserPool aus.
Beispiel für einen Befehl describe-user-pool:
aws cognito-idp describe-user-pool --user-pool-id example_pool_id --region example_region --query 'UserPool.EmailConfiguration'
Beispielausgabe 1:
{ "SourceArn": "arn:aws:ses:us-east-1:123456789012:identity/admin@example.com", "EmailSendingAccount": "DEVELOPER", "From": "admin@example.com" }
Beispielausgabe 2:
{ "SourceArn": "arn:aws:ses:us-east-1:123456789012:identity/admin@example.com", "EmailSendingAccount": "COGNITO_DEFAULT" }
Wenn EmailSendingAccount den Wert DEVELOPER hat, verwendet dein Benutzerpool Amazon SES zum Senden von E-Mail-Nachrichten. Du kannst auch die Amazon SES-Protokolle einsehen, um weitere Informationen zu Zustellproblemen zu erhalten.
Wenn EmailSendingAccount den Wert COGNITO_DEFAULT hat, verwendet dein Benutzerpool die Standard-E-Mail-Funktion von Amazon Cognito zum Senden von E-Mail-Nachrichten. Diese Funktionalität verfügt über ein Kontingent für gesendete E-Mails pro Benutzerpool, was zu Fehlern aufgrund des täglichen E-Mail-Kontingents führen kann.
Fehler beim täglichen E-Mail-Kontingent beheben
Wenn du das Kontingent für die Standard-E-Mail-Konfiguration von Amazon Cognito überschreitest, erhältst du möglicherweise die folgende Fehlermeldung:
„Exceeded daily email limit for the operation or account. Number of allowed operation has exceeded. If a higher limit is required, please configure your user pool to use your own Amazon SES configuration for sending email messages.“
Um diese Fehlermeldung zu beheben, konfiguriere deinen Benutzerpool so, dass er deine eigene Amazon SES-Konfiguration zum Senden von E-Mails verwendet. Diese Konfiguration erhöht deine Amazon SES-Sendekontingente.
Ähnliche Informationen
- Tags
- Amazon Cognito
- Sprache
- Deutsch

Relevanter Inhalt
AWS OFFICIALAktualisiert vor einem Jahr