Configurer Power BI Embedded

S’APPLIQUE À : L’application possède des données L’utilisateur possède des données

Si vous souhaitez commencer à utiliser Power BI Embedded pour partager vos rapports avec d’autres utilisateurs, utilisez l’outil de configuration de l’analytique incorporée Power BI pour bien démarrer. Cet article vous montre comment procéder.

Pour utiliser l’analytique incorporée Power BI, vous devez inscrire une application Microsoft Entra dans Azure. L’application Microsoft Entra établit des autorisations pour les ressources REST Power BI et autorise l’accès aux API REST Power BI.

Prérequis

Pour configurer un environnement d’analytique incorporée Power BI, vous avez besoin de l’un des éléments suivants :

• Locataire Microsoft Entra et un utilisateur d’organisation (maître)
• Compte Power BI Pro

Avant de commencer

Avant de pouvoir inscrire votre application, choisissez la solution qui correspond le mieux à vos besoins parmi les options ci-dessous :

• incorporer pour les clients
• Pour votre organisation

Incorporer pour vos clients

Utilisez la solution Incorporer pour vos clients, également appelée L’application est propriétaire des données, si vous créez une application conçue pour vos clients. Les utilisateurs n’ont pas besoin de se connecter à Power BI ni de disposer d’une licence Power BI pour utiliser votre application. Votre application s’authentifie auprès de Power BI à l’aide d’un compte utilisateur maître (licence Power BI Pro utilisée pour la connexion à Power BI) ou d’un principal de service.

La solution Incorporer pour vos clients est généralement utilisée par les éditeurs de logiciels indépendants (ISV) et les développeurs qui créent des applications pour un tiers.

Incorporer pour votre organisation

Utilisez la solution Incorporer pour votre organisation, également appelée L’utilisateur propriétaire des données, si vous créez une application qui impose aux utilisateurs d’utiliser leurs informations d’identification pour s’authentifier auprès de Power BI.

La solution Incorporer pour votre organisation est généralement utilisée par les grandes entreprises et organisations et s’adresse aux utilisateurs internes.

Pour plus d’informations sur les deux solutions, consultez Quelles sont les solutions d’analytique incorporée Power BI ?.

Configurer votre environnement

Une fois que vous avez compris les deux options d’incorporation, vous pouvez utiliser l’outil de configuration pour créer votre environnement Power BI Embedded.

Si vous préférez configurer l’environnement manuellement, ignorez les étapes des sections suivantes. Procédez plutôt comme décrit dans la section Inscription manuelle de cet article.

Important

Si vous effectuez une incorporation pour un Cloud de la communauté du secteur public, suivez les instructions de la section Inscription manuelle.

Pour utiliser l’outil afin de configurer votre environnement, accédez à l’outil de configuration de l’analytique incorporée Power BI. Sélectionnez l’option d’incorporation de votre choix.

Étape 1 : se connecter à Power BI

1. Sous Étape 1 de l’outil d’installation, sélectionnez Se connecter. Cette étape vous connecte à Power BI. Si vous êtes invité à choisir un compte, connectez-vous avec un utilisateur qui fait partie de votre locataire Power BI. L’application Microsoft Entra est inscrite sous cet utilisateur.

   Remarque

   Si vous êtes déjà connecté, vérifiez que vous êtes connecté sous le nom d’utilisateur avec lequel vous souhaitez créer l’application Microsoft Entra. Pour modifier les utilisateurs, sélectionnez Se déconnecter. Une fois que l’outil a redémarré, connectez-vous avec l’utilisateur approprié.

2. Sélectionnez Suivant pour passer à l’étape suivante.

   

Étape 2 : inscrire votre application

Dans cette étape, vous inscrivez une application Microsoft Entra dans Azure. L’application Microsoft Entra établit des autorisations pour les ressources REST Power BI et autorise l’accès aux API REST Power BI. Vous pouvez toujours modifier ces paramètres ultérieurement.

Incorporer pour vos clients

1. Pour inscrire votre application pour vos clients, renseignez les champs suivants :

   • Nom de l’application – Donnez un nom à votre application.

   • Accès aux API – Sélectionnez les API Power BI (également appelées « étendues ») dont votre application a besoin. Vous pouvez utiliser Sélectionner tout pour sélectionner l’ensemble des API. Pour plus d’informations sur les autorisations d’accès de Power BI, consultez Autorisations et consentement dans le point de terminaison de la plateforme d’identités Microsoft.

2. Sélectionnez Inscrire.

3. L’ID d’application de votre application Microsoft Entra s’affiche dans la zone Résumé. Copiez cette valeur en vue d’une utilisation ultérieure.

   

Incorporer pour votre organisation

1. Pour inscrire votre application pour votre organisation, renseignez les champs suivants :

   • Nom de l’application – Donnez un nom à votre application.

   • URL de la page d’accueil – Entrez une URL pour votre page d’accueil.

   • URL de redirection : sélectionnez une option de redirection. Quand vos utilisateurs se connectent, ils sont redirigés vers cette adresse tandis que votre application reçoit un code d’authentification d’Azure. Choisissez l’une des options suivantes pour cette URL :

     • Utiliser une URL par défaut : cette option permet de créer et de télécharger automatiquement un exemple d’application d’analytique incorporée. L’URL par défaut est http://localhost:13526/.
     • Utiliser une URL personnalisée : cette option est appropriée si vous disposez déjà d’une application d’analytique incorporée et que vous connaissez l’URL à utiliser.

   • Accès aux API – Sélectionnez les API Power BI (également appelées « étendues ») dont votre application a besoin. Utilisez Sélectionner tout pour sélectionner l’ensemble des API. Pour plus d’informations sur les autorisations d’accès de Power BI, consultez Autorisations et consentement dans le point de terminaison de la plateforme d’identités Microsoft.

2. Sélectionnez Inscrire.

3. Les valeurs ID d’application et Secret de l’application de votre application Microsoft Entra sont affichées dans la zone Résumé. Copiez ces valeurs pour les utiliser ultérieurement.

Étape 3 : créer un espace de travail (facultatif)

Créez un espace de travail dans le service Power BI :

• Si vous disposez déjà d’un espace de travail Power BI, sélectionnez Ignorer.

• Pour créer un espace de travail, entrez un nom pour votre espace de travail, puis sélectionnez Créer un espace de travail. Le nom et l’ID de votre espace de travail s’affichent dans la zone Résumé. Copiez ces valeurs pour les utiliser ultérieurement.

  Conseil

  Pour que l’exemple d’application d’analytique incorporée fonctionne comme prévu, vous devez utiliser l’outil afin de créer un espace de travail.

Étape 4 : importer du contenu (facultatif)

Sélectionnez l’une des options suivantes :

• Si vous disposez de votre propre application Power BI, vous pouvez sélectionner Ignorer.

• Si vous souhaitez créer un exemple d’application Power BI à l’aide d’un exemple de rapport, sélectionnez Exemple de rapport Power BI, puis sélectionnez Importer.

• Si vous souhaitez créer un exemple d’application Power BI à l’aide de votre propre rapport, sélectionnez Charger un fichier .pbix, recherchez votre fichier, puis sélectionnez Importer.

Étape 5 : accorder des autorisations (Incorporer pour vos clients uniquement)

Sélectionnez Accorder des autorisations. Dans la boîte de dialogue, sélectionnez Accepter. Cette étape permet à votre application Microsoft Entra d’accéder aux API que vous avez sélectionnées (également appelées « étendues ») avec l’utilisateur connecté. Cet utilisateur est aussi appelé utilisateur maître.

Télécharger l’exemple d’application (facultatif)

Si vous avez créé un espace de travail Power BI et que vous y avez chargé du contenu à l’aide de cet outil, vous pouvez maintenant sélectionner Télécharger l’exemple d’application.

Notes

Si vous avez ignoré les étapes facultatives, vous pouvez toujours télécharger un exemple d’application Power BI. Cependant, les propriétés renseignées pendant l’inscription manquent dans le code de l’application téléchargée. Par exemple, si vous n’avez pas créé d’espace de travail, l’exemple d’application ne comporte pas l’ID d’espace de travail.

Veillez à copier toutes les informations contenues dans la zone Résumé. Votre environnement d’incorporation Power BI est prêt à l’emploi.

Inscription manuelle

Si vous n’avez pas utilisé l’outil de configuration de l’analytique incorporée Power BI, procédez comme suit pour inscrire manuellement une application Microsoft Entra. Toutefois, effectuez ces étapes uniquement si vous créez l’une des solutions suivantes :

• Une application Incorporer pour votre organisation
• Une application Incorporer pour vos clients avec un principal de service

Pour plus d’informations sur l’inscription des applications dans Microsoft Entra ID, consultez Inscrire une application auprès de la plateforme d’identités Microsoft.

1. Connectez-vous au portail Azure.

2. Sélectionnez votre locataire Microsoft Entra en sélectionnant votre compte dans l’angle supérieur droit de la page.

3. Sélectionnez Inscriptions d’applications. Si vous ne voyez pas cette option, recherchez-la.

4. Dans Inscriptions d’applications, sélectionnez Nouvelle inscription.

5. Remplissez les champs suivants :

   • Nom – Donnez un nom à votre application.

   • Type de compte pris en charge – Sélectionnez qui peut utiliser l’application.

6. (Facultatif) Dans la zone URI de redirection, ajoutez une URL de redirection.

7. Sélectionnez Inscription. Une fois votre application inscrite, vous êtes dirigé vers la page Vue d’ensemble de votre application, où vous pouvez obtenir l’ID d’application.

Contenu connexe

D’autres questions ? Essayez d’interroger la communauté Power BI