ログイン許可リスト

Last updated on October 2, 2026

注釈：本資料はAI技術を用いて翻訳されています。

概要

AccelByte Gaming Services (AGS) では、プレイヤーアカウントのログイン用の許可リストを設定できます。これにより、指定したプレイヤーアカウントのみが特定の機能にアクセスできるようになり、テスト、フィードバック収集、イベント管理などのプロセスを効率化できます。

本記事では、AGS Admin Portal または AGS CLI でログイン許可リストを設定する方法を説明します。

AGS Public Cloud

ログイン許可リストは、AGS Public Cloudではまだ利用できません。

権限

AGS Admin Portalでログイン許可リストを設定する前に、お使いのアカウントに以下の表に示す権限が付与されていることを確認してください。

用途	権限タグ	アクション
ログイン許可リストの設定を表示する	ADMIN:NAMESPACE:{namespace}:LOGINALLOWLIST	READ
ログイン許可リストの設定を更新する	ADMIN:NAMESPACE:{namespace}:LOGINALLOWLIST	UPDATE

AGS CLI の手順に従う場合は、AGS CLI をインストールし、上記の権限に加えて、ロールを一覧表示するための ADMIN:ROLE に対する READ 権限を持つアカウントでサインインしてください。詳細については、インストールとサインインを参照してください。例では Bash シェルを使用しています。

ログイン許可リストを設定する

Admin Portal

1. AGS Admin Portalで、対象のゲームネームスペースに移動します。

2. Foundations > Tools & Utilities > Login Allowlist に移動します。

3. Role Allowlist セクションで、許可リストに Roles を追加または削除します。これにより、特定のロールを持つユーザーのアクセスを簡単に制御できます。

4. Activate をクリックして、ログイン許可リストを有効にします。デフォルトでは無効になっています。

AGS CLI

1. 許可するロールの ID を確認します。出力内で各ロールを roleName で探し、その roleId をコピーします。

   ags iam roles list --format json

2. 現在のログイン許可リストをファイルに保存します。<YourGameNamespace> は、お使いのゲームネームスペースに置き換えてください。

   ags iam allow-list get --namespace <YourGameNamespace> --format json > allowlist.json

3. allowlist.json で、roleIds 内のロール ID を追加または削除し、active を設定します。

   {
     "active": true,
     "namespace": "<YourGameNamespace>",
     "roleIds": ["<RoleId>"]
   }

   • roleIds: 許可リストが有効な間にログインできるユーザーのロールです。
   • active: true でログイン許可リストを有効にし、false で無効にします。roleIds が空の場合は false に設定してください。Admin Portal では、許可リストに少なくとも 1 つのロールがある場合にのみ有効にでき、最後のロールを削除すると無効になります。

4. 更新した許可リストを送信します。@ の後に JSON ファイルへのパスを指定します。

   ags iam allow-list update --namespace <YourGameNamespace> --json @allowlist.json

   警告

   この更新により、許可リスト全体が置き換えられます。必ず手順 2 で取得した現在の許可リストをもとに編集してください。そうしないと、ファイルに含まれていないロールはすべて削除されます。