> ## 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 앱을 만드는 과정을 안내합니다. **Client ID**와 **Client Secret**을 수집하고, Clerk가 요구하는 JavaScript 원본과 리디렉션 URI를 구성하게 됩니다.

<Note>
  이 페이지는 Google Cloud Console에서의 제공자 측 설정만 다룹니다. Google 활성화 및 **Auth 패널**에서의 자격 증명 입력을 포함한 전체 Clerk Auth 흐름은 Clerk Auth 문서의 [SSO 제공자용 OAuth 자격 증명 구성하기](/ko/features/auth-and-identity/clerk-auth#configuring-oauth-credentials-for-an-sso-provider)를 참고하세요.
</Note>

## 사전 준비 사항

* [Google Cloud Console](https://console.cloud.google.com/) 접근 권한
* [게시된 Replit 앱](/ko/learn/projects-and-artifacts/replit-deployments) — 커스텀 OAuth 자격 증명은 **Production** 환경에서만 사용할 수 있습니다
* **Google** 제공자의 편집 패널을 다음 경로로 엽니다: **Auth 패널** → **Configure** 탭 → **SSO providers** 섹션 → **Production** 환경 선택 → **Google** 옆의 **Edit** 선택

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

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

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

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

### OAuth 동의 화면 구성하기

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

### OAuth 자격 증명 만들기

1. **APIs & Services**에서 **Credentials**를 선택합니다
2. 상단의 **Create Credentials**를 선택한 다음 **OAuth client ID**를 선택합니다
3. 애플리케이션 유형으로 **Web application**을 선택합니다
4. **Authorized JavaScript origins**와 **Authorized redirect URIs**를 **Auth 패널**의 **Provider setup**에 표시된 정확한 값으로 설정합니다. 나열된 모든 값을 추가하세요 — 게시된 도메인과 커스텀 도메인이 모두 포함됩니다. 이 값들을 찾는 방법은 [SSO 제공자용 OAuth 자격 증명 구성하기](/ko/features/auth-and-identity/clerk-auth#configuring-oauth-credentials-for-an-sso-provider)를 참고하세요.
5. **Create**를 선택합니다
6. **Client ID**와 **Client Secret**을 저장합니다

<Warning>
  Client Secret을 안전하게 보관하고 절대 버전 관리 시스템에 커밋하지 마세요.
</Warning>

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

## 문제 해결

### 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 모두에 추가하세요