Een Azure AD-toepassing registeren om bij Power BI te gebruiken

In deze stappen wordt beschreven hoe u een Azure AD-toepassing registreert voor de Power BI-oplossing Insluiten voor uw klanten.

1. Open het registratiehulpprogramma voor Power BI-apps.

2. Selecteer Insluiten voor uw klanten in het gedeelte Een insluitoplossing kiezen.

3. In Stap 1: aanmelden bij Power BI meld u zich aan met een gebruiker die deel uitmaakt van uw Power BI-tenant. De Azure AD-app wordt geregistreerd onder deze gebruiker.

   Als u al bent aangemeld, controleert u of u bent aangemeld met de gebruiker die u wilt gebruiken voor het maken van de Azure AD-app. Als u een gebruiker wilt wijzigen, selecteert u de koppeling Afmelden en meldt u zich opnieuw aan nadat het hulpprogramma opnieuw is opgestart.

4. In Stap 2 - uw toepassing registreren vult u de volgende velden in:

   • Toepassingsnaam: geef uw toepassing een naam.

   • API-toegang: selecteer de Power BI-API's (ook wel scopes genoemd) die uw toepassing nodig heeft. U kunt Alles selecteren gebruiken om alle API's te selecteren. Zie Machtigingen en toestemming in het eindpunt van Microsoft identity platform voor meer informatie over machtigingen voor Power BI-toegang.

5. Selecteer Registreren.

   De toepassings-id van uw Azure AD-app wordt weergegeven in het vak Samenvatting. Kopieer deze waarde voor later gebruik.

6. (Optioneel) In Stap 3: een werkruimte maken kunt u een werkruimte in de Power BI-service maken.

   • Als u al een Power BI-werkruimte hebt, selecteert u Overslaan.

   • Als u een werkruimte wilt maken, voert u een naam in voor uw werkruimte en selecteert u Werkruimte maken. De naam en id van uw werkruimte worden weergegeven in het vak Samenvatting. Kopieer deze waarden voor later gebruik.

   Notitie

   U moet een werkruimte maken met het hulpprogramma, als u wilt dat de voorbeeld-app voor ingesloten analyse werkt zoals verwacht.

7. (Optioneel) In Stap 4: inhoud importeren selecteert u een van de volgende opties:

   • Als u uw eigen Power BI-app hebt, kunt u Overslaan selecteren.

   • Als u een Power BI-voorbeeld-app wilt maken met behulp van een voorbeeldrapport, selecteert u Power BI-voorbeeldrapport en selecteert u daarna Importeren.

   • Als u een Power BI-voorbeeld-app wilt maken met behulp van uw eigen rapport, selecteert u Een PBIX-bestand uploaden, bladert u naar uw bestand en selecteert u daarna Importeren.

8. In Stap 5 - machtigingen verlenen selecteert u Machtigingen verlenen en selecteert u Accepteren in het pop-upvenster. Hierdoor kan uw Azure AD-app toegang krijgen tot de API's die u hebt geselecteerd (ook bekend als scopes) met uw aangemelde gebruiker. Deze gebruiker wordt ook wel de hoofdgebruiker genoemd.

9. (Optioneel) Als u een Power BI-werkruimte hebt gemaakt en inhoud erin hebt geüpload met het hulpprogramma, kunt u nu Voorbeeldtoepassing downloaden selecteren. Zorg ervoor dat u alle gegevens in het vak Samenvatting kopieert.

In deze stappen wordt beschreven hoe u een Azure AD-toepassing registreert voor de Power BI-oplossing Insluiten voor uw organisatie.

1. Open het registratiehulpprogramma voor Power BI-apps.

2. Selecteer Insluiten voor uw organisatie in het gedeelte Een insluitoplossing kiezen.

3. In Stap 1: aanmelden bij Power BI meld u zich aan met een gebruiker die deel uitmaakt van uw Power BI-tenant. De Azure AD-app wordt geregistreerd onder deze gebruiker.

   Als u al bent aangemeld, controleert u of u bent aangemeld met de gebruiker die u wilt gebruiken voor het maken van de Azure AD-app. Als u een gebruiker wilt wijzigen, selecteert u de koppeling Afmelden en meldt u zich opnieuw aan nadat het hulpprogramma opnieuw is opgestart.

4. In Stap 2 - uw toepassing registreren vult u de volgende velden in:

   • Toepassingsnaam: geef uw toepassing een naam.

   • URL van startpagina: voer een URL in voor de startpagina.

   • Omleidings-URL: wanneer u zich aanmeldt, worden uw toepassingsgebruikers omgeleid naar dit adres terwijl uw toepassing een verificatiecode van Azure ontvangt. Selecteer een van deze opties:

     • Een standaard-URL gebruiken: met deze optie wordt automatisch een voorbeeldtoepassing voor ingesloten analyse gemaakt en gedownload. De standaard-URL is http://localhost:13526/.

     • Een aangepaste URL gebruiken: selecteer deze optie als u al een toepassing voor ingesloten analyse hebt en u al weet wat u wilt gebruiken als omleidings-URL.

   • API-toegang: selecteer de Power BI-API's (ook wel scopes genoemd) die uw toepassing nodig heeft. U kunt Alles selecteren gebruiken om alle API's te selecteren. Zie Machtigingen en toestemming in het eindpunt van Microsoft identity platform voor meer informatie over machtigingen voor Power BI-toegang.

5. Selecteer Registreren.

   De waarden toepassings-id en toepassingsgeheim van uw Azure AD-app worden weergegeven in het vak Samenvatting. Kopieer deze waarden voor later gebruik.

6. (Optioneel) In Stap 3: een werkruimte maken kunt u een werkruimte in de Power BI-service maken.

   • Als u al een Power BI-werkruimte hebt, selecteert u Overslaan.

   • Als u een werkruimte wilt maken, voert u een naam in voor uw werkruimte en selecteert u Werkruimte maken. De naam en id van uw werkruimte worden weergegeven in het vak Samenvatting. Kopieer deze waarden voor later gebruik.

   Notitie

   U moet een werkruimte maken met het hulpprogramma, als u wilt dat de voorbeeld-app voor ingesloten analyse werkt zoals verwacht.

7. (Optioneel) In Stap 4: inhoud importeren selecteert u een van de volgende opties:

   • Als u uw eigen Power BI-app hebt, kunt u Overslaan selecteren.

   • Als u een Power BI-voorbeeld-app wilt maken met behulp van een voorbeeldrapport, selecteert u Power BI-voorbeeldrapport en selecteert u daarna Importeren.

   • Als u een Power BI-voorbeeld-app wilt maken met behulp van uw eigen rapport, selecteert u Een PBIX-bestand uploaden, bladert u naar uw bestand en selecteert u daarna Importeren.

8. (Optioneel) Als u een Power BI-werkruimte hebt gemaakt en inhoud erin hebt geüpload met het hulpprogramma, kunt u nu Voorbeeldtoepassing downloaden selecteren. Zorg ervoor dat u alle gegevens in het vak Samenvatting kopieert.

Gebruik de handmatige app-registratie van Microsoft Azure Active Directory alleen als u een van de volgende oplossingen maakt:

• Een insluiting voor de app van uw organisatie.

• Een insluiting voor de app van uw klanten met een service-principal.

  Notitie

  Als u deze optie kiest, moet u hiervoor na het registreren van uw Microsoft Azure Active Directory-app Power BI-machtigingen toevoegen.

Zie Een app registreren bij Azure Active Directory voor meer informatie over het registreren van toepassingen in Azure Active Directory.

1. Meld u aan bij Azure Portal.

2. Selecteer uw Azure AD-tenant door uw account te selecteren in de rechterbovenhoek van de pagina.

3. Selecteer App-registraties. Als deze optie niet wordt weergegeven, zoekt u deze op.

4. Selecteer in App-registraties Nieuwe registratie.

5. Vul de volgende velden in:

   • Naam: geef uw toepassing een naam.

   • Ondersteund accounttype: selecteer wie de toepassing kan gebruiken.

6. (Optioneel) Voeg in de omleidings-URI een omleidings-URL toe.

7. Selecteer Registreren. Nadat u uw app hebt geregistreerd, wordt u naar de overzichtspagina van uw app geleid, waar u de toepassings-id kunt verkrijgen.

In Azure Portal kunt u uw app bekijken en wijzigingen aanbrengen in de machtigingen ervoor.

1. Meld u aan bij Azure Portal.

2. Selecteer uw Azure AD-tenant door uw account te selecteren in de rechterbovenhoek van de pagina.

3. Selecteer App-registraties. Als deze optie niet wordt weergegeven, zoekt u deze op.

4. Selecteer uw app op het tabblad Toepassingen in eigendom. De toepassing wordt geopend op het tabblad Overzicht, waar u de toepassings-id kunt controleren.

5. Selecteer het tabblad API-machtigingen.

6. Voer de volgende stappen uit om machtigingen toe te voegen:

   1. Selecteer de optie Een machtiging toevoegen en selecteer vervolgens Power BI-service.

   2. Selecteer Gedelegeerde machtigingen en voeg de specifieke machtigingen toe die u nodig hebt, of verwijder deze.

   3. Wanneer u klaar bent, selecteert u Machtigingen toevoegen om uw wijzigingen op te slaan.

7. Voer de volgende stappen uit om een machtiging te verwijderen:

   1. Selecteer het beletselteken (...) aan de rechterkant van de machtiging.

   2. Selecteer Machtiging verwijderen.

   3. Selecteer Ja, verwijderen in het pop-upvenster Machtiging verwijderen.

Als u de machtigingen van uw Azure AD-app via een programma wilt wijzigen, moet u de bestaande service-principals (gebruikers) in uw Tenant ophalen. Zie servicePrincipal voor informatie over hoe u dit kunt doen.

1. Als u alle service-principals in uw tenant wilt ophalen, roept u de Get servicePrincipal-API aan zonder {ID}.

2. Zoek naar een service-principal met de toepassings-id van uw app als appId-eigenschap.

   Post https://graph.microsoft.com/v1.0/servicePrincipals HTTP/1.1
   Authorization: Bearer ey..qw
   Content-Type: application/json
   {
   "accountEnabled" : true,
   "appId" : "{App_Client_ID}",
   "displayName" : "{App_DisplayName}"
   }
   

   Notitie

   displayName is optioneel.

3. Ken Power BI machtigingen toe aan uw app door een van deze waarden toe te wijzen aan consentType:

   • AllPrincipals: kan alleen worden gebruikt door een Power BI-beheerder om namens alle gebruikers in de tenant machtigingen te verlenen.

   • Principal: wordt gebruikt om machtigingen te verlenen namens een specifieke gebruiker. Als u deze optie gebruikt, voegt u de principalId={User_ObjectId}-eigenschap toe aan de hoofdtekst van de aanvraag.

   Post https://graph.microsoft.com/v1.0/OAuth2PermissionGrants HTTP/1.1
   Authorization: Bearer ey..qw
   Content-Type: application/json
   {
   "clientId":"{Service_Plan_ID}",
   "consentType":"AllPrincipals",
   "resourceId":"c78a3685-1ce7-52cd-95f7-dc5aea8ec98e",
   "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"
   }
   

   Notitie

   • Als u een hoofdgebruiker gebruikt om te voorkomen dat u om toestemming wordt gevraagd door Azure AD, moet u machtigingen verlenen aan het hoofdaccount.
   • De resourceId c78a3685-1ce7-52cd-95f7-dc5aea8ec98e is afhankelijk van de tenant en is niet universeel. Deze waarde is de objectId van de toepassing Power BI Service in Azure AD. Als u deze waarde wilt ophalen uit Azure Portal, gaat u naar Enterprise-toepassingen > Alle toepassingen en zoekt u naar Power BI Service.

4. Ken app-machtigingen toe aan Azure AD door een waarde toe te wijzen aan consentType.

   Post https://graph.microsoft.com/v1.0/OAuth2PermissionGrants HTTP/1.1
   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"
   }
   

U kunt de machtigingen voor uw Azure AD-app ook wijzigen met C#. Zie de oAuth2PermissionGrant-API voor meer informatie. Deze methode kan nuttig zijn als u overweegt een aantal van uw processen te automatiseren.

Raadpleeg het tabblad HTTP voor meer informatie over de HTTP-aanvragen.

var graphClient = GetGraphClient();

currentState.createdApp = await graphClient.Applications
    .Request()
    .AddAsync(application);

System.Threading.Thread.Sleep(2000);

var passwordCredential = new PasswordCredential
{
    DisplayName = "Client Secret Created in C#"
};

currentState.createdSecret = await graphClient.Applications[currentState.createdApp.Id]
    .AddPassword(passwordCredential)
    .Request()
    .PostAsync();

var servicePrincipal = new ServicePrincipal
{
    AppId = currentState.createdApp.AppId
};

currentState.createdServicePrincipal = await graphClient.ServicePrincipals
    .Request()
    .AddAsync(servicePrincipal);

GraphServiceClient graphClient = new GraphServiceClient(authProvider);

// Use oAuth2PermissionGrant to change permissions
var oAuth2PermissionGrant = await graphClient.Oauth2PermissionGrants["{id}"]
               .Request()
               .GetAsync();