教程：创建用于 Insights 的 Microsoft Entra ID 应用程序

本教程介绍如何创建要与 Insights 配合使用的 Microsoft Entra ID 应用程序，这是将以下工具与 Insights 连接的先决条件之一：

• Azure 数据工厂 (ADF)
• Grafana
• Python

注意

PlayFab Insights 管理已于 2023 年 12 月 11 日起弃用。 我们建议使用 Azure 数据资源管理器 (ADX) 连接 来管理未来性能和成本。 如果你的游戏仍在使用 Insights，请继续查看本文以了解实施详细信息。 有关详细信息，请参阅 Insights 弃用博客。

先决条件

• 具有活动订阅的 Azure 帐户。 免费创建帐户

创建 Microsoft Entra ID 应用程序

若要创建 Microsoft Entra ID 应用程序以链接到游戏数据库，请执行以下操作：

1. 登录到 Azure 门户。 如果没有 Azure 订阅，请创建免费帐户。

2. 登录门户后，使用搜索栏查找并选择“应用注册”。 然后，选择左上角的“新注册”。

   

3. 在“注册应用程序”窗口中，输入注册的名称，然后选择你希望此注册支持的帐户类型。 （如果需要帮助决定，请选择“帮助我选择”链接，这将打开一个包含更多信息的窗口。）

   

4. 选择“注册”。 你将被定向到一个页面，其中包含你新注册的应用程序的概述。 将应用程序（客户端）ID 和目录（租户）ID 保存到某个位置（以后需要这些信息）。

5. 在左侧导航面板中，选择 证书 & 机密 ->新建客户端机密。

   

6. 输入密钥的说明，并选择期望的密钥有效期。

   

7. 选择“添加”，新密钥将显示在“客户端密码”下方。 现在，请确保复制密钥并将其保存在安全的地方。 现在这样做非常重要，因为离开此页面后，你将无法访问密钥。

将 Microsoft Entra ID 应用连接到游戏数据库

现在，我们来将 Azure 应用连接到你的游戏数据库。

1. 从 GameManager 或 Kusto.Explorer 中的“资源管理器”页面中，运行以下命令，替换为你自己的游戏 ID 和客户端/租户 ID：

   .add database <titleID> Admin ('aadapp=<app/client ID>;<tenant ID>')

   titleID 区分大小写，因此请确保它全都处于上限。

   

   可以通过访问 GameManager 中的“用户”页面来验证此命令是否成功。 应存在与客户端/租户 ID 匹配的条目。

   请注意，这将使 Azure 应用成为 PlayFab 中你的游戏的管理员。 如果希望 Azure 应用具有较少的权限，请在 PlayFab 中为 Azure 应用分配仅对 Kusto 数据库具有权限的自定义角色。 必要的权限包括：

   • 资源管理器数据和选项卡。
   • 分析数据读取访问，以运行查询和简单的管理命令。
   • 分析数据写入访问，以创建/删除表、更改保留策略、引入数据、清除。

注意

仅可通过 角色更改应用程序的角色 -> 编辑角色成员 菜单（如果不想向应用程序分配电子邮件地址）

后续步骤

在创建 Azure 应用并将其链接到游戏数据库后，请按照以下步骤将所选工具与 Insights 相连接：

• 与 Azure 数据工厂 (ADF) 进行连接
• 与 Grafana 进行连接
• 与 Python 进行连接