메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

이 가이드는 Google Cloud Console에서 Google OAuth 앱을 만드는 방법을 안내합니다. 클라이언트 ID클라이언트 시크릿을 수집하고, Clerk에 필요한 JavaScript 출처 및 리디렉션 URI를 구성합니다.
이 페이지는 Google Cloud Console에서의 공급자 측 설정만 다룹니다. Google을 활성화하고 Auth 창에 자격 증명을 입력하는 전체 Clerk Auth 흐름에 대해서는 Clerk Auth 문서의 SSO 공급자에 대한 OAuth 자격 증명 구성을 참조하세요.

사전 요구 사항

  • Google Cloud Console 접근 권한
  • 게시된 Replit 앱 — 사용자 정의 OAuth 자격 증명은 프로덕션 환경에서만 사용 가능
  • Auth 창구성 탭 → SSO 공급자 섹션 → 프로덕션 환경 선택 → Google 옆의 편집 선택에서 열린 Google 공급자 편집 패널

1단계: Google OAuth 앱 만들기

Google Cloud Console로 이동합니다:

프로젝트 만들기 또는 선택하기

  1. 프로젝트 드롭다운에서 기존 프로젝트를 선택하거나 새 프로젝트를 만듭니다
  2. 프로젝트 대시보드로 리디렉션됩니다

OAuth 동의 화면 구성

  1. 왼쪽 사이드바에서 메뉴 아이콘(≡)을 선택하고 API 및 서비스를 선택합니다
  2. OAuth 동의 화면을 선택합니다
  3. 필요한 정보로 앱의 동의 화면을 구성합니다
  4. 변경 사항을 저장합니다

OAuth 자격 증명 만들기

  1. API 및 서비스에서 자격 증명을 선택합니다
  2. 상단에서 자격 증명 만들기를 선택한 다음 OAuth 클라이언트 ID를 선택합니다
  3. 애플리케이션 유형으로 웹 애플리케이션을 선택합니다
  4. 승인된 JavaScript 출처승인된 리디렉션 URIAuth 창공급자 설정에 표시된 정확한 값으로 설정합니다. 나열된 모든 값을 추가하세요 — 게시된 도메인과 사용자 정의 도메인이 모두 포함됩니다. 값을 찾는 방법은 SSO 공급자에 대한 OAuth 자격 증명 구성을 참조하세요.
  5. 만들기를 선택합니다
  6. 클라이언트 ID클라이언트 시크릿을 저장합니다
클라이언트 시크릿을 안전하게 보관하고 버전 관리에 커밋하지 마세요.
Google 로그인은 내장 브라우저나 인앱 웹뷰에서 작동하지 않습니다. 사용자는 표준 웹 브라우저를 사용해야 합니다.

문제 해결

리디렉션 URI 불일치

  • Google Cloud Console의 리디렉션 URI가 Auth 창공급자 설정에 표시된 값과 정확히 일치하는지 확인하세요
  • 후행 슬래시나 오타가 없는지 확인하세요
  • Google 구성이 전파되는 데 몇 분 기다리세요

유효하지 않은 클라이언트

  • 클라이언트 ID와 클라이언트 시크릿이 올바르게 복사되었는지 다시 확인하세요
  • 추가 공백이 없는지 확인하세요
  • OAuth 동의 화면이 구성되어 있는지 확인하세요

사용자 정의 도메인에서 작동하지 않음

  • Auth 창공급자 설정에 표시된 사용자 정의 도메인 항목을 승인된 JavaScript 출처와 승인된 리디렉션 URI 모두에 추가하세요