Generieren Sie Einmalpasswörter (OTPs) mit Amazon Pinpoint

Amazon Pinpoint umfasst eine Funktion zur Verwaltung von Einmalkennwörtern (OTP), mit der Sie neue Einmalkennwörter generieren und diese als SMS-Nachrichten an Ihre Empfänger senden können.

Wichtig

Um diese Funktion nutzen zu können, muss Ihr Konto über Produktionszugriff und eine aktive Originationsidentität verfügen. Weitere Informationen finden Sie unter Informationen zur SMS/MMS- und Sprach-Sandbox und Anfordern einer Telefonnummer im SMS-Benutzerhandbuch für AWS Endbenutzernachrichten.

In einigen Ländern und Regionen müssen Sie sich eine eigene Telefonnummer oder Absender-ID besorgen, bevor Sie SMS-Nachrichten versenden können. Wenn Sie beispielsweise Nachrichten an Empfänger in den USA senden, benötigen Sie eine eigene gebührenfreie Nummer, eine 10DLC-Nummer oder eine Kurzwahlnummer. Wenn Sie Nachrichten an Empfänger in Indien senden, benötigen Sie eine registrierte Absender-ID, die eine Principal Entity ID (PEID) und eine Vorlagen-ID umfasst. Diese Anforderungen gelten weiterhin, wenn Sie das OTP-Feature verwenden.

Um dieses Feature verwenden zu können, benötigen Sie Berechtigungen zum Senden und Überprüfen von OTP-Nachrichten, siehe. Einmalpasswörter Wenn Sie Hilfe beim Ermitteln von Berechtigungen benötigen, finden Sie weitere Informationen unterFehlerbehebung der Identitäts- und Zugriffsverwaltung für Amazon Pinpoint.

Sie können die SendOtpMessages-Operation in der Amazon-Pinpoint-API verwenden, um einen OTP-Code an einen Benutzer Ihrer Anwendung zu senden. Wenn Sie diese API verwenden, generiert Amazon Pinpoint einen zufälligen Code und sendet ihn als SMS-Nachricht an Ihren Benutzer. Ihre Anfrage kann die folgenden Parameter enthalten:

• Channel: Der Kommunikationskanal, über den der OTP-Code gesendet wird. Derzeit werden nur SMS-Nachrichten unterstützt, sodass der einzig akzeptable Wert SMS ist.

• BrandName: Der Name der Marke, des Unternehmens oder des Produkts, das dem OTP-Code zugeordnet ist. Dieser Name kann bis zu 20 Zeichen umfassen.

  Anmerkung

  Wenn Amazon Pinpoint die OTP-Nachricht sendet, wird der Markenname automatisch in die folgende Nachrichtenvorlage eingefügt:

  This is your One Time Password: {{otp}} from {{brand}}

  Wenn Sie also Ihren Markennamen angeben ExampleCorp und Amazon Pinpoint ein Einmalpasswort von 123456 generiert, sendet Amazon die folgende Nachricht an Ihren Benutzer:

  This is your One Time Password: 123456 from ExampleCorp

• CodeLength: Die Anzahl der Ziffern, die der OTP-Code enthalten soll, der an den Empfänger gesendet wird. OTP-Codes können zwischen 5 und einschließlich 8 Ziffern enthalten.

• ValidityPeriod: Die Dauer in Minuten, in der der OTP-Code gültig ist. Die Gültigkeitsdauer kann zwischen 5 und einschließlich 60 Minuten liegen.

• AllowedAttempts: Wie oft der Empfänger erfolglos versuchen kann, das Einmalpasswort zu verifizieren. Wenn die Anzahl der Versuche diesen Wert überschreitet, wird das OTP automatisch ungültig. Die maximale Anzahl der zulässigen Versuche beträgt 5.

• Language: Die Sprache im IETF BCP-47-Format, die beim Senden der Nachricht verwendet werden soll. Zulässige Werte sind:

  • de-DE – Deutsch

  • en-GB – Englisch (UK)

  • en-US – Englisch (USA)

  • es-419 – Spanisch (lateinamerikanisch)

  • es-ES – Spanisch

  • fr-CA – Französisch (Kanada)

  • fr-FR – Französisch

  • it-IT – Italienisch

  • ja-JP – Japanisch

  • ko-KR – Koreanisch

  • pt-BR – Portugiesisch (Brasilien)

  • zh-CN – Chinesisch (vereinfacht)

  • zh-TW – Chinesisch (traditionell)

• OriginationIdentity: Die ursprüngliche Identität (z. B. ein Langcode, ein Kurzcode oder eine Absender-ID), die zum Senden des OTP-Codes verwendet wird. Wenn Sie zum Senden des OTP einen Langcode oder eine gebührenfreie Nummer verwenden, muss die Telefonnummer im E.164-Format vorliegen.

• DestinationIdentity: Die Telefonnummer im E.164-Format, an die der OTP-Code gesendet wurde.

• ReferenceId: Eine eindeutige Referenz-ID für die Anforderung. Die Referenz-ID entspricht genau der Referenz-ID, die Sie bei der Überprüfung des OTP angeben. Die Referenz-ID kann zwischen 1 und einschließlich 48 Zeichen enthalten.

• EntityId: Eine Entitäts-ID, die bei einer Aufsichtsbehörde registriert ist. Dieser Parameter wird derzeit nur beim Senden von Nachrichten an Empfänger in Indien verwendet. Wenn Sie nicht an Empfänger in Indien senden, können Sie diesen Parameter weglassen.

• TemplateId: Eine Vorlagen-ID, die bei einer Aufsichtsbehörde registriert ist. Dieser Parameter wird derzeit nur beim Senden von Nachrichten an Empfänger in Indien verwendet. Wenn Sie nicht an Empfänger in Indien senden, können Sie diesen Parameter weglassen.

  Anmerkung

  Weitere Informationen zu den Anforderungen für das Senden von Nachrichten an Empfänger in Indien finden Sie unter Registrierungsprozess für die indische Absender-ID im Amazon Pinpoint Pinpoint-Benutzerhandbuch.

Um sicherzustellen, dass Ihr Amazon Pinpoint Pinpoint-Konto ordnungsgemäß für das Senden von OTP-Nachrichten konfiguriert ist, können Sie das AWS CLI zum Senden einer Testnachricht verwenden. Weitere Informationen zu finden Sie im AWS Command Line Interface Benutzerhandbuch. AWS CLI

Um eine OTP-Testnachricht mit dem zu senden AWS CLI, führen Sie den send-otp-messagefolgenden Befehl im Terminal aus:

aws pinpoint send-otp-message --application-id 7353f53e6885409fa32d07cedexample --send-otp-message-request-parameters Channel=SMS,BrandName=ExampleCorp,CodeLength=5,ValidityPeriod=20,AllowedAttempts=5,OriginationIdentity=[phone],DestinationIdentity=[phone],ReferenceId=SampleReferenceId

Gehen Sie im vorhergehenden Befehl wie folgt vor:

• Ersetzen Sie es 7353f53e6885409fa32d07cedexample durch Ihre Anwendungs-ID.

• ExampleCorpErsetzen Sie es durch den Namen Ihres Unternehmens.

• Ersetzen Sie 5 es durch die Anzahl der Ziffern, die im OTP-Code enthalten sein werden, der an den Empfänger gesendet wird. CodeLegth

• Geben Sie 20 ValidityPeriod an, wie lange der OTP-Code gültig sein wird (in Minuten).

• Geben Sie 5 anAllowedAttempts, wie oft der Empfänger erfolglos versuchen kann, das Einmalpasswort zu verifizieren.

• Ersetzen Sie [phone] in OriginationIdentity durch die ursprüngliche Identität, die zum Senden des OTP-Codes verwendet wurde.

• Ersetzen Sie [phone] in DestinationIdentity durch die Telefonnummer, an die der OTP-Code gesendet werden soll.

• Ersetzen Sie SampleReferenceId in ReferenceId durch eine eindeutige Referenz-ID für die Anfrage.

SendOtpMessage-Antwort

Wenn Sie eine OTP-Nachricht erfolgreich senden, erhalten Sie eine Antwort, die dem folgenden Beispiel ähnelt:

{
    "MessageResponse": {
        "ApplicationId": "7353f53e6885409fa32d07cedexample",
        "RequestId": "255d15ea-75fe-4040-b919-096f2example",
        "Result": {
            "[phone]": {
                "DeliveryStatus": "SUCCESSFUL",
                "MessageId": "nvrmgq9kq4en96qgp0tlqli3og1at6aexample",
                "StatusCode": 200,
                "StatusMessage": "MessageId: nvrmgq9kq4en96qgp0tlqli3og1at6aexample"
            }
        }
    }
}