Cet article explique comment inscrire une application web Power BI dans Azure Active Directory (Azure AD). Pour autoriser votre application à accéder à l’API REST Power BI, vous devez l’inscrire sur Azure Active Directory. Vous pourrez ainsi établir une identité pour votre application et spécifier des autorisations sur les ressources REST de Power BI. Pour obtenir la liste des autorisations Power BI, consultez Autorisations Power BI.

Important Avant d’inscrire une application Power BI, vous devez disposer d’un annuaire Azure Active Directory et d’un utilisateur d’organisation, ainsi que d’un compte de service Power BI.

Vous pouvez inscrire votre application web de deux façons différentes : avec l’outil d’inscription d’application Power BI ou sur le portail de gestion Azure. L’outil d’inscription d’application Power BI est l’option la plus simple, car il n’y a que quelques champs à renseigner. Si vous souhaitez apporter des modifications à votre application, vous pouvez le faire via le portail de gestion Azure.

Inscription d’une application web avec l’outil d’inscription d’application Power BI

Vous devez inscrire votre application cliente dans Azure Active Directory pour établir une identité pour votre application et spécifier des autorisations sur les ressources REST de Power BI. Quand vous inscrivez une application web, vous recevez un ID client et une clé secrète client. L’ ID client permet à l’application de s’identifier auprès des utilisateurs auxquels elle demande des autorisations. La clé secrète client est utilisée par l’application web pour s’identifier de façon sécurisée sur le service Power BI.

Voici comment inscrire votre application web auprès de l’ outil d’inscription d’application de Power BI:

  1. Accédez à dev.powerbi.com/apps.
  2. Dans l’ outil d’inscription d’application de Power BI, suivez les quatre étapes suivantes :

Étape 1 - Choisissez Se connecter pour vous connecter à votre compte Azure AD. Votre nom s’affiche dans la ligne de bienvenue.

Étape 2 – Entrez les informations relatives à votre application.

  • Nom de l’application :nom de votre application.
  • Type d’application :choisissez Application native.
  • URI de redirection :pour une application web, un URI de redirection fournit à AAD des détails supplémentaires sur l’application qu’il doit authentifier. Un URI de redirection ressemble à ceci : http://localhost/redirect.
  • Page d’accueil: page d’accueil ou de connexion de votre application web.

Étape 3 – Choisissez les API auxquelles accéder. Pour plus d’informations sur les autorisations d’accès Power BI, consultez Autorisations Power BI.

Étape 4 - Pour inscrire votre application, cliquez sur Inscrire l’application. Une fois l’application inscrite dans Azure AD, vous obtenez un ID client et une Clé secrète client. Veillez à copier l’ID client et la clé secrète client. Vous pouvez obtenir l’ID client ou la clé secrète client plus tard dans le portail de gestion Azure. Voir Obtenir un ID client via le portail de gestion Azure et Comment obtenir une clé secrète du client.

Vous pouvez maintenant utiliser vos ID client et clé secrète client pour votre application. La section suivante montre comment inscrire une application web avec le portail de gestion Azure.

Inscrire une application web via le portail de gestion Azure

Quand vous inscrivez une application web, vous recevez un ID client et une clésecrète client. L’ID client permet à l’application de s’identifier auprès des utilisateurs auxquels elle demande des autorisations. La clé secrète client est utilisée par l’application web pour s’identifier en toute sécurité auprès du service Power BI.

Pour savoir comment authentifier une application web à l’aide d’un ID client et d’une clé secrète du client Azure Active Directory, voir Authentifier une application web.

Voici comment inscrire une application cliente :

  1. Acceptez les conditions d’utilisation de l’API Microsoft Power BI.
  2. Connectez-vous à votre abonnement Microsoft Azure à l’adresse https://manage.windowsazure.com.
  3. Dans le panneau de service de gauche, sélectionnez ACTIVE DIRECTORY.
  4. Cliquez sur un répertoire Active Directory quelconque.

  5. Cliquez sur APPLICATIONS.

  6. Cliquez sur AJOUTER.

  7. Dans Parlez-nous de votre application, entrez un NOM, choisissez le type APPLICATION WEB ET/OU API WEB, puis cliquez sur l’icône Suivant.

  8. Dans Propriétés de l’application, entrez une URL DE CONNEXION et un URI D’ID D’APPLICATION. L’URL DE CONNEXION est l’URL de votre application, par exemple, https://localhost:44307. L’URI D’ID D’APPLICATION est l’URI de votre client Azure suivi du nom de votre application. Par exemple, https://votreclient.onmicrosoft.com/YourWebApp.

  9. Cliquez sur l’icône Terminé.

  10. Dans la page de l’application, choisissez CONFIGURER. La page CONFIGURER comporte un ID client et une clé pour votre application.

    Étape 10

  11. Pour une application web, vous avez besoin d’une clésecrète client. Dans la section clés, sélectionnez une durée. La clé s’affiche une fois enregistrée. Veillez à en effectuer une copie, car elle ne sera plus disponible sur la page de configuration lors d’un accès ultérieur.

  12. Dans la page CONFIGURATION, cliquez sur Ajouter une application.

  13. Dans Autorisations pour d’autres applications, sélectionnez Service Power BI.

    Important Si Service Power BI ne figure pas dans la liste Autorisations pour d’autres applications, vous devez vous inscrire au Service Power BI. Pour cela, vous devez disposer d’au moins un utilisateur d’organisation dans votre client Azure Active Directory (AAD). Si vous n’avez pas de locataire Azure Active Directory (AAD), consultez Créer un locataire Azure Active Directory pour créer un locataire Azure AD et un utilisateur d’organisation dans votre locataire Azure AD.

  14. Cliquez sur l’icône Terminer dans l’angle inférieur droit de la page.

  15. Dans le groupe Autorisations pour d’autres applications, déroulez la liste
    Autorisations déléguées, puis choisissez les opérations que votre application est autorisée à appeler. Pour plus d’informations sur les autorisations Power BI, voir Autorisations Power BI.

  16. Cliquez sur Enregistrer.

    ** Important ** Pour une application web, vous avez besoin d’une clé secrète client. La clé secrète client s’affichera une fois que vous aurez cliqué sur Enregistrer. Veillez à en effectuer une copie, car elle ne sera plus disponible sur la page de configuration lors d’un accès ultérieur.

Obtention d’un ID d’application cliente

Quand vous inscrivez une application web, vous recevez un ID client. L’ID client permet à l’application de s’identifier auprès des utilisateurs auxquels elle demande des autorisations.

Voici comment obtenir un ID d’application cliente :

  1. Connectez-vous à votre abonnement Microsoft Azure à l’adresse https://manage.windowsazure.com.
  2. Dans le panneau de service de gauche, sélectionnez ACTIVE DIRECTORY.
  3. Sélectionnez un répertoire Active Directory quelconque.
  4. Cliquez sur APPLICATIONS.
  5. Sélectionnez une application.
  6. Dans la page de l’application, choisissez CONFIGURER.
  7. Dans la page CONFIGURER, copiez l’ ID CLIENT.

    étape 1.3

Obtention d’une clé secrète client

Pour une application web, vous avez besoin d’une clésecrète client. Lorsque vous inscrivez une application web, Azure AD génère une clé (voir l’étape 11 ci-dessus). Dans la section clés, sélectionnez une durée. La clé s’affiche une fois enregistrée. Veillez à en effectuer une copie, car elle ne sera plus disponible sur la page de configuration lors d’un accès ultérieur.

Voir aussi

Autorisations Power BI
Locataire Azure Active Directory et un utilisateur d’organisation
Compte de service Power BI
Authentifier une application web
Vue d’ensemble de l’API REST Power BI
D’autres questions ? Posez vos questions à la communauté Power BI