# 사용자 지정 도메인 설정

> 조직에 사용자 지정 도메인을 추가하고, 소유권 및 라우팅 DNS 레코드를 생성한 뒤 도메인을 인증합니다.

## 시작하기 전에

* 조직의 요금제에 사용자 지정 도메인이 포함되어 있어야 합니다. Free에는 1개가 포함되며, Identity Plus와 Team Plus에는 무제한으로 포함됩니다. [사용자 지정 도메인](/ko/custom-domains#%EC%9A%94%EA%B8%88%EC%A0%9C%EB%B3%84-%ED%8F%AC%ED%95%A8-%EA%B8%B0%EB%8A%A5)을 참조하세요.
* 조직의 **소유자** 또는 **관리자**여야 합니다.
* 등록기관이나 DNS 공급자에서 해당 도메인의 DNS 레코드를 생성할 수 있어야 합니다.
* 사용할 주소를 정해 두어야 합니다. `secrets.example.com`과 같은 하위 도메인을 권장합니다. 하위 도메인은 CNAME 레코드를 사용하므로 서비스의 주소가 바뀌어도 계속 작동합니다. `example.com`과 같은 apex 도메인은 고정 IP 주소를 가리키는 A 레코드가 필요합니다.

## 도메인 추가

1. 로그인한 뒤 사용자 메뉴를 열고 **도메인**을 선택합니다. 그러면 조직 설정의 **도메인** 탭이 열립니다. 도메인은 설정이 열려 있는 조직에 속하게 됩니다.
2. **도메인 추가**를 선택합니다.
3. **사용자 지정 도메인**에 주소를 입력합니다(예: `secrets.example.com`). `example.com`과 같은 apex 도메인을 입력하면 비밀 링크를 어디에 둘지 묻습니다. **인기 있는 하위 도메인** 중 하나를 고르거나 **루트 도메인 사용**을 선택하세요.
4. ***내 도메인*(으)로 계속**을 선택합니다(예: **secrets.example.com(으)로 계속**).

도메인이 조직에 추가되고, 다음 화면에 생성해야 할 DNS 레코드 두 개가 표시됩니다. 지역 선택은 없으며, 레코드는 조직이 사용하는 지역 사이트를 가리킵니다. [도메인이 서비스되는 위치](/ko/custom-domains#%EB%8F%84%EB%A9%94%EC%9D%B8%EC%9D%B4-%EC%84%9C%EB%B9%84%EC%8A%A4%EB%90%98%EB%8A%94-%EC%9C%84%EC%B9%98)를 참조하세요.

## DNS 레코드 생성

DNS 공급자에서 두 레코드를 모두 생성합니다. 값은 도메인의 인증 페이지에서 복사하세요. 아래 예시는 형식만 보여 줍니다.

### 소유권 레코드(TXT)

이 레코드는 사용자가 도메인을 관리하고 있음을 증명합니다. 인증은 이 레코드에 따라 결정됩니다.

* **호스트:** `_onetime-challenge-` 뒤에 도메인의 짧은 식별자가 붙습니다. 하위 도메인의 경우 그 뒤에 하위 도메인이 추가됩니다. 예를 들어 `example.com`에는 `_onetime-challenge-abc1234`, `secrets.example.com`에는 `_onetime-challenge-abc1234.secrets`입니다. 기본 도메인(`example.com`)의 존에 생성하세요.
* **값:** 32자리 16진수 코드입니다.

일부 공급자는 호스트 레이블만 입력받고 존을 자동으로 붙이며, 다른 공급자는 전체 이름을 입력받습니다. 레코드가 `<host>.<your base domain>`에서 조회되고 값이 변경 없이 반환되기만 하면 어느 형식이든 괜찮습니다. 해당 이름에는 이 TXT 레코드만 있어야 합니다. 이전 시도에서 남은 값은 제거하세요.

도메인이 조직에 있는 동안 값은 그대로 유지됩니다. 도메인을 제거했다가 다시 추가하면 새 값이 부여되며, 보통 호스트도 새로 부여됩니다.

인증 후에도 이 레코드를 유지하세요. 인증은 백그라운드에서 반복되며, 레코드를 더 이상 찾지 못하는 검사가 발생하면 도메인 서비스가 중단됩니다.

### 라우팅 레코드(CNAME 또는 A)

이 레코드는 방문자를 Onetime Secret으로 보냅니다.

* **하위 도메인:** 하위 도메인(예: `secrets`)에서 인증 페이지에 표시된 대상으로 향하는 CNAME 레코드입니다.
* **Apex 도메인:** `@`(또는 공급자에 따라 빈 호스트)에 대한 A 레코드로, 인증 페이지에 표시된 IP 주소를 사용합니다.

참고로 각 지역 사이트의 대상은 다음과 같습니다.

| 지역                          | CNAME 대상        | A 레코드 주소              |
| ------------------------------- | ----------------------------- | --------------------------------- |
| 캐나다                       | `identity.ca.onetime.co`      | 인증 페이지에 표시된 값   |
| 유럽 연합                   | `identity.eu.onetime.co`      | `109.105.217.207`                 |
| 아오테아로아 뉴질랜드 | `identity.nz.onetime.co`      | 인증 페이지에 표시된 값   |
| 영국                          | `identity.ingress.onetime.co` | 인증 페이지에 표시된 값 |
| 미국                              | `identity.us.onetime.co`      | `66.51.126.41`                    |

같은 호스트에 대한 다른 A, AAAA 또는 CNAME 레코드는 모두 제거하세요. TXT 소유권 레코드는 충돌하지 않으므로 제거하지 마세요.

## 도메인 인증

1. **도메인** 탭에서 도메인의 메뉴를 열고 **도메인 인증**을 선택하거나, 도메인의 상태를 선택합니다. 인증 페이지에서 **도메인 인증**을 선택합니다. 이 버튼은 잠시 후 다시 사용할 수 있습니다.
2. 서비스는 백그라운드에서도 도메인을 다시 검사하므로, 버튼을 누르지 않아도 인증이 완료될 수 있습니다. DNS 변경은 보통 몇 분 안에 적용되지만, DNS 공급자와 레코드의 TTL(time to live)에 따라 하루 이상 걸릴 수도 있습니다.

TXT 레코드가 발견되면 인증이 성공합니다. 그러면 도메인이 서비스되며, 비밀 메시지를 생성할 때 해당 도메인을 선택할 수 있습니다. 라우팅 레코드와 인증서는 별도로 추적됩니다. 각 단계와 상태 레이블은 [DNS 검증](/en/custom-domains/dns-validation)을 참조하세요.

## 결과 확인

도메인이 준비되면 도메인 탭의 도메인 옆에 체크 표시가 나타나고, 툴팁에 **도메인 확인 완료 및 활성 상태**가 표시되며, 도메인 자체 페이지에는 **활성**이 표시됩니다. 조치가 필요한 도메인은 대신 도메인 탭에 상태가 텍스트로 표시됩니다.

검사가 한 번 실행된 뒤에는 도메인의 인증 페이지에 다음 필드가 있는 **도메인 상태** 패널이 표시됩니다.

* **도메인**: 도메인 이름입니다.
* **상태**: 도메인에 대해 보고된 최신 결과입니다.
* **대상 주소**: 일부 환경에서 서비스가 도메인을 내부적으로 라우팅하는 위치입니다. DNS에 입력할 값이 아닙니다.
* **DNS 레코드**: 마지막 검사 시점에 도메인이 가리키던 위치입니다.
* **SSL 상태**: 인증서가 활성 상태인지 여부입니다.
* **SSL 갱신**: 현재 인증서의 만료일입니다. 서비스가 그 전에 인증서를 갱신하므로 별도로 할 일은 없습니다.
* **마지막 모니터링**: 도메인이 마지막으로 검사된 시각입니다.
* **마지막 확인 검사 실패**: 최신 검사를 완료하지 못한 경우에만 표시됩니다.

## 도메인 사용

로그인한 상태에서 비밀 메시지를 생성할 때, 생성에 사용할 도메인을 선택합니다. 그러면 비밀 링크에 사용자의 도메인이 사용됩니다(예: `https://secrets.example.com/secret/abc123`).

## 질문이 있거나 지원이 필요하신가요?

[support@onetimesecret.com](mailto:support@onetimesecret.com)으로 이메일을 보내거나 [피드백 양식](https://onetimesecret.com/feedback)을 이용하세요.