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

# Benutzerdefinierte Domains

> Richten Sie gebrandete URLs für Ihr Verifizierungsportal und Ihre Konsole mit benutzerdefinierter Domainkonfiguration und DNS-Verifizierung ein.

Benutzerdefinierte Domains ermöglichen es Ihnen, das Truthlocks-Verifizierungsportal und die Konsole von Ihrer eigenen Domain aus zu betreiben. Anstelle von `verify.truthlocks.com` sehen Ihre Benutzer `verify.yourdomain.com`.

> [!NOTE]
>
> Benutzerdefinierte Domains sind in allen Plänen verfügbar. Navigieren Sie zu **Einstellungen > Domains**
> in der Konsole, um loszulegen.

## Domain-Typen

Truthlocks unterstützt zwei Arten von benutzerdefinierten Domains:

| Typ | Zweck | Beispiel |
| :- | :- | :- |
| **Verifizierung** | Öffentliches Verifizierungsportal, auf dem Empfänger und Prüfer Bescheinigungen verifizieren | `verify.yourdomain.com` |
| **Console** | Verwaltungskonsole für Ihr Team | `console.yourdomain.com` |

Sie können je nach Bedarf einen oder beide Typen konfigurieren.

## Einrichten einer benutzerdefinierten Domain

**1. Domain-Einstellungen öffnen**

Navigieren Sie in der Konsole zu **Einstellungen > Domains**.

**2. Eine Domain hinzufügen**

Klicken Sie auf **Domäne hinzufügen**, wählen Sie den Domänentyp (Verifizierung oder Console) und
Geben Sie den Hostnamen ein, den Sie verwenden möchten (z. B. `verify.yourdomain.com`).

**3. Den DNS-Eintrag hinzufügen**

Truthlocks generiert ein eindeutiges Verifizierungs-Token für Ihre Domain. Fügen Sie einen TXT-Eintrag hinzu.
Datensatz zu Ihrer DNS-Konfiguration:

| Feld | Wert |
| :- | :- |
| **Typ** | `TXT` |
| **Name** | `_truthlocks-verify` |
| **Wert** | Das in der Konsole angezeigte Verifizierungs-Token |

Kopieren Sie das Token mit der Schaltfläche **Kopieren** daneben.

**4. Domain verifizieren**

Nachdem Sie den DNS-Eintrag hinzugefügt haben, klicken Sie in der Konsole auf **DNS-Eintrag überprüfen**.
Truthlocks prüft den TXT-Eintrag und aktualisiert den Domain-Status.

> [!TIP]
>
> Die DNS-Propagation kann bis zu 48 Stunden dauern, obwohl die meisten Anbieter
> innerhalb weniger Minuten. Wenn die Verifizierung fehlschlägt, warten Sie einige Minuten und versuchen Sie es erneut.

## Domain-Status

Jede Domäne durchläuft drei Status:

| Status | Bedeutung |
| :- | :- |
| **Ausstehend** | Die Domain wurde hinzugefügt, aber der DNS-Eintrag wurde noch nicht verifiziert. |
| **Verifiziert** | Der DNS-TXT-Eintrag wurde gefunden und validiert. Die Domain wird automatisch aktiv. |
| **Aktiv** | Die Domain ist live und bedient Traffic für Ihren Mandanten. |

## Domains über die API verwalten

Sie können benutzerdefinierte Domänen programmgesteuert hinzufügen, auflisten und verifizieren.

### Domains auflisten

```http Request theme={null}
GET /v1/settings/domains
X-API-Key: tl_live_...
```

```json Response theme={null}
{
  "domains": [
    {
      "id": "dom_abc123",
      "tenant_id": "tn_xyz789",
      "type": "VERIFY",
      "hostname": "verify.acme.com",
      "status": "ACTIVE",
      "verification_token": "tl-verify-abc123def456",
      "verified_at": "2026-03-25T14:30:00Z",
      "created_at": "2026-03-25T14:00:00Z"
    }
  ]
}
```

### Eine Domain hinzufügen

```http Request theme={null}
POST /v1/settings/domains
X-API-Key: tl_live_...
Content-Type: application/json

{
  "type": "VERIFY",
  "hostname": "verify.acme.com"
}
```

Das Feld `type` akzeptiert `VERIFY` für Verifizierungsdomänen oder `CONSOLE` für Konsolendomänen. Die Antwort enthält die `verification_token`, die Sie für die DNS-Einrichtung benötigen.

### Eine Domain verifizieren

```http Request theme={null}
POST /v1/settings/domains/{domain_id}/verify
X-API-Key: tl_live_...
```

Gibt das aktualisierte Domänenobjekt zurück. Wenn der DNS-Eintrag nicht gefunden wird, bleibt der Status `PENDING`.

## Beispiel: vollständige Einrichtung

```bash theme={null}
# 1. Add the domain
curl -X POST https://api.truthlocks.com/v1/settings/domains \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{"type": "VERIFY", "hostname": "verify.acme.com"}'

# 2. Add the TXT record to your DNS (using your DNS provider)
# Name:  _truthlocks-verify
# Value: <verification_token from response>

# 3. Verify the domain
curl -X POST https://api.truthlocks.com/v1/settings/domains/dom_abc123/verify \
  -H "X-API-Key: tl_live_..."
```

## Fehlerbehebung

### Verifizierung schlägt immer wieder fehl

1. Bestätigen Sie, dass der TXT-Eintragname genau `_truthlocks-verify` ist (einige Anbieter fügen die Domain automatisch an – suchen Sie nach Duplikaten wie `_truthlocks-verify.yourdomain.com.yourdomain.com`).
2. Warten Sie auf die DNS-Propagierung. Verwenden Sie `dig TXT _truthlocks-verify.yourdomain.com`, um zu bestätigen, dass der Eintrag sichtbar ist.
3. Stellen Sie sicher, dass der TXT-Wert genau mit dem in der Konsole angezeigten Token übereinstimmt, ohne zusätzliche Leerzeichen.

### Domäne ist verifiziert, aber nicht aktiv

Verifizierte Domänen wechseln automatisch zu Aktiv. Wenn sich der Status nicht aktualisiert, aktualisieren Sie die Seite oder rufen Sie sie erneut über die API ab.

## Verwandt

> [card] [Benutzerdefiniertes Branding](https://docs.truthlocks.com/guides/enterprise-branding.md)
>
> Laden Sie Logos hoch und legen Sie Markenfarben für Verifizierungsseiten und E-Mails fest.

> [card] [E-Mail-Zustellung](https://docs.truthlocks.com/security/email-delivery.md)
>
> Konfigurieren Sie benutzerdefinierte E-Mail-Absender und SMTP-Server.


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