Zum Hauptinhalt springen
Didit Authentication verwendet für die gehosteten Anmeldeseiten und die Anmelde-E-Mails Ihr Branding, dasselbe Branding wie für Ihren Verifizierungsablauf. Sie legen die Seitentexte und rechtlichen Links für Authentication fest und können die Anmeldung auf Ihre eigene Domain verlegen, zum Beispiel auth.example.com. Verwalten Sie das in der Business Console unter Authentication > Branding and emails. Dort sehen Sie eine Live-Vorschau der gehosteten Anmeldeseite im hellen und im dunklen Design.
Die Seite Branding and emails in der Didit Business Console für eine Sandbox-Anwendung, mit dem Branding aus Customization, den Seitentexten und einer Vorschau der gehosteten Seite

Authentication > Branding and emails, mit einer Vorschau der gehosteten Seite.

Ihre Marke

Logo, Markenfarbe, Hintergrund, Eckenradius und Schriftart stammen aus den Customization-Einstellungen Ihrer Anwendung in der Console, und die gehosteten Seiten und E-Mails übernehmen sie. Wählen Sie Edit in Customization, um sie zu ändern: Eine Änderung aktualisiert gleichzeitig den Verifizierungsablauf und die Anmeldeseiten.
  • Die Seiten folgen dem Hell- oder Dunkelmodus des Geräts der Person, und die Markenfarbe wird für dunkle Hintergründe angepasst.
  • Die Seiten zeigen den Namen Ihrer Anwendung.
  • Im Free-Tarif zeigen die gehosteten Seiten das Badge Secured by Didit an.
Didits gehostete Anmeldeseite für eine Sandbox-Anwendung im hellen und dunklen Modus, mit Passkey-Schaltfläche sowie E-Mail- und Passwortfeldern

Die gehostete Anmeldeseite passt sich dem Hell- oder Dunkelmodus des Geräts der Person an.

Die gehosteten Seiten sind ins Englische, Spanische, Französische, Deutsche und Japanische übersetzt. Die Sprache wird aus dem Browser der Person übernommen oder aus ui_locales in der Anmelde-URL. Legen Sie Ihre eigenen Texte je Sprache fest: Für eine Sprache ohne Ihren Text bleibt der übersetzte Standardtext von Didit erhalten. Per API setzt PATCH branding/ über die Authentifizierungs-Management-API dieselben Felder:
Ein Text, den Sie leer senden, wird auf den Standardtext zurückgesetzt.

E-Mails zum Anmelden

In der Ansicht Branding and emails sehen Sie die Anmelde-E-Mails Ihrer Anwendung mit einer Vorschau zu jeder E-Mail und der Schaltfläche Send a test: Jede E-Mail ist für Ihre Anwendung als On oder Off markiert. E-Mails werden von Ihrer verifizierten E-Mail-Domain gesendet, wenn Sie diese unter Customization eingerichtet haben, andernfalls von Didit <no-reply@didit.me>.

Benutzerdefinierte Domain

Standardmäßig melden sich Ihre Benutzer über https://<slug>.auth.didit.me an. Eine benutzerdefinierte Domain verlagert die gehosteten Seiten, die Runtime-API und den Token-Aussteller auf eine Subdomain Ihrer eigenen Domain, zum Beispiel auth.example.com. Benutzerdefinierte Domains sind für Live-Anwendungen gedacht: Eine Sandbox-Anwendung meldet Benutzer immer über ihre Didit-Domain an.
Passkeys gehören zu der Domain, über die sich Benutzer anmelden. Wenn Sie eine benutzerdefinierte Domain aktivieren, müssen bestehende Passkeys erneut registriert werden. Fügen Sie Ihre Domain daher hinzu, bevor Benutzer damit beginnen, Passkeys anzulegen.

Einrichtung

  1. Geben Sie unter Custom domain bei Your domain die Domain ein, zum Beispiel auth.example.com, und wählen Sie Add domain. Verwenden Sie eine Subdomain: Ein CNAME kann nicht an der Wurzel Ihrer Domain liegen.
  2. Legen Sie den DNS-Eintrag an, den die Konsole anzeigt: einen CNAME von Ihrer Domain auf den Didit-Host Ihrer Anwendung.
  3. Wählen Sie Check DNS now. Ein neuer Eintrag kann bis zu einer Stunde brauchen, bis er angezeigt wird. Sobald Didit ihn findet, stellt Didit ein Zertifikat für Ihre Domain aus, das sich automatisch erneuert.
  4. Wenn bei der Domain Verified angezeigt wird, wählen Sie Use this domain, um sie als Anmelde-Origin Ihrer Anwendung festzulegen.
Über die API fügen Sie mit PUT domain/ und {"domain": "auth.example.com"} die Domain hinzu, prüfen sie mit POST domain/verify/, aktivieren sie mit POST domain/activate/ und entfernen sie mit DELETE domain/.

Was sich bei der Aktivierung ändert

  • Der Issuer. Neue Token nennen Ihre Domain im Claim iss, und Discovery sowie das JWKS wechseln zu ihr. Aktualisieren Sie den Issuer, den Ihr Backend prüft, oder akzeptieren Sie beide Issuer, bis ältere Token ablaufen. Siehe Token und JWKS.
  • Der Publishable Key. Er kodiert den Issuer und ändert sich daher. Kopieren Sie den neuen Schlüssel aus Authentication > Developers in Ihre App.
  • Sitzungen und Token unter der alten Domain enden innerhalb von 5 Minuten.
  • Passkeys müssen auf der neuen Domain erneut registriert werden.
  • Weiterleitungs-URLs, Einstellungen und die registrierten Benutzer bleiben gleich.
Speichern Sie den Publishable Key in einer einzigen Einstellung Ihrer App, damit der Wechsel nur eine Änderung erfordert.
Zuletzt geändert am 22. November 2026