메인 콘텐츠로 건너뛰기

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 개발자 포털에서 X OAuth 앱을 만드는 방법을 안내합니다. Auth 창에 입력할 클라이언트 ID클라이언트 시크릿을 수집합니다.
이 페이지는 X 개발자 포털에서의 공급자 측 설정만 다룹니다. X를 활성화하고 Auth 창에 자격 증명을 입력하는 전체 Clerk Auth 흐름에 대해서는 Clerk Auth 문서의 SSO 공급자에 대한 OAuth 자격 증명 구성을 참조하세요.

사전 요구 사항

  • X 개발자 계정 (무료 티어 사용 가능)
  • 게시된 Replit 앱 — 사용자 정의 OAuth 자격 증명은 프로덕션 환경에서만 사용 가능
  • Auth 창구성 탭 → SSO 공급자 섹션 → 프로덕션 환경 선택 → X 옆의 편집 선택에서 열린 X 공급자 편집 패널

1단계: X 개발자 앱 설정

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

  1. X 개발자 포털로 이동합니다
  2. 개발자 계정이 없으면 신청합니다
  3. 사용 사례를 설명하는 신청서를 완료합니다

앱 만들기 또는 선택하기

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

2단계: 인증 구성

  1. 사용자 인증 설정으로 스크롤합니다
  2. 설정을 선택합니다
앱 권한: 최소 권한 수준을 선택합니다:
  • 읽기 - 사용자 프로필에 필요 (최소)
  • 쓰기 - 사용자를 대신하여 게시하는 경우 (선택 사항)
  • 다이렉트 메시지 - DM 접근을 위한 경우 (선택 사항)
권한이 요청된 범위와 일치해야 합니다. 앱이 tweet.write를 요청하지만 읽기만 활성화한 경우 인증이 실패합니다.
앱 유형: 웹 앱, 자동화된 앱 또는 봇을 선택합니다 앱 정보:
  • 콜백 URI / 리디렉션 URL: Auth 창공급자 설정에 표시된 값을 복사합니다
  • 웹사이트 URL: Auth 창공급자 설정에 표시된 값을 복사합니다
이러한 값을 찾는 방법은 SSO 공급자에 대한 OAuth 자격 증명 구성을 참조하세요.
  1. 저장을 선택합니다
  2. 클라이언트 ID와 클라이언트 시크릿을 저장합니다
클라이언트 시크릿을 안전하게 저장하세요. 분실한 경우 재생성하면 이전 시크릿이 무효화됩니다.

문제 해결

리디렉션 URI 불일치

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

유효하지 않은 클라이언트

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

범위/권한 오류

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

앱이 개발 모드인 경우

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

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

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

추가 리소스