Zum Hauptinhalt springen

Integrationsleitfaden: Auth0

Versenden Sie automatisierte OTPs und sichere SMS-Benachrichtigungen direkt aus Ihrer Auth0-App mithilfe von ClickSend.

Heute aktualisiert

Was enthalten ist

Wenn Sie ClickSend in Auth0 integrieren, erhalten Sie:

  • OTP-Verifizierung – Versenden Sie einmalige Passwörter für das Login oder die Registrierung

  • SMS-Benachrichtigungen – Versenden Sie Echtzeit-Benachrichtigungen für die Multifaktor-Authentifizierung (MFA)


Voraussetzungen

  • Ein ClickSend-Konto

  • Ein Auth0-Konto

  • Ihre ClickSend API-Kundenmeinungen (Benutzername + API-Schlüssel)


Installation

  1. Richten Sie ClickSend in Auth0 ein:

    • Loggen Sie sich in Ihr Auth0-Dashboard ein.

    • Gehen Sie zum Marketplace und klicken Sie auf Integration hinzufügen.

    • Wählen Sie Ihren Tenant aus und erteilen Sie die erforderlichen Berechtigungen.

    • Sie werden zur Library weitergeleitet, wo Sie Ihre ClickSend API-Kundenmeinungen (Benutzername und API-Schlüssel) eingeben müssen.

    • Der API-Schlüssel ist in Ihrem ClickSend-Dashboard zu finden: ClickSend API-Schlüssel.

    • Klicken Sie auf Erstellen, um die Verbindung zu speichern.

  2. Konfigurieren Sie die OTP-Einstellungen in Auth0:

    • Gehen Sie zu Dashboard > Sicherheit > Multifaktor-Authentifizierung (MFA).

    • Aktivieren Sie das Einmalpasswort (OTP).

    • Scrollen Sie zu Richtlinien definieren und setzen Sie Multifaktor-Authentifizierung (MFA) anfordern auf Immer, und klicken Sie dann auf Speichern.

  3. Konfigurieren Sie Phone Message für den Telekommunikationsdienst:

    • Konfigurieren Sie unter Sicherheit den Phone Message Factor für die Telekommunikationsdienst-Zustellung.

    • Aktivieren Sie Phone Message und speichern Sie Ihre Änderungen.

  4. Fügen Sie die ClickSend-Aktion zum Flow hinzu:

    • Klicken Sie im angezeigten Pop-up-Fenster auf Add to Flow.

    • Ziehen Sie die ClickSend-Aktion an die gewünschte Stelle in Ihrem MFA-Flow.


Authentifizierung

Um die Telekommunikationsdienst-Komponente zu aktivieren:

  1. Gehen Sie in den Komponenten-Einstellungen von Auth0 zu den API-Kundenmeinungen.

  2. Geben Sie Folgendes ein:

    • Benutzername – Ihr ClickSend-Benutzername

    • API-Schlüssel – Der in Ihrem ClickSend-Dashboard gefundene Schlüssel


OTP-Verifizierung (Einmalige Passwörter)

Verifizieren Sie Nutzer während des Logins oder der Registrierung mithilfe von einmaligen Passwörtern (OTP).

Konfiguration

  1. Gehen Sie zum Menü Verifizierung > Message Body.

  2. Fügen Sie %otp% dort ein, wo das OTP in Ihrer Nachricht erscheinen soll.

  3. Beispiel: Ihr Verifizierungscode lautet %otp%.

  4. Tipp: Verwenden Sie Magic Text, um gespeicherte Telefonnummern automatisch aus der Nutzer-Datenbank abzurufen.

  5. Anpassen: Passen Sie den Text, das Aussehen und den Flow des „Get OTP“-Buttons an Ihre Bedürfnisse an.


SMS-Benachrichtigung

Versenden Sie Telekommunikationsdienst-Benachrichtigungen für die Multifaktor-Authentifizierung (MFA) oder andere In-App-Auslöser (z. B. Nutzer-Login-Versuche).

Konfiguration

  1. Fügen Sie im Phone Message Factor eine statische oder dynamische Nachricht in das Feld Message Body ein.

  2. Richten Sie optional eine Bestätigungsnachricht ein, nachdem der Telekommunikationsdienst versendet wurde, wie z. B. „Telekommunikationsdienst versendet“.

  3. Erlauben Sie Nutzern, die Nachricht in Echtzeit vor dem Versand zu bearbeiten.


Fehlerbehebung

Wenn das Versenden von Nachrichten fehlschlägt, versuchen Sie Folgendes:

  • API-Kundenmeinungen überprüfen:

    • Bestätigen Sie, dass Sie den korrekten ClickSend-Benutzernamen und API-Schlüssel (nicht Ihr Passwort) eingegeben haben.

  • Ausreichend Guthaben sicherstellen:

    • Überprüfen Sie, ob Ihr ClickSend-Konto über ausreichend Guthaben verfügt. Laden Sie Ihr Konto hier auf.

  • Pflichtfelder ausfüllen:

    • Stellen Sie sicher, dass alle Pflichtfelder (z. B. an Telefonnummer, Message Body) korrekt ausgefüllt sind.


Probleme mit Alpha-Tags:

Wenn Sie einen Unternehmensnamen (Alpha-Tag) als Absender verwenden:

  • Stellen Sie sicher, dass er maximal 11 Zeichen lang ist und keine Leerzeichen enthält.

  • Einige Länder bieten keinen Support für Alpha-Tags. Überprüfen Sie die unterstützte Liste hier.

  • Stellen Sie sicher, dass das Alpha-Tag im ClickSend-Dashboard registriert und genehmigt ist.


FAQs

Kann ich meinen Firmennamen als Absender verwenden?

Ja, aber nur in Ländern, die Support für Alpha-Tags bieten. Stellen Sie sicher, dass das Alpha-Tag:

  • 11 Zeichen oder weniger hat

  • Keine Leerzeichen enthält

  • Über Ihre Seite für Absender-IDs in ClickSend registriert und genehmigt wurde

Wie richte ich ein Alpha-Tag ein?

Gehen Sie im ClickSend-Dashboard zu den API-Kundenmeinungen und aktivieren Sie die Option Alpha-Tag/Absender-ID ändern.

Hat dies deine Frage beantwortet?