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

# X (Twitter) OAuth 구성하기

> 앱 인증을 위한 소셜 로그인 제공자로 X(구 Twitter)를 설정하세요

이 가이드는 X Developer Portal에서 X OAuth 앱을 만드는 과정을 안내합니다. **Client ID**와 **Client Secret**을 수집하여 **Auth 패널**에 입력하게 됩니다.

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

## 사전 준비 사항

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

## 1단계: X Developer 앱 설정하기

### 개발자 계정 만들기(필요한 경우)

1. [X Developer Portal](https://developer.twitter.com/en/portal/dashboard)로 이동합니다
2. 개발자 계정이 없다면 신청합니다
3. 사용 사례를 설명하는 신청서를 작성합니다

### 앱 만들기 또는 선택하기

1. X Developer Portal에서 **Projects & Apps**로 이동합니다
2. 기존 앱을 사용하거나 **Add App**을 선택합니다
3. 앱 이름을 입력하고 **Next**를 선택합니다
4. **App settings**를 선택합니다

## 2단계: 인증 구성하기

1. **User authentication settings**로 스크롤합니다
2. **Set up**을 선택합니다

**App permissions:**

최소 권한 수준을 선택하세요.

* **Read** - 사용자 프로필에 필요(최소 요구 사항)
* **Write** - 사용자를 대신하여 게시하기 위해 필요(선택 사항)
* **Direct Messages** - DM 접근을 위해 필요(선택 사항)

<Warning>
  권한은 요청된 스코프와 일치해야 합니다. 앱이 `tweet.write`를 요청하는데 Read만 활성화했다면 인증이 실패합니다.
</Warning>

**Type of app:**

**Web App, Automated App or Bot**을 선택하세요

**App info:**

* **Callback URI / Redirect URL**: **Auth 패널**의 **Provider setup**에 표시된 값을 복사합니다
* **Website URL**: **Auth 패널**의 **Provider setup**에 표시된 값을 복사합니다

이 값들을 찾는 방법은 [SSO 제공자용 OAuth 자격 증명 구성하기](/ko/features/auth-and-identity/clerk-auth#configuring-oauth-credentials-for-an-sso-provider)를 참고하세요.

3. **Save**를 선택합니다
4. **Client ID와 Client Secret을 저장하세요**

<Warning>
  Client Secret을 안전하게 보관하세요. 잃어버리면 재생성 시 기존 값이 무효화됩니다.
</Warning>

## 문제 해결

### Redirect URI mismatch

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

### Invalid client

* Client ID와 Client Secret을 다시 확인하세요
* 여분의 공백이 없는지 확인하세요
* OAuth 1.0a가 아닌 OAuth 2.0 자격 증명을 사용하고 있는지 확인하세요

### Scope/permission 오류

* 스코프가 X Developer Portal에서 활성화된 권한과 일치하는지 확인하세요
* 최소한 Read 권한이 활성화되어 있는지 확인하세요

### 개발 모드의 앱

* X 앱은 제한된 사용자 수로 개발 모드에서 시작합니다
* 프로덕션 용도로는 상향된 접근 권한을 신청해야 할 수 있습니다

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

* Website URL과 Callback URI를 **Auth 패널**의 **Provider setup**에 표시된 커스텀 도메인 값으로 업데이트하세요

## 추가 자료

* [X OAuth 2.0 문서](https://developer.twitter.com/en/docs/authentication/oauth-2-0)
* [X OAuth 스코프](https://developer.twitter.com/en/docs/authentication/oauth-2-0/authorization-code)