사용자 인증
로그인한 시청자를 회원으로 이어 주는 방법입니다. 댓글 기능을 사용하려면 발급한 소스 JWT 토큰을 accessToken 쿼리로 넘깁니다.
토큰이 필요한 기능
댓글은 회원으로 확인된 시청자만 쓸 수 있습니다.
나머지 기능은 토큰 없이 그대로 동작합니다.
| accessToken | 해당 기능 |
|---|---|
| 필수 | 댓글 작성 · 답글 · 댓글 좋아요 · 신고 |
| 불필요 | 클립 재생 · 상품 · 공유 · 플로팅 · 링크 버튼 |
💡 댓글 기능 자체는 소스 어드민 설정으로 켭니다. 꺼져 있으면 플레이어에 댓글 영역이 나오지 않습니다.
📍 토큰 없이 댓글 입력란을 누르면 로그인 안내 모달이 뜨고, 확인하면 소스 어드민에 등록한 자사몰 로그인 주소로 이동합니다.
토큰 발급
토큰 규격은 소스라이브 플레이어·쇼룸과 같은 소스 JWT 입니다. 이미 다른 소스 제품에 토큰을 발급하고 있다면 그 토큰을 그대로 씁니다.
💡 발급 방법은 JWT 토큰 생성 API에 있습니다.
전달 방법
라이브러리·URL 두 방식 모두 페이지 주소의 accessToken 쿼리로 넘깁니다. 라이브러리에는 토큰을 넘기는 함수가 없습니다.
| 연동 방식 | 토큰을 붙이는 주소 |
|---|---|
| 라이브러리 | 라이브러리를 넣은 자사몰 페이지의 주소 |
| URL 연동 | 플레이어 주소 |
text
// 라이브러리 — 자사몰 페이지 주소에 붙인다 https://자사몰/clip?accessToken=발급받은 JWT 토큰 // URL 연동 — 플레이어 주소에 붙인다 https://player.sauceclip.com/player?partnerUniqueId=파트너 ID&clipId=클립 ID&accessToken=발급받은 JWT 토큰
📌 쇼룸에서 클립 카드를 눌러 이동할 때는 쇼룸이 이 토큰을 자동으로 붙입니다. 이동을 브릿지 이벤트로 직접 처리하면 붙지 않으므로 직접 붙여야 합니다 — 쇼룸 이동 연동 참조.
토큰 보관과 재사용
한 번 전달한 토큰은 브라우저에 파트너별로 보관되어 다음 방문에도 쓰입니다.
주소에서 토큰을 뺀 뒤에도 회원 상태가 이어집니다.
| 상황 | 동작 |
|---|---|
| 주소에 토큰이 있음 | 보관된 값을 새 토큰으로 교체하고 검증 |
| 주소에 없고 보관된 토큰이 있음 | 보관된 토큰으로 검증 |
| 검증 실패 | 보관된 토큰을 지우고 회원 확인 없이 재생 — 댓글 기능은 쓸 수 없습니다 |
| 보관 후 24시간 경과 | 보관된 토큰이 만료되어 자동으로 지워짐 |
⚠️ 시청자가 자사몰에서 로그아웃해도 플레이어의 보관 토큰은 그대로 남습니다. 토큰 없이 다시 열면 보관된 이전 토큰으로 검증하므로, 계정이 바뀌면 새 토큰을 주소에 붙여 교체합니다.
Updated about 4 hours ago
Did this page help you?