Pular para o conteúdo principal

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
O PlayFab Insights Management foi desativado em 31/03/2026. Recomendamos usar as Conexões do Azure Data Explorer (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.

Pré-requisitos

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. Se você não tiver uma assinatura do Azure, crie uma conta gratuita.
  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
  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
  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
  6. Insira uma descrição para o segredo e selecione por quanto tempo você deseja que ele seja válido. ADF Adicionar segredo
  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 Você pode verificar se esse comando foi bem-sucedido acessando a página Users no GameManager. 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 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.
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

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:
Última modificação em 20 de outubro de 2026