네이버 로그인 API 연동: 인증 흐름과 사전 검수

안녕하세요. 사랑받는 IT 프로덕트의 첫걸음, 똑똑한개발자입니다.

네이버 로그인은 이용자의 네이버 계정을 서비스의 회원 계정과 연결하는 소셜 로그인 기능입니다. OAuth 2.0 인증 흐름을 거쳐 동의받은 프로필 정보를 조회하며, 일반 사용자에게 공개하기 전 검수 절차가 있습니다. 오늘은 앱 등록부터 인증과 사전 검수까지 알아보겠습니다.

네이버 로그인 API 연동, 카카오와 무엇이 다를까

둘 다 OAuth 2.0 인가 코드 방식이라 코드 골격은 같습니다. 달라지는 부분은 콘솔 설정과 출시 절차입니다.

개발 중에는 등록한 관리자·테스터 계정으로 동작을 확인하고, 일반 사용자 대상 공개에는 사전 검수 절차를 거칩니다.

네이버 개발자센터 애플리케이션 등록부터 시작합니다

사용 API에서 '네이버 로그인'을 골라야 제공 정보 선택이 열립니다.

출발점은 Application > 애플리케이션 등록입니다. 이름은 동의 화면에 그대로 보이니 서비스 이름으로 적고 이메일·휴대전화번호 같은 제공 정보는 필수와 추가로 나눠 고릅니다.

Callback URL은 개발과 운영 주소를 함께 넣습니다.

코드가 돌아올 주소라 요청 값과 맞아야 하고 환경별로 최대 5개까지 등록됩니다.

Client Secret은 서버에만 둡니다.

Client ID와 Client Secret은 내 애플리케이션에서 확인하는데, Secret은 유출이 의심되면 재발급합니다.

네아로 인증 흐름, state가 세 번 등장합니다

인증 요청에 서버가 만든 state를 붙입니다.

요청 위조를 막는 값이라 임의 문자열을 세션에 저장해 둡니다.

https://nid.naver.com/oauth2.0/authorize?response_type=code&client_id=CLIENT_ID&state=STATE_STRING&redirect_uri=CALLBACK_URL

콜백으로 돌아온 state를 저장값과 먼저 비교합니다.

동의가 끝나면 code와 state가 함께 오는데, 값이 다르면 거기서 멈춥니다.

토큰 요청에도 state를 다시 보냅니다.

https://nid.naver.com/oauth2.0/token에 grant_type, client_id, client_secret, code, state를 담습니다. code는 한 번만 쓸 수 있습니다.

프로필 조회 API에서 이용자 식별자를 받습니다.

https://openapi.naver.com/v1/nid/me에 Authorization: Bearer 헤더를 붙입니다. 응답의 id는 애플리케이션마다 다른 이용자 식별자라 회원 연결 키로 씁니다.

네이버 로그인 검수 전에는 등록된 아이디만 로그인됩니다

개발 중 상태에서는 등록자와 멤버만 들어옵니다.

여기서 멤버는 멤버관리 탭에 관리자·테스터로 넣은 아이디입니다. 네이버 로그인 검수 상태 탭에서 요청하면 공식 가이드 기준 2~3 영업일 안에 결과가 옵니다.

고른 제공 정보마다 활용 화면을 보여줘야 합니다.

이용자 식별자를 뺀 나머지 정보는 쓰이는 화면을 캡처해 냅니다. 통계용 성별·연령대는 활용 사례로 인정되지 않습니다. 휴대전화번호를 고르면 사업자 확인도 거칩니다.

네이버로 가입한 회원에게 별도 비밀번호를 받으면 반려됩니다.

애플리케이션 이름을 '네이버 로그인'으로 적은 경우도 마찬가지입니다.

네이버 로그인 버튼 디자인 가이드와 자주 막히는 지점

버튼은 지정 컬러를 지키고 녹색 완성형을 권장합니다.

형태는 아이콘형과 완성형 두 가지입니다. 지정 컬러는 바꿀 수 없지만 문구는 바꿔도 됩니다.

팀원만 로그인되고 고객은 안 된다면 검수 상태부터 봅니다.

먼저 애플리케이션의 공개·검수 상태와 멤버 등록 여부를 확인합니다. 024 인증실패가 뜨면 토큰 만료부터 의심하고 갱신 토큰으로 다시 받습니다.

세부 항목과 최신 적용 조건은 네이버 로그인 개발 가이드를 참고해 보세요.

네이버 로그인 다음의 회원 경험도 함께

회원 가입과 인증을 하나씩 붙이다 보면 화면뿐 아니라 데이터와 운영 방식도 함께 살펴보게 됩니다. 지금 서비스에 필요한 범위부터 차근차근 정리해볼 수 있습니다.

똑똑한개발자는 UX/UI 디자인과 웹·앱 개발을 함께 진행합니다. 사용자가 이용하는 화면과 운영에 필요한 기능을 연결해 서비스를 만들어가는 과정을 돕습니다.

회원 가입과 인증을 준비하면서 궁금한 점이 있다면 아래 똑똑한개발자 링크로 편하게 이야기 남겨주세요. 함께 살펴보겠습니다. 감사합니다. :)