Skip to main content
OAuth를 사용하면 사용자가 로그인 페이지나 iOS 웹뷰를 통해 직접 Whop에 로그인합니다. 앱은 임베디드 채팅을 인증하고 로그인한 사용자를 대신해 작업할 수 있는 Whop 사용자 토큰을 받습니다. 앱이 사용자의 Whop 계정에 접근해야 하거나, 자체 백엔드에서 계정 범위 사용자 토큰을 발급하고 싶지 않을 때 OAuth를 사용하세요.

전체 OAuth 가이드

전체 OAuth 2.1 + PKCE 흐름, 토큰 교환, 갱신, 폐기에 대한 자세한 내용은 일반 OAuth 가이드를 참고하세요.

설정

현재 @whop/sdk의 apps.create가 반환하는 App 객체는 client_secret 필드를 노출하지 않습니다. 대신 대시보드 탭에서 클라이언트 시크릿을 복사하세요.
Create App 엔드포인트를 사용해 프로그래밍 방식으로 OAuth 앱을 생성하세요:
리디렉션 URI는 나중에 Update App 엔드포인트로 업데이트할 수 있습니다.

필수 범위

OAuth 구성에는 다음 범위가 포함되어야 합니다:

웹 토큰 엔드포인트

서버는 필수 범위를 가진 유효한 OAuth 토큰을 반환하는 토큰 엔드포인트를 제공해야 합니다. React와 바닐라 JavaScript 채팅 요소는 인증이 필요할 때마다 이 함수를 호출합니다.
서버 측 토큰 교환 구현 방법은 OAuth 가이드를 참고하세요.

iOS의 SDK 관리 OAuth

앱 실행 시 configureWithOAuth를 호출하세요. SDK가 로그인 웹뷰 표시, 토큰 획득, 자동 갱신까지 전체 흐름을 처리합니다.
기본적으로 SDK는 리디렉션 URI에 번들 식별자(com.yourapp.bundle://oauth/callback)를 사용합니다. 이를 사용자 지정할 수 있습니다:
리디렉션 URI가 Whop 대시보드 > Developer > App > OAuth에서 구성한 값과 일치하는지 확인하세요. 사용자가 채팅 뷰로 이동했을 때 아직 인증되지 않았다면 SDK가 자동으로 OAuth 흐름을 시작합니다. 로그인과 로그아웃을 수동으로 시작할 수도 있습니다:

인증 상태 추적하기

.whopAuthState 수정자를 사용해 사용자의 로그인 여부를 반응형으로 추적하세요:

토큰 미리 채우기

다른 출처에서 이미 사용자의 Whop 토큰을 가지고 있다면 이를 미리 채워 첫 실행 시 로그인 웹뷰를 건너뛸 수 있습니다. 출처에는 웹 OAuth 흐름이나 백엔드에서 동기화된 토큰이 포함됩니다. 이는 선택 사항이며 사용자가 이미 다른 곳에서 Whop으로 인증한 경우에만 해당됩니다.
SDK는 JSON Web Token(JWT)에서 토큰 만료 시간을 추출하고 갱신을 자동으로 처리합니다. SDK가 만료된 미리 채운 토큰을 갱신할 수 없으면 일반 OAuth 흐름이 시작됩니다.

다음 단계

인증

임베디드 채팅에서 OAuth와 계정 범위 토큰을 비교합니다.

일반 OAuth 가이드

전체 OAuth 흐름, 토큰 교환, 갱신, 폐기를 구현합니다.

Chat 요소

채팅 UI의 props, 이벤트, 스타일, 딥 링크 옵션을 알아봅니다.

임베디드 채팅 빠른 시작

첫 임베디드 채팅 경험을 렌더링합니다.