# keenauth_custom_domain

La ressource `keenauth_custom_domain` ajoute un domaine de connexion personnalisé à l'environnement. Voir [Configurer un domaine de connexion personnalisé](/docs/guides/custom-domains) pour savoir ce que le domaine sert et comment fonctionne la vérification.

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

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

## Cycle de vie

- Le domaine démarre en `pending_dns`. Publiez les enregistrements TXT et CNAME de `dns_records` chez votre fournisseur DNS ; la plateforme les vérifie et émet le certificat.
- `status`, `is_primary`, `failure_reason` et `certificate_expires_at` suivent les contrôles de la plateforme. Ils sont en lecture seule et ne provoquent jamais de modification du plan.
- Écrivez `hostname` en minuscules, sans point final. Écrivez les noms internationalisés en A-labels (`xn--…`).
- Modifier `hostname` remplace le domaine personnalisé.
- Supprimer la ressource libère le domaine : la connexion sur ce domaine s'arrête et le nom reste en quarantaine pendant 30 jours.
- Le domaine principal ne peut pas être supprimé ; l'API répond `409 custom_domain_in_use`. Définissez d'abord un autre domaine comme principal, dans le tableau de bord ou avec `keenauth custom-domains make-primary`.
- Un domaine libéré en dehors du fournisseur est retiré de l'état puis replanifié.
- L'environnement `development` n'a pas de domaines personnalisés.

## Importation

Importez par nom d'hôte ou par identifiant :

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