# keenauth_custom_domain

La risorsa `keenauth_custom_domain` aggiunge un dominio di accesso personalizzato all'ambiente. Vedi [Configurare un dominio di accesso personalizzato](/docs/guides/custom-domains) per capire cosa serve il dominio e come funziona la verifica.

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

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

## Ciclo di vita

- Il dominio parte da `pending_dns`. Pubblica i record TXT e CNAME di `dns_records` presso il tuo provider DNS; la piattaforma li verifica ed emette il certificato.
- `status`, `is_primary`, `failure_reason` e `certificate_expires_at` seguono i controlli della piattaforma. Sono di sola lettura e non causano mai una modifica del piano.
- Scrivi `hostname` in minuscolo, senza punto finale. Scrivi i nomi internazionalizzati come A-label (`xn--…`).
- Cambiare `hostname` sostituisce il dominio personalizzato.
- Rimuovere la risorsa rilascia il dominio: l'accesso su quel dominio si interrompe e il nome resta in quarantena per 30 giorni.
- Il dominio principale non può essere rimosso; l'API risponde `409 custom_domain_in_use`. Prima rendi principale un altro dominio, nella dashboard o con `keenauth custom-domains make-primary`.
- Un dominio rilasciato fuori dal provider viene rimosso dallo stato e pianificato di nuovo.
- L'ambiente `development` non ha domini personalizzati.

## Importazione

Importa tramite hostname o ID:

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