> ## 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.

# Criando um aplicativo do Microsoft Entra ID e conectando-o ao banco de dados do título

> Crie um aplicativo do Microsoft Entra ID e conecte-o ao banco de dados do seu título no PlayFab Insights para que o Azure Data Factory, o Grafana ou o Python possam consultá-lo.

# Tutorial: Criar um aplicativo do Microsoft Entra ID para usar com o Insights

Este tutorial aborda a criação de um aplicativo do Microsoft Entra ID para usar com o Insights, que é um dos pré-requisitos para conectar as seguintes ferramentas ao Insights:

* Azure Data Factory (ADF)
* Grafana
* Python

> [!NOTE]
>
> O PlayFab Insights Management foi desativado em 31/03/2026. Recomendamos usar as [Conexões do Azure Data Explorer (ADX)](/pt-BR/services/playfab/data-analytics/export-data/data-connection-adx) para gerenciar seu desempenho e custo daqui em diante. Se o seu título ainda estiver usando o **Insights**, continue consultando este artigo para obter detalhes de implementação. Para obter mais informações, confira [PlayFab Digest: March feature updates](https://developer.microsoft.com/en-us/games/articles/2026/04/playfab-digest-march-feature-updates/).

## Pré-requisitos

* Uma conta do Azure com uma assinatura ativa. [Crie uma conta gratuitamente](https://azure.microsoft.com/free)

## Criar um aplicativo do Microsoft Entra ID

Para criar um aplicativo do Microsoft Entra ID a ser vinculado ao banco de dados do seu título:

1. Faça login no [portal do Azure](https://portal.azure.com). Se você não tiver uma assinatura do Azure, [crie uma conta gratuita](https://azure.microsoft.com).
2. Depois de fazer login no portal, use a barra de pesquisa para localizar e selecionar **App Registrations**. Em seguida, selecione **New registration** no canto superior esquerdo. ![ADF Novos registros](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)
3. Na janela Register an application, insira um nome para o registro e selecione os tipos de conta aos quais você deseja que esse registro dê suporte. (Se precisar de ajuda para decidir, selecione o link **Help me choose**, que abrirá uma janela com mais informações.) ![ADF Registrar aplicativo](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)
4. Selecione **Register**. Você será direcionado para uma página com uma visão geral do aplicativo recém-registrado. Salve a **Application (client) ID** e a **Directory (tenant) ID** em algum lugar (você precisará delas mais tarde).
5. No painel de navegação à esquerda, selecione **Certificates & secrets** -> **New client secret**. ![ADF Certificados e segredos](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)
6. Insira uma descrição para o segredo e selecione por quanto tempo você deseja que ele seja válido. ![ADF Adicionar segredo](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)
7. Selecione **Add**, e o novo segredo aparecerá em **Client secrets**. Agora, certifique-se de copiar a chave secreta e salvá-la em um local seguro. *É essencial fazer isso agora, pois você não poderá acessar a chave secreta depois de sair desta página.*

## Conectar o aplicativo do Microsoft Entra ID ao banco de dados do seu título

Agora vamos conectar o aplicativo do Azure ao banco de dados do seu título.

1. Na página **Explorer** do GameManager ou no Kusto Explorer, execute o comando a seguir, substituindo pela sua própria ID do título e ID do cliente/locatário:
   > `.add database <titleID> Admin ('aadapp=<app/client ID>;<tenant ID>') ` `titleID` diferencia maiúsculas de minúsculas, portanto, certifique-se de que esteja todo em letras maiúsculas. ![Explorer Adicionar banco de dados](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) Você pode verificar se esse comando foi bem-sucedido acessando a página **Users** no [GameManager](https://developer.playfab.com). Deve haver uma entrada que corresponda à ID do cliente/locatário. Observe que isso tornará o aplicativo do Azure um administrador do seu jogo no PlayFab. Se você quiser que o aplicativo do Azure tenha permissões menores, atribua ao aplicativo do Azure uma [função personalizada](/pt-BR/services/playfab/identity/dev-identity/permissions/playfab-user-roles) no PlayFab que tenha permissões apenas para o banco de dados Kusto. As permissões necessárias são:
   * **Dados e guia do Explorer**.
   * **Acesso de leitura aos dados de Analytics**, para executar consultas e comandos simples de gerenciamento.
   * **Acesso de gravação aos dados de Analytics**, para criar/descartar tabelas, alterar a política de retenção, ingerir dados e limpar.

> [!NOTE]
>
> A alteração das funções do aplicativo só é possível por meio do menu **Roles -> Edit Role Members** se você não quiser atribuir um endereço de email ao seu aplicativo

![Função personalizada de conectividade](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)

## Próximas etapas

Agora que você criou um aplicativo do Azure e o vinculou ao banco de dados do seu título, siga as etapas para conectar a ferramenta de sua escolha ao Insights:

* [Conectar com o Azure Data Factory (ADF)](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-azure-data-factory-to-insights)
* [Conectar com o Grafana](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-grafana-to-insights)
* [Conectar com o Python](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-python-to-insights)


## Related topics

- [Conectando o Grafana ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-grafana-to-insights.md)
- [Conectando o Python ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-python-to-insights.md)
- [Conectando o SDK do Kusto para C# ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-kusto-csharp-to-insights.md)
- [Conectando o Azure Data Factory (ADF) ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-azure-data-factory-to-insights.md)
- [Conectando o Power BI ao Insights](/pt-BR/services/playfab/data-analytics/legacy/connectivity/connecting-power-bi-to-insights.md)
