アクセストークン開発者ガイド
Learn to generate and manage Vivox Access Tokens for controlling player access.
読み終わるまでの所要時間 1 分最終更新 14日前
Vivox リソースへのプレイヤーのアクセスは、Vivox アクセストークン (VAT) を介して制御されます。Vivox アクセストークンには特権操作を定義するペイロードが含まれています。このトークンは、ゲームサーバーによってトークン署名キーを使用して署名され、プレイヤーが特権操作を実行したいときにクライアントから Vivox システムに送信されます。Vivox アクセストークンは JSON ウェブトークンに似ていますが、代わりに空の アクセストークンヘッダー があります。
アクセストークンには以下のような特徴があります。
- トークンは 1 回しか使用できません。トークンを特権操作に使用した後は、再利用できません。
- トークンは 1 回も使用していなくても期限切れになります。トークン発行者によって設定された有効期限が過ぎると、トークンを使用できません。
ゲームクライアントが Vivox システムで操作を実行するには、アクセストークンが必要です。
- ゲームクライアントによって生成されたトークン: プロトタイプ作成またはテストの目的で使用します。
- 安全なゲームサーバーによって生成されたトークン: 製品版のゲームを安全に展開し、ユーザーの時間の設定によるトークンエラーを回避するために使用します。
Unity Authentication (UAS) を使用しているとき、Vivox アクセストークンは、ペイロード の UASID を解析します。Safe Text で Vivox アクセストークンを使用している場合は、埋め込み UAS ID をアクセストークンに加える必要があります。
トークンを生成するには、クライアント上でのトークンの生成 および 安全なサーバー上でのトークンの生成 を参照してください。
クライアントまたはサーバーがトークンを生成するためには、その前にトークン発行者とトークン署名キーが必要であることに注意してください。詳細については、Unity サポートナレッジベース の カスタムアプリケーションの認証情報を見つける方法 を参照してください。
以下のダイアグラムは、ゲームクライアント、ゲームサーバー、Vivox システムの間の典型的なインタラクションを示しています。
