> ## 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) Connections](/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 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 New Registrations" 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 Register App" 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 Certificates & Secrets" 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 Add Secret" 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 Add Database" 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 앱에 더 적은 권한을 부여하려면 Kusto 데이터베이스에 대한 권한만 있는 [사용자 지정 역할](/services/playfab/identity/dev-identity/permissions/playfab-user-roles)을 PlayFab에서 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="Connectivity Custom Role" 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

- [PlayFab API용 Microsoft Entra ID 인증](/ko/services/playfab/identity/dev-identity/authentication/entra-id-api-authentication.md)
- [Grafana를 Insights에 연결](/ko/services/playfab/data-analytics/legacy/connectivity/connecting-grafana-to-insights.md)
- [빠른 시작 - C#용 PlayFab Client 라이브러리](/ko/services/playfab/sdks/c-sharp/quickstart.md)
- [PC용 MSIXVC2 패키징 시작하기](/ko/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC-msixvc2.md)
- [Foundation Mode 온보딩](/ko/services/playfab/get-started/foundation-onboarding.md)