DEV WIKI
인프라 · 오류·증상

TXT 인증 레코드가 권한 있는 DNS 응답에 보이지 않음

TXT 인증 레코드를 등록한 뒤 권한 있는 네임서버의 DNS 응답에서 해당 이름과 값을 확인할 수 있는지 점검하는 문서입니다.

빠른 답변

우선 확인할 원인
TXT 인증 레코드를 등록했는데 권한 있는 DNS 응답에서 보이지 않으면, 인증 레코드 이름·값·변경 시각과 각 권한 있는 네임서버의 TXT 응답을 비교해야 합니다.
먼저 확인할 항목
서비스가 제시한 TXT 레코드 이름과 DNS에 등록한 이름이 같은지 기록합니다.
적용 범위
현재 증상과 본문에 적은 관찰 조건이 함께 확인된 경우
출처 확인일
2026-07-29
최종 검토
2026-07-29
수정일
2026-07-30
오류·수정 제보 (새 창에서 열림)

현재 증상

  • TXT 인증 레코드가 권한 있는 응답에 보이지 않음

먼저 확인할 항목

서비스가 제시한 TXT 레코드 이름과 DNS에 등록한 이름이 같은지 기록합니다.

각 권한 있는 네임서버의 TXT 응답에 해당 레코드가 보이는지와 확인 시각을 기록합니다.

여러 권한 있는 네임서버의 응답이 서로 다른지 비교합니다.

피해야 할 조치

주의

  • 인증 레코드가 보이지 않는다고 기존 TXT 레코드를 일괄 삭제하지 않습니다.
  • DNS 공급자 계정·API 토큰·인증 토큰 전체를 전달하지 않습니다.
  • 인증 서비스의 재검증을 반복 실행하기 전에 제공자의 대기 시간 안내를 확인합니다.

환경별 원인과 조치

적용 범위

이 문서는 TXT 인증 레코드가 권한 있는 DNS 응답에 실제로 보이는지를 확인합니다. 인증 서비스가 제시한 이름이나 값과 등록값이 다른 경우는 TXT 인증 레코드의 이름 또는 값이 제공값과 다름을 확인합니다.

변경 없이 확인할 항목

  1. 서비스가 제시한 TXT 레코드 이름과 DNS에 등록한 이름을 기록합니다.
  2. 각 권한 있는 네임서버가 반환한 TXT 응답과 확인 시각을 기록합니다.
  3. 여러 권한 있는 응답이 서로 다른지 비교합니다.

Let's Encrypt는 DNS-01 검증에서 지정한 이름 아래의 TXT 레코드를 조회합니다. 권한 있는 응답이 보이지 않는다는 사실만으로 인증 서비스의 계정 권한이나 서비스 장애를 확정하지는 않습니다.

다음 문서

권한 있는 DNS 응답에 레코드가 보이지만 인증이 계속 실패하면 해당 서비스의 재검증 시점과 계정 상태를 확인하세요. DNS 기본 개념은 DNS에서 확인합니다.

관찰값 기록

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

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

  1. 서비스가 제시한 TXT 레코드 이름과 DNS에 등록한 이름이 같은지 기록합니다.
  2. 각 권한 있는 네임서버의 TXT 응답에 해당 레코드가 보이는지와 확인 시각을 기록합니다.
  3. 여러 권한 있는 네임서버의 응답이 서로 다른지 비교합니다.

판정 기준

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

안전한 다음 확인

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

참고 자료

Challenge Types (새 창에서 열림)

Let's Encrypt · 공식 자료 · 확인 범위: DNS-01 검증은 지정한 이름 아래 TXT 레코드를 DNS에서 조회해 값이 일치하는지 확인합니다., DNS 공급자마다 변경한 레코드가 모든 서버에서 확인되기까지 시간이 다를 수 있습니다. · 확인일: 2026-07-29

Troubleshooting - Public DNS (새 창에서 열림)

Google · 공식 자료 · 확인 범위: 권한 있는 네임서버의 응답이 서로 다르면 일부 서버가 이전 데이터를 제공할 수 있습니다. · 확인일: 2026-07-29