GuidesAPI GuideChangelog
Log In
Guides

사용자 인증

회원 정보를 쇼룸에 전달하는 방식은 서버에서 발급한 토큰을 넘기는 JWT 인증과 회원 정보로 쇼룸이 토큰을 발급하는 간편 인증 두 가지입니다.

사용자 인증 — 쇼룸 WEB
예상 소요 시간: 15분
📋 사전 조건: 라이브러리 설치
인증 방식 비교

둘 중 하나만 호출합니다. 결과는 같고, 토큰을 누가 만드는지가 다릅니다.

JWT 인증setMemberToken간편 인증setMemberObject
전달값발급받은 JWT 토큰회원 정보 4개
토큰 발급고객사쇼룸
사전 준비JWT 토큰 발급 구현없음
적합한 경우이미 소스 JWT 토큰을 발급하고 있는 경우회원 정보만 있고 토큰 발급 구현이 없는 경우
💡 두 함수 모두 async 입니다. 인증 결과를 기다린 뒤 콘텐츠를 표시하려면 await 로 호출합니다.

JWT 인증

서버에서 발급한 토큰을 그대로 넘깁니다. 쇼룸이 유효성을 검증한 뒤 세션으로 사용합니다.

javascript
await window.SauceShowroomLib.setMemberToken('발급받은 JWT 토큰')
⚠️ 토큰이 유효하지 않거나 회원 토큰이 아니면 세션이 비워집니다. 이 경우 쇼룸은 인증하지 않은 상태로 동작합니다.

간편 인증

회원 정보를 넘기면 쇼룸이 토큰을 발급해 세션으로 사용합니다.

javascript
await window.SauceShowroomLib.setMemberObject({
  memberId: '회원 식별 ID',
  nickname: '닉네임',
  age: '20',
  gender: 'm'
})
파라미터타입필수설명값이 유효하지 않으면
memberIdString필수회원 식별 ID브라우저 콘솔에 멤버ID를 설정해주세요. 를 남기고 중단
nicknameString필수닉네임브라우저 콘솔에 닉네임을 설정해주세요. 를 남기고 중단
ageString선택연령대 — 10대 '10' · 20대 '20'숫자 형식의 문자열이 아니면 경고 없이 'etc' 로 처리
genderString선택남성 'm' · 여성 'w' · 기타 'e'세 값이 아니면 경고 없이 'e' 로 처리
📌 필수 두 개가 없으면 토큰을 발급하지 않고 중단하고, 그 사실은 브라우저 콘솔에만 남습니다. 문구별 원인은 콘솔 경고와 문제 해결에 있습니다.

인증하지 않은 상태

두 함수를 호출하지 않아도 콘텐츠는 표시됩니다. 회원을 식별해야 하는 동작만 제한됩니다.

동작인증한 상태인증하지 않은 상태
콘텐츠 표시표시표시
라이브 알림 버튼알림 받기/해제 진행로그인 모달 노출 → 로그인 브릿지 전송
플레이어 이동이동 URL 에 accessToken 이 실림토큰 없이 이동

Did this page help you?
🏠 소스라이브 🎬 소스클립 🔗 소스링크 📢 소스애드
🧩 API 가이드
🆕 최근 업데이트
💬 도움이 더 필요하신가요?
메일로 문의 카카오톡 채널로 문의
담당자에게 문의하기

궁금한 점이나 불편했던 점을 남겨주시면 담당자가 확인 후 답변드릴게요.

가이드 챗봇 BETA
* AI를 활용해 답변해서 사실과 다를 수도 있어요. 더 궁금한 사항은 '담당자에게 문의하기'를 이용해주세요.
💡 궁금한 솔루션(예: 라이브, 링크 등)을 함께 적어주시면 더 정확한 답변을 받을 수 있어요.