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 istsign_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.- Prüfen Sie das Zugriffstoken bei jeder Anfrage. Prüfen Sie die ES256-Signatur anhand des JWKS Ihres Ausstellers, anschließend
iss,aud,expundtyp: at+jwt. Lehnen Sie ein Token ab, dessenactnichtnullist, es sei denn, die Route akzeptiert KI-Agenten. Siehe Token auf Ihrem Server prüfen. - 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. - 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. - Übernehmen Sie
vendor_dataaus 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.

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
webcredentialsin Ihrerapple-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.
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 einenvendor_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.
Sign-in-Ereignisse empfangen
Abonnieren Sie ein Webhook-Ziel für dieauth.*-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 alsexternal_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
- Die Authentifizierung ist für Ihre Live-Anwendung auf der Seite Products aktiviert.
- Ihre produktiven Redirect-URLs mit
https://und erlaubte Ursprünge sind in der Live-Anwendung registriert. Eine Live-Anwendung akzeptiert keinehttp://-Adressen. - Jede Social-Login-Methode verwendet Client-ID und Secret Ihrer eigenen App. Die Testzugangsdaten von Didit funktionieren nur in der Sandbox.
- Ihre Produktionskonfiguration enthält den Live-Publishable-Key (
pk_live_) und Ihren Live-Issuer. - Ihre MFA-Richtlinie, Sitzungsdauer, Inaktivitäts-Timeout, Passwortlänge und Registrierungsrichtlinie entsprechen Ihren Vorgaben. Siehe Anwendungseinstellungen.
- Bot-Schutz ist aktiviert, einschließlich der Prüfung auf kompromittierte Passwörter.
- Ihr Backend verifiziert jedes Access-Token und ruft
GET /session/vor sensiblen Aktionen auf. - 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.
- Ihr Webhook-Ziel hat die
auth.*-Typen abonniert, die Sie verarbeiten. - Sie haben Registrierung, Anmeldung zurückkehrender Nutzer, Abbruch, Passwort vergessen, MFA, Ablauf der Sitzung, Abmeldung und eine widerrufene Sitzung auf der Live-Anwendung getestet.