> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# KYC 인증 커스텀 도메인: DNS 설정

> verify.didit.me 대신 자체 서브도메인으로 Didit 인증 흐름을 제공하세요. 도메인 추가, DNS 레코드 2개 생성, 소유권 확인 순서로 진행합니다.

자체 서브도메인에서 인증 플로우를 제공하세요. `verify.didit.me` 대신 `verify.yourbrand.com`을 사용합니다. 사용자는 전체 과정에서 자사 도메인에 머물기 때문에, [화이트 라벨](https://docs.didit.me/ko/console/white-label.md) 플로우에서 Didit을 드러내는 마지막 요소가 사라집니다.

> [!NOTE]
>
> 커스텀 도메인은 화이트 라벨에 포함되며, **Scale** 및 **Enterprise** 요금제에서 사용할 수 있습니다. 또한 **Customization**에 대한 쓰기 권한이 필요합니다. 읽기 전용 권한을 가진 멤버에게는 이 섹션이 비활성화되어 표시됩니다.

> [!NOTE]
>
> 조직이 Scale 또는 Enterprise를 벗어나면(유료 요금제 없이 끝나는 Scale 체험판 포함) 커스텀 도메인이 제거되고, 새 인증 링크는 다시 Didit의 도메인을 사용합니다. 2026년 11월 1일 이전에 연결된 커스텀 도메인은 모든 요금제에서 유지됩니다. 이 도메인을 삭제하는 경우 커스텀 도메인을 다시 추가하려면 Scale 또는 Enterprise가 필요합니다.

> [!NOTE]
>
> 커스텀 도메인은 **라이브 애플리케이션**에서만 사용할 수 있습니다. [샌드박스](https://docs.didit.me/ko/integration/sandbox-testing.md) 애플리케이션에는 추가할 수 없으며, 샌드박스 세션은 항상 기본 호스팅 인증 도메인에서 실행됩니다. 도메인을 설정하려면 Business Console에서 라이브 애플리케이션으로 전환하세요.

***

## 요구 사항

| 요구 사항 | 세부 정보 |
| - | - |
| **라이브 애플리케이션** | 도메인은 라이브 애플리케이션에 속합니다. 샌드박스 애플리케이션에서는 커스텀 도메인을 설정할 수 없습니다. |
| **서브도메인만 가능** | `verify.yourbrand.com`을 사용하세요. `yourbrand.com`과 같은 루트 도메인과 `www.` 접두사는 거부됩니다. |
| **사용 중이 아님** | 이 서브도메인은 귀하의 기존 웹사이트나 애플리케이션을 가리킬 수 없습니다. |
| **DNS 접근 권한** | DNS 제공업체에서 레코드 두 개를 생성해야 합니다. |

***

## 작동 방식

Business Console에 서브도메인을 입력합니다. 그러면 Didit이 제공업체에 추가할 DNS 레코드 두 개를 생성합니다.

| 레코드 | 용도 |
| - | - |
| **확인 CNAME** | 도메인 소유권을 증명하며, 이를 통해 SSL 인증서가 발급됩니다. |
| **CloudFront CNAME** | 서브도메인이 인증 UI를 가리키도록 설정합니다. |

두 레코드 모두 필수입니다. 두 레코드가 DNS에서 확인되면 콘솔에서 소유권을 인증합니다. 그 후 인증 플로우가 사용자의 도메인에서 제공됩니다.

***

## 도메인 설정

**1. 도메인 추가**

**Customization > Domain**으로 이동하여 서브도메인(예: `verify.yourbrand.com`)을 입력한 다음 **도메인 추가**를 클릭하세요.

콘솔이 DNS 레코드를 생성합니다. 몇 초 정도 걸립니다.

**2. 레코드 두 개 복사**

콘솔에 **확인 CNAME**과 **CloudFront CNAME**에 대한 카드가 각각 표시됩니다. 각 카드에는 두 개의 값이 있습니다.

| 카드 필드 | DNS 제공업체에서 입력할 위치 |
| - | - |
| **호스트명** | 레코드 **이름**(호스트) |
| **데이터/URL** | 레코드 **값**(대상) |

> [!WARNING]
>
> DNS 제공업체에 붙여넣을 때 **호스트명**과 **데이터/URL**을 바꾸지 마세요. 각 값은 해당 복사 버튼으로 복사하세요. 인증 값은 길어서 입력 실수가 생기기 쉽습니다.

**3. DNS 제공업체에 레코드 두 개 모두 추가**

두 레코드를 모두 `CNAME`으로 생성하세요. CloudFront 레코드만 추가하는 것은 나중에 인증이 실패하는 가장 흔한 원인입니다.

TTL을 `300`으로 설정하면 이후에 수정한 내용이 몇 시간이 아니라 몇 분 안에 반영됩니다.

**4. 소유권 확인**

콘솔로 돌아가 **도메인 확인**을 클릭하세요. 성공하면 패널이 **도메인 확인됨**으로 바뀌고 버튼이 사라집니다.

실패하면 콘솔에 구체적인 사유가 표시된 **인증 실패** 상자가 나타납니다. 무엇이든 변경하기 전에 이 내용을 먼저 읽으세요. 누락되었거나 잘못된 레코드가 명시되어 있습니다.

> [!NOTE]
>
> DNS는 보통 몇 분 안에 전파되지만 최대 **24\~48시간**이 걸릴 수 있습니다. 콘솔에 **DNS 변경 감지됨**이 표시되면 레코드는 올바르며, 전파가 아직 진행 중입니다. 별도 조치는 필요하지 않습니다.

***

## 도메인 변경 또는 제거

인증 플로우를 다른 서브도메인으로 옮기려면 새 서브도메인을 입력하고 **도메인 업데이트**를 클릭하세요. Didit이 새 레코드 쌍을 발급하므로, 이 레코드를 DNS 제공업체에 추가하고 다시 확인해야 합니다.

`verify.didit.me`로 돌아가려면 입력란을 비우고 **도메인 제거**를 클릭하세요.

> [!NOTE]
>
> 커스텀 도메인이 설정되어 있는 동안에는 Didit 로그인 화면을 다시 활성화할 수 없습니다. 먼저 도메인을 제거하세요.

***

## 문제 해결

> [accordion] 500 오류 또는 다른 CloudFront 배포에 대한 메시지
>
> 하위 도메인에 CNAME과 충돌하는 `A` 레코드가 있습니다. 하나의 호스트에는 두 레코드가 함께 있을 수 없습니다. `A` 레코드를 삭제하고 CNAME만 남기십시오.
>
> `A` 레코드가 없다면 CloudFront CNAME이 잘못된 대상을 가리키고 있는 것입니다. 콘솔의 **데이터/URL** 값과 한 글자도 다르지 않은지 대조하십시오.

> [accordion] 인증이 계속 성공하지 않음
>
> 제공업체에 **두** 레코드가 모두 있는지 확인하십시오. CloudFront 레코드만 추가하는 것이 가장 흔한 원인입니다. 이 경우 흐름은 정상적으로 로드되는 것처럼 보이지만 인증서가 발급되지 않습니다.
>
> 콘솔의 **인증 실패** 상자에 누락되었거나 잘못된 레코드가 표시됩니다.

> [accordion] 인증서가 발급되지 않음(Cloudflare)
>
> 두 레코드를 모두 **DNS 전용**으로 설정하십시오. 회색 구름, 즉 프록시를 끈 상태입니다. 주황색 구름 프록시는 요청을 가로채 인증서 발급을 방해합니다.
>
> cPanel처럼 프록시 전환 기능이 없는 제공업체는 영향을 받지 않습니다.

> [accordion] 레코드 이름이 중복됨
>
> 일부 제공업체는 영역(zone)을 자동으로 덧붙입니다. 그래서 `verify.yourbrand.com`이 `verify.yourbrand.com.yourbrand.com`이 되기도 합니다.
>
> 이런 제공업체에서는 콘솔에 표시된 전체 이름 대신 **상대** 이름을 입력하십시오. `verify.yourbrand.com` 대신 `verify`를, `_abc123.verify.yourbrand.com` 대신 `_abc123.verify`를 입력합니다. 그다음 저장된 레코드를 다시 열어, 저장된 전체 이름이 콘솔의 **호스트명**과 정확히 일치하는지 확인하십시오.

> [accordion] 수정 사항이 적용되는 데 몇 시간이 걸림
>
> 레코드는 TTL 기간만큼 캐시됩니다. TTL을 `300`으로 낮추고, 다시 테스트하기 전에 이전 값이 만료될 때까지 기다리십시오.

***

## 다음 단계

* **나머지 UI를 브랜드에 맞추십시오** — 색상, 로고, 서체는 [맞춤 설정](https://docs.didit.me/ko/console/white-label.md)에서 관리합니다.
* **워크플로별로 스타일을 활성화하십시오** — 브랜딩은 **사용자 정의 스타일 포함**을 켠 워크플로에만 적용됩니다. [화이트 라벨](https://docs.didit.me/ko/console/white-label.md#워크플로에서-사용자-정의-스타일-활성화)을 참조하십시오.
* **공개 의무를 검토하십시오** — 커스텀 도메인은 Didit 브랜딩을 숨기지만 Didit의 역할까지 숨기지는 않습니다. [규정 준수 책임](https://docs.didit.me/ko/console/white-label.md#화이트-라벨-흐름에서의-규정-준수-책임)을 참조하십시오.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.