G · SOCIAL IDENTITY
Google 로그인
개별 연동 안내.
Google OAuth 2.0 / OpenID Connect를 사용해 웹 앱의 사용자 인증을 별도로 구성합니다.
G · SOCIAL IDENTITY
ROUTE PREVIEW
사용자 기기
Client
OAuth 2.0 · HTTPS
연결 중계
제공자별 로그인
서버 callback · 포털 계정
제공자 앱 등록, callback, 최소 동의 범위와 기존 포털 회원 계정 연결을 각각 구성합니다.
PACKET FLOW
IMPLEMENTATION GUIDE
04 IMPLEMENTATION STEPS
Google 로그인 구현 순서
Google OAuth 2.0 / OpenID Connect를 사용해 웹 앱의 사용자 인증을 별도로 구성합니다. 포털 로그인과 별도 연동이며, 앱 등록·콜백 검증·계정 연결을 서버에서 안전하게 구현해야 합니다.
시작 전 준비사항
- Google Cloud 프로젝트와 웹 OAuth 클라이언트
- 운영 도메인과 정확히 일치하는 HTTPS redirect URI
- 필요 최소 scope 및 Google subject와 포털 회원 연결 정책
구현 및 검증 순서
- 공식 지원 범위 확인
공급자의 최신 개발자 문서와 앱 검수 조건을 확인합니다. Instagram은 계정 유형과 인증 목적에 맞는 공식 지원 여부를 먼저 확인하고, 다음 로그인의 경우 별도 인증 API가 제공되는지 확인하기 전까지 연동을 시작하지 않습니다.
- 개별 앱과 callback 등록
제공자 콘솔에 서비스 도메인과 정확한 HTTPS callback 주소를 등록하고 개발·스테이징·운영 환경을 분리합니다.
- 서버 측 인증 흐름 구현
CSRF 방지 state를 세션에 묶고 authorization code를 서버에서 교환·검증합니다. client secret과 토큰은 서버 비밀 설정에 보관하고 로그에 남기지 않습니다.
- 회원 연결과 철회 시험
제공자 사용자 고유 ID를 기준으로 계정을 연결하고, 동의 취소·연결 해제·포털 로그아웃을 시험합니다. 이메일만으로 계정을 자동 병합하지 않습니다.
운영 전 확인 목록
- 공식 제공 범위·검수 조건과 redirect URI가 일치하는가
- state·인가 코드·토큰 검증이 서버에서 이뤄지는가
- 계정 연결·동의 철회·탈퇴를 안전하게 처리하는가
ID token을 사용할 경우 발급자·서명·audience·만료를 서버에서 검증하세요. Google 이메일만으로 기존 포털 계정을 자동 병합하지 마세요.