카카오 로그인 KOE006, Redirect URI 한 글자 차이부터 확인하라

|작성자: QUASA 편집팀|5 분 소요
카카오 로그인 KOE006, Redirect URI 한 글자 차이부터 확인하라

카카오 로그인에서 KOE006이 발생했다면 실제 인가 코드 요청의 redirect_uri와 앱에 등록한 리다이렉트 URI를 먼저 대조해야 한다. 카카오의 카카오싱크 FAQ는 등록하지 않은 값으로 인가 코드를 요청할 때 이 오류가 발생하며, 프로토콜·도메인·포트·경로·마지막 슬래시까지 일치해야 한다고 안내한다.

먼저 실패한 요청에 실린 주소와 사용한 앱 키를 찾고, 그 키에 등록된 주소와 비교한다. 카페24 쇼핑몰이라면 사이트 도메인과 카카오 로그인 콜백 주소를 별개로 확인해야 한다. 인가 코드가 돌아온 뒤에는 토큰 요청에도 인가 요청과 같은 redirect_uri를 보내야 로그인 흐름이 이어진다.

실패한 인가 요청의 주소와 앱 키를 찾는다

관리 화면에 저장된 주소부터 바꾸기보다 오류가 난 로그인 시도에서 실제로 전송한 redirect_uri를 확보한다. 오류 화면에 값이 표시되면 그대로 기록하고, 표시되지 않으면 서비스의 인가 요청 로그를 확인한다. 쇼핑몰 첫 화면의 주소나 브라우저에 최종적으로 보이는 주소를 콜백 주소로 추정하면 거절된 값을 찾기 어렵다.

직접 REST API를 연동했다면 인가 요청 URL의 client_id는 사용한 REST API 키이고, redirect_uri는 인가 코드를 받을 서비스 주소다. 로그인 경로마다 다른 앱이나 키를 사용한다면, 실패한 요청의 키와 URI를 한 쌍으로 기록한다. 같은 주소가 다른 앱에 등록돼 있어도 현재 요청에 사용한 앱의 설정을 확인해야 한다.

  1. 실패한 요청에서 client_id와 redirect_uri를 찾는다. 로그에 URI가 URL 인코딩돼 있다면 주소를 읽을 수 있는 형태로 풀어 등록값과 비교한다.
  2. 카카오디벨로퍼스의 해당 앱에서 [앱] → [플랫폼 키] → 사용한 [REST API 키] 또는 [JavaScript 키] → [카카오 로그인 리다이렉트 URI]를 확인한다.
  3. 요청한 주소가 등록돼 있는지 확인한다. 실제로 코드를 받을 주소가 맞다면 그 주소를 등록하고, 요청값이 잘못됐다면 인가 요청을 등록된 콜백 주소로 수정한다.

JavaScript SDK와 REST API를 함께 쓴다면 두 키의 설정을 각각 살펴야 한다. PC의 로그인 버튼과 모바일의 로그인 버튼이 서로 다른 방식으로 인가를 요청할 수도 있으므로, 한 경로에서 성공했다는 결과만으로 다른 경로의 키와 URI까지 같다고 판단하지 않는다. 수정 대상을 정할 때는 오류가 발생한 경로의 실제 요청을 기준으로 삼는다.

프로토콜·도메인·경로·끝 슬래시를 나눠 대조한다

카카오 로그인 콜백 주소에서 프로토콜·도메인·경로·끝 슬래시를 대조하는 구성

URI는 비슷해 보이는 주소를 뜻으로 비교하는 항목이 아니라 요청에 넣은 값을 등록값과 대조하는 항목이다. 아래 주소들은 차이를 보여 주기 위한 조건부 예시다. 운영 중인 쇼핑몰의 주소나 콜백 경로를 이 예시로 일괄 변경하라는 뜻은 아니다.

  • 프로토콜: 등록값이 https://sample.com으로 시작하는데 요청값이 http://sample.com으로 시작하는지 본다. 두 문자열은 시작 부분부터 다르다.
  • 도메인: sample.com, www.sample.com, m.sample.com을 구분한다. 모바일에서만 오류가 난다면 모바일 인가 요청에 실린 호스트와 등록된 호스트를 먼저 비교한다.
  • 포트와 경로: 포트를 명시해 사용한다면 그 값도 대조한다. 도메인만 등록하고 실제 요청에 붙는 콜백 경로를 빠뜨렸는지, 경로의 대소문자와 철자가 같은지도 확인한다.
  • 끝 슬래시: /kakao와 /kakao/는 마지막 문자 하나가 다르다. 앞부분이 모두 같아 보여도 주소의 끝까지 읽어야 한다.

비교할 때는 요청값과 등록값을 나란히 놓고 프로토콜, 호스트, 포트, 경로 순서로 끊어 읽으면 차이가 드러난다. 예를 들어 http에서 https로 접속 방식을 바꿨거나 대표 도메인을 변경했다면, 로그인 요청을 만드는 설정에 이전 주소가 남아 있을 수 있다. 이 경우 최종 페이지가 새 주소로 열리는지보다 인가 요청이 어느 주소를 보냈는지가 KOE006 진단에 직접적이다.

등록 주소를 추가할지 요청 주소를 고칠지는 콜백이 실제로 작동하는 위치에 따라 결정한다. 존재하지 않는 콜백 주소를 오류 메시지에 맞춰 등록하면 인가 요청 단계의 불일치만 가릴 수 있다. 반대로 정상적으로 코드를 받는 주소가 요청에 쓰였는데 등록만 빠졌다면 그 정확한 URI를 해당 키에 등록하는 편이 문제의 위치에 맞는 수정이다.

카페24는 도메인 등록과 콜백 경로를 별도로 확인한다

카페24 쇼핑몰의 PC·모바일 도메인에 각각 이어지는 카카오 로그인 콜백 경로

카페24의 카카오싱크 로그인 도움말은 KOE006을 Redirect URI 입력 문제로 구분하고, 도메인 뒤에 /Api/Member/Oauth2ClientCallback/kakao/ 경로가 모두 포함됐는지 확인하도록 안내한다. 사이트 도메인이 올바르게 등록돼 있어도 로그인 요청에 사용하는 전체 콜백 URI의 등록 상태는 따로 살펴야 한다.

먼저 쇼핑몰 관리자에서 PC 주소를 확인한다. 도움말에 제시된 경로는 [쇼핑몰 설정] → [기본 설정] → [쇼핑몰 정보] → [도메인 설정]의 도메인 관리다. 모바일 주소는 [쇼핑몰 설정] → [사이트 설정] → [사이트 환경 설정] → [쇼핑몰 환경 설정]의 모바일 탭에서 확인하며, 멀티몰 모바일 주소는 해당 멀티몰 관리자에서 각각 확인한다.

그다음 오류가 난 접속 경로의 인가 요청에서 콜백 URI를 읽는다. 예를 들어 요청값이 https://m.sample.com/Api/Member/Oauth2ClientCallback/kakao/라면 https://sample.com/Api/Member/Oauth2ClientCallback/kakao/와는 호스트가 다르다. 모바일 접속 주소가 있다는 이유만으로 모바일 콜백 주소를 추측해 추가하지 말고, 실제 요청에 쓰인 호스트와 경로가 해당 앱 키에 등록돼 있는지 확인한다.

도메인 등록을 점검할 때도 쇼핑몰에서 실제로 사용하는 PC·모바일·멀티몰 주소를 구분한다. 카페24 안내에는 http와 https, 기본 도메인과 모바일 도메인에 따른 콜백 URI 예시가 제시돼 있지만, 모든 예시를 무조건 등록해야 한다는 뜻으로 받아들일 필요는 없다. 운영 중인 접속 경로와 실제 인가 요청값을 확인한 뒤 필요한 주소를 고르는 것이 정확하다.

표시된 오류 코드가 다르면 점검 위치도 달라진다. 카페24는 KOE002를 카카오 로그인 WEB URL 입력 문제, KOE006을 Redirect URI 입력 문제, KOE101을 앱 키 입력 문제로 분류한다. KOE002라면 웹 도메인 설정을, KOE101이라면 요청에 사용한 앱 키를 확인하고, KOE006이라면 콜백 URI의 등록값과 요청값부터 대조한다.

인가 코드가 돌아오면 토큰 요청에도 같은 URI를 보낸다

인가 요청을 고쳐 콜백 주소로 코드가 전달됐다면 다음에는 토큰 요청의 redirect_uri를 확인한다. 카카오 로그인 REST API 문서는 토큰 요청에 인가 코드 요청 때 사용한 redirect_uri와 같은 값을 넣도록 명시한다. 인가 요청의 주소만 새 도메인으로 바꾸고 토큰 요청에 이전 도메인을 남겨 두면 두 단계의 값이 달라진다.

직접 연동한 서비스라면 등록된 URI, 인가 요청의 redirect_uri, 토큰 요청의 redirect_uri를 따로 기록해 비교한다. 첫 두 값이 같아 인가 코드가 도착하더라도 토큰 요청값까지 자동으로 바뀌는 것은 아니다. 특히 인가 요청을 만드는 클라이언트 설정과 토큰 요청을 만드는 서버 설정이 분리돼 있다면 양쪽의 변경 여부를 확인해야 한다.

  1. 오류가 났던 접속 경로에서 새 로그인을 시도하고 인가 요청에 실린 URI를 확인한다. 여전히 KOE006이 뜬다면 해당 요청의 키와 등록된 URI를 다시 대조한다.
  2. 인가 코드가 콜백에 도착했다면 토큰 요청에 사용한 redirect_uri를 확인한다. 프로토콜, 호스트, 포트, 경로, 끝 슬래시가 방금 인가 요청에 보낸 값과 같은지 본다.
  3. URI가 같은데도 토큰 발급이 실패한다면 반환된 오류 코드와 토큰 요청의 인증 정보·형식을 확인한다. 인가 단계의 KOE006과 토큰 단계에서 새로 발생한 오류를 구분해야 수정할 설정을 좁힐 수 있다.

PC와 모바일 또는 멀티몰에서 서로 다른 주소로 로그인한다면 오류가 발생했던 경로를 각각 다시 시도한다. 확인할 결과는 새 인가 요청이 등록된 콜백 URI를 보내는지, 그 주소로 코드가 돌아오는지, 같은 URI로 토큰 요청이 이어지는지다. 토큰까지 발급됐는데 쇼핑몰 회원 로그인이 끝나지 않는다면 이후의 회원 조회·가입 처리 단계에서 멈춘 위치를 살펴본다.

함께 읽기:

공유:

뉴스레터 구독

최신 Web3, AI, 암호화폐 뉴스를 이메일로 받아보세요.

0