이 페이지는 Google Cloud Console에서의 제공자 측 설정만 다룹니다. Google 활성화 및 Auth 패널에서의 자격 증명 입력을 포함한 전체 Clerk Auth 흐름은 Clerk Auth 문서의 SSO 제공자용 OAuth 자격 증명 구성하기를 참고하세요.
사전 준비 사항
- Google Cloud Console 접근 권한
- 게시된 Replit 앱 — 커스텀 OAuth 자격 증명은 Production 환경에서만 사용할 수 있습니다
- Google 제공자의 편집 패널을 다음 경로로 엽니다: Auth 패널 → Configure 탭 → SSO providers 섹션 → Production 환경 선택 → Google 옆의 Edit 선택
1단계: Google OAuth 앱 만들기
Google Cloud Console로 이동합니다.프로젝트 만들기 또는 선택하기
- 프로젝트 드롭다운에서 기존 프로젝트를 선택하거나 새 프로젝트를 만듭니다
- 프로젝트의 Dashboard로 리디렉션됩니다
OAuth 동의 화면 구성하기
- 왼쪽 사이드바에서 메뉴 아이콘(≡)을 선택하고 APIs & Services를 선택합니다
- OAuth consent screen을 선택합니다
- 필요한 정보로 앱의 동의 화면을 구성합니다
- 변경 사항을 저장합니다
OAuth 자격 증명 만들기
- APIs & Services에서 Credentials를 선택합니다
- 상단의 Create Credentials를 선택한 다음 OAuth client ID를 선택합니다
- 애플리케이션 유형으로 Web application을 선택합니다
- Authorized JavaScript origins와 Authorized redirect URIs를 Auth 패널의 Provider setup에 표시된 정확한 값으로 설정합니다. 나열된 모든 값을 추가하세요 — 게시된 도메인과 커스텀 도메인이 모두 포함됩니다. 이 값들을 찾는 방법은 SSO 제공자용 OAuth 자격 증명 구성하기를 참고하세요.
- Create를 선택합니다
- Client ID와 Client Secret을 저장합니다
문제 해결
Redirect URI mismatch
- Google Cloud Console의 리디렉션 URI가 Auth 패널의 Provider setup에 표시된 값과 정확히 일치하는지 확인하세요
- 후행 슬래시나 오타가 없는지 확인하세요
- Google의 구성이 전파되기까지 몇 분 정도 기다리세요
Invalid client
- Client ID와 Client Secret이 올바르게 복사되었는지 다시 확인하세요
- 여분의 공백이 없는지 확인하세요
- OAuth 동의 화면이 구성되었는지 확인하세요
커스텀 도메인에서 작동하지 않음
- Auth 패널의 Provider setup에 표시된 커스텀 도메인 항목을 Authorized JavaScript origins와 Authorized redirect URIs 모두에 추가하세요