Skip to main content
Whop 앱은 whop.com의 iframe 안에서 렌더링됩니다. 앱에 누가 요청하는지 알 수 있도록 Whop은 모든 동일 출처 요청의 x-whop-user-token 헤더에 수명이 짧은 JSON Web Token(JWT)을 전달합니다. SDK로 이 토큰을 검증해 사용자 ID를 얻은 다음, 해당 사용자가 무엇을 볼 수 있는지 확인합니다.

iframe 사용자 토큰 검증하기

verifyUserToken은 현재 @whop/sdk에서 사용할 수 없으므로, 이 페이지의 TypeScript 코드 조각은 참고용으로 남겨 두었으며 작성된 그대로는 실행되지 않습니다. Python은 다릅니다. whop-sdk는 이 헬퍼를 whop_sdk.lib.verify_user_token으로 제공하며, PyJWT를 함께 설치해야 합니다(pip install "pyjwt[crypto]"). whop_sdk gem도 이를 제공하지만, 클라이언트와 다른 루트 네임스페이스 아래의 모듈 함수 WhopSDK::Helpers::VerifyUserToken.verify_user_token!로 제공하며, 클라이언트는 Whop_sdk::Client입니다. 클라이언트의 메서드가 아니며, gem은 이미 jwt에 의존합니다.
각 요청에서 verifyUserToken을 호출하세요. 이 함수는 x-whop-user-token 헤더를 읽고, JWT 서명과 만료를 검증한 뒤 사용자 ID를 반환합니다. 유효하지 않은 토큰은 기본적으로 예외를 발생시킵니다. TypeScript와 Python은 예외를 발생시키지 않는 변형도 제공합니다:
토큰은 iframe의 window.location.origin으로 향하는 요청에만 첨부됩니다. 예시:
  • 상대 경로 페이지 이동: <a href="/ko/sub_page">...</a>
  • 도메인 없는 fetch: await fetch("/api/quizzes")
이 요청들은 App.base_url 도메인으로 확인됩니다.
프런트엔드는 example.com에서, API는 api.example.com에서 실행된다면 API 요청이 x-whop-user-token 헤더를 전달하도록 example.com/api를 통해 리버스 프록시하세요.
  • Cloudflare: example.com의 /api를 api.example.com/api로 다시 쓰는 “origin rule”을 생성합니다.
  • Next.js: next.config.mjs에 rewrite를 추가합니다.
  • nginx / Caddy: 서버 구성에서 rewrite 기능을 사용합니다.
이 설정은 브라우저의 엄격한 교차 출처 쿠키 정책 때문에 필요합니다.

로컬 설정

Whop은 프로덕션 iframe 및 쿠키 동작과 일치하는 로컬 리버스 프록시를 제공하므로, 작성한 코드가 localhost와 프로덕션에서 동일하게 작동합니다. 설정 방법은 개발 프록시 가이드를 참고하세요.

접근 권한 확인하기

누가 요청하는지 알았으니 이제 무엇을 볼 수 있는지 확인하세요. checkAccess 메서드를 사용해 경험, 계정 또는 상품에 대한 접근 권한을 확인합니다.

리소스 ID 및 접근 수준

응답의 access_level은 다음 중 하나입니다:

고객 앱(경험 뷰)

고객 앱은 경로 매개변수로 전달된 experienceId를 기준으로 접근을 제한해야 합니다. 보는 사람에게 유효한 멤버십이 없으면 no_access를 반환하거나 리디렉션하세요.
API 라우트에서도 같은 패턴이 작동합니다. headers()를 request.headers로 바꾸고 JSX 대신 403 Response를 반환하세요.

대시보드 앱(대시보드 뷰)

대시보드 앱은 계정 팀 멤버만 뷰를 로드할 수 있도록 access_level === "admin"을 기준으로 접근을 제한해야 합니다.
API 라우트에서도 같은 패턴입니다. headers()를 request.headers로 바꾸고 JSX 대신 403 Response를 반환하세요.

다음 단계

로컬 개발 프록시 실행하기

localhost에서 프로덕션 iframe 및 쿠키 설정을 재현합니다.

권한 요청하기

게시하기 전에 앱에 필요한 범위를 추가하세요.

웹훅 수신하기

서버에서 결제, 멤버십, 신청 이벤트를 받으세요.

앱 뷰 만들기

대시보드 뷰, 경험, 디스커버 등록을 설정하세요.