> ## 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 连接的先决条件之一：

* Azure Data Factory (ADF)
* Grafana
* Python

<Note>
  PlayFab Insights Management 已于 2026 年 3 月 31 日退役。我们建议使用 [Azure Data Explorer (ADX) 连接](/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 门户](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. 在"注册应用程序"窗口中，输入注册名称，然后选择你希望此注册支持哪些账户类型。（如果你需要帮助来决定，请选择 **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 和 client/tenant 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** 页面验证此命令是否成功。应该有一个与 Client/Tenant ID 匹配的条目。请注意，这将使 Azure 应用成为你在 PlayFab 中游戏的管理员。如果你希望 Azure 应用具有较低的权限，请在 PlayFab 中为 Azure 应用分配一个仅具有 Kusto 数据库权限的[自定义角色](/services/playfab/identity/dev-identity/permissions/playfab-user-roles)。所需权限为：
   * **Explorer 数据和选项卡**。
   * **Analytics 数据读取访问**，用于运行查询和简单的管理命令。
   * **Analytics 数据写入访问**，用于创建/删除表、更改保留策略、引入数据、清除。

<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)


## Related topics

- [将 Grafana 连接到 Insights](/zh-CN/services/playfab/data-analytics/legacy/connectivity/connecting-grafana-to-insights.md)
- [用于 PlayFab API 的 Microsoft Entra ID 身份验证](/zh-CN/services/playfab/identity/dev-identity/authentication/entra-id-api-authentication.md)
- [将 Kusto C# SDK 连接到 Insights](/zh-CN/services/playfab/data-analytics/legacy/connectivity/connecting-kusto-csharp-to-insights.md)
- [为 PlayFab 设置 Sign In with Apple](/zh-CN/services/playfab/identity/player-identity/platform-specific-authentication/apple-open-id/overview.md)
- [Insights](/zh-CN/services/playfab/data-analytics/legacy/insights/overview.md)