# keenauth_custom_domain

`keenauth_custom_domain` リソースは、環境にカスタムログインドメインを追加します。ドメインが提供する内容と検証の仕組みについては、[カスタムログインドメインの設定](/docs/guides/custom-domains)を参照してください。

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

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

## ライフサイクル

- ドメインは `pending_dns` の状態で始まります。`dns_records` にある TXT と CNAME のレコードを DNS プロバイダーで公開すると、プラットフォームがそれを検証して証明書を発行します。
- `status`、`is_primary`、`failure_reason`、`certificate_expires_at` は、プラットフォームのチェック結果に従います。読み取り専用で、プランの変更を引き起こすことはありません。
- `hostname` は小文字で、末尾にドットを付けずに記述してください。国際化ドメイン名は A ラベル(`xn--…`)で記述します。
- `hostname` を変更すると、カスタムドメインは置き換えられます。
- リソースを削除するとドメインが解放されます。そのドメインでのサインインは停止し、名前は 30 日間隔離されます。
- プライマリドメインは削除できません。API は `409 custom_domain_in_use` を返します。先に、ダッシュボードまたは `keenauth custom-domains make-primary` で別のドメインをプライマリに設定してください。
- プロバイダーの外部で解放されたドメインはステートから削除され、再度プランに現れます。
- `development` 環境にはカスタムドメインがありません。

## インポート

ホスト名または ID でインポートします:

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