Zum Hauptinhalt springen
Dieser Leitfaden erklärt, wie eine Produktionsintegration von Didit Authentication aufgebaut ist, von der ersten Weiterleitung bis zur Go-Live-Checkliste. Wenn Sie eine Person noch nicht angemeldet haben, beginnen Sie mit dem Schnellstart. Den Code für jedes SDK finden Sie in den Plattform-Schnellstarts.

Architektur

An dem Ablauf sind vier Komponenten beteiligt: In Ihrer App darf nie ein Didit-API-Schlüssel oder ein Geheimnis liegen: Der öffentliche Schlüssel ist öffentlich, und der Code-Austausch ist durch PKCE statt durch ein Client-Secret geschützt.

Gehostete Seiten oder eigene Bildschirme

Legen Sie fest, wo Personen ihre E-Mail-Adresse, ihr Passwort oder ihren Code eingeben. Die Einstellung ist sign_in_ui (standardmäßig hosted, alternativ own), und Sie können sie später ändern. Passkeys gehören zum Anmelde-Origin Ihrer Anwendung. Die Passkey-Methoden der SDKs funktionieren nur auf Seiten, die von diesem Origin ausgeliefert werden. Auf Ihren eigenen Bildschirmen auf einer anderen Domain verweisen Sie Personen für Passkeys daher auf die gehostete Seite.

Wählen Sie Ihr SDK

Ohne SDK implementieren Sie den Authorization-Code-Flow mit PKCE selbst: Die JavaScript-Schnellstartanleitung zeigt den gesamten Vertrag.

Ihr Backend schützen

Die Sitzungsprüfung im Frontend steuert nur, was angezeigt wird. Ihr Backend trifft jede Entscheidung auf Basis eines verifizierten Tokens.
  1. Prüfen Sie das Zugriffstoken bei jeder Anfrage. Prüfen Sie die ES256-Signatur anhand des JWKS Ihres Ausstellers, anschließend iss, aud, exp und typ: at+jwt. Lehnen Sie ein Token ab, dessen act nicht null ist, es sei denn, die Route akzeptiert KI-Agenten. Siehe Token auf Ihrem Server prüfen.
  2. Prüfen Sie die aktive Sitzung vor einer sensiblen Aktion. Ein Zugriffstoken bleibt bis zu seinem Ablauf gültig, also höchstens 5 Minuten. GET /session/ schlägt sofort fehl, wenn die Sitzung widerrufen wurde, inaktiv geworden oder abgelaufen ist, wenn die Person gesperrt wurde oder wenn die Sitzung Ihre MFA-Richtlinie nicht mehr erfüllt. Siehe Sitzung prüfen.
  3. Fordern Sie einen Step-up an, wenn die Aktion riskant ist. Fragen Sie vor einer Auszahlung, einem neuen Bankkonto oder einer Änderung der E-Mail-Adresse oder Telefonnummer bei Didit an, ob sich die Person erneut verifizieren muss. Handeln Sie nur auf Basis eines approved-Step-ups, den Ihr Backend selbst gelesen hat. Siehe Step-up vor sensiblen Aktionen.
  4. Übernehmen Sie vendor_data aus dem verifizierten Token, niemals aus einem Feld, das der Browser gesendet hat, und verwenden Sie es für die Verifizierungen und Transaktionen der Person.

Sitzungen

Die Laufzeiten ändern Sie unter Authentication > Security and sessions oder per API in den Anwendungseinstellungen.
Die Ansicht Active sessions in der Didit Business Console mit angemeldeten Sitzungen, jeweils mit Gerät, Standort, Beginn, letzter Aktivität, Ende und einer Revoke-Schaltfläche

Authentication > Sign-ins > Active sessions, mit Revoke bei jeder Sitzung.

Native Apps

Didit leitet Benutzer nur über eine HTTPS-Weiterleitung in eine native App zurück und akzeptiert keine benutzerdefinierten URL-Schemata.
  • iOS: Machen Sie die Weiterleitung zu einer zugehörigen Domain, mit webcredentials in Ihrer apple-app-site-association.
  • Android: Machen Sie die Weiterleitung zu einem App Link, mit Ihrer assetlinks.json.
  • Registrieren Sie jede Weiterleitungs-URL unter Authentication > Security and sessions, wie eine Web-Callback-URL.
Für Passkeys in Ihrer App registrieren Sie die Apps, die die Passkeys Ihrer Anwendung gemeinsam nutzen, mit PUT native-apps/ über die Authentication-Management-API. Didit nimmt diese dann in die apple-app-site-association und die assetlinks.json auf, die auf Ihrem Anmelde-Origin ausgeliefert werden. MANAGEMENT_BASE ist die Adresse der Management-API Ihrer Anwendung, und ein API-Schlüssel mit dem Bereich authentication und write kann den Aufruf ausführen. Der Aufruf ersetzt beide Listen. Senden Sie daher beide mit:
Die Schnellstartanleitungen für iOS und Android zeigen die App-Seite.

Identitätsverifizierung und Transaktionsüberwachung verbinden

Jede Person hat genau einen vendor_data-Wert, der in ihren Tokens und ihrer Sitzung enthalten ist. Verwenden Sie ihn als vendor_data, wenn Sie eine Verifizierungssitzung erstellen oder eine Transaktion übermitteln. Die Konsole zeigt dann Anmeldungen, Verifizierungen und Transaktionen derselben Person an.
  • Um Personen bei der Registrierung oder erneut vor einer Auszahlung zu verifizieren, ohne einen Verifizierungsablauf aufzubauen, nutzen Sie die verifizierte Identität.
  • Anmeldeereignisse gelangen automatisch zu den Ereignisregeln und in die Betrugsansichten. Senden Sie für dieselben Anmeldungen keine eigenen auth.login-Ereignisse.
  • Eine erfolgreiche Anmeldung genehmigt niemals eine Verifizierung oder eine Transaktion. Behandeln Sie die Entscheidung jedes Produkts separat.
Siehe dieselbe Person über alle Produkte hinweg beibehalten.

Sign-in-Ereignisse empfangen

Abonnieren Sie ein Webhook-Ziel für die auth.*-Typen, die Sie benötigen, zum Beispiel auth.new_device oder auth.account_locked. Dedupizieren Sie anhand von auth_event.event_id und prüfen Sie die Signatur wie bei jedem Didit-Webhook. Alle Typen und ihre Payloads finden Sie unter Ereignisse und Webhooks.

Bestehende Benutzer migrieren

Wenn Ihre Benutzer bereits Konten bei einer anderen Identitätsplattform oder in Ihrer eigenen Datenbank haben, importieren Sie sie, bevor Sie die Anmeldung umstellen. Importieren Sie die Passwort-Hashes, sofern die Quelle sie bereitstellt, behalten Sie die Social-Login-Verknüpfungen bei und speichern Sie Ihre eigenen Benutzer-IDs als external_id, die dann als vendor_data hinterlegt werden. Für Ihre Benutzer ändert sich nichts, bis Sie Ihre App auf Didit umstellen.

Checkliste für den Go-live

  1. Die Authentifizierung ist für Ihre Live-Anwendung auf der Seite Products aktiviert.
  2. Ihre produktiven Redirect-URLs mit https:// und erlaubte Ursprünge sind in der Live-Anwendung registriert. Eine Live-Anwendung akzeptiert keine http://-Adressen.
  3. Jede Social-Login-Methode verwendet Client-ID und Secret Ihrer eigenen App. Die Testzugangsdaten von Didit funktionieren nur in der Sandbox.
  4. Ihre Produktionskonfiguration enthält den Live-Publishable-Key (pk_live_) und Ihren Live-Issuer.
  5. Ihre MFA-Richtlinie, Sitzungsdauer, Inaktivitäts-Timeout, Passwortlänge und Registrierungsrichtlinie entsprechen Ihren Vorgaben. Siehe Anwendungseinstellungen.
  6. Bot-Schutz ist aktiviert, einschließlich der Prüfung auf kompromittierte Passwörter.
  7. Ihr Backend verifiziert jedes Access-Token und ruft GET /session/ vor sensiblen Aktionen auf.
  8. Ihr Branding, Ihre Seitentexte sowie Links zu Nutzungsbedingungen und Datenschutzbestimmungen sind festgelegt. Wenn Sie eine benutzerdefinierte Domain planen, aktivieren Sie diese, bevor Nutzer Passkeys hinzufügen.
  9. Ihr Webhook-Ziel hat die auth.*-Typen abonniert, die Sie verarbeiten.
  10. Sie haben Registrierung, Anmeldung zurückkehrender Nutzer, Abbruch, Passwort vergessen, MFA, Ablauf der Sitzung, Abmeldung und eine widerrufene Sitzung auf der Live-Anwendung getestet.

Fehlerbehebung

Zuletzt geändert am 22. November 2026