워드프레스 응용 프로그램 비밀번호, 401·404 원인 찾기

워드프레스를 외부 서비스와 연결할 때는 평소 로그인 비밀번호가 아니라 사용자 → 프로필에서 따로 만드는 응용 프로그램 비밀번호를 씁니다. 연결이 실패하면 401은 아이디·비밀번호 쪽, 404는 사이트 주소나 REST API 경로 쪽을 먼저 봅니다.
워드프레스 6.9부터 한국어 화면에서는 이 기능의 이름이 「애플리케이션 비밀번호」로 보입니다. 이름만 다를 뿐 같은 기능입니다(2026년 11월 translate.wordpress.org 확인).
요약 ① 응용 프로그램 비밀번호는 워드프레스 5.6부터 있는 기능이고, 사용자 → 프로필에서 만들며 만든 직후에만 볼 수 있습니다. ② 기본적으로 HTTPS 사이트나 로컬 개발 환경에서 켜지고, 워드프레스 로그인 화면에는 쓸 수 없습니다. ③ /wp-json/wp/v2/users/me 에 비밀번호를 붙여 물어보면 200·401·403·404로 어디가 문제인지 가를 수 있습니다.
응용 프로그램 비밀번호란?
응용 프로그램 비밀번호는 외부 프로그램이 REST API나 XML-RPC로 워드프레스에 접속할 때 실제 로그인 비밀번호 대신 쓰는 비밀번호입니다. 워드프레스 5.6부터 들어갔고, 언제든 폐기할 수 있으며, 사이트 로그인 화면에서는 쓸 수 없습니다.
만들 때마다 24자로 생성되고, 읽기 쉽게 abcd EFGH 1234 ijkl MNOP 6789처럼 4자씩 띄어 보여 줍니다. 연결할 서비스마다 하나씩 만들어 두면, 한 곳만 끊을 때 그 비밀번호만 폐기하면 됩니다.
| 워드프레스 버전 | 한국어 화면의 이름 |
|---|---|
| 5.6 | 응용 프로그램 비밀번호 |
| 6.4, 6.8 | 응용프로그램 비밀번호 |
| 6.9, 7.0, 7.1 | 애플리케이션 비밀번호 |
표는 2026년 11월 translate.wordpress.org의 한국어 번역에서 확인한 이름입니다. 확인하지 않은 버전은 넣지 않았습니다.
어디서 만드나요?
- 워드프레스 관리자에서 사용자 → 프로필로 갑니다.
- 아래쪽 「애플리케이션 비밀번호」 칸(이전 버전은 「응용프로그램 비밀번호」)의 「새 애플리케이션 비밀번호 이름」에 연결할 서비스 이름을 적고, 「애플리케이션 비밀번호 추가」를 누릅니다.
- 나타난 24자 비밀번호를 바로 복사해 연결할 서비스에 붙여 넣습니다. 워드프레스는 이 비밀번호를 다시 보여 주지 않으니 안전한 곳에 저장하라고 안내합니다.
띄어쓰기는 지우지 않아도 됩니다. 워드프레스는 응용 프로그램 비밀번호로 인증할 때 영문과 숫자가 아닌 글자를 지우고 비교합니다.
필요 없어진 비밀번호는 같은 칸에서 하나씩 폐기하거나 「모든 애플리케이션 비밀번호 폐기」로 한꺼번에 폐기합니다.
칸이 보이지 않으면 HTTPS부터 봅니다
이 기능은 기본적으로 SSL(HTTPS)을 쓰는 사이트나 로컬 개발 환경에서 켜집니다. HTTPS가 아닌 사이트에서는 워드프레스가 "애플리케이션 비밀번호 기능은 HTTPS가 필수"라는 안내를 띄웁니다.
플러그인이나 설정으로 이 기능을 일부러 꺼 둔 사이트도 있습니다. 그런 사이트는 REST API 첫 화면(/wp-json/)의 authentication 항목이 비어 있습니다.
연결되는지 직접 확인하는 법
연결할 서비스에 넣기 전에 두 단계로 직접 확인할 수 있습니다.
1단계: 브라우저로 /wp-json/ 열기
브라우저 주소창에 https://내도메인/wp-json/을 넣습니다. 사이트 이름과 routes가 든 JSON 글자가 보이면 REST API가 열려 있습니다.
404가 나면 https://내도메인/?rest_route=/도 열어 봅니다. 이쪽만 열린다면 설정 → 고유주소를 확인합니다.
워드프레스 문서에 따르면 REST API가 /wp-json/에 있는 것은 고유주소(퍼머링크)를 쓰는 사이트이고, 그렇지 않은 사이트에서는 rest_route 매개변수로 붙기 때문입니다.
2단계: 비밀번호를 붙여 users/me 물어보기
터미널에서 아래 한 줄을 실행합니다. 아이디, 응용 프로그램 비밀번호, 주소를 내 것으로 바꿉니다.
curl -i --user "아이디:xxxx xxxx xxxx xxxx xxxx xxxx" "https://내도메인/wp-json/wp/v2/users/me?context=edit"
워드프레스 개발자 문서의 예시(curl --user "USERNAME:PASSWORD" https://HOSTNAME/wp-json/wp/v2/users?context=edit)에서 주소만 users/me로 바꾼 것입니다.
users/me는 인증한 그 사용자의 정보를 돌려줍니다. -i를 붙이면 맨 윗줄에 응답 코드가 보입니다.
| 응답 | 뜻 | 확인할 것 |
|---|---|---|
| 200 | 인증 성공 | 응답의 capabilities에 "publish_posts": true가 있으면 글 발행 권한도 있습니다 |
| 401 | 인증 실패 | 본문의 code를 봅니다(아래) |
| 403 | 요청 거절 | 본문의 code와 메시지로 누가 거절했는지 봅니다 |
| 404 | 경로 없음 | 주소가 워드프레스가 설치된 첫 화면 주소인지, 1단계의 /wp-json/이 열리는지 봅니다 |
401이면 응답 본문의 code가 원인을 알려 줍니다. 워드프레스 소스 기준으로 읽는 법은 이렇습니다.
- incorrect_password: 응용 프로그램 비밀번호가 틀렸습니다. 로그인 비밀번호를 넣은 경우도 여기에 해당합니다.
- invalid_username: 그 아이디를 찾지 못했습니다.
- application_passwords_disabled: 이 사이트에서 응용 프로그램 비밀번호를 쓸 수 없습니다.
- rest_not_logged_in: 인증 정보가 워드프레스까지 닿지 않았습니다. users/me는 인증되지 않은 요청에 이 code와 401을 돌려줍니다.
403과 401의 일반적인 차이는 HTTP 상태코드 401 403 차이에 정리했습니다.
비밀번호가 맞는데 rest_not_logged_in이 나면
워드프레스 문서는 CGI 환경의 웹서버가 인증 헤더를 지울 수 있다고 안내합니다. 아파치(Apache)는 설정 파일이나 .htaccess에 아래 내용을 넣습니다.
<IfModule mod_setenvif>
SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1
</IfModule>
엔진엑스(Nginx)는 서버 설정의 fastcgi 부분에 fastcgi_pass_header Authorization;을 넣습니다. 서버 설정을 직접 바꿀 수 없다면 호스팅 업체에 이 문서의 내용을 전달해 요청합니다.
REST API를 꺼 두었다면
워드프레스 문서는 REST API를 끄지 말라고 안내합니다. 끄면 REST API에 기대는 관리자 기능이 깨지기 때문입니다. 외부 접근을 줄이려면 끄는 대신 인증한 요청만 받게 하는 필터를 쓸 수 있다고 같은 문서가 적습니다.
AI 라이터는 연결할 때 무엇을 확인하나요?
구독 중일 때 AI 라이터 설정의 「워드프레스 계정」에 사이트 주소·아이디·응용 프로그램 비밀번호를 넣고 「연결 확인하고 저장」을 누르면, 글을 올리기 전에 워드프레스에 한 번 물어봅니다.
보내는 요청은 위 2단계와 같은 /wp-json/wp/v2/users/me?context=edit(Basic 인증)이고, 결과는 이렇게 안내합니다.
| 워드프레스 응답 | AI 라이터 화면의 안내 |
|---|---|
| 401·403 | 아이디나 응용 프로그램 비밀번호가 맞지 않아요. 로그인 비밀번호가 아니라 프로필에서 새로 만든 24자리입니다. |
| 404 | 이 주소에서 워드프레스를 찾지 못했어요. 관리자 주소(/wp-admin)가 아니라 블로그 첫 화면 주소를 넣어 주세요. 보안 플러그인이 REST 를 막고 있을 수도 있어요. |
| 200, 글 발행 권한(publish_posts) 없음 | 이 계정에는 글 발행 권한이 없어요. 글을 발행할 수 있는 계정(관리자·편집자·글쓴이)으로 연결해 주세요. |
| 응답 없음 | 사이트에 닿지 못했어요. 주소가 맞는지, https 로 열리는지 확인해 주세요. |
401·403을 받으면 다시 시도하지 않고 한 번에 멈춥니다. 연결이 확인된 계정만 저장하고, http 주소는 받지 않습니다(https만).
저장한 응용 프로그램 비밀번호는 서버에 암호화해서 보관하고, 발행(지금 발행·예약 발행)과 설정의 「연결 확인」에만 꺼내 씁니다. 설정에서 언제든 지울 수 있고, 지우면 그 계정으로 걸어 둔 대기 예약도 함께 취소됩니다.
AI 라이터로 연결하기. 매번 명령줄로 확인하기 번거롭다면, AI 라이터가 계정을 저장할 때 같은 확인을 대신하고 원인을 위 표의 문장으로 알려 줍니다.
워드프레스로 바로 발행하는 기능은 구독자 전용이고, 무료로 쓸 때는 워드프레스용 본문을 복사해 붙여 넣습니다.
로그인하면 무료로 써 볼 수 있습니다 · 워드프레스 바로 발행은 구독자 전용

새 글을 올린 뒤 검색엔진에 알리는 방법은 워드프레스 색인 요청, 구글·네이버·빙 공식 방법 정리에 따로 정리했습니다.
정리
- 외부 연결에는 로그인 비밀번호가 아니라 사용자 → 프로필에서 만드는 응용 프로그램(애플리케이션) 비밀번호를 씁니다.
- 이 기능은 기본적으로 HTTPS 사이트나 로컬 환경에서 켜지고, 비밀번호는 만든 직후에만 볼 수 있습니다.
- /wp-json/이 열리는지 먼저 보고, users/me 요청의 응답 코드와 본문 code로 원인을 가릅니다.
- 401은 아이디·비밀번호·인증 헤더, 404는 사이트 주소·고유주소·REST API 쪽을 먼저 확인합니다.
로그인하면 무료로 써 볼 수 있습니다 · 워드프레스 바로 발행은 구독자 전용
자주 묻는 질문
로그인 비밀번호로는 왜 연결이 안 되나요?
워드프레스가 외부 프로그램의 기본 인증(Basic Auth) 요청에 받도록 만든 것은 응용 프로그램 비밀번호입니다. 로그인 비밀번호를 넣으면 응용 프로그램 비밀번호와 맞지 않아 incorrect_password로 401이 납니다.
만든 비밀번호를 잊어버렸습니다.
다시 볼 수 없습니다. 같은 칸에서 그 비밀번호를 폐기하고 새로 만들어, 연결한 서비스에 새 비밀번호를 다시 넣습니다.
사이트 전체에 접속 암호(기본 인증)를 걸어 두었습니다.
워드프레스는 이런 사이트에서 "웹사이트가 현재 응용 프로그램 비밀번호와 호환하지 않는 기본 인증을 사용하는 것으로 보입니다"라는 안내를 띄웁니다. 응용 프로그램 비밀번호도 기본 인증(Basic Auth) 방식으로 전달되기 때문입니다.
관리자가 아닌 계정으로도 연결할 수 있나요?
인증 자체는 그 계정의 응용 프로그램 비밀번호로 됩니다. 다만 글을 올리려면 그 계정에 글 발행 권한(publish_posts)이 있어야 하고, AI 라이터는 이 권한이 없는 계정은 저장하지 않습니다.