로그인 설정

소셜 로그인 발급 준비 가이드

카카오·네이버·구글·애플별로 개발자에게 전달할 키·파일과 콘솔에 등록할 설정, 발급 절차를 정리했습니다.

1. 계정 등록 및 관리

소셜 로그인은 로그인 버튼만 붙이면 끝나는 기능이 아닙니다. 각 서비스에 우리 사업의 앱을 등록하고, 발급된 인증 정보를 연결해야 합니다.

서비스 운영에 사용할 개인 또는 회사 관리 계정으로 가입·앱 생성·본인 인증·사업자 확인·약관 동의·필요한 결제를 진행합니다. 이후에도 서비스를 관리할 수 있도록 계정 소유권을 유지합니다.

개발자가 알려준 주소와 설정값을 콘솔에 등록한 뒤, 발급값과 등록 결과를 전달합니다. 로그인 비밀번호·인증 문자·복구 코드는 전달 항목이 아닙니다.

2. 발급 전에 먼저 준비할 것

  • 기본 준비 정보: 서비스명, 로고, 회사·대표자 정보, 연락 가능한 이메일, 본인 인증 수단. 사업자 확인이나 조직 가입이 필요하면 해당 증빙도 준비합니다.
  • 개발자에게 받을 것: 운영·개발 환경의 사이트 주소, 서비스별 정확한 Redirect URI / Callback URL / Return URL, 필요한 사용자 정보 목록.
  • 함께 확정할 것: 서비스 소개 페이지, 개인정보처리방침·이용약관 주소, 로그인·회원가입·탈퇴 흐름과 검수에 쓸 화면 자료.
  • 앱도 만든다면: Android 패키지명·서명 지문/키 해시, iOS Bundle ID 등 플랫폼별 등록값은 개발자에게 받아 입력합니다. 웹용 키만으로 앱 설정까지 완료되지는 않습니다.

3. 서비스별 발급 항목 한눈에 보기

웹 서버의 인증 코드 방식 기준입니다. 카카오 Client Secret은 활성화 시 필수이며, 구글 브라우저 전용 로그인은 Client ID만 전달합니다. SDK·모바일 앱의 추가 항목은 아래에서 구분합니다.
서비스발급·확인해서 전달할 항목출시 전에 확인할 것
카카오REST API 키. Client Secret이 활성화되어 있으면 그 값도 필수. JavaScript·네이티브 앱 키는 해당 SDK 사용 시 추가.카카오 로그인 사용 설정·동의항목·복귀 주소. 추가 정보 수집에 필요한 권한과 심사.
네이버Client ID, Client Secret.서비스 URL·Callback URL, 제공 정보 사용처, 네이버 로그인 사전 검수 승인.
구글OAuth Client ID, Client Secret(웹 서버 인증 코드 방식). 브라우저 전용 로그인은 Client ID만 전달.동의 화면·외부 사용자 대상 설정·등록 URL. 사용 범위와 브랜딩에 따른 검증 여부.
애플Team ID, Services ID(웹 Client ID), Key ID, Sign in with Apple용 .p8 원본 파일. 네이티브 앱 연동 시 Bundle ID 추가.Developer Program 가입·갱신, 기본 App ID 연결, 웹 도메인·Return URL, 서버 인증 설정.

4. 서비스별 신청 순서

카카오

카카오 — 발급 콘솔 열기

필수 전달값 (웹 서버 로그인 기준)

  • REST API 키 — 앱 > 플랫폼 키 > REST API 키에서 복사한 전체 값.
  • Client Secret 활성화 상태(ON/OFF)와, ON이면 Client Secret 전체 값. 새 REST API 키는 기본 ON입니다.

해당하는 경우에만 추가 전달

  • JavaScript SDK 사용 시: JavaScript 키.
  • Android·iOS SDK 사용 시: 네이티브 앱 키. 앱 ID는 관리 참고용으로 함께 전달할 수 있습니다.

콘솔에 등록한 뒤 알려줄 설정

  • 등록한 카카오 로그인 Redirect URI 전체 주소와 개발·운영 구분.
  • 카카오 로그인 사용 상태, 동의항목과 승인 상태. SDK 사용 시 등록 도메인·패키지명·키 해시·Bundle ID도 확인합니다.

발급·설정 순서

  1. Kakao Developers에서 서비스 운영에 사용할 계정으로 앱을 만들고 서비스명·회사 정보를 입력합니다.
  2. 앱의 카카오 로그인 설정에서 사용 설정을 켜고, 필요한 동의항목을 개발자와 정합니다.
  3. 앱 > 플랫폼 키 > REST API 키에서 키와 Client Secret 상태를 확인하고, 개발자가 준 카카오 로그인 리다이렉트 URI를 등록합니다. 새 REST API 키는 Client Secret이 기본 활성화됩니다.
  4. JavaScript SDK를 쓰면 JavaScript 키와 SDK 도메인도 등록합니다. 네이티브 앱은 개발자가 준 패키지명·키 해시·Bundle ID에 맞춰 별도로 설정합니다.
  5. 이메일 등 추가 권한이 필요한 동의항목은 비즈 앱 전환·사업자 정보 확인·추가 기능 심사 요건을 확인합니다. 필요한 수집 항목이 승인됐는지 확인하고 앱 ID와 발급값을 전달합니다.

공식 문서: 카카오 문서 1 · 카카오 문서 2

구글

구글 — 발급 콘솔 열기

필수 전달값 (웹 서버 로그인 기준)

  • OAuth Client ID — Google Auth Platform > Clients에서 해당 Web application의 전체 값.
  • Client Secret — 해당 클라이언트의 서버용 비밀값. 브라우저 전용 로그인에는 전달하지 않습니다.

해당하는 경우에만 추가 전달

  • Android·iOS 앱도 제공할 때: 개발자가 지정한 각 플랫폼용 OAuth Client ID.
  • 프로젝트 ID·클라이언트 이름은 관리 참고용입니다. OAuth Client ID 대신 전달하면 안 됩니다.

콘솔에 등록한 뒤 알려줄 설정

  • 등록한 Authorized redirect URIs와, 브라우저 연동 시 Authorized JavaScript origins.
  • 개발·운영 구분, Audience·게시 상태·요청 범위와 필요한 검증 결과. 테스트 사용자 제한이 있으면 등록 여부도 전달합니다.

발급·설정 순서

  1. Google Cloud Console에서 서비스 운영에 사용할 프로젝트를 만들거나 선택합니다. 직접 설정하고 발급값을 전달하면 되며 개발자 초대는 필수가 아닙니다.
  2. Google Auth Platform의 Branding에서 앱 이름·지원 이메일·서비스와 개인정보처리방침 주소를 설정하고, Audience에서 이용 대상을 정합니다. 일반 고객용이면 외부 사용자 대상 설정을 확인합니다.
  3. Clients에서 OAuth 클라이언트를 만듭니다. 웹 서버 로그인은 Web application을 선택하고, 개발자가 준 Authorized redirect URIs를 등록합니다. 브라우저 방식에 필요한 Authorized JavaScript origins도 확인합니다.
  4. Client ID와 서버 방식에 필요한 Client Secret을 전달합니다. Android·iOS 앱은 개발자가 지정한 유형으로 클라이언트를 별도 생성합니다.
  5. 테스트 사용자·게시 상태를 확인하고, 요청 범위와 브랜딩 설정에 따라 필요한 검증을 완료합니다. 기본 로그인 정보와 민감·제한 범위의 추가 API 접근은 검증 요건이 다릅니다.

공식 문서: 구글 문서 1 · 구글 문서 2 · 구글 문서 3

애플

애플 — 발급 콘솔 열기

필수 전달값 (웹 서버 로그인 기준)

  • Team ID — Developer 계정의 Membership details에서 확인하는 팀 식별자.
  • Services ID — Identifiers에서 등록한 웹 로그인용 Identifier 전체 값. 표시 이름이 아닌 식별자를 전달합니다.
  • Key ID — Keys에서 Sign in with Apple용으로 만든 키의 식별자.
  • .p8 비공개 키 원본 파일 — 위 Key ID에 해당하는 Sign in with Apple 키. 파일명이나 Key ID만으로는 부족합니다.

해당하는 경우에만 추가 전달

  • iOS 등 네이티브 앱 연동 시: 해당 App ID의 Bundle ID. 네이티브 인증에서는 이 값이 Client ID로 사용됩니다.
  • client secret(JWT)은 별도로 발급받아 준비할 항목이 아닙니다. 개발자가 Team ID·Client ID·Key ID·.p8로 생성하고 갱신합니다.

콘솔에 등록한 뒤 알려줄 설정

  • Services ID에 연결한 기본 App ID, 등록 도메인과 Return URL 전체 주소, 개발·운영 구분.
  • Sign in with Apple 활성화와 Developer Program 멤버십 상태. 키가 해당 기본 App ID에 연결되어 있는지도 확인합니다.

발급·설정 순서

  1. 개인 또는 회사 명의로 Apple Developer Program 가입을 준비합니다. 2단계 인증과 개인·조직별 가입 요건을 확인하고, 유료 멤버십 비용·갱신은 가입 화면에서 확인합니다.
  2. Certificates, Identifiers & Profiles > Identifiers에서 기본 App ID에 Sign in with Apple을 설정합니다. 웹 로그인도 이 기능이 켜진 기본 App ID에 연결해야 합니다.
  3. 웹용 Services ID를 등록하고 Sign in with Apple > Configure에서 기본 App ID, 도메인과 개발자가 알려준 Return URL을 연결합니다.
  4. Keys에서 Sign in with Apple용 키를 만들고 기본 App ID에 연결합니다. Key ID를 기록하고 .p8 파일을 내려받습니다. 키 생성에는 Account Holder 또는 Admin 권한이 필요합니다.
  5. Team ID·App ID·Services ID·Key ID와 .p8 파일을 안전하게 전달합니다. 서버에서 쓰는 client secret은 개발자가 키로 서명해 생성하고 만료·갱신을 관리합니다.

공식 문서: 애플 문서 1 · 애플 문서 2 · 애플 문서 3 · 애플 문서 4

5. 개발자에게 최종 전달할 목록

  • 서비스별 필수 전달값과 해당하는 추가값을 개발·운영 환경별로 구분해 전달합니다. 키는 전체 문자열로, Apple .p8은 원본 파일로 전달합니다. 파일명이나 비밀값을 가린 화면만으로는 연동할 수 없습니다.
  • Client Secret과 Apple .p8 파일은 합의한 보안 전달 경로로 공유하고 공개 채팅·게시글·Git 저장소에는 올리지 않습니다. 카카오 앱 ID·구글 프로젝트 ID·앱 이름은 관리 참고 정보이며 로그인용 키를 대신하지 않습니다.
  • 실제로 등록한 사이트 도메인과 로그인 복귀 주소, 개발·운영 구분, 허용한 사용자 정보 항목.
  • 개발 중·테스트·운영 등 현재 상태, 테스트 계정, 심사 결과와 보완 요청. 비밀값을 가린 설정 화면도 함께 전달하면 확인이 쉽습니다.

발급 완료와 로그인 오픈은 별도입니다

계정과 발급 정보가 준비되면 개발자가 서버에 연결하고 로그인·가입·재로그인·탈퇴를 확인합니다. 테스트 계정 외 일반 사용자도 로그인 가능한지, 필요한 심사와 운영 전환이 끝났는지 함께 확인한 뒤 공개해 주세요. 키 재발급이나 도메인 변경도 적용 중인 로그인에 영향을 주므로 개발자와 먼저 조율해 주세요.

공식 문서 확인: 2026년 11월 14일. 콘솔 메뉴와 신청 요건은 변경될 수 있으니 연결된 공식 안내도 확인해 주세요.