액세스 토큰 페이로드
Understand the payload section of a Vivox Access Token.
읽는 시간 1분최근 업데이트: 19일 전
페이로드는 base64url로 인코딩된 JSON 객체로, 토큰에서 보장하는 클레임을 포함합니다. 페이로드에 클레임을 순서에 상관없이 나열할 수 있습니다. 다음 표에 토큰에 사용할 수 있는 클레임이 자세히 나와 있습니다. 각 토큰에 필요한 파라미터에 대한 자세한 내용은 액세스 토큰 예제를 참고하시기 바랍니다.
페이로드 내 Unity Authentication ID
애플리케이션에서 Unity Authentication 서비스를 사용하여 플레이어를 인증하는 경우, Vivox 액세스 토큰 내에서 UAS ID를 사용하여 적절한 플레이어 ID를 확인할 수 있습니다. 플레이어를 식별하는 데 사용되는 SIP URI는 전체 SIP URI에서 플레이어 ID가 파싱되도록 적절한 형식이어야 합니다. 이 형식은 VAT가 적용되는 모든 Unity Moderation 서비스를 사용하는 데 필수입니다. 다음은 예상되는 SIP 형식의 예입니다.UAS에서 작동하려면sip:.issuer.unity_player_id.unity_environment_id.@domain.vivox.com
fsub참고
예제의 파라미터만 포함되어 있는지 확인합니다. 잘못된 파라미터가 포함된 클레임은 API 호출 시 ‘유효하지 않은 서명’ 또는 ‘잘못된 형식의 페이로드’ 오류가 반환됩니다.
| 클레임 | 예제 값 | 설명 |
| vxi | 1 | 토큰의 고유함을 보장합니다. 다른 모든 클레임이 동일하다면 이 값은 반드시 달라야 합니다. 그렇지 않으면 토큰이 이미 사용된 것으로 간주되어 거부될 수 있습니다. 토큰이 한 개 생성될 때마다 1씩 증가하는 무부호 정수를 사용하는 것이 좋습니다. |
| sub | sip:.blindmelon-AppName-dev.jerky.@tla.vivox.com | 대상. 음소거와 추방 액션에 사용하는 사용자 SIP URI입니다. 음소거나 음소거 해제 또는 추방된 사용자입니다. |
| f | sip:.blindmelon-AppName-dev.beef.@tla.vivox.com | 부터. 모든 액션에 사용하는 사용자 SIP URI입니다. 로그인, 채널 참여, 다른 사용자 음소거 등의 액션을 수행하는 사용자입니다. |
| iss | blindmelon-AppName-dev | 애플리케이션별 발급자. Unity Cloud 대시보드에서 애플리케이션을 생성하면 발급자가 제공됩니다. |
| vxa | 추방 | Vivox 액션. 자세한 내용은 Vivox 액션 클레임에 지원되는 값을 참고하시기 바랍니다. |
| t | sip:confctl-g-blindmelon-AppName-dev.testchannel@tla.vivox.com | 까지. 참여, 음소거, 추방, 트랜스크립션 액션에 사용하는 채널 SIP URI입니다. 액션이 발생하는 채널입니다. |
| exp | 1600349400 | 만료 시점(epoch 초). 이 값은 일반적으로 현재 시각에 90초를 더한 값입니다. |