> ## 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.

# GitHub OAuth 구성

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

이 가이드는 GitHub 개발자 설정에서 GitHub OAuth 앱을 만드는 방법을 안내합니다. **Auth 창**에 입력할 **클라이언트 ID**와 **클라이언트 시크릿**을 수집합니다.

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

## 사전 요구 사항

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

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

1. [GitHub 개발자 설정](https://github.com/settings/developers)으로 이동합니다
2. 사이드바에서 **OAuth Apps**를 선택합니다
3. **New OAuth App**을 선택합니다
4. 애플리케이션 세부 정보를 입력합니다:

**Application name:**

애플리케이션 이름을 입력합니다.

**Homepage URL** 및 **Authorization callback URL:**

둘 다 **Auth 창**의 **공급자 설정**에 표시된 정확한 값으로 설정합니다. 값을 찾는 방법은 [SSO 공급자에 대한 OAuth 자격 증명 구성](/references/auth-and-identity/clerk-auth#configuring-oauth-credentials-for-an-sso-provider)을 참조하세요.

5. **Register application**을 선택합니다

## 2단계: 클라이언트 자격 증명 생성

1. 앱의 설정 페이지에서 **Client ID**를 확인하고 복사합니다
2. **Generate a new client secret**을 선택합니다
3. **Client Secret**을 즉시 복사합니다

<Warning>
  클라이언트 시크릿을 안전하게 저장하세요. 페이지를 떠난 후에는 다시 볼 수 없습니다. 분실한 경우 새 시크릿을 생성해야 합니다.
</Warning>

## 문제 해결

### 리디렉션 URI 불일치

* Authorization callback URL이 **Auth 창**의 **공급자 설정**에 표시된 값과 정확히 일치하는지 확인하세요
* 오타나 잘못된 프로토콜이 없는지 확인하세요
* 후행 슬래시 없음

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

* 클라이언트 ID와 클라이언트 시크릿이 올바르게 복사되었는지 다시 확인하세요
* 붙여넣을 때 추가 공백이 없는지 확인하세요

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

* Homepage URL과 Authorization callback URL을 **Auth 창**의 **공급자 설정**에 표시된 사용자 정의 도메인 값으로 업데이트하세요