이 페이지는 X Developer Portal에서의 제공자 측 설정만 다룹니다. X 활성화 및 Auth 패널에서의 자격 증명 입력을 포함한 전체 Clerk Auth 흐름은 Clerk Auth 문서의 SSO 제공자용 OAuth 자격 증명 구성하기를 참고하세요.
사전 준비 사항
- X Developer 계정 (무료 등급 사용 가능)
- 게시된 Replit 앱 — 커스텀 OAuth 자격 증명은 Production 환경에서만 사용할 수 있습니다
- X 제공자의 편집 패널을 다음 경로로 엽니다: Auth 패널 → Configure 탭 → SSO providers 섹션 → Production 환경 선택 → X 옆의 Edit 선택
1단계: X Developer 앱 설정하기
개발자 계정 만들기(필요한 경우)
- X Developer Portal로 이동합니다
- 개발자 계정이 없다면 신청합니다
- 사용 사례를 설명하는 신청서를 작성합니다
앱 만들기 또는 선택하기
- X Developer Portal에서 Projects & Apps로 이동합니다
- 기존 앱을 사용하거나 Add App을 선택합니다
- 앱 이름을 입력하고 Next를 선택합니다
- App settings를 선택합니다
2단계: 인증 구성하기
- User authentication settings로 스크롤합니다
- Set up을 선택합니다
- Read - 사용자 프로필에 필요(최소 요구 사항)
- Write - 사용자를 대신하여 게시하기 위해 필요(선택 사항)
- Direct Messages - DM 접근을 위해 필요(선택 사항)
- Callback URI / Redirect URL: Auth 패널의 Provider setup에 표시된 값을 복사합니다
- Website URL: Auth 패널의 Provider setup에 표시된 값을 복사합니다
- Save를 선택합니다
- Client ID와 Client Secret을 저장하세요
문제 해결
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에 표시된 커스텀 도메인 값으로 업데이트하세요