# 액세스 토큰 개발자 가이드

> Learn to generate and manage Vivox Access Tokens for controlling player access.

> **Warning:**
>
> Vivox 액세스 토큰은 플레이어 채널 액세스를 관리하기 위한 선택적인 고급 기능입니다. 채널 액세스 제어가 필요하지 않을 경우 플레이어를 관리하기 위해 권장되는 방법은 [Unity Authentication 토큰](./authentication-package-tokens.md)입니다.

Vivox 리소스에 대한 플레이어 액세스는 VAT(Vivox 액세스 토큰)를 통해 제어됩니다. Vivox 액세스 토큰은 권한이 필요한 작업을 정의하고, 게임 서버에서 토큰 서명 키를 사용하여 서명한 후 클라이언트에서 Vivox 시스템에 전달하는 페이로드를 포함합니다. Vivox 액세스 토큰은 JSON 웹 토큰과 유사하지만, [액세스 토큰 헤더](./access-token-format/access-token-header.md)가 비어 있습니다.

액세스 토큰의 특성은 다음과 같습니다.

* 토큰은 한 번만 사용할 수 있습니다. 권한이 필요한 작업에 사용한 토큰은 재사용할 수 없습니다.
* 토큰은 사용하지 않아도 만료됩니다. 토큰 발급자가 설정한 만료 시점 이후에는 토큰을 사용할 수 없습니다.

게임 클라이언트가 Vivox 시스템에서 작업을 수행하려면 액세스 토큰이 필요합니다.

* 게임 클라이언트에서 생성된 토큰: 프로토타이핑 또는 테스트 용도로 사용합니다.
* 보안 게임 서버에서 생성된 토큰: 프로덕션 게임을 안전하게 배포하고 사용자 시간 설정으로 인한 토큰 오류를 방지하기 위해 사용합니다.

[UAS(Unity Authentication)](/authentication.md)를 사용할 때 Vivox 액세스 토큰은 토큰 [페이로드](./access-token-format/access-token-payload.md)에서 UASID를 파싱할 수 있습니다. Safe Text와 함께 Vivox 액세스 토큰을 사용 중인 경우, 액세스 토큰에 내장된 UAS ID를 반드시 포함해야 합니다.

토큰을 생성하려면 [클라이언트에서 토큰 생성](./generate-tokens-unity.md)과 [보안 서버에서 토큰 생성](./generate-token-secure-server/generate-token-secure-server-toc.md)이라는 제목의 섹션을 참고하시기 바랍니다.

클라이언트 또는 서버에서 토큰을 생성하려면 토큰 발급자와 토큰 서명 키가 필요합니다. 자세한 내용은 Unity 지원 Knowledge Base 의 [Where do I find my custom application credentials?](https://support.unity.com/hc/en-us/articles/4432290896020)를 참고하시기 바랍니다.

다음 다이어그램은 게임 클라이언트, 게임 서버, Vivox 시스템 간의 일반적인 인터랙션을 나타냅니다.


**Frame:**
![](/api/media?file=/vivox-unity/media/images/access-token-overview-diagram.png)