네이버·다음 · 공식 문서
IndexNow API 키 파일 만드는 법과 인증 확인 순서
IndexNow 키는 8~128자 문자열이고, 키와 같은 이름의 .txt 파일에 키만 적어 UTF-8 로 저장한 뒤 사이트 루트에 둡니다. 검색엔진은 URL 을 제출받으면 이 파일을 크롤링해 소유를 확인하며, 서브도메인은 별개 호스트라 키 파일을 따로 둡니다.
IndexNow 로 URL 을 보내려면 먼저 그 사이트의 주인이라는 것을 보여야 합니다. 그 증명이 사이트에 올려 두는 키 파일 하나입니다.
네이버 서치어드바이저와 IndexNow.org 는 키 규칙을 조금 다르게 적었습니다. 두 문서를 맞대어 양쪽 모두에 맞는 키를 만드는 순서로 정리했습니다.
발견 01
키는 8~128자이고, 0~9 와 a~f 로 만들면 네이버와 IndexNow 규칙에 모두 맞습니다
| 규칙 | 네이버 서치어드바이저 원문 | IndexNow.org 원문 |
|---|---|---|
| 길이 | key의 길이는 최소 8자, 최대 128자입니다. | Your-key should have a minimum of 8 and a maximum of 128 hexadecimal characters.키는 16진수 문자 8자 이상 128자 이하여야 한다. |
| 쓸 수 있는 글자 | key는 16진수에 사용되는 문자, 숫자, - 만을 이용해서 만들어야 합니다. | The key can contain only the following characters: lowercase characters (a-z), uppercase characters (A-Z), numbers (0-9), and dashes (-).키에는 영문 소문자(a-z)·대문자(A-Z)·숫자(0-9)·하이픈(-)만 쓸 수 있다. |
| 인코딩·파일 이름 | UTF-8 인코딩을 사용해야 합니다. key 값의 내용을 담은 파일을 'key와 동일한 이름'.txt 로 저장하여 웹사이트의 루트 디렉터리에 업로드합니다. | Save the file in UTF-8 encoding with the key as the filename, followed by .txt.키를 파일 이름으로 하고 .txt 를 붙여 UTF-8 로 저장한다. |
| 순서 | 할 일 | 방법 |
|---|---|---|
| 1 | 키 문자열 만들기 | UUID 생성기로 만든 값에서 하이픈을 뺀 32자처럼, 0~9 와 a~f 만으로 8~128자를 만듭니다. |
| 2 | 텍스트 파일 만들기 | 파일 안에는 키 한 줄만 넣고 UTF-8 로 저장합니다. |
| 3 | 파일 이름 정하기 | 키와 똑같은 이름에 .txt 를 붙입니다. 예: 0f26d5e892544f74b806ec5c5522e6a1.txt |
| 4 | 사이트 루트에 올리기 | https://도메인/키.txt 로 열리는 자리에 둡니다. 서브도메인마다 따로 둡니다. |
쓰는 제작 플랫폼·호스팅·CDN 이 IndexNow 를 지원하면 키 파일을 직접 만들 일이 없습니다(원문: When your CMS, hosting provider, or SEO plugin supports IndexNow, you don't need a key file.) 그 기능이 있는지부터 확인합니다.
발견 02
키 파일은 사이트 루트에 두고, 다른 자리에 두면 keyLocation 과 범위 제한이 붙습니다
| 자리 | 네이버 원문 | IndexNow.org 원문 |
|---|---|---|
| 루트(권장) | key 값의 내용을 담은 파일을 'key와 동일한 이름'.txt 로 저장하여 웹사이트의 루트 디렉터리에 업로드합니다. | It is strongly recommended that you use Option 1 and place your file key at the root directory of your web server.1번 방식, 곧 키 파일을 웹 서버 루트 디렉터리에 두는 방식을 강하게 권한다. |
| 다른 디렉터리 | 이 경우에는 API 요청 시에 keyLocation 정보를 명시해 주어야 합니다. 주의할 점은 특정 디렉터리에 올린 key 정보는 같은 디렉터리에 있는 웹페이지의 갱신을 알릴 때만 유효합니다. | In this option 2, the location of a key file determines the set of URLs that can be included with this key.2번 방식에서는 키 파일이 놓인 위치가 그 키로 보낼 수 있는 URL 범위를 정한다. |
| 도메인·서브도메인이 여럿 | 주의할 점은 웹사이트가 여러 개의 도메인으로 이루어져 있다면, 각 도메인마다 별개의 key를 이용해야 합니다. | Each subdomain is treated as a separate host, which means you must create and manage individual key files for each one.서브도메인은 각각 별개 호스트로 보므로 서브도메인마다 키 파일을 따로 만들고 관리해야 한다. |
| 검색엔진이 하는 일 | 원문 |
|---|---|
| 네이버 | 웹사이트 관리자가 IndexNow API를 이용하기 위해서는, 웹사이트의 소유자임을 알리는 고유의 key를 사용해야 합니다. key 파일을 생성해서 웹사이트에 올리면, 검색엔진은 해당 key의 내용을 확인하고, 웹사이트의 API 사용이 적법한지 판단합니다. |
| IndexNow.org | Once you submit your URLs to search engines, search engines will crawl the key file to verify ownership and use the key until you change the key.URL 을 제출하면 검색엔진이 키 파일을 크롤링해 소유를 확인하고, 키를 바꿀 때까지 그 키를 쓴다. |
발견 03
인증은 키 파일 URL 을 직접 열어 보고, 첫 제출의 응답 코드로 5단계 확인합니다
| 순서 | 할 일 | 보이는 것 |
|---|---|---|
| 1 | 로그인하지 않은 브라우저에서 https://도메인/키.txt 열기 | 키 한 줄만 글자로 보이면 됩니다. |
| 2 | 회사 밖 네트워크에서 같은 URL 열기 | 로그인·방화벽·IP 제한 없이 열려야 검색엔진이 읽습니다. |
| 3 | URL 하나를 제출해 응답 코드 보기 | 첫 요청은 202(키 확인 중)일 수 있고, 확인이 끝나면 200 이 옵니다. |
| 4 | 403·422 가 오면 파일과 요청 대조 | 403 은 키 불일치, 422 는 URL 과 키의 호스트 불일치입니다. |
| 5 | 키를 바꿀 때 파일부터 교체 | 새 키 파일을 올린 뒤 새 키로 제출하면 검색엔진이 다시 확인합니다. |
| 확인 항목 | 원문 |
|---|---|
| 파일이 열리면 | If the file loads and displays only your key, your site is verified.파일이 열리고 키만 보이면 사이트 인증이 된 것이다. |
| 열려야 하는 조건 | File accessibility: It must be reachable at https://yourdomain.com/{your-key}.txt without login, firewall, or IP restrictions파일 접근성: 로그인·방화벽·IP 제한 없이 https://도메인/{키}.txt 로 열려야 한다. |
| 첫 요청 | For your first request, you may receive an HTTP 202 response.첫 요청에는 HTTP 202 응답이 올 수 있다. |
| 202 (네이버) | URL 정보가 수신되었습니다. key 정보를 확인 중입니다. |
| 403 (네이버) | key가 유효하지 않습니다. |
| 422 (네이버) | URL이 key 정보와 일치하지 않습니다. |
| 키를 바꾼 뒤 | Search engines will automatically re-verify ownership when the updated key is detected during URL submission.URL 제출 중 바뀐 키가 확인되면 검색엔진이 소유를 자동으로 다시 확인한다. |
발견 04
B2B·B2C·B2G 모두 키 파일 하나로 시작하고, 걸리는 자리만 다릅니다
예시 ① 서브도메인이 셋인 SaaS 기업 사이트(B2B)
B2B SaaS 기업이 www·blog·docs 서브도메인을 씁니다. 서브도메인은 별개 호스트라 키 파일을 세 개 만들어 각 루트에 둡니다.
제출할 때도 URL 의 호스트에 맞는 키를 씁니다. 다른 호스트 키로 보내면 422 가 옵니다.
예시 ② 루트에 파일을 올리기 어려운 쇼핑몰(B2C)
자사 쇼핑몰의 제작 플랫폼이 루트 디렉터리 업로드를 차단해 두었습니다. 먼저 플랫폼에 IndexNow 기능이 있는지 확인하고, 있으면 그것을 켭니다.
기능이 없어 하위 디렉터리에 키 파일을 두면 keyLocation 을 함께 보냅니다. 그 디렉터리 밖 상품 URL 은 이 키로 알릴 수 없다는 점을 미리 적어 둡니다.
예시 ③ 보안 장비가 해외 접속을 차단하는 공공기관 누리집(B2G)
공공기관 누리집이 해외 IP 접속을 보안 장비로 제한합니다. 내부망에서는 키 파일이 열리지만 검색엔진은 열지 못할 수 있습니다.
IndexNow FAQ 는 키 파일이 방화벽·IP 제한 없이 열려야 한다고 적었습니다. 키 파일 URL 하나만 예외로 허용해 달라고 보안 담당에 요청합니다.
그럼 오늘 키 파일을 어떤 순서로 올리나요?
- 쓰는 제작 플랫폼·호스팅·CDN 에 IndexNow 기능이 있는지 먼저 봅니다. 있으면 그 기능을 켭니다.
- 없으면 0~9·a~f 로 32자 키를 만들고, 키.txt 파일에 키만 넣어 UTF-8 로 저장합니다.
- 사이트 루트에 올리고 로그인 없는 브라우저와 회사 밖 네트워크에서 열어 봅니다.
- URL 하나를 제출해 202 또는 200 이 오는지 봅니다. 403·422 면 위 대조표로 원인을 찾습니다.
- 서브도메인마다 같은 순서를 반복하고, 키와 파일 URL 은 담당자 문서에 적어 둡니다.
- IndexNow 를 받는 검색엔진과 구글 쪽 경로는 「IndexNow 구글 지원 여부」 편에 정리했습니다.
조사 방법
- 네이버 서치어드바이저 「API Key 생성하기」 · 최종 확인일 2026-10-25 · https://searchadvisor.naver.com/guide/indexnow-api-key
- 네이버 서치어드바이저 「페이지 갱신 요청하기」 · 최종 확인일 2026-10-25 · https://searchadvisor.naver.com/guide/indexnow-request
- IndexNow.org 「Documentation」 · 최종 확인일 2026-10-25 · https://www.indexnow.org/documentation
- IndexNow.org 「FAQ」 · 최종 확인일 2026-10-25 · https://www.indexnow.org/faq
- 만드는 4단계와 확인 5단계는 위 문서들이 적은 키 규칙·파일 위치·응답 코드를 작업 순서로 묶은 것입니다. 묶는 방식은 편집 판단입니다.
- 「0~9 와 a~f 로 만든다」는 두 문서가 적은 글자 범위의 겹치는 부분을 고른 편집 판단입니다.
- 예시 ①②③은 이해를 돕기 위해 만든 가상 상황이며, 실제 기업·기관의 사례가 아닙니다.
- IndexNow.org 원문은 영어이고, 네이버 원문은 한국어 가이드 그대로입니다. 두 곳 모두 페이지에 수정일이 없습니다.