카카오 로그인은 카카오 Developers의 앱 설정과 워드프레스 플러그인의 값이 정확히 일치해야 작동합니다.
1. 카카오 앱 만들기
- 카카오 Developers에 로그인하고 내 애플리케이션에서 앱을 만듭니다.
- 앱 이름과 사업자 정보를 실제 서비스 기준으로 입력합니다.
- 플랫폼 키에서 REST API 키를 확인하되 공개 문서나 메신저에 붙여 넣지 않습니다.
2. 플랫폼 키와 웹 도메인 설정
- 서버 방식 로그인은 REST API 키, JavaScript SDK 방식은 JavaScript 키 설정을 확인합니다.
- 사용 방식에 맞는 키 설정에서 웹 도메인과 Redirect URI를 등록합니다.
- 사이트 도메인은
https://example.com처럼 HTTPS와 실제 운영 도메인을 정확히 입력합니다. - www 또는 테스트 도메인을 따로 사용하면 실제 요청에 필요한 주소만 추가합니다.
3. 카카오 로그인 활성화
- 카카오 로그인 사용 설정을 켭니다.
- 비랜딩이 제공한 Callback URL을 사용 방식에 맞는 플랫폼 키의 Redirect URI에 등록합니다.
- URL의 HTTPS, www, 경로, 대소문자와 마지막 슬래시까지 플러그인 화면의 값과 같아야 합니다.
예시: https://example.com/wp-login.php?social=callback&provider=kakao위 주소는 예시입니다
복사해서 사용하지 말고 실제 사이트 관리자 설정 화면에 표시되는 Callback URL을 등록하세요.
4. 동의 항목 설정
서비스에 꼭 필요한 정보만 요청합니다. 이메일이 로그인 식별값으로 필요하면 카카오 Developers의 동의 항목과 개인정보처리방침을 함께 점검하세요. 권한이 없는 항목을 필수로 설정하려 하지 않습니다.
5. 워드프레스에 키 입력
- 워드프레스 관리자에서 소셜 로그인 또는 멤버십 설정으로 이동합니다.
- REST API 키와 필요 시 Client Secret을 입력합니다.
- 저장 후 로그아웃 상태 또는 시크릿 창에서 신규 로그인을 시험합니다.
자주 발생하는 오류
| 증상 | 확인할 항목 |
|---|---|
| KOE006 | 요청한 Redirect URI가 앱에 등록된 값과 정확히 같은지 확인 |
| 동의 화면이 나오지 않음 | 이미 동의한 계정인지, 필요한 동의 항목이 추가됐는지 확인 |
| 이메일이 전달되지 않음 | 이메일 동의 항목 상태와 사용자 계정의 이메일 제공 가능 여부 확인 |
공식 문서: 카카오 앱·Redirect URI 설정 · 카카오 로그인 REST API · 오류 코드 안내