> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Gebrandete Anmeldeseiten, Anmelde-E-Mails und eigene Auth-Domain

> Didit-Anmeldeseiten und Anmelde-E-Mails im eigenen Branding: Texte in fünf Sprachen, Links zu AGB und Datenschutz und eigene Anmelde-Domain.

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](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-branding.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=9653e0d5b5556cec809139cfa6eaf055)

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](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/hosted-sign-in-light-dark.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=835219dfc253b7bfcb830255aff8ff93)

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

## Seitentexte und Links zu rechtlichen Hinweisen

| Feld | Limit | Wo es angezeigt wird |
| - | - | - |
| **Titel der Anmeldung** | 120 Zeichen | Die Überschrift der Anmeldeseite. |
| **Untertitel** | 160 Zeichen | Die Zeile unter der Überschrift. |
| **Titel der Registrierung** | 120 Zeichen | Die Überschrift der Registrierungsseite. |
| **URL der Nutzungsbedingungen** | 500 Zeichen | Ein Link auf den Seiten. Ist er gesetzt, bittet das Registrierungsformular die Person, Ihre Nutzungsbedingungen zu akzeptieren. |
| **URL der Datenschutzerklärung** | 500 Zeichen | Ein Link auf den Seiten, neben Ihren Nutzungsbedingungen. |

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](https://docs.didit.me/de/authentication/set-up-by-api.md) dieselben Felder:

```bash theme={null}
curl --fail-with-body --request PATCH "${MANAGEMENT_BASE}branding/" \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "texts": {
      "en": {"sign_in_title": "Welcome back", "subtitle": "Sign in to manage your account.", "sign_up_title": "Open your account"},
      "es": {"sign_in_title": "Hola de nuevo"}
    },
    "terms_url": "https://example.com/legal/terms",
    "privacy_url": "https://example.com/legal/privacy"
  }'
```

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**:

| E-Mail | Versendet, wenn |
| - | - |
| E-Mail-Code | Eine Person meldet sich mit einem E-Mail-Code an oder registriert sich damit. |
| Magic Link | Eine Person fordert einen Anmelde-Link an. |
| Passwort zurücksetzen | Eine Person startet [Passwort vergessen](https://docs.didit.me/de/authentication/sign-in-methods.md#passwort-vergessen-und-zurücksetzen). |
| Anmeldung von einem neuen Gerät | Eine Person meldet sich von einem neuen Gerät aus an. |
| Einladung | Sie laden eine Person ein, sich mit der Registrierungsrichtlinie `invited` zu registrieren. |
| Einladung zu einer Organisation | Sie laden eine Person zu einer Ihrer [Organisationen](https://docs.didit.me/de/authentication/organizations.md#einladungen) ein. |
| Agent genehmigt, Agent-Zugriff beendet | Der [KI-Agent](https://docs.didit.me/de/authentication/agent-access.md) einer Person erhält Zugriff oder verliert ihn. |

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.

> [!WARNING]
>
> 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.

| Status | Bedeutung |
| - | - |
| Waiting for DNS | Didit hat den `CNAME`-Eintrag noch nicht gefunden. |
| Issuing certificate | Der Eintrag ist vorhanden, und das Zertifikat wird ausgestellt. |
| Verified | Ihre Domain stellt die gehosteten Seiten bereit. Sie ist erst dann Ihr Anmelde-Origin, wenn Sie sie aktivieren. |
| Active | Ihre Domain ist der Anmelde-Origin und der Aussteller. |
| Not found | Die Prüfung ist fehlgeschlagen. Korrigieren Sie den Eintrag und prüfen Sie erneut. |

Ü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](https://docs.didit.me/de/authentication/tokens-and-jwks.md).
* **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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.