Passer au contenu principal

Tutoriel : Créer une application Microsoft Entra ID à utiliser avec Insights

Ce tutoriel explique comment créer une application Microsoft Entra ID à utiliser avec Insights, ce qui constitue l’un des prérequis pour connecter les outils suivants à Insights :
  • Azure Data Factory (ADF)
  • Grafana
  • Python
PlayFab Insights Management a été mis hors service le 31/03/2026. Nous vous recommandons d’utiliser les connexions Azure Data Explorer (ADX) pour gérer votre rendement et vos coûts à l’avenir. Si votre titre utilise encore Insights, continuez à consulter cet article pour les détails de mise en œuvre. Pour plus d’informations, consultez PlayFab Digest: March feature updates.

Prérequis

Créer une application Microsoft Entra ID

Pour créer une application Microsoft Entra ID à lier à la base de données de votre titre :
  1. Connectez-vous au portail Azure. Si vous n’avez pas d’abonnement Azure, créez un compte gratuit.
  2. Une fois connecté au portail, utilisez la barre de recherche pour trouver et sélectionner App Registrations. Sélectionnez ensuite New registration dans le coin supérieur gauche. ADF - Nouvelles inscriptions
  3. Dans la fenêtre Register an application, entrez un nom pour votre inscription, puis sélectionnez les types de comptes que cette inscription doit prendre en charge. (Si vous avez besoin d’aide pour décider, sélectionnez le lien Help me choose, qui ouvrira une fenêtre contenant plus d’informations.) ADF - Inscrire une application
  4. Sélectionnez Register. Vous serez redirigé vers une page présentant une vue d’ensemble de votre application nouvellement inscrite. Enregistrez l’Application (client) ID et le Directory (tenant) ID quelque part (vous en aurez besoin plus tard).
  5. Dans le panneau de navigation de gauche, sélectionnez Certificates & secrets -> New client secret. ADF - Certificats et secrets
  6. Entrez une description pour la clé secrète et sélectionnez sa durée de validité. ADF - Ajouter une clé secrète
  7. Sélectionnez Add, et la nouvelle clé secrète apparaîtra sous Client secrets. Assurez-vous maintenant de copier la clé secrète et de l’enregistrer dans un endroit sûr. Il est essentiel de le faire maintenant, car vous ne pourrez plus accéder à la clé secrète une fois que vous aurez quitté cette page.

Connecter l’application Microsoft Entra ID à la base de données de votre titre

Nous allons maintenant connecter l’application Azure à la base de données de votre titre.
  1. À partir de la page Explorer de GameManager ou dans Kusto Explorer, exécutez la commande suivante en la remplaçant par votre propre ID de titre et votre ID client/locataire :
    .add database <titleID> Admin ('aadapp=<app/client ID>;<tenant ID>') titleID respecte la casse; assurez-vous donc qu’il est entièrement en majuscules. Explorer - Ajouter une base de données Vous pouvez vérifier que cette commande a réussi en accédant à la page Users dans GameManager. Une entrée correspondant à l’ID client/locataire devrait s’y trouver. Notez que cela fera de l’application Azure un administrateur de votre jeu dans PlayFab. Si vous souhaitez que l’application Azure dispose d’autorisations moindres, attribuez-lui un rôle personnalisé dans PlayFab qui dispose uniquement d’autorisations pour la base de données Kusto. Les autorisations nécessaires sont :
    • Explorer data & tab.
    • Analytics data read access, pour exécuter des requêtes et des commandes de gestion simples.
    • Analytics data write access, pour créer ou supprimer des tables, modifier la politique de rétention, ingérer des données et effectuer des purges.
La modification des rôles de l’application n’est possible qu’au moyen du menu Roles -> Edit Role Members si vous ne souhaitez pas attribuer d’adresse courriel à votre application
Rôle personnalisé de connectivité

Étapes suivantes

Maintenant que vous avez créé une application Azure et que vous l’avez liée à la base de données de votre titre, suivez les étapes pour connecter l’outil de votre choix à Insights :
Dernière modification le 6 octobre 2026