> ## 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 管理已於 3/31/2026 淘汰。我們建議日後使用 [Azure Data Explorer (ADX) 連線](/zh-TW/services/playfab/data-analytics/export-data/data-connection-adx)來管理您的效能和成本。如果您的遊戲仍在使用 **Insights**，請繼續參閱本文以了解實作詳細資料。如需詳細資訊，請參閱 [PlayFab Digest: March feature updates](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. 在 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) 和用戶端/租用戶識別碼：
   > `.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** 頁面，確認此命令是否成功。應該會有一個與用戶端/租用戶識別碼相符的項目。請注意，這會使 Azure 應用程式成為您在 PlayFab 中遊戲的系統管理員。如果您希望 Azure 應用程式擁有較少的權限，請在 PlayFab 中為 Azure 應用程式指派僅具有 Kusto 資料庫權限的[自訂角色](/zh-TW/services/playfab/identity/dev-identity/permissions/playfab-user-roles)。必要的權限如下：
   * **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) 連線](/zh-TW/services/playfab/data-analytics/legacy/connectivity/connecting-azure-data-factory-to-insights)
* [與 Grafana 連線](/zh-TW/services/playfab/data-analytics/legacy/connectivity/connecting-grafana-to-insights)
* [與 Python 連線](/zh-TW/services/playfab/data-analytics/legacy/connectivity/connecting-python-to-insights)


## Related topics

- [將 Grafana 連線至 Insights](/zh-TW/services/playfab/data-analytics/legacy/connectivity/connecting-grafana-to-insights.md)
- [PlayFab API 的 Microsoft Entra ID 驗證](/zh-TW/services/playfab/identity/dev-identity/authentication/entra-id-api-authentication.md)
- [為 PlayFab 設定 Sign in with Apple](/zh-TW/services/playfab/identity/player-identity/platform-specific-authentication/apple-open-id/overview.md)
- [將 Kusto C# SDK 連線至 Insights](/zh-TW/services/playfab/data-analytics/legacy/connectivity/connecting-kusto-csharp-to-insights.md)
- [要求 User Store ID 以進行服務對服務驗證](/zh-TW/publishing/xstore-commerce/xstore-requesting-userstoreid.md)