워드프레스 자동 색인 "오류 401" 해결하는 방법

워드프레스 블로그 게시글 자동 색인을 위해 열심히 설정하다가, 갑자기 나타난 오류 401: 요청에 필요한 인증 정보가 없습니다.라는 메시지에 당황하셨을 거예요. 마치 구글이 "너 누구니? 신분증 내놔!"라고 외치는 것 같죠.

이 오류는 주로 구글 클라우드 플랫폼에서 생성한 서비스 계정의 인증 정보가 워드프레스 플러그인에 제대로 연결되지 않았거나, 서비스 계정에 필요한 권한이 부족할 때 발생합니다. 너무 걱정 마세요! 몇 가지 단계를 다시 확인하면 금방 해결할 수 있습니다.

오류 401, 왜 발생할까요?

• JSON 파일 문제: 다운로드한 JSON 파일이 손상되었거나, 워드프레스 플러그인에 제대로 업로드/복사되지 않았을 때
• 서비스 계정 권한 부족: 구글 서치 콘솔에서 서비스 계정에 소유자 또는 제한 없음 권한을 부여하지 않았을 때
• 잘못된 서비스 계정: 워드프레스 플러그인에 입력한 서비스 계정 정보가 구글 서치 콘솔에 등록된 서비스 계정과 다를 때
• API 비활성화: Search Console API가 비활성화되어 있을 때

그럼 이제 하나씩 차근차근 해결 방법을 알아볼까요?

반응형

해결 방법 1: JSON 파일 및 서비스 계정 정보 재확인 (가장 흔한 원인!)

이 오류의 90%는 이 단계에서 해결됩니다.

1. 새로운 JSON 키 파일 생성:

• Google Cloud Console에 접속합니다.
• 이전에 자동 색인을 위해 만들었던 서비스 계정을 찾습니다. (왼쪽 메뉴: API 및 서비스 -> 사용자 인증 정보)
• 목록에서 해당 서비스 계정을 클릭합니다.
• '키' 탭으로 이동합니다.
• 기존 키를 삭제하고 (선택 사항이지만 깔끔합니다), '+ 키 추가' -> '새 키 만들기'를 클릭합니다.
• JSON을 선택하고 '만들기' 버튼을 클릭하여 새로운 JSON 파일을 다운로드합니다.

• 팁: 기존에 받았던 파일과 이름이 다를 수 있으니, 헷갈리지 않게 잘 확인하세요.

1. 워드프레스 플러그인에 새 JSON 파일 적용:

• 워드프레스 관리자 페이지로 이동합니다.
• Instant Indexing 또는 Rank Math SEO 플러그인의 설정 페이지로 이동합니다.
• Google API Settings 또는 유사한 이름의 탭을 찾습니다.
• 이전에 업로드/복사했던 JSON 내용을 새로 다운로드한 JSON 파일의 내용으로 완전히 교체하거나, 파일을 다시 업로드합니다.
• 설정을 저장하고 다시 시도해봅니다.

해결 방법 2: 구글 서치 콘솔에서 서비스 계정 권한 확인 (중요!)

서비스 계정에게 내 사이트를 제어할 수 있는 권한을 제대로 주었는지 확인해야 합니다.

1. 구글 서치 콘솔 접속:
   Google Search Console에 접속하여 오류가 발생하는 본인의 워드프레스 사이트 속성을 선택합니다.
2. 사용자 및 권한 확인:

• 왼쪽 메뉴에서 설정을 클릭합니다.
• 사용자 및 권한을 클릭합니다.

1. 서비스 계정 권한 확인 및 추가:

• 목록에서 2단계에서 생성한 서비스 계정의 이메일 주소가 있는지 확인합니다. (이메일 주소는 보통 서비스계정명@프로젝트ID.iam.gserviceaccount.com 형식입니다.)
• 만약 없다면: 사용자 추가 버튼을 클릭하고 해당 서비스 계정의 이메일 주소를 입력한 후, 소유자 또는 제한 없음 권한을 부여하고 추가합니다.
• 만약 있다면: 해당 서비스 계정의 권한이 소유자 또는 제한 없음으로 되어 있는지 확인합니다. 만약 다른 권한(예: 제한)으로 되어 있다면, 해당 계정을 클릭하여 권한을 소유자 또는 제한 없음으로 변경한 후 저장합니다.

해결 방법 3: Search Console API 활성화 여부 확인

간혹 Search Console API가 비활성화되어 있을 때도 이 오류가 발생할 수 있습니다.

1. 구글 클라우드 콘솔 접속:
   Google Cloud Console에 접속하여 해당 프로젝트를 선택합니다.
2. API 라이브러리 확인:

• 왼쪽 메뉴에서 API 및 서비스 -> 라이브러리로 이동합니다.
• 검색창에 Search Console API를 입력하고 검색합니다.
• Search Console API가 '사용 설정됨' 상태인지 확인합니다.
• 만약 '사용 설정' 버튼이 보인다면, 클릭하여 활성화합니다.

해결 방법 4: 플러그인 업데이트 또는 재설치 (최후의 수단)

드물지만, 플러그인 자체의 문제로 인해 오류가 발생할 수도 있습니다.

1. 플러그인 업데이트:

• 워드프레스 관리자 페이지에서 플러그인 -> 설치된 플러그인으로 이동합니다.
• Instant Indexing 또는 Rank Math SEO 플러그인에 업데이트 알림이 있다면, 업데이트를 진행합니다.

1. 플러그인 재설치:

• 최후의 수단으로, 플러그인을 비활성화하고 삭제한 후 다시 설치해볼 수 있습니다.
• 주의: 플러그인 삭제 시 설정이 초기화될 수 있으니, 이전에 설정했던 내용을 다시 입력할 준비를 해두세요.

다시 시도해보기

위의 해결 방법들을 모두 시도한 후에는, 워드프레스 플러그인에서 색인 요청을 다시 시도해 보세요. 보통은 이 단계에서 오류가 해결되고 정상적으로 작동할 겁니다.

만약 이 모든 방법을 시도했는데도 여전히 '오류 401'이 발생한다면, 구글 클라우드 콘솔의 '로그 탐색기'에서 더 자세한 오류 메시지를 확인하여 문제를 진단하거나, 워드프레스 플러그인 개발자에게 문의하는 것을 고려해볼 수 있습니다.

자동 색인 설정이 조금 까다롭게 느껴질 수 있지만, 한 번만 제대로 설정해두면 블로그 운영이 훨씬 편리해질 거예요. 포기하지 마시고, 이 가이드가 여러분의 문제 해결에 도움이 되기를 바랍니다!