# keenauth_custom_domain

El recurso `keenauth_custom_domain` añade un dominio de inicio de sesión personalizado al entorno. Consulta [Configurar un dominio de inicio de sesión personalizado](/docs/guides/custom-domains) para saber qué sirve el dominio y cómo funciona la verificación.

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

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

## Ciclo de vida

- El dominio empieza en `pending_dns`. Publica los registros TXT y CNAME de `dns_records` en tu proveedor de DNS; la plataforma los verifica y emite el certificado.
- `status`, `is_primary`, `failure_reason` y `certificate_expires_at` siguen las comprobaciones de la plataforma. Son de solo lectura y nunca provocan un cambio en el plan.
- Escribe `hostname` en minúsculas y sin punto final. Escribe los nombres internacionalizados como A-labels (`xn--…`).
- Cambiar `hostname` reemplaza el dominio personalizado.
- Eliminar el recurso libera el dominio: el inicio de sesión en ese dominio se detiene y el nombre queda en cuarentena durante 30 días.
- El dominio principal no se puede eliminar; la API responde `409 custom_domain_in_use`. Antes, haz principal otro dominio en el panel o con `keenauth custom-domains make-primary`.
- Un dominio liberado fuera del proveedor se elimina del estado y vuelve a planificarse.
- El entorno `development` no tiene dominios personalizados.

## Importación

Importa por nombre de host o por ID:

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