DEV WIKI
인프라 · 오류·증상

TXT 인증 레코드의 이름 또는 값이 제공값과 다름

도메인 소유권 인증에 등록한 TXT 레코드의 이름 또는 값이 인증 서비스가 제공한 레코드와 일치하는지 확인하는 문서입니다.

빠른 답변

우선 확인할 원인
TXT 기반 도메인 소유권 인증이 실패하면 서비스가 제시한 TXT 레코드의 이름과 값이 DNS에 등록한 값과 정확히 일치하는지 먼저 확인해야 합니다.
먼저 확인할 항목
인증 서비스가 제시한 TXT 레코드 이름과 값을 비밀값을 가린 상태로 기록합니다.
적용 범위
현재 증상과 본문에 적은 관찰 조건이 함께 확인된 경우
출처 확인일
2026-07-29
최종 검토
2026-07-29
수정일
2026-07-30
오류·수정 제보 (새 창에서 열림)

현재 증상

  • TXT 인증 레코드 값 불일치

먼저 확인할 항목

인증 서비스가 제시한 TXT 레코드 이름과 값을 비밀값을 가린 상태로 기록합니다.

DNS에 등록한 TXT 레코드 이름과 값이 제공값과 각각 일치하는지 기록합니다.

서비스 화면에 표시된 인증 실패 문구와 발생 시각을 기록합니다.

피해야 할 조치

주의

  • 인증 토큰 전체, DNS 공급자 계정·API 토큰, 인증 URL의 비밀값을 공유하지 않습니다.
  • 기존 TXT 레코드를 삭제하기 전에 다른 서비스가 같은 이름을 사용하는지 확인합니다.
  • 서비스가 요구하지 않은 인증 레코드나 값을 임의로 추가하지 않습니다.

환경별 원인과 조치

적용 범위

이 문서는 TXT 인증 레코드의 이름과 값이 서비스가 제시한 값과 일치하는지 확인합니다. 등록값은 맞지만 권한 있는 DNS 응답에서 보이지 않는 경우에는 TXT 인증 레코드가 권한 있는 DNS 응답에 보이지 않음을 확인합니다.

변경 없이 확인할 항목

  1. 인증 서비스가 제시한 TXT 레코드 이름과 값을 비밀값을 가린 상태로 기록합니다.
  2. DNS에 등록한 TXT 레코드 이름과 값이 각각 일치하는지 기록합니다.
  3. 서비스 화면의 인증 실패 문구와 시각을 기록합니다.

Google Search Console과 Let's Encrypt는 각각 DNS TXT 레코드를 이용한 도메인 인증을 제공합니다. 두 서비스의 레코드 이름과 값은 서로 다를 수 있으므로, 다른 서비스의 예시 값을 복사해 사용하지 않습니다.

다음 문서

등록값은 맞지만 권한 있는 DNS 응답에서 보이지 않으면 TXT 인증 레코드가 권한 있는 DNS 응답에 보이지 않음을 확인합니다. DNS 기본 개념은 DNS에서 확인합니다.

관찰값 기록

문제가 발생한 URL 또는 화면, 표시 시각, 운영 환경과 최근 변경 사항을 먼저 기록합니다. 화면이나 로그에 오류 문구가 일부만 보이면 앞뒤 문장을 보존하고 비밀번호·토큰·쿠키·개인정보는 가립니다.

다음 항목을 실제 값과 함께 확인합니다.

  1. 인증 서비스가 제시한 TXT 레코드 이름과 값을 비밀값을 가린 상태로 기록합니다.
  2. DNS에 등록한 TXT 레코드 이름과 값이 제공값과 각각 일치하는지 기록합니다.
  3. 서비스 화면에 표시된 인증 실패 문구와 발생 시각을 기록합니다.

판정 기준

오류 문구가 일치해도 같은 원인이 확정되는 것은 아닙니다. 웹서버·런타임·운영체제·플랫폼과 최근 변경 사항을 비교하고, 기대한 관찰값이 나오지 않으면 다음 단계로 넘어가지 않습니다. 이 문서는 출처가 확인한 범위만 설명하며, 범위를 벗어난 원인과 조치는 단정하지 않습니다.

안전한 다음 확인

설정·권한·데이터를 변경하기 전에 백업과 되돌리기 방법을 기록합니다. 운영 환경의 방화벽 전체 해제, 인증서 검증 우회, 데이터 삭제, 비밀값 공개를 기본 조치로 사용하지 않습니다. 확인 결과가 문서의 조건과 다르면 관련 Platform·Component 문서와 공식 출처를 먼저 확인합니다.

참고 자료

Verify your site ownership (새 창에서 열림)

Google · 공식 자료 · 확인 범위: Search Console의 TXT 인증은 서비스가 제공한 TXT 레코드를 DNS에 추가해 수행합니다. · 확인일: 2026-07-29

Challenge Types (새 창에서 열림)

Let's Encrypt · 공식 자료 · 확인 범위: DNS-01 검증은 특정 TXT 레코드에서 기대한 값이 일치하는지 확인합니다. · 확인일: 2026-07-29