> ## 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 OAuth 구성

> 앱 인증의 소셜 로그인 공급자로 Google을 설정하세요

이 가이드는 Google Cloud Console에서 Google OAuth 앱을 만드는 방법을 안내합니다. **클라이언트 ID**와 **클라이언트 시크릿**을 수집하고, Clerk에 필요한 JavaScript 출처 및 리디렉션 URI를 구성합니다.

<Note>
  이 페이지는 Google Cloud Console에서의 공급자 측 설정만 다룹니다. Google을 활성화하고 **Auth 창**에 자격 증명을 입력하는 전체 Clerk Auth 흐름에 대해서는 Clerk Auth 문서의 [SSO 공급자에 대한 OAuth 자격 증명 구성](/references/auth-and-identity/clerk-auth#configuring-oauth-credentials-for-an-sso-provider)을 참조하세요.
</Note>

## 사전 요구 사항

* [Google Cloud Console](https://console.cloud.google.com/) 접근 권한
* [게시된 Replit 앱](/learn/projects-and-artifacts/replit-deployments) — 사용자 정의 OAuth 자격 증명은 **프로덕션** 환경에서만 사용 가능
* **Auth 창** → **구성** 탭 → **SSO 공급자** 섹션 → **프로덕션** 환경 선택 → **Google** 옆의 **편집** 선택에서 열린 **Google** 공급자 편집 패널

## 1단계: Google OAuth 앱 만들기

[Google Cloud Console](https://console.cloud.google.com/)로 이동합니다:

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

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

### OAuth 동의 화면 구성

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

### OAuth 자격 증명 만들기

1. **API 및 서비스**에서 **자격 증명**을 선택합니다
2. 상단에서 **자격 증명 만들기**를 선택한 다음 **OAuth 클라이언트 ID**를 선택합니다
3. 애플리케이션 유형으로 **웹 애플리케이션**을 선택합니다
4. **승인된 JavaScript 출처**와 **승인된 리디렉션 URI**를 **Auth 창**의 **공급자 설정**에 표시된 정확한 값으로 설정합니다. 나열된 모든 값을 추가하세요 — 게시된 도메인과 사용자 정의 도메인이 모두 포함됩니다. 값을 찾는 방법은 [SSO 공급자에 대한 OAuth 자격 증명 구성](/references/auth-and-identity/clerk-auth#configuring-oauth-credentials-for-an-sso-provider)을 참조하세요.
5. **만들기**를 선택합니다
6. **클라이언트 ID**와 **클라이언트 시크릿**을 저장합니다

<Warning>
  클라이언트 시크릿을 안전하게 보관하고 버전 관리에 커밋하지 마세요.
</Warning>

<Warning>
  Google 로그인은 내장 브라우저나 인앱 웹뷰에서 작동하지 않습니다. 사용자는 표준 웹 브라우저를 사용해야 합니다.
</Warning>

## 문제 해결

### 리디렉션 URI 불일치

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

### 유효하지 않은 클라이언트

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

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

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