# keenauth_custom_domain

Die Ressource `keenauth_custom_domain` fügt der Umgebung eine benutzerdefinierte Login-Domain hinzu. Was die Domain ausliefert und wie die Verifizierung funktioniert, steht unter [Eigene Anmeldedomain einrichten](/docs/guides/custom-domains).

```terraform
resource "keenauth_custom_domain" "login" {
  hostname = "login.example.com"
}

output "dns_records" {
  value = keenauth_custom_domain.login.dns_records
}
```

## Lebenszyklus

- Die Domain startet im Status `pending_dns`. Veröffentlichen Sie die TXT- und CNAME-Einträge aus `dns_records` bei Ihrem DNS-Anbieter; die Plattform prüft sie und stellt das Zertifikat aus.
- `status`, `is_primary`, `failure_reason` und `certificate_expires_at` folgen den Prüfungen der Plattform. Sie sind nur lesbar und lösen nie eine Planänderung aus.
- Schreiben Sie `hostname` in Kleinbuchstaben ohne abschließenden Punkt. Internationalisierte Namen schreiben Sie als A-Labels (`xn--…`).
- Eine Änderung von `hostname` ersetzt die benutzerdefinierte Domain.
- Das Entfernen der Ressource gibt die Domain frei: Anmeldungen über diese Domain enden, und der Name bleibt 30 Tage in Quarantäne.
- Die primäre Domain kann nicht entfernt werden; die API antwortet mit `409 custom_domain_in_use`. Machen Sie zuerst eine andere Domain zur primären, im Dashboard oder mit `keenauth custom-domains make-primary`.
- Eine außerhalb des Providers freigegebene Domain wird aus dem State entfernt und neu geplant.
- Die Umgebung `development` hat keine benutzerdefinierten Domains.

## Import

Importieren Sie über Hostname oder ID:

```shell
tofu import keenauth_custom_domain.login login.example.com
tofu import keenauth_custom_domain.login cdom_01j9zq3v8c5m2x7k4t6r1n0b3d
```