> ## 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.

# Custom Domain für KYC-Verifizierung: DNS-Einrichtung

> Didit-Verifizierung über eigene Subdomain statt verify.didit.me bereitstellen: Domain hinzufügen, zwei DNS-Einträge setzen, Inhaber bestätigen.

Stellen Sie den Verifizierungsablauf über Ihre eigene Subdomain bereit, zum Beispiel `verify.yourbrand.com` statt `verify.didit.me`. Nutzer bleiben während des gesamten Ablaufs auf Ihrer Domain, was den letzten sichtbaren Hinweis auf Didit in einem [White-Label](https://docs.didit.me/de/console/white-label.md)-Ablauf entfernt.

> [!NOTE]
>
> Die benutzerdefinierte Domain ist Teil von White-Label und in den Tarifen **Scale** und **Enterprise** verfügbar. Sie benötigen außerdem **Schreibzugriff auf Customization**. Mitglieder mit reinem Lesezugriff sehen den Abschnitt deaktiviert.

> [!NOTE]
>
> Wenn Ihre Organisation Scale oder Enterprise verlässt, auch wenn eine Scale-Testphase ohne kostenpflichtigen Tarif endet, wird ihre benutzerdefinierte Domain entfernt, und neue Verifizierungslinks verwenden wieder die Domain von Didit. Eine benutzerdefinierte Domain, die vor dem 1. November 2026 verbunden wurde, bleibt in jedem Tarif erhalten. Wenn Sie sie löschen, benötigen Sie für das erneute Hinzufügen einer benutzerdefinierten Domain Scale oder Enterprise.

> [!NOTE]
>
> Benutzerdefinierte Domains sind nur für **Live-Anwendungen** verfügbar. Eine [Sandbox](https://docs.didit.me/de/integration/sandbox-testing.md)-Anwendung kann keine benutzerdefinierte Domain hinzufügen, und Sandbox-Sitzungen laufen immer über die Standard-Domain für gehostete Verifizierung. Wechseln Sie in der Business Console zu Ihrer Live-Anwendung, um Ihre Domain einzurichten.

***

## Anforderungen

| Anforderung | Details |
| - | - |
| **Live-Anwendung** | Die Domain gehört zu einer Live-Anwendung. Sandbox-Anwendungen können keine benutzerdefinierte Domain konfigurieren. |
| **Nur Subdomain** | Verwenden Sie `verify.yourbrand.com`. Root-Domains wie `yourbrand.com` werden abgelehnt, ebenso ein `www.`-Präfix. |
| **Noch nicht in Verwendung** | Die Subdomain darf nicht auf eine bestehende Website oder Anwendung von Ihnen verweisen. |
| **DNS-Zugriff** | Sie müssen zwei Einträge bei Ihrem DNS-Anbieter anlegen. |

***

## So funktioniert es

Sie geben Ihre Subdomain in der Business Console ein. Didit generiert dann zwei DNS-Einträge, die Sie bei Ihrem Anbieter hinzufügen:

| Eintrag | Zweck |
| - | - |
| **Verification CNAME** | Belegt, dass Ihnen die Domain gehört, und stellt das SSL-Zertifikat aus. |
| **CloudFront CNAME** | Leitet Ihre Subdomain zur Verifizierungsoberfläche weiter. |

Beide Einträge sind erforderlich. Sobald sie aufgelöst werden, bestätigen Sie den Besitz in der Business Console, und der Ablauf wird über Ihre Domain bereitgestellt.

***

## Domain einrichten

**1. Domain hinzufügen**

Rufen Sie **Customization > Domain** auf, geben Sie Ihre Subdomain ein (zum Beispiel `verify.yourbrand.com`) und klicken Sie auf **Domain hinzufügen**.

Die Business Console generiert Ihre DNS-Einträge. Das dauert einige Sekunden.

**2. Die beiden Einträge kopieren**

Die Business Console zeigt für jeden Eintrag eine Karte an: **Verification CNAME** und **CloudFront CNAME**. Jede Karte enthält zwei Werte:

| Kartenfeld | Wohin es bei Ihrem DNS-Anbieter gehört |
| - | - |
| **Hostname** | Der Name des Eintrags (Host) |
| **Daten/URL** | Der Wert des Eintrags (Ziel) |

> [!WARNING]
>
> Vertauschen Sie **Hostname** und **Daten/URL** beim Einfügen bei Ihrem DNS-Anbieter nicht, und verwenden Sie für jeden Wert die Kopierschaltfläche. Die Verifizierungswerte sind lang und lassen sich leicht falsch abtippen.

**3. Beide Einträge bei Ihrem DNS-Anbieter hinzufügen**

Legen Sie beide Einträge als `CNAME` an. Das alleinige Hinzufügen des CloudFront-Eintrags ist der häufigste Grund, warum die Verifizierung später fehlschlägt.

Setzen Sie die TTL auf `300`, damit jede spätere Korrektur innerhalb von Minuten statt Stunden wirksam wird.

**4. Besitz verifizieren**

Kehren Sie zur Business Console zurück und klicken Sie auf **Domain überprüfen**. Bei Erfolg wechselt das Panel zu **Domain verifiziert**, und die Schaltfläche verschwindet.

Schlägt die Prüfung fehl, zeigt die Business Console ein Hinweisfeld **Verifizierung fehlgeschlagen** mit dem konkreten Grund an. Lesen Sie es, bevor Sie etwas ändern: Es nennt den Eintrag, der fehlt oder falsch ist.

> [!NOTE]
>
> DNS wird meist innerhalb weniger Minuten aktualisiert, kann aber bis zu **24–48 Stunden** dauern. Meldet die Business Console **DNS-Änderungen erkannt**, sind Ihre Einträge korrekt und die Aktualisierung läuft noch. Sie müssen nichts tun.

***

## Domain ändern oder entfernen

Um den Ablauf auf eine andere Subdomain umzustellen, geben Sie die neue Subdomain ein und klicken Sie auf **Domain aktualisieren**. Didit erzeugt ein neues Paar von Einträgen, das Sie bei Ihrem DNS-Anbieter hinzufügen und erneut verifizieren müssen.

Um zu `verify.didit.me` zurückzukehren, leeren Sie das Feld und klicken Sie auf **Domain entfernen**.

> [!NOTE]
>
> Solange eine benutzerdefinierte Domain konfiguriert ist, können Sie den Didit-Anmeldebildschirm nicht wieder aktivieren. Entfernen Sie zuerst die Domain.

***

## Fehlerbehebung

> [accordion] Fehler 500 oder eine Meldung über eine andere CloudFront-Distribution
>
> Ihre Subdomain hat einen `A`-Eintrag, der mit dem CNAME in Konflikt steht. Ein Host kann nicht beides haben. Löschen Sie den `A`-Eintrag und behalten Sie nur den CNAME.
>
> Wenn kein `A`-Eintrag vorhanden ist, verweist der CloudFront-CNAME auf das falsche Ziel. Gleichen Sie ihn Zeichen für Zeichen mit dem Wert **Daten/URL** in der Konsole ab.

> [accordion] Die Verifizierung gelingt nie
>
> Prüfen Sie, ob **beide** Einträge bei Ihrem Anbieter vorhanden sind. Wenn nur der CloudFront-Eintrag hinzugefügt wurde, ist das die häufigste Ursache, weil der Ablauf scheinbar lädt, während das Zertifikat nie ausgestellt wird.
>
> Das Feld **Verifizierung fehlgeschlagen** in der Konsole nennt den Eintrag, der fehlt oder falsch ist.

> [accordion] Das Zertifikat wird nie ausgestellt (Cloudflare)
>
> Setzen Sie beide Einträge auf **DNS only**, also graue Wolke mit deaktiviertem Proxy. Der Proxy mit orangefarbener Wolke fängt die Anfrage ab und verhindert die Ausstellung des Zertifikats.
>
> Anbieter ohne Proxy-Schalter, wie cPanel, sind nicht betroffen.

> [accordion] Der Eintragsname wird doppelt angehängt
>
> Manche Anbieter hängen Ihre Zone automatisch an, sodass aus `verify.yourbrand.com` der Name `verify.yourbrand.com.yourbrand.com` wird.
>
> Geben Sie bei diesen Anbietern den **relativen** Namen ein statt des vollständigen Namens, den die Konsole anzeigt: `verify` statt `verify.yourbrand.com` und `_abc123.verify` statt `_abc123.verify.yourbrand.com`. Öffnen Sie danach den gespeicherten Eintrag erneut und prüfen Sie, ob der gespeicherte vollständige Name genau dem **Hostnamen** in der Konsole entspricht.

> [accordion] Eine Korrektur braucht Stunden, bis sie wirksam wird
>
> Ihre Einträge werden für die Dauer ihrer TTL zwischengespeichert. Setzen Sie die TTL auf `300` und warten Sie, bis der vorherige Wert abgelaufen ist, bevor Sie erneut testen.

***

## Nächste Schritte

* **Passen Sie die restliche Oberfläche an Ihre Marke an**: Farben, Logo und Typografie finden Sie unter [Anpassung](https://docs.didit.me/de/console/white-label.md).
* **Aktivieren Sie Ihren Stil pro Workflow**: Das Branding gilt nur für Workflows, bei denen **Individuellen Stil einschließen** aktiviert ist. Siehe [White-Label](https://docs.didit.me/de/console/white-label.md#individuellen-stil-in-ihrem-workflow-aktivieren).
* **Prüfen Sie Ihre Offenlegungspflichten**: Eine benutzerdefinierte Domain blendet das Branding von Didit aus, nicht aber dessen Rolle. Siehe [Compliance-Verantwortlichkeiten](https://docs.didit.me/de/console/white-label.md#compliance-verantwortung-bei-white-label-abläufen).


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