Inscrire une application Azure AD pour incorporer du contenu Power BIRegister an Azure AD app to embed Power BI content

Découvrez comment inscrire une application dans Azure Active Directory (Azure AD) afin de l’utiliser avec l’incorporation de contenu Power BI.Learn how to register an application within Azure Active Directory (Azure AD) for use with embedding Power BI content.

Vous devez inscrire votre application auprès d’Azure AD afin de l’autoriser à accéder aux API REST Power BI.You register your application with Azure AD to allow your application access to the Power BI REST APIs. Vous pourrez ainsi établir une identité pour votre application et spécifier des autorisations sur les ressources REST de Power BI.This will allow you to establish an identity for your application and specify permissions to Power BI REST resources.

Important

Pour pouvoir inscrire une application Power BI, vous devez disposer d’un locataire Azure Active Directory et d’un utilisateur d’organisation.Before you register a Power BI app you need an Azure Active Directory tenant and an organizational user. Si vous n’êtes pas encore inscrit à Power BI avec un utilisateur de votre locataire, l’inscription de l’application échoue.If you haven't signed up for Power BI with a user in your tenant, the app registration will not complete successfully.

Vous pouvez inscrire votre application de deux façons.There are two ways to register your application. Vous pouvez vous servir de l’outil d’inscription d’application Power BI ou y accéder directement à partir du portail Azure.The first is with the Power BI App Registration Tool or you can do it directly within the Azure portal. L’outil d’inscription d’application Power BI est l’option la plus simple, car il n’y a que quelques champs à renseigner.The Power BI App Registration Tool is the easiest option since there are just a few fields to fill in. Si vous souhaitez apporter des modifications à votre application, utilisez le portail Azure.If you want to make changes to your app, use the Azure portal.

Inscrire une application avec l’outil d’inscription d’application BI PowerRegister with the Power BI App Registration Tool

Vous devez inscrire votre application dans Azure Active Directory afin d’établir une identité pour votre application et spécifier des autorisations sur les ressources REST de Power BI.You need to register your application in Azure Active Directory to establish an identity for your application and specify permissions to Power BI REST resources. Lorsque vous inscrivez une application, par exemple une application console ou un site web, vous recevez un identificateur que l’application utilise pour s’identifier auprès des utilisateurs auxquels elle demande des autorisations.When you register an application, such as a console app or a web site, you receive an identifier which is used by the application to identify themselves to the users that they are requesting permissions from.

Voici comment inscrire votre application avec l’outil d’inscription d’application Power BI :Here's how to register your application with the Power BI App Registration Tool:

  1. Accédez à dev.powerbi.com/apps.Go to dev.powerbi.com/apps.
  2. Sélectionnez Connectez-vous avec votre compte existant.Select Sign in with your existing account.
  3. Fournissez le Nom de l’application.Provide an App Name.
  4. La sélection du type d’application dépend du type d’application que vous utilisez.The App type selection will depend on the type of application you are using.

    • Optez pour le type Application web côté serveur pour les applications ou les API web.Use Server-side Web app for web apps or web APIs.
    • Optez pour le type Application native pour les applications qui s’exécutent sur des appareils clients.Use Native app for apps that run on client devices. Choisissez également *Application native si vous incorporez du contenu pour vos clients, quelle que soit l’application réelle. Même pour les applications web.You will also choose Native app if you are embedding content for your customers regardless of what the actual application is. Even for web applications.***
  5. Spécifiez l’URL de redirection et l’URL de la page d’accueil.Enter a value for Redirect URL and Home Page URL. Toute URL valide fonctionne.Any valid URL will work.

    L’URL de la page d’accueil est disponible uniquement si vous choisissez le type d’application Application web côté serveur.Home Page URL is only available if you choose Server-side Web app for the applciation type.

    Pour les exemples Incorporation pour vos clients et integrate-dashboard-web-app, l’URL de redirection est http://localhost:13526/redirect.For the embedding for your customers and integrate-dashboard-web-app samples, the redirect URL will be http://localhost:13526/redirect. Pour les exemples relatifs au rapport et à la vignette, l’URL de redirection est http://localhost:13526/.For the report and tile sample, the redirect URL will be http://localhost:13526/.

  6. Choisissez les API auxquelles cette application a accès.Choose the APIs that this application will have access to. Pour plus d’informations sur les autorisations d’accès Power BI, consultez Autorisations Power BI.For more information about Power BI access permissions, see Power BI Permissions.

  7. Sélectionnez Inscrire l’application.Select Register App.

    Vous recevez alors un ID client.You will then be provided with a Client ID. Si vous avez sélectionné le type Application web côté serveur, vous recevez également une clé secrète client.If you selected Server-side Web app, you will also receive a Client Secret. Le cas échéant, vous pourrez récupérer l’ID client sur le portail Azure ultérieurement.The Client ID can be retrieved from the Azure portal, at a later time, if needed. Si vous perdez le Secret du client, vous devez en créer un autre dans le portail Azure.If you lose the Client Secret, you will need to create a new one within the Azure portal.

Vous pouvez à présent utiliser l’application inscrite au sein de votre application personnalisée pour interagir avec le service Power BI.You can now use the registered application as part of your custom application to interact with the Power BI service.

Important

Si vous incorporez du contenu s’adressant à vos clients, vous devez configurer des autorisations supplémentaires dans le portail Azure.If you are embedding content for your customers, you will need to configure additional permissions within the Azure portal. Pour en savoir plus, consultez Appliquer des autorisations à votre application.For more information, see Apply permissions to your application.

Inscrire une application par le biais du portail AzureRegister with the Azure portal

L’autre option pour l’inscription de votre application consiste à accéder directement au portail Azure.Your other option for registering your application is to do so directly in the Azure portal. Pour inscrire votre application, procédez comme suit.To register your application, follow these steps.

  1. Acceptez les conditions d’utilisation de l’API Microsoft Power BI.Accept the Microsoft Power BI API Terms.
  2. Connectez-vous au portail Azure.Sign into the Azure portal.
  3. Choisissez votre locataire Azure AD en sélectionnant votre compte dans l’angle supérieur droit de la page.Choose your Azure AD tenant by selecting your account in the top right corner of the page.
  4. Dans le volet de navigation gauche, choisissez Autres services, sélectionnez Inscriptions des applications sous Sécurité + Identité, puis Nouvelle inscription d’application.In the left-hand navigation pane, choose More Services, select App Registrations under Security + Identity and select New application registration.

  5. Suivez les invites pour créer une application.Follow the prompts and create a new application.

    • Pour des applications web, spécifiez l’URL de connexion, qui est l’URL de base de votre application, où les utilisateurs peuvent se connecter. Par exemple : http://localhost:13526.For Web Applications, provide the Sign-On URL, which is the base URL of your app, where users can sign in e.g http://localhost:13526.
    • Pour des applications natives, spécifiez un URI de redirection qu’Azure AD utilise pour retourner des réponses de jeton.For Native Applications, provide a Redirect URI, which Azure AD uses to return token responses. Entrez une valeur spécifique de votre application. Par exemple : http://myapplication/redirectEnter a value specific to your application, .e.g http://myapplication/redirect

Pour plus d’informations sur la façon d’inscrire des applications dans Azure Active Directory, consultez Intégration d’applications dans Azure Active Directory.For more information about how to register applications in Azure Active Directory, see Integrating applications with Azure Active Directory

Comment obtenir l’ID clientHow to get the client id

Lorsque vous inscrivez une application, vous recevez un ID client.When you register an application, you receive a Client ID. L’ID client permet à l’application de s’identifier auprès des utilisateurs auxquels elle demande des autorisations.The Client ID is used by the application to identify themselves to the users that they are requesting permissions from.

Voici comment obtenir un ID client :Here's how to get a client id:

  1. Connectez-vous au portail Azure.Sign into the Azure portal.
  2. Choisissez votre locataire Azure AD en sélectionnant votre compte dans l’angle supérieur droit de la page.Choose your Azure AD tenant by selecting your account in the top right corner of the page.
  3. Dans le volet de navigation gauche, choisissez Autres services, puis sélectionnez Inscriptions des applications.In the left-hand navigation pane, choose More Services and select App Registrations.
  4. Sélectionnez l’application dont vous souhaitez récupérer l’ID client.Select the application that you want to retrieve the client id for.
  5. Vous pouvez voir un ID d’application répertorié en tant que GUID.You will see Application ID listed as a GUID. Il s’agit de l’ID client pour l’application.This is the client id for the application.

    ID client répertorié en tant qu’ID d’application lors de l’inscription d’application

Appliquer des autorisations à votre application dans Azure ADApply permissions to your application within Azure AD

Important

Cette section s’applique uniquement aux applications qui incorporent du contenu s’adressant à votre organisation.This section only applies to applications that are embedding content for your organization.

Vous devez activer des autorisations supplémentaires pour votre application en plus de ce que vous avez fourni dans la page d’inscription de l’application.You will need to enable additional permissions to your application in addition to what was provided in app registration page. Cela est possible via le portail Azure AD, ou par programme.You can accomplish this through the Azure AD portal, or programmatically.

Vous devez être connecté en utilisant un compte principal pour l’incorporation, ou un compte Administrateur global.You will want to be logged in with either the master account, used for embedding, or a Global admin account.

Utilisation du portail Azure ADUsing the Azure AD portal

  1. Accédez à Inscriptions des applications dans le portail Azure, puis sélectionnez l’application que vous utilisez pour l’incorporation.Browse to App registrations within the Azure portal and select the app that you are using for embedding.

  2. Sous Accès aux API, sélectionnez Autorisations requises.Select Required permissions under API Access.

  3. Sélectionnez Windows Azure Active Directory puis vérifiez que l’option Accéder au répertoire en tant qu’utilisateur actuellement connecté est sélectionnée.Select Windows Azure Active Directory and then make sure Access the directory as the signed-in user is selected. Sélectionnez Enregistrer.Select Save.

  4. Dans Autorisations requises, sélectionnez Service Power BI (Power BI).Within Required permissions, select Power BI Service (Power BI).

    Note

    Si vous avez créé l’application dans le portail Azure AD, le service Power BI (Power BI) peut ne pas être présent.If you created the app directly in the Azure AD portal, Power BI Service (Power BI) may not be present. Dans ce cas, sélectionnez + Ajouter, puis 1 Sélectionner une API.If it is not, select + Add and then 1 Select and API. Choisissez Service Power BI dans la liste des API, puis Sélectionner.Select Power BI Service in the API list and select Select. Si Service Power BI (Power BI) n’est pas disponible dans + Ajouter, inscrivez-vous à Power BI avec au moins un utilisateur.If Power BI Service (Power BI) is not available within + Add, sign up for Power BI with at least one user.

  5. Sous Autorisations déléguées, sélectionnez toutes les autorisations.Select all permissions under Delegated Permissions. Vous devez les sélectionner une par une afin d’enregistrer les sélections.You will need to select them one by one in order to save the selections. Lorsque vous avez terminé, sélectionnez Enregistrer.Select Save when done.

  6. Dans Autorisations requises, sélectionnez Accorder des autorisations.Within Required permissions, select Grant Permissions.

    L’action Accorder des autorisations est nécessaire pour éviter qu’Azure AD exige une confirmation du compte principal.The Grant Permissions action is needed for the master account to avoid being prompted for consent by Azure AD. Si le compte qui effectue cette action est celui d’un administrateur global, vous pouvez accorder des autorisations pour tous les utilisateurs de votre organisation pour cette application.If the account performing this action is a Global Admin, you will grant permissions to all users within your organization for this application. Si le compte qui effectue cette action est le compte principal et pas celui d’un administrateur global, vous pouvez uniquement accorder des autorisations au compte principal pour cette application.If the account performing this action is the master account and is not a Global Admin, you will grant permissions only to the master account for this application.

    Accorder des autorisations dans la boîte de dialogue Autorisations requises

Application d’autorisations par programmationApplying permissions programmatically

  1. Vous devez obtenir les principaux du service (utilisateurs) existants au sein de votre client.You will need to get the existing service principals (users) within your tenant. Pour plus d’informations sur la procédure à suivre, voir Get servicePrincipal.For information on how to do that, see Get servicePrincipal.

    Vous pouvez appeler l’API Get servicePrincipal sans {id}. Elle obtiendra tous les principaux du service au sein du client.You can call the Get servicePrincipal api without {id} and it will get you all of the service principals within the tenant.

  2. Recherchez un principal du service en utilisant votre id client d’application en tant que propriété appId.Check for a service principal with you app client id as appId property.
  3. Créez un plan de service s’il n’y en a pas pour votre application.Create a new service plan if missing for your app.

    Post https://graph.microsoft.com/beta/servicePrincipals
    Authorization: Bearer ey..qw
    Content-Type: application/json
    {
    "accountEnabled" : true,
    "appId" : "{App_Client_ID}",
    "displayName" : "{App_DisplayName}"
    }
    
  4. Accorder l’autorisation d’application à l’API Power BIGrant App Permission to PowerBI API

    Post https://graph.microsoft.com/beta/OAuth2PermissionGrants
    Authorization: Bearer ey..qw
    Content-Type: application/json
    { 
    "clientId":"{Service_Plan_ID}",
    "consentType":"AllPrincipals",
    "resourceId":"c78b2585-1df6-41de-95f7-dc5aeb7dc98e",
    "scope":"Dataset.ReadWrite.All Dashboard.Read.All Report.Read.All Group.Read Group.Read.All Content.Create Metadata.View_Any Dataset.Read.All Data.Alter_Any",
    "expiryTime":"2018-03-29T14:35:32.4943409+03:00",
    "startTime":"2017-03-29T14:35:32.4933413+03:00"
    }
    
  5. Accorder l’autorisation d’application à AADGrant App Permission to AAD

    La valeur de consentType dépend de l’utilisateur effectuant la demande.The value for consentType will depend on the user performing the request. Vous pouvez fournir la valeur AllPrincipals ou Principal.You can supply either AllPrincipals or Principal. La valeur AllPrincipals peut uniquement être utilisée par un administrateur pour accorder l’autorisation à tous les utilisateurs.AllPrincipals can only be used by an administrator to grant permission to all users. La valeur Principal est utilisée pour accorder une autorisation à un utilisateur spécifique.Principal is used to grant permission to a specific user.

    L’octroi d’autorisation est nécessaire pour éviter qu’Azure AD exige une confirmation du compte principal.The permission grant is needed for the master account to avoid being prompted for consent by Azure AD.

    Si vous utilisez un locataire existant et ne souhaitez pas accorder d’autorisations au nom de tous les utilisateurs de ce locataire, vous pouvez accorder des autorisations à un utilisateur spécifique en remplaçant la valeur de contentType par Principal.If you are using an existing tenant, and not interested in granting permissions on behalf of all tenant users, you can grant permissions to a specific user by replacing the value of contentType to Principal.

    Post https://graph.microsoft.com/beta/OAuth2PermissionGrants
    Authorization: Bearer ey..qw
    Content-Type: application/json
    { 
    "clientId":"{Service_Plan_ID}",
    "consentType":"AllPrincipals",
    "resourceId":"61e57743-d5cf-41ba-bd1a-2b381390a3f1",
    "scope":"User.Read Directory.AccessAsUser.All",
    "expiryTime":"2018-03-29T14:35:32.4943409+03:00",
    "startTime":"2017-03-29T14:35:32.4933413+03:00"
    }
    

Étapes suivantesNext steps

Maintenant que vous avez enregistré votre application dans Azure AD, vous devez authentifier les utilisateurs dans votre application.Now that you have registered your application within Azure AD, you will need to authenticate users within your application. Pour plus d’informations, consultez Authentifier des utilisateurs et obtenir un jeton d’accès Azure AD pour votre application Power BI.Have a look at Authenticate users and get an Azure AD access token for your Power BI app to learn more.

D’autres questions ?More questions? Essayez d’interroger la communauté Power BITry asking the Power BI Community