카카오, 네이버 OpenAPI 앱 키 발급받는 방법

카카오나 네이버에서 제공하는 OpenAPI를 사용하려면, 먼저 개발자 사이트에서 앱을 만들고 앱 키를 발급받아야 한다. 계정이 없다면 회원가입을 해야 한다. 지금부터 카카오, 네이버의 앱 키를 발급받는 방법을 포스팅하려고 한다.

카카오 앱 키 발급받기

카카오 개발자 사이트에서 로그인 한 뒤 메뉴에서 [내 애플리케이션]을 클릭한 뒤 [애플리케이션 추가하기] 버튼을 클릭한다.

애플리케이션 추가하는 팝업창이 뜨는데, 앱 이름과 사업자명을 자유롭게 입력한 후 저장 버튼을 클릭한다.

• 앱 이름: 서비스 이름
• 사업자명: 서비스의 사업자 이름

생성된 애플리케이션이 목록이 보인다. 방금 생성한 애플리케이션을 클릭하자.

아래와 같이 발급된 앱 키를 확인할 수 있다. 

앱 키는 4종류가 존재한다. 앱을 생성하면 플랫폼별로 앱 키가 발급된다. 서로 호환이 되지 않으므로, 각 플랫폼 호출별 올바른 키를 사용해야 한다.

• 네이티브 앱 키 : iOS, Android 앱 개발 시 필요한 key
• REST API 키 : REST API 호출 시 필요한 key
• Javascript 키 : Javascript 앱 개발 시 필요한 key
• Admin 키 : Push, 앱 관리 등 관리자 권한에서 필요한 key (보안 유지 필수)

사용자가 발급받은 앱 키 값을 통해, 카카오 플랫폼은 올바른 API 요청인지 검증하며, 플랫폼에 맞지 않는 앱 키를 사용하면 에러 응답을 반환한다. 

주의할 점은 앱 키는 노출되지 않도록 하는 것이다. 가끔 Github에 올라온 소스를 보다 보면 앱 키가 그대로 노출된 경우가 종종 있었다. 악용될 소지가 있으므로 공유 저장소에 올릴 때에는 주의하자.

만약 앱 키가 노출되었을 경우, 앱 키를 재발급할 수도 있다. 당연한 얘기겠지만 앱 키를 재발급하게 되면, 이미 적용되어 있는 과거의 앱 키를 신규 앱 키로 변경해야 카카오 API를 정상적으로 이용할 수 있다.

좀 더 자세한 내용은 카카오 가이드 문서를 참고하자.

네이버 앱 키 발급받기

네이버 개발자 사이트에서 로그인 한 뒤 메뉴에서 [Application] > [애플리케이션 등록]을 클릭한다.

애플리케이션을 등록하기 위해 1. 약관동의, 2. 계정 정보 등록, 3. 애플리케이션 등록 화면까지 이동한다.

3단계 애플리케이션 등록 화면에서 아래의 정보를 입력한다.

• 애플리케이션 이름 : 서비스 이름
• 사용 API : 본인이 앱에 적용하고자 하는 API (API는 여러 개 추가 가능)

사용 API를 선택하면, 하단에 (비)로그인 오픈 API 서비스 환경이 생긴다.

사용자가 선택한 API가 로그인 방식의 오픈 API인지(ex. 네이버 로그인), 비로그인 방식의 오픈 API(ex. 검색)에 따라 다르게 보인다. 좀 더 자세한 내용은 네이버 오픈 API 종류 가이드를 참고하자.

내 경우 파이썬 토이 프로젝트에 사용할 용도로 앱을 생성하는 것이므로, 사용 API는 '검색'을 선택한 뒤 환경은 'WEB 설정'했다. 웹 서비스 URL은 임시로 'http://localhost:8080'를 작성하여 앱을 등록했다.

메뉴에서 [Application] > [내 애플리케이션]에 들어가면 Client ID, Client Secret 정보가 보인다. 네이버 API 호출 시, 이 2개의 값을 HTTP 헤더에 포함해서 전송해야 API를 호출할 수 있다.

Client Secret 값은 Client ID의 비밀번호라고 보면 된다. 보기 버튼을 클릭하여 값을 확인할 수 있고, 재발급 또한 가능하다.

References

• 카카오 개발자 가이드
• 네이버 API 공통 가이드