> ## 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 개발자 포털에서 X OAuth 앱을 만드는 방법을 안내합니다. **Auth 창**에 입력할 **클라이언트 ID**와 **클라이언트 시크릿**을 수집합니다.

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

## 사전 요구 사항

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

## 1단계: X 개발자 앱 설정

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

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

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

1. X 개발자 포털에서 **프로젝트 및 앱**으로 이동합니다
2. 기존 앱을 사용하거나 **앱 추가**를 선택합니다
3. 앱 이름을 입력하고 **다음**을 선택합니다
4. **앱 설정**을 선택합니다

## 2단계: 인증 구성

1. **사용자 인증 설정**으로 스크롤합니다
2. **설정**을 선택합니다

**앱 권한:**

최소 권한 수준을 선택합니다:

* **읽기** - 사용자 프로필에 필요 (최소)
* **쓰기** - 사용자를 대신하여 게시하는 경우 (선택 사항)
* **다이렉트 메시지** - DM 접근을 위한 경우 (선택 사항)

<Warning>
  권한이 요청된 범위와 일치해야 합니다. 앱이 `tweet.write`를 요청하지만 읽기만 활성화한 경우 인증이 실패합니다.
</Warning>

**앱 유형:**

**웹 앱, 자동화된 앱 또는 봇**을 선택합니다

**앱 정보:**

* **콜백 URI / 리디렉션 URL**: **Auth 창**의 **공급자 설정**에 표시된 값을 복사합니다
* **웹사이트 URL**: **Auth 창**의 **공급자 설정**에 표시된 값을 복사합니다

이러한 값을 찾는 방법은 [SSO 공급자에 대한 OAuth 자격 증명 구성](/references/auth-and-identity/clerk-auth#configuring-oauth-credentials-for-an-sso-provider)을 참조하세요.

3. **저장**을 선택합니다
4. **클라이언트 ID와 클라이언트 시크릿을 저장합니다**

<Warning>
  클라이언트 시크릿을 안전하게 저장하세요. 분실한 경우 재생성하면 이전 시크릿이 무효화됩니다.
</Warning>

## 문제 해결

### 리디렉션 URI 불일치

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

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

* 클라이언트 ID와 클라이언트 시크릿을 다시 확인하세요
* 추가 공백이 없는지 확인하세요
* OAuth 2.0 자격 증명을 사용하고 있는지 확인하세요 (OAuth 1.0a가 아닌)

### 범위/권한 오류

* 범위가 X 개발자 포털에서 활성화된 권한과 일치하는지 확인하세요
* 최소한 읽기 권한이 활성화되어 있는지 확인하세요

### 앱이 개발 모드인 경우

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

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

* **Auth 창**의 **공급자 설정**에 표시된 사용자 정의 도메인 값으로 웹사이트 URL과 콜백 URI를 업데이트하세요

## 추가 리소스

* [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)