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.

Einstellungen für SMS-Nachrichten für Amazon-Cognito-Benutzerpools

Einige Amazon-Cognito-Ereignisse für Ihren Benutzerpool können dazu führen, dass Amazon Cognito SMS-Textnachrichten an Ihre Benutzer sendet. Wenn Sie beispielsweise Ihren Benutzerpool so konfigurieren, dass eine Telefon-Verifizierung erforderlich ist, erhält der Benutzer eine SMS-Textnachricht von Amazon Cognito, wenn er in Ihrer App ein neues Konto für sich anmeldet oder sein Passwort zurücksetzt. Abhängig von der Aktion, die die SMS-Nachricht initiiert, enthält die Nachricht einen Verifizierungscode, ein temporäres Kennwort oder eine Begrüßungsnachricht.

Amazon Cognito kann SMS-Nachrichten mit einer der folgenden Konfigurationen senden:

Ein Benutzerpool verwendet jeweils eine SMS-Konfiguration. Die Amazon SNS- und AWS End User Messaging SMS Direktkonfigurationen schließen sich gegenseitig aus. Wenn Sie eine Konfiguration festlegen, löscht Amazon Cognito die andere. Dies gilt für CreateUserPoolUpdateUserPool,- und SetUserPoolMfaConfigOperationen.

Amazon SNS SMS ist in den AWS-Regionen aufgelisteten Sprachen verfügbar. Konfiguration der Region für den Amazon SNS SNS-Pfad Um SMS-Nachrichten aus einem Benutzerpool in einem anderen zu senden AWS-Region, verwenden Sie AWS End User Messaging SMS direkt.

Wenn Sie zum ersten Mal eine Textnachricht über Amazon Cognito senden, befinden Sie AWS End User Messaging SMS sich in einer Sandbox-Umgebung. In der Sandbox-Umgebung können Sie Ihre Anwendungen auf SMS-Textnachrichten testen. In der Sandbox können Sie Nachrichten an eine begrenzte Anzahl verifizierter Zieltelefonnummern senden, wenn Sie eine Absenderidentität haben, oder das Senden von Nachrichten simulieren, wenn Sie dies nicht tun.

AWS End User Messaging SMS Gebühren für SMS-Textnachrichten. Weitere Informationen finden Sie unter AWS End User Messaging SMS Preise.

Amazon Cognito sendet Ihren Benutzern SMS-Nachrichten mit einem Code, den diese eingeben können. Die folgende Tabelle zeigt die Ereignisse, die eine SMS-Nachricht generieren können.

Nachrichtenoptionen

¹ Erfordert den Feature-Plan Essentials oder höher und die E-Mail-Konfiguration von Amazon SES.

² Für SMS- und E-Mail-Nachrichten.

³ Sie können die MFA-Nachrichtenvorlage nur anpassen, wenn MFA in Ihrem Benutzerpool erforderlich oder optional ist. Wenn MFA inaktiv ist, sendet Amazon Cognito Einmalkennwörter mit der Standardvorlage.

AWS End User Messaging SMS Gebühren für SMS-Nachrichten. Weitere Informationen finden Sie unter AWS End User Messaging SMS Preise.

Weitere Informationen zu MFA finden Sie unter SMS- und E-Mail-Nachricht MFA.

Amazon Cognito verhindert möglicherweise die Zustellung zusätzlicher E-Mail- oder SMS-Nachrichten an ein einzelnes Ziel in einem kurzen Zeitraum. Wenn Sie glauben, dass Ihr Benutzerpool betroffen ist, konfigurieren und überprüfen Sie die Protokolle auf Fehler bei der Nachrichtenzustellung und wenden Sie sich dann an Ihr Kundenbetreuungsteam.

Wählen Sie zwischen Amazon SNS und AWS End User Messaging SMS

Amazon Cognito Cognito-Benutzerpools können SMS-Nachrichten über zwei Wege versenden: Amazon SNS oder AWS End User Messaging SMS direkt. Verwenden Sie für neue Benutzerpools den AWS End User Messaging SMS direkten Pfad. Amazon SNS SMS ist nur in einer festen Anzahl von AWS-Regionen verfügbar. Der direkte AWS End User Messaging SMS Pfad unterstützt zusätzliche Regionen und macht Funktionen verfügbar, die der Amazon SNS SNS-Pfad nicht bietet. Beide Pfade übermitteln Nachrichten über. AWS End User Messaging SMS

In der folgenden Tabelle werden die beiden SMS-Konfigurationspfade verglichen.

SMS-Konfiguration in der Amazon Cognito Cognito-Benutzerpools-API

Das SmsConfigurationTypeObjekt in der Amazon Cognito Cognito-Benutzerpools-API enthält die SMS-Konfiguration für Ihren Benutzerpool. Dieses Objekt hat die folgenden Konfigurationspfade:

Weitere Informationen finden Sie SmsConfigurationTypein der Amazon Cognito User Pools API-Referenz.

Bewährte Methoden

Aufgrund des weltweiten Volumens an unaufgefordertem SMS-Verkehr verhängen einige Regierungen Sperren zwischen Absendern und Empfängern von SMS-Nachrichten. Wenn Sie SMS-Nachrichten für MFA und Benutzeraktualisierungen verwenden, müssen Sie zusätzliche Maßnahmen ergreifen, um sicherzustellen, dass Ihre Nachrichten zugestellt werden. Sie müssen auch die SMS-message-related Vorschriften in Ländern, in denen Ihre Benutzer möglicherweise leben, überwachen und Ihre SMS-Nachrichtenkonfiguration auf dem neuesten Stand halten. Weitere Informationen finden Sie im AWS End User Messaging SMS Benutzerhandbuch unter Funktionen und Einschränkungen der jeweiligen Länder für SMS und MMS.

Die Verwendung von SMS-Nachrichten zur Authentifizierung und Überprüfung von Benutzern ist kein bewährtes Sicherheitsverfahren. Telefonnummern können den Besitzer wechseln und stellen möglicherweise keinen zuverlässigen Something You Have-MFA-Faktor für Ihre Benutzer dar. Implementieren Sie stattdessen TOTP MFA in Ihrer App oder mit Ihrem Drittanbieter-IdP. Es ist auch möglich, zusätzliche benutzerdefinierte Authentifizierungsfaktoren mit Lambda-Auslöser für benutzerdefinierte Authentifizierungsaufforderungen zu erstellen.

Unter den folgenden Links finden Sie Informationen zur Sicherung Ihrer Architektur für die SMS-Nachrichtenzustellung.

Erstmaliges Einrichten von SMS-Nachrichten in Amazon-Cognito-Benutzerpools

Amazon Cognito verwendet entweder Amazon SNS (und indirekt AWS End User Messaging SMS) oder AWS End User Messaging SMS direkt, um SMS-Nachrichten aus Ihren Benutzerpools zu versenden. Sie können auch einen Benutzerdefinierter Lambda-Auslöser für SMS-Sender verwenden, um Ihre eigenen Ressourcen zum Senden von SMS-Nachrichten zu verwenden. Wenn Sie SMS-Textnachrichten zum ersten Mal in einer bestimmten Region einrichten AWS-Region, werden Ihre Textnachrichten AWS-Konto in der SMS-Sandbox für diese Region AWS End User Messaging SMS platziert. AWS End User Messaging SMS verwendet die Sandbox, um Betrug und Missbrauch zu verhindern und Compliance-Anforderungen zu erfüllen. Wenn Sie AWS-Konto sich in der Sandbox befinden, gelten einige AWS End User Messaging SMS Einschränkungen. Sie können beispielsweise Textnachrichten an maximal 10 verifizierte Zielnummern senden, wenn Sie eine Absenderidentität haben, oder Sie können das Senden von Nachrichten ohne Absenderidentität simulieren. Solange Sie in der Sandbox AWS-Konto bleiben, sollten Sie in der Produktion keine SMS-Nachrichten versenden. Wenn Sie sich in der Sandbox befinden, kann Amazon Cognito keine Nachrichten an die Telefonnummern Ihrer Benutzer senden.

Bereiten Sie eine IAM-Rolle vor, mit der Amazon Cognito SMS-Nachrichten senden kann AWS End User Messaging SMS

Wenn Sie eine SMS-Nachricht aus Ihrem Benutzerpool senden, übernimmt Amazon Cognito eine IAM-Rolle in Ihrem Konto. Die Berechtigungen, die für die Rolle erforderlich sind, hängen vom SMS-Konfigurationspfad ab, den Sie wählen:

In der Amazon Cognito Cognito-Konsole können Sie im Menü Authentifizierungsmethoden Ihres Benutzerpools unter SMS eine IAM-Rollenauswahl festlegen oder diese Auswahl während des Assistenten zur Erstellung des Benutzerpools treffen.

Die folgende IAM-Rollenvertrauensrichtlinie gewährt Benutzerpools von Amazon Cognito eine eingeschränkte Möglichkeit, die Rolle zu übernehmen. Amazon Cognito kann die Rolle nur übernehmen, wenn es die folgenden Bedingungen erfüllt:

Diese Vertrauensrichtlinien gelten sowohl für den Amazon SNS SNS-Pfad als auch für den AWS End User Messaging SMS direkten Pfad.

JSON

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "",
            "Effect": "Allow",
            "Principal": {
                "Service": "cognito-idp.amazonaws.com"
            },
            "Action": "sts:AssumeRole",
            "Condition": {
                "StringEquals": {
                    "sts:ExternalId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
                    "aws:SourceAccount": "111122223333"
                },
                "ArnLike": {
                    "aws:SourceArn": "arn:aws:cognito-idp:us-west-2:111122223333:userpool/us-west-2_EXAMPLE"
                }
            }
        }
    ]
}

Sie können einen genauen Benutzerpool-ARN oder ein Platzhalter-ARN im Wert der Bedingung aws:SourceArn angeben. Suchen Sie in der AWS-Managementkonsole oder mit einer DescribeUserPoolAPI-Anfrage nach den ARNs Ihrer Benutzerpools.

Um SMS-Nachrichten für die Multi-Faktor-Authentifizierung zu senden, muss Ihre IAM-Rollenvertrauensrichtlinie eine Bedingung erfüllen. sts:ExternalId Der Wert dieser Bedingung muss der ExternalId Eigenschaft SmsConfigurationIhres Benutzerpools entsprechen. Wenn Sie während der Erstellung des Benutzerpools in der Amazon Cognito-Konsole eine IAM-Rolle erstellen, konfiguriert Amazon Cognito die externe ID für Sie in der Rolle und in den Benutzerpooleinstellungen. Dies ist nicht der Fall, wenn Sie eine vorhandene IAM-Rolle verwenden.

Sie müssen den ExternalId Benutzerpoolparameter in einer UpdateUserPoolAPI-Anforderung aktualisieren und die Vertrauensrichtlinie für die IAM-Rolle mit einer sts:externalId Bedingung mit demselben Wert aktualisieren. Informationen zur Verwendung der API zur Aktualisierung eines Benutzerpools unter Beibehaltung der ursprünglichen Konfiguration finden Sie unter. Aktualisierung der Benutzerpool- und App-Client-Konfiguration

Weitere Informationen zu IAM-Rollen und -Vertrauensrichtlinien finden Sie unter Rollenbegriffe und -Konzepte im AWS Identity and Access Management -Benutzerhandbuch.

So führen Sie die Einrichtung durch: AWS End User Messaging SMS direkte SMS für einen Benutzerpool

Gehen Sie wie folgt vor, um Ihren Benutzerpool so zu konfigurieren, dass SMS-Nachrichten direkt über gesendet AWS End User Messaging SMS werden. Diese Konfiguration verwendet das EumsSms Objekt in SmsConfigurationType.

IAM-Berechtigungen für AWS End User Messaging SMS direkte SMS

Die IAM-Rolle in CallerArn erfordert eine Vertrauensrichtlinie, die es dem cognito-idp.amazonaws.com Dienstprinzipal ermöglicht, sie zu übernehmen. Verwenden Sie dieselbe Vertrauensrichtlinienstruktur wie der Amazon SNS SNS-Pfad (sieheBereiten Sie eine IAM-Rolle vor, mit der Amazon Cognito SMS-Nachrichten senden kann AWS End User Messaging SMS). Für die Rolle ist außerdem eine Berechtigungsrichtlinie erforderlich, die Ihrer ursprünglichen Identität sms-voice:SendTextMessage einen ARN mit Gültigkeitsbereich gewährt (siehe das Einrichtungsverfahren unter). So führen Sie die Einrichtung durch: AWS End User Messaging SMS direkte SMS für einen Benutzerpool

Wählen Sie das Symbol AWS-Region für SMS-Nachrichten

Konfiguration der Region für den Amazon SNS SNS-Pfad

In einigen Fällen können Sie die Region auswählen AWS-Regionen, die die Amazon SNS SNS-Ressourcen enthält, die Sie für Amazon Cognito-SMS-Nachrichten verwenden möchten. In allen Ländern, in AWS-Region denen Amazon Cognito verfügbar ist, außer im asiatisch-pazifischen Raum (Seoul), können Sie Amazon SNS SNS-Ressourcen dort verwenden, AWS-Region wo Sie Ihren Benutzerpool erstellt haben. Um Ihre SMS-Nachrichten schneller und zuverlässiger zu gestalten, wenn Sie zwischen verschiedenen Regionen auswählen können, verwenden Sie Amazon SNS-Ressourcen in derselben Region wie Ihr Benutzerpool.

Wählen Sie eine Region für SMS-Ressourcen im Schritt Nachrichtenzustellung konfigurieren des Assistenten für neue Benutzerpools aus. Sie können auch im Menü Authentifizierungsmethoden eines vorhandenen Benutzerpools unter SMS die Option Bearbeiten auswählen.

Bei der Markteinführung sendete Amazon Cognito für einige AWS-Regionen SMS-Nachrichten mit Amazon SNS SNS-Ressourcen in einer anderen Region. Um Ihre bevorzugte Region festzulegen, verwenden Sie den SnsRegion Parameter des SmsConfigurationTypeObjekts für Ihren Benutzerpool. Wenn Sie eine Amazon-Cognito-Benutzerpool-Ressource in einer Amazon Cognito Region (Amazon-Cognito-Region) aus der folgenden Tabelle programmgesteuert erstellen und keinen SnsRegion-Parameter angeben, kann Ihr Benutzerpool SMS-Nachrichten mit Amazon-SNS-Ressourcen in einer Legacy-Amazon SNS Region (Amazon-SNS-Region) senden.

Amazon Cognito Cognito-Benutzerpools im asiatisch-pazifischen Raum (Seoul) AWS-Region müssen Ihre Amazon SNS SNS-Konfiguration in der Region Asien-Pazifik (Tokio) verwenden.

Amazon SNS (bis AWS End User Messaging SMS) legt das Ausgabenkontingent für alle neuen Konten auf 1,00 USD pro Monat fest. Möglicherweise haben Sie Ihr Ausgabenlimit in einer AWS-Region erhöht, die Sie mit Amazon Cognito verwenden. Bevor Sie die AWS-Region für Amazon SNS SMS-Nachrichten ändern, öffnen Sie im AWS Support Center einen Fall zur Erhöhung des Kontingents, um Ihr Limit in der neuen Region zu erhöhen. Weitere Informationen finden Sie im Benutzerhandbuch unter Umstellung von der AWS End User Messaging SMS MMS- und Voice-Sandbox auf die AWS End User Messaging SMS Produktionsumgebung.

Sie können SMS-Nachrichten für jede Amazon Cognito Cognito-Region in der folgenden Tabelle mit AWS End User Messaging SMS Ressourcen in der entsprechenden SMS-Nachrichtenregion senden.

AWS End User Messaging SMS direkter Pfad, Konfiguration der Region

AWS End User Messaging SMS ist in eigenen Gruppen verfügbar, die sich von den Regionen unterscheiden können AWS-Regionen, in denen Amazon SNS- oder Amazon Cognito Cognito-Benutzerpools verfügbar sind. Die aktuelle Liste finden Sie im AWS End User Messaging SMS Benutzerhandbuch unter Unterstützte Regionen und Länder.

Das Region Feld des EumsSms Objekts in SmsConfigurationTypelegt fest, AWS-Region wo Amazon Cognito aufruft AWS End User Messaging SMS. AWS End User Messaging SMS muss in der Region Ihres Benutzerpools verfügbar sein. Lassen Sie Region die Verwendung von Amazon Cognito AWS End User Messaging SMS in der Region Ihres Benutzerpools aus oder legen Sie Region sie explizit auf die Region Ihres Benutzerpools fest. Amazon Cognito lehnt jeden anderen Wert ab.

Eine Ursprungsidentität zum Senden von SMS-Nachrichten an US-Telefonnummern anfordern

Wenn Sie SMS-Textnachrichten an US-Telefonnummern senden möchten, müssen Sie eine Ursprungsidentität anfordern, unabhängig davon, ob Sie eine SMS-Sandbox-Testumgebung oder eine Produktionsumgebung erstellen.

US-Mobilfunkanbieter benötigen eine Absenderidentität, um Nachrichten an US-Telefonnummern zu senden. Wenn Sie noch keine Ursprungsidentität besitzen, müssen Sie eine anfordern. Informationen dazu, wie Sie eine Absenderidentität erhalten, finden Sie im AWS End User Messaging SMS Benutzerhandbuch unter Telefonnummer anfordern.

Wenn Sie mehr als eine Absenderidentität in derselben Datei haben AWS-Region, AWS End User Messaging SMS wählt Sie einen Identitätstyp in der folgenden Prioritätsreihenfolge aus: Kurzcode, 10DLC, gebührenfreie Nummer. Sie können diese Prioritätsreihenfolge nicht ändern. Weitere Informationen finden Sie unter AWS End User Messaging SMS : Häufig gestellte Fragen.

Bestätigen Sie, dass Sie sich in der SMS-Sandbox befinden.

Gehen Sie wie folgt vor, um zu bestätigen, dass Sie sich in der SMS-Sandbox befinden. Wiederholen Sie den Vorgang für jeden AWS-Region , in dem Sie Amazon Cognito Cognito-Produktions-Benutzerpools haben.

Verschieben Sie Ihr Konto aus der Sandbox

Um Ihre App in der Produktion zu verwenden, holen Sie Ihr Konto aus der SMS-Sandbox und übergeben Sie es in die Produktion. Nachdem Sie in der eine Originationsidentität konfiguriert haben AWS-Region , die die AWS End User Messaging SMS Ressourcen enthält, die Amazon Cognito verwenden soll, können Sie US-Telefonnummern verifizieren, während Ihre in der AWS-Konto SMS-Sandbox verbleiben. Wenn sich Ihre Umgebung in der Produktionsumgebung befindet, müssen Sie die Telefonnummern der Benutzer nicht verifizieren, bevor Sie SMS-Nachrichten an sie senden.

Sie können eine Anfrage zum Verlassen der Sandbox entweder von der AWS End User Messaging SMS Konsole oder der Amazon SNS SNS-Konsole aus erstellen. Eine ausführliche Anleitung finden Sie im Benutzerhandbuch unter Umstieg aus der SMS-Sandbox.AWS End User Messaging SMS

Verwenden Sie Simulatornummern oder verifizierte Telefonnummern mit AWS End User Messaging SMS

Wenn Sie Ihr Konto aus der SMS-Sandbox verschoben haben, überspringen Sie diesen Schritt.

Wenn Sie sich in der Sandbox befinden, aber eine Ausgangsnummer eingerichtet haben, können Sie Nachrichten an verifizierte Zielnummern senden. Informationen zum Einrichten verifizierter Ziele finden Sie im AWS End User Messaging SMS Benutzerhandbuch unter Hinzufügen einer verifizierten Zieltelefonnummer.

Sie können auch Nachrichten mit simulierten Absendern und Zielen senden. Simulatornachrichten erzeugen Protokolle, werden jedoch nicht über das Carrier-Netzwerk gesendet. Wählen Sie im Menü Kurzbefehle die Option SMS-Versand mit SMS-Simulator testen aus. Weitere Informationen finden Sie im AWS End User Messaging SMS Benutzerhandbuch unter Simulator-Telefonnummern.

Die Benutzerpool-Einrichtung in Amazon Cognito abschließen

Kehren Sie zur Browser-Registerkarte zurück, auf der Sie Ihren Benutzerpool erstellt oder bearbeitet haben. Schließen Sie das Verfahren ab. Wenn Sie Ihrem Benutzerpool erfolgreich eine SMS-Konfiguration hinzugefügt haben, sendet Amazon Cognito eine Testnachricht an eine interne Telefonnummer, um zu überprüfen, ob Ihre Konfiguration funktioniert. AWS End User Messaging SMS Gebühren für jede Test-SMS-Nachricht.