액세스 토큰 개발자 가이드
Learn to generate and manage Vivox Access Tokens for controlling player access.
읽는 시간 1분최근 업데이트: 7달 전
경고
Vivox 액세스 토큰은 플레이어 채널 액세스를 관리하기 위한 선택적인 고급 기능입니다. 채널 액세스 제어가 필요하지 않을 경우 플레이어를 관리하기 위해 권장되는 방법은 Unity Authentication 토큰입니다.
Vivox 리소스에 대한 플레이어 액세스는 VAT(Vivox 액세스 토큰)를 통해 제어됩니다. Vivox 액세스 토큰은 권한이 필요한 작업을 정의하고, 게임 서버에서 토큰 서명 키를 사용하여 서명한 후 클라이언트에서 Vivox 시스템에 전달하는 페이로드를 포함합니다. Vivox 액세스 토큰은 JSON 웹 토큰과 유사하지만, 액세스 토큰 헤더가 비어 있습니다.
액세스 토큰의 특성은 다음과 같습니다.
- 토큰은 한 번만 사용할 수 있습니다. 권한이 필요한 작업에 사용한 토큰은 재사용할 수 없습니다.
- 토큰은 사용하지 않아도 만료됩니다. 토큰 발급자가 설정한 만료 시점 이후에는 토큰을 사용할 수 없습니다.
게임 클라이언트가 Vivox 시스템에서 작업을 수행하려면 액세스 토큰이 필요합니다.
- 게임 클라이언트에서 생성된 토큰: 프로토타이핑 또는 테스트 용도로 사용합니다.
- 보안 게임 서버에서 생성된 토큰: 프로덕션 게임을 안전하게 배포하고 사용자 시간 설정으로 인한 토큰 오류를 방지하기 위해 사용합니다.
UAS(Unity Authentication)를 사용할 때 Vivox 액세스 토큰은 토큰 페이로드에서 UASID를 파싱할 수 있습니다. Safe Text와 함께 Vivox 액세스 토큰을 사용 중인 경우, 액세스 토큰에 내장된 UAS ID를 반드시 포함해야 합니다.
토큰을 생성하려면 클라이언트에서 토큰 생성과 보안 서버에서 토큰 생성이라는 제목의 섹션을 참고하시기 바랍니다.
클라이언트 또는 서버에서 토큰을 생성하려면 토큰 발급자와 토큰 서명 키가 필요합니다.
자세한 내용은 Unity 지원 Knowledge Base 의 Where do I find my custom application credentials?를 참고하시기 바랍니다.
다음 다이어그램은 게임 클라이언트, 게임 서버, Vivox 시스템 간의 일반적인 인터랙션을 나타냅니다.
