> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PlayFab のユーザー ロール

> PlayFab Game Manager でユーザー ロールを作成し、タイトルごとにきめ細かなアクセス許可を割り当て、管理者、サポート、製品チームのスタジオ アクセスを管理します。

ロールは、PlayFab の Game Manager でユーザーのアクセス許可とナビゲーションを管理する方法です。スタジオはロールとユーザーを管理する管理上のグループであり、ロールの割り当ては一般に個々のタイトルへのアクセスを制御します。ロールとは、スタジオ内のユーザーにタイトル単位で割り当てる、名前付きのアクセス許可のコレクションです。ロールを一度定義すれば、必要なだけ多くのユーザーに割り当てることができ、ロールを編集することで全員のアクセスを一度に更新できます。これらのスコープの詳細については、[PlayFab の概念](https://docs.xbox.com/ja-jp/services/playfab/get-started/concepts.md#studios-namespaces-and-titles) を参照してください。

この記事では、最もよく行う 3 つの操作 (ロールの作成、アクセス許可の構成、ユーザーへの割り当て) について説明します。

## ロールのしくみ

PlayFab では、数百もの個別のアクセス許可を備えたきめ細かなアクセス許可モデルを使用しているため、各ユーザーに許可する操作を *正確に* 決定できます。Game Manager の各領域は、完全にオフにしたり、読み取り専用に設定したり、編集可能にしたりできます。

これが役立つ例をいくつか紹介します:

* カスタマー サービス担当者は、プレイヤー プロファイルを編集できますが、収益データを見ることはできません。
* プロダクト マネージャーは、収益ダッシュボードを表示できますが、マルチプレイヤー サーバーのビルドをアップロードすることはできません。
* データ サイエンティストは、すべてのイベントとダッシュボードを読み取ることができますが、どこにも書き込みアクセス権を持ちません。

アクセス許可は個々のユーザーではなくロールに保持されるため、ポリシーの変更は 1 回の編集で済みます。ロールを更新すると、そのロールを持つすべてのユーザーに変更が即座に反映されます。

ロールは **タイトルごと** に割り当てられ、ユーザーは同じタイトルで **複数のロール** を持つことができます。たとえば、あるユーザーに *Customer Support* ロールと *Data Scientist* ロールの両方を付与すると、そのユーザーには両方を組み合わせたアクセス許可が与えられます。また、同じユーザーが、同じスタジオ内で、あるタイトルではタイトル管理者、別のタイトルではプロダクト マネージャー、3 つ目のタイトルではカスタマー サービス担当者になることもできます。

### 組み込みロールと管理者レベル

すべてのスタジオには、次の 3 つの定義済みロールが用意されています:

* **Title Admin**: 特定のタイトルに対する完全なアクセス許可
* **Dashboard**: タイトルのダッシュボードを表示するアクセス許可のみ
* **Commercial admin**: タイトルのダッシュボードの表示、設定の編集、Economy の支払いの表示、製品のアクティブ化の管理を行うアクセス許可

タイトルへのアクセスに影響する、スタジオ全体に適用される特別なアクセス許可が 2 つあります。

* **Studio Admin**: タイトルの作成、ロールの定義と編集を行うことができ、スタジオ内のすべてのタイトルに対する **タイトル管理者** 権限を自動的に持ちます。ロールを作成したりユーザーに割り当てたりするには、Studio Admin である必要があります。
* **Commercial admin**: スタジオの課金プロセスを一部制御でき、スタジオ内のすべてのタイトルに対する **コマーシャル管理者** 権限を自動的に持ちます。

## ロールの作成

1. 開発者アカウントで [PlayFab にサインイン](https://developer.playfab.com/) します。
2. **\[My Studios and Titles]** で、スタジオの右側にある **3 つのドット (...) メニュー** を選択し、**\[Roles]** を選択します。

   ![\[Roles\] オプションが表示されたスタジオの 3 つのドット メニューのスクリーンショット](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/dev-identity/user-roles-my-studios-roles.jpg?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=3dbf611d76d08ed29680e4bd5d7c8c29)
3. スタジオに既に存在するロールの一覧が表示されます。カスタム ロールを開始するには、**\[New custom role]** を選択します。

   ![\[New Role\] ボタンが表示されたロールの一覧のスクリーンショット](https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/identity/dev-identity/user-roles-list-roles.jpg?fit=max\&auto=format\&n=Oa_DP1q6U1lat7c2\&q=85\&s=1e8a58c2d5a2eb248aa5c5acaa470f47)
4. **\[Role details]** で、ロールにわかりやすい **\[Role title]** を付けます。これは後でロールを割り当てる際に選択する名前になるため、内容がわかる名前にしてください (たとえば、*Customer Support* や *Build Engineer*)。

   ![\[Role details\] セクションのスクリーンショット](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/dev-identity/user-roles-role-details.jpg?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=970a9b4ba4dc6ece42e3fe7ad5722a18)
5. このロールにタイトルへの無制限のアクセス権を与える場合は、**\[Title admin]** をオンにします。これにより、タイトルに対する完全なアクセス許可が付与され、以下の個々のアクセス許可の選択よりも優先されます。

### アクセス許可の構成

**\[Configure permissions]** セクションでは、ロールが実行できる操作を正確に選択します。アクセス許可は **Overview**、**Identity**、**Economy** などのグループに整理されており、各グループには、現在選択されているアクセス許可の数を示すカウンター (たとえば、*Overview (0/7)*) が表示されます。

各アクセス許可には、1 つ以上のアクセス レベルがあります:

* **Read**: データまたは領域を表示します
* **Edit**: 作成および変更します
* **Delete**: 削除します

すべてのアクセス許可に 3 つすべてがあるわけではありません。領域によっては、**Activate**、**Submit**、**Review** など、独自の専用アクションが追加されています。アクションの対象範囲がわからない場合は、その横にある **(i)** ツールチップにカーソルを合わせると、詳しい説明が表示されます。たとえば、*Payouts tab* の **Review** アクションでは、"Approve and reject payouts" (支払いを承認および拒否する) ことができると説明されています。

すばやく操作するには、一括コントロールを使用します:

* **Search**: アクセス許可の一覧をフィルター処理して、特定の項目を見つけます。
* **Toggle all permissions**: すべてのアクセス許可を一度に選択またはクリアします。
* **Set read only**: スコープ全体で **Read** チェック ボックスのみを選択し、**Edit** と **Delete** はクリアしたままにします。
* **Collapse all**: すべてのグループの内容を非表示にして、表示をすっきりさせます。

各グループにも独自の **Select all** と **Set read only** があるため、一度に 1 つの領域ずつ構成できます。

![アクセス許可グループが表示された \[Configure permissions\] セクションのスクリーンショット](https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/identity/dev-identity/user-roles-category-selected.jpg?fit=max\&auto=format\&n=Oa_DP1q6U1lat7c2\&q=85\&s=18a2e99f0363de481ec86a5ff0131c15)

アクセス許可が適切であることを確認したら、一番下までスクロールして **\[Save Role]** を選択します。

## ユーザーへのロールの割り当て

ロールは、ユーザーから割り当てる方法と、ロールから割り当てる方法の 2 つの方法で割り当てることができます。

**ユーザーから:**

1. **\[My Studios and Titles]** で、スタジオの横にある **3 つのドット (...) メニュー** を選択し、**\[Users]** を選択します。
2. 更新するユーザーを開き、タイトルごとにロールを選択します。ロールのスコープはタイトルであるため、ユーザーが必要とするタイトルごとにロールを割り当ててください。
3. 変更を保存します。

![タイトルごとにユーザーにロールを割り当てるスクリーンショット](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/dev-identity/user-roles-user-manage-roles.jpg?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=58ae4b3237a5ad03b373cbeccf95a12c)

**ロールから:**

既存のロールを開き、その **\[Members]** タブを選択します。そこで、スタジオ内のどのユーザーがこのロールをどのタイトルで持つかを選択できます。この方法は、複数のユーザーを同じロールに一度にオンボードする場合に便利です。

![ロールの \[Members\] タブのスクリーンショット](https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/dev-identity/user-roles-role-members.jpg?fit=max\&auto=format\&n=mLCHf0iQv3VidfBe\&q=85\&s=e86015d46073fe8c2ad1f8a98a4303f2)

## まとめ

ロールを使用すると、Game Manager で誰が何を実行できるかを、スタジオ全体で柔軟に制御できます。ロールを定義し、Read/Edit/Delete (および領域固有の) コントロールでアクセス許可を調整して、タイトルごとにチームに割り当てます。ロールを一度更新すれば、そのロールを持つすべてのユーザーが同期された状態に保たれます。


## Related topics

- [XR-112 アクティブ化時と再開時のユーザーとコントローラーの設定](https://docs.xbox.com/ja-jp/publishing/certification/xr/xr-112.md)
- [XR115 ゲームプレイ中のユーザーまたはコントローラーの追加と削除](https://docs.xbox.com/ja-jp/publishing/certification/fma/xr-115.md)
- [PlayFab ユーザー生成コンテンツ](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/ugc/overview.md)
- [XBOX ゲーム向け XBOX 要件](https://docs.xbox.com/ja-jp/publishing/certification/xbox-requirements.md)
- [XR-115 ゲームプレイ中のユーザーまたはコントローラーの追加と削除](https://docs.xbox.com/ja-jp/publishing/certification/xr/xr-115.md)