> ## 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 Developer Settings에서 GitHub OAuth 앱을 만드는 과정을 안내합니다. **Client ID**와 **Client Secret**을 수집하여 **Auth 패널**에 입력하게 됩니다.

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

## 사전 준비 사항

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

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

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

**Application name:**

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

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

두 값 모두 **Auth 패널**의 **Provider setup**에 표시된 값으로 정확히 설정합니다. 이 값들을 찾는 방법은 [SSO 제공자용 OAuth 자격 증명 구성하기](/ko/features/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>
  Client Secret을 안전하게 저장하세요. 페이지를 벗어난 후에는 다시 볼 수 없습니다. 잃어버렸다면 새로 생성해야 합니다.
</Warning>

## 문제 해결

### Redirect URI mismatch

* Authorization callback URL이 **Auth 패널**의 **Provider setup**에 표시된 값과 정확히 일치하는지 확인하세요
* 오타나 잘못된 프로토콜이 없는지 확인하세요
* 후행 슬래시가 없어야 합니다

### Invalid client

* Client ID와 Client Secret이 올바르게 복사되었는지 다시 확인하세요
* 붙여넣을 때 여분의 공백이 없는지 확인하세요

### 커스텀 도메인에서 작동하지 않음

* Homepage URL과 Authorization callback URL을 **Auth 패널**의 **Provider setup**에 표시된 커스텀 도메인 값으로 업데이트하세요