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

# PlayFab Insights 用の Microsoft Entra ID アプリを作成する

> Microsoft Entra ID アプリを作成して PlayFab Insights のタイトル データベースに接続し、Azure Data Factory、Grafana、または Python からクエリできるようにします。

# チュートリアル: Insights で使用する Microsoft Entra ID アプリケーションを作成する

このチュートリアルでは、Insights で使用する Microsoft Entra ID アプリケーションの作成について説明します。これは、次のツールを Insights に接続する際の前提条件の 1 つです:

* Azure Data Factory (ADF)
* Grafana
* Python

<Note>
  PlayFab Insights Management は 2026/3/31 に廃止されました。今後のパフォーマンスとコストを管理するには、[Azure Data Explorer (ADX) Connections](/services/playfab/data-analytics/export-data/data-connection-adx) の使用をお勧めします。タイトルがまだ **Insights** を使用している場合は、実装の詳細についてこの記事を参照し続けてください。詳細については、[PlayFab Digest: 3 月の機能更新](https://developer.microsoft.com/en-us/games/articles/2026/04/playfab-digest-march-feature-updates/) を参照してください。
</Note>

## 前提条件

* アクティブなサブスクリプションを持つ Azure アカウント。[無料アカウントを作成](https://azure.microsoft.com/free)

## Microsoft Entra ID アプリケーションの作成

タイトル データベースにリンクする Microsoft Entra ID アプリケーションを作成するには:

1. [Azure Portal](https://portal.azure.com) にログインします。Azure サブスクリプションをお持ちでない場合は、[無料アカウントを作成](https://azure.microsoft.com) してください。
2. ポータルにログインした後、検索バーを使用して **\[App Registrations]** を見つけて選択します。次に、左上隅にある **\[New registration]** を選択します。 <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/adf-new-registration.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=871d391f7ce189ac7553b426bf5f06f0" alt="ADF 新しい登録" width="1286" height="692" data-path="images/playfab/data-analytics/legacy/connectivity/adf-new-registration.png" />
3. \[Register an application] ウィンドウで、登録の名前を入力し、この登録でサポートするアカウント タイプを選択します。(決めかねる場合は、**\[Help me choose]** リンクを選択すると、詳細情報を含むウィンドウが開きます。) <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/adf-register-app.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=147d32644e2b0691576c615a9d77dd64" alt="ADF アプリを登録" width="1303" height="940" data-path="images/playfab/data-analytics/legacy/connectivity/adf-register-app.png" />
4. **\[Register]** を選択します。新しく登録したアプリケーションの概要ページに移動します。**\[Application (client) ID]** と **\[Directory (tenant) ID]** をどこかに保存してください (後で必要になります)。
5. 左側のナビゲーション パネルで、**\[Certificates & secrets]** -> **\[New client secret]** を選択します。 <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/adf-certificates-secrets.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=3b6f8fc015864a6ede703601bff161e4" alt="ADF 証明書とシークレット" width="1897" height="886" data-path="images/playfab/data-analytics/legacy/connectivity/adf-certificates-secrets.png" />
6. シークレットの説明を入力し、有効期間を選択します。 <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/adf-add-secret.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=abb15c36e6e9313e41f7d085ddc7c8ab" alt="ADF シークレットを追加" width="985" height="461" data-path="images/playfab/data-analytics/legacy/connectivity/adf-add-secret.png" />
7. **\[Add]** を選択すると、新しいシークレットが **\[Client secrets]** の下に表示されます。ここで必ずシークレット キーをコピーして、安全な場所に保存してください。*この操作は今すぐ実行することが不可欠です。このページを離れると、シークレット キーにアクセスできなくなるためです。*

## Microsoft Entra ID アプリをタイトル データベースに接続する

次に、Azure アプリをタイトル データベースに接続します。

1. GameManager の **\[Explorer]** ページまたは Kusto Explorer から、独自の Title ID とクライアント/テナント ID に置き換えて、次のコマンドを実行します:
   > `.add database <titleID> Admin ('aadapp=<app/client ID>;<tenant ID>') ` `titleID` は大文字と小文字が区別されるため、必ずすべて大文字にしてください。 <img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/explorer-add-database.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=7dcec75f2ac73336563c6d746009d3b3" alt="Explorer データベースを追加" width="2057" height="1225" data-path="images/playfab/data-analytics/legacy/connectivity/explorer-add-database.png" /> このコマンドが成功したことを確認するには、[GameManager](https://developer.playfab.com) の **\[Users]** ページに移動します。クライアント/テナント ID と一致するエントリが表示されるはずです。これにより、Azure アプリは PlayFab のゲームの管理者になることに注意してください。Azure アプリの権限を減らしたい場合は、Kusto データベースの権限のみを持つ PlayFab の [カスタム ロール](/services/playfab/identity/dev-identity/permissions/playfab-user-roles) を Azure アプリに割り当てます。必要な権限は次のとおりです:
   * **Explorer data & tab**。
   * **Analytics data read access**。クエリと単純な管理コマンドを実行するため。
   * **Analytics data write access**。テーブルの作成/削除、リテンション ポリシーの変更、データの取り込み、パージを行うため。

<Note>
  アプリケーションにメール アドレスを割り当てたくない場合、アプリケーションのロールの変更は **\[Roles -> Edit Role Members]** メニューからのみ可能です。
</Note>

<img src="https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/legacy/connectivity/connectivity-cutom-role.png?fit=max&auto=format&n=MjJ0-cTsb1bpaMcX&q=85&s=6fb677c9317b5e9dcdcfa555761916c0" alt="接続カスタム ロール" width="445" height="729" data-path="images/playfab/data-analytics/legacy/connectivity/connectivity-cutom-role.png" />

## 次のステップ

Azure アプリを作成してタイトル データベースにリンクしたので、次の手順に従って、選択したツールを Insights と接続してください:

* [Azure Data Factory (ADF) との接続](/services/playfab/data-analytics/legacy/connectivity/connecting-azure-data-factory-to-insights)
* [Grafana との接続](/services/playfab/data-analytics/legacy/connectivity/connecting-grafana-to-insights)
* [Python との接続](/services/playfab/data-analytics/legacy/connectivity/connecting-python-to-insights)