# 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
```