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

# 도메인 인증

> 사용자 지정 도메인의 상태를 확인하고 DNS 및 인증서 문제를 해결하세요.

DNS 레코드를 추가하면 GetQR이 도메인을 인증하고 HTTPS 인증서를 자동으로 발급합니다. 이 페이지에서는 **Domains** 탭의 각 상태와 직접 조치가 필요한 상태를 해결하는 방법을 설명합니다.

> [!NOTE]
>
> 사용자 지정 도메인은 베타 기능이며 아직 모든 워크스페이스에서 사용할 수 있는 것은 아닙니다.

## 시작하기 전에

* 도메인 연결을 시작한 상태여야 합니다. [사용자 지정 도메인 연결](/ko/custom-domains/connect-domain)을 참조하세요.
* **Check now** 실행, 인증서 재시도, 도메인 제거를 하려면 **Admin** 또는 **Editor** 역할이 필요합니다. **Viewer**는 상태를 볼 수 있지만 작업은 할 수 없습니다.

## 도메인 상태 확인

**1. Domains 탭 열기**

사이드바에서 프로필 메뉴를 열고 **My Account**를 클릭합니다. 그런 다음 **Domains** 탭을 선택합니다.

**2. 상태와 호스트 이름 아래의 줄 읽기**

각 도메인에는 상태 레이블과 세부 정보 줄이 표시됩니다. 문제가 있는 경우 세부 정보 줄에 정확한 원인이 표시됩니다(예: "Record not found yet."). 활성화된 도메인의 경우 이를 사용하는 QR 코드 수와 인증서 갱신 시점이 표시됩니다.

**3. 작업 메뉴 열기**

**More actions**(행 끝의 메뉴)를 클릭하여 해당 도메인의 **View DNS record**, **Check now** 및 기타 작업을 확인합니다.

**4. 확인 실행**

레코드를 수정한 후 **Check now**를 클릭합니다. GetQR이 다음 자동 확인을 기다리지 않고 즉시 DNS와 인증서를 확인합니다.

> [!TIP]
>
> 도메인이 **Waiting for DNS** 또는 **Issuing certificate** 상태일 때 상태 레이블을 클릭하면 **Last checked** 및 **Next automatic check** 시간이 표시된 인증 화면이 열립니다.

## 상태

| 상태 | 의미 | 조치 |
| - | - | - |
| **Waiting for DNS** | GetQR이 아직 올바른 CNAME 레코드를 찾지 못했습니다. | 레코드를 추가하거나 수정한 다음 **Check now**를 클릭합니다. |
| **Issuing certificate** | DNS 레코드가 올바르며 HTTPS 인증서를 발급하는 중입니다. 보통 몇 분 정도 걸립니다. | 조치 필요 없음. **Live**가 될 때까지 기다립니다. |
| **Live** | 도메인이 HTTPS로 QR 코드를 제공합니다. | 조치 필요 없음. QR 코드 빌더에서 선택할 수 있습니다. |
| **Certificate failed** | 인증서를 발급하거나 갱신할 수 없습니다. 세부 정보 줄에 이유가 표시됩니다. | 원인을 해결한 다음 **Retry certificate**를 클릭합니다. |
| **Not resolving** | 활성화되었던 도메인이 더 이상 GetQR을 가리키지 않습니다. 해당 도메인의 QR 코드가 스캔되지 않습니다. | DNS 레코드를 복원한 다음 **Check now**를 클릭합니다. |
| **Setup incomplete** | 7일 동안 설정이 진행되지 않아 자동 확인이 중지되었습니다. | 레코드를 수정한 다음 **Check now**를 클릭하여 설정을 다시 시작합니다. |
| **Paused** | 워크스페이스 구독이 비활성 상태여서 도메인이 일시 중지되었습니다. | 구독을 복원합니다. [도움말 센터](https://getqr.com/help)를 참조하세요. |

### GetQR의 확인 주기

* **Waiting for DNS**, **Issuing certificate**, **Live** 도메인은 약 1시간마다 확인합니다.
* **Certificate failed** 및 **Not resolving** 도메인은 약 15분마다 확인하므로 수정된 레코드가 빠르게 반영됩니다.
* **Setup incomplete** 도메인은 **Check now**를 클릭할 때까지 확인하지 않습니다.
* **Check now**는 즉시 확인을 실행합니다. 너무 자주 클릭했다면 1분 정도 기다린 후 다시 시도하세요.

### 이메일 알림

GetQR은 도메인이 활성화될 때, 인증서가 실패할 때, 확인되지 않을 때, 복구될 때, 설정이 미완료로 표시될 때 워크스페이스 멤버에게 이메일을 보냅니다.

## 문제 해결

호스트 이름 아래의 세부 정보 줄과 일치하는 해결 방법을 아래에서 찾으세요.

> **“Record not found yet.”**
>
> GetQR이 아직 하위 도메인의 CNAME 레코드를 찾을 수 없습니다.
>
> 1. **More actions**를 클릭한 다음 **View DNS record**를 클릭하고, DNS 제공업체의 값과 비교합니다.
> 2. 레코드 유형이 **CNAME**이고 이름이 하위 도메인 부분만(예: `qr`) 포함하는지 확인합니다.
> 3. DNS 변경 사항이 전파되는 데 시간이 걸릴 수 있습니다. 나중에 **Check now**를 클릭합니다.

> **“The record points to … — it should be …”**
>
> CNAME이 있지만 잘못된 대상을 가리키고 있습니다.
>
> 1. **More actions**를 클릭한 다음 **View DNS record**를 클릭하고 **Target**을 복사합니다.
> 2. DNS 제공업체에서 CNAME 레코드를 편집하여 값을 해당 대상으로 바꿉니다.
> 3. **Check now**를 클릭합니다.

> **“The record is proxied, so the certificate can't be issued.”**
>
> DNS 제공업체가 레코드를 프록시하고 있어 GetQR이 인증서를 발급할 수 없습니다.
>
> 1. DNS 제공업체에서 레코드를 **DNS only**로 전환합니다. Cloudflare에서는 주황색 구름이 회색이 될 때까지 클릭합니다.
> 2. GetQR로 돌아와 **More actions**를 클릭한 다음 **Retry certificate**를 클릭합니다.

> **“A CAA record is blocking our certificate authority.”**
>
> 루트 도메인에 GetQR이 인증서에 사용하는 Let's Encrypt를 허용하지 않는 CAA 레코드가 있습니다.
>
> 1. 루트 도메인에 다음 CAA 레코드를 추가합니다(`yourbrand.com`을 내 도메인으로 바꾸세요).
>
>    ```text theme={null}
>    yourbrand.com. CAA 0 issue "letsencrypt.org"
>    ```
>
> 2. 기존 CAA 레코드는 유지하세요. 교체하는 것이 아니라 하나를 추가하는 것입니다.
>
> 3. **More actions**를 클릭한 다음 **Retry certificate**를 클릭합니다.

> **“DNS is correct but the certificate hasn't been issued yet.”**
>
> 레코드가 2시간 넘게 올바른 상태였지만 아직 인증서가 발급되지 않았습니다. **More actions**를 클릭한 다음 **Retry certificate**를 클릭합니다. 다시 실패하면 [help@getqr.com](mailto:help@getqr.com)으로 문의하세요.

> **“The certificate expired and couldn't be renewed.”**
>
> 도메인이 활성화되어 있었지만 인증서를 갱신할 수 없었습니다. CNAME 레코드가 여전히 **View DNS record**에 표시된 **Target**을 가리키는지, 프록시되지 않았는지, `letsencrypt.org`를 차단하는 CAA 레코드가 없는지 확인하세요. 그런 다음 **Retry certificate**를 클릭합니다.

> **“Too many retries for this domain”**
>
> 도메인당 시간당 최대 5번까지 인증서를 재시도할 수 있습니다. 먼저 원인을 해결하고 잠시 기다린 후 다시 시도하세요.

> **도메인에 Not resolving이 표시되고 QR 코드가 스캔되지 않습니다**
>
> 활성화된 도메인이 연속 두 번 확인에 실패하면 **Not resolving** 상태로 바뀝니다. 보통 CNAME 레코드가 삭제되거나 변경된 경우입니다. 문제가 해결될 때까지 QR 코드 목록에 경고 배너가 표시됩니다. **View DNS record**에 표시된 대로 정확히 레코드를 복원한 다음 **Check now**를 클릭합니다. 공유 GetQR 단축 도메인의 QR 코드는 영향을 받지 않습니다.

> **도메인에 Setup incomplete가 표시됩니다**
>
> 도메인이 7일 동안 진행되지 않아 GetQR이 확인을 중지했습니다. DNS 레코드를 수정한 다음 **Check now**를 클릭합니다. 새로운 7일 기간과 함께 **Waiting for DNS**부터 설정이 다시 시작됩니다.

> **도메인에 Paused가 표시됩니다**
>
> 워크스페이스 구독이 비활성 상태입니다. 도메인에서 스캔하면 콘텐츠 대신 비활성화 페이지가 표시됩니다. 구독이 다시 활성화되면 DNS를 변경하지 않아도 도메인이 재개됩니다. 결제 관련 질문은 [도움말 센터](https://getqr.com/help)를 참조하세요.

> **QR 코드를 다운로드할 때 “isn't live yet”이 표시됩니다**
>
> QR 코드가 설정이 완료되지 않은 도메인을 사용하거나 도메인이 제거되었습니다. 지금 인쇄하는 것은 스캔되지 않습니다. 다운로드하기 전에 **Open domain settings**를 클릭하여 설정을 완료하세요.

## 도메인 제거

> [!WARNING]
>
> 도메인 제거는 인쇄된 코드에 영구적인 영향을 줍니다. 도메인을 제거하는 즉시 해당 도메인의 모든 QR 코드가 스캔되지 않으며, 인쇄된 코드는 복구할 수 없습니다.

**1. 작업 메뉴 열기**

**Domains** 탭에서 도메인 행의 **More actions**를 클릭합니다.

**2. Remove domain 선택**

**Remove domain**을 클릭합니다. 대화 상자에 해당 도메인을 사용하는 QR 코드 수가 표시됩니다.

**3. 확인**

이 도메인의 모든 QR 코드가 작동을 멈춘다는 것을 확인하는 상자를 체크합니다. 그런 다음 **Remove domain**을 클릭합니다.

## 다음 단계

> **[사용자 지정 도메인 연결](/ko/custom-domains/connect-domain)**
>
> 새 하위 도메인을 설정하세요.

> **[사용자 지정 단축 링크 만들기](/ko/short-links/create-short-link)**
>
> 활성화된 도메인을 QR 코드에 사용하세요.

> **[문제 해결](/ko/faq/troubleshooting)**
>
> 기타 스캔 문제를 해결하세요.

> **[도움말 센터](https://getqr.com/help)**
>
> 결제 및 계정 관련 질문.


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