Zelfstudie: Power BI-inhoud insluiten met behulp van een voorbeeld insluiten voor de toepassing van uw klanten

VAN TOEPASSING OP: App is eigenaar van gegevens die gebruiker eigenaar is van gegevens

Met ingesloten analyses en Power BI Embedded (de Azure-aanbieding) kunt u Power BI-inhoud, zoals rapporten, dashboards en tegels, insluiten in uw toepassing.

In deze zelfstudie leert u het volgende:

  • Stel uw ingesloten omgeving in.
  • Configureer een insluiting voor uw klanten (ook wel bekend als app is eigenaar van gegevens) voorbeeldtoepassing.

Als u uw toepassing wilt gebruiken, hoeven uw gebruikers zich niet aan te melden bij Power BI of een Power BI-licentie te hebben.

We raden u aan de insluitingsmethode voor uw klanten te gebruiken om uw Power BI-inhoud in te sluiten als u een onafhankelijke softwareleverancier (ISV) of een ontwikkelaar bent die toepassingen voor derden wil maken.

Belangrijk

Als u inhoud insluit voor een nationale/regionale cloud, zijn de eerste stappen van deze zelfstudie anders. Zie Inhoud insluiten voor nationale/regionale clouds voor meer informatie.

Specificaties voor codevoorbeelden

Deze zelfstudie bevat instructies voor het configureren van een insluiting voor de voorbeeldtoepassing van uw klanten in een van de volgende frameworks:

  • .NET Framework
  • .NET Core
  • Java
  • Node JS
  • Python

De codevoorbeelden ondersteunen de volgende browsers:

  • Microsoft Edge
  • Google Chrome
  • Mozilla Firefox

Vereisten

Voordat u aan deze zelfstudie begint, controleert u of u zowel de Power BI- als codeafhankelijkheden hebt die hieronder worden vermeld:

  • Power BI-afhankelijkheden

    • Uw eigen Microsoft Entra-tenant.

    • Als u uw app wilt verifiëren voor Power BI, hebt u een van de volgende zaken nodig:

      • Service-principal: een Microsoft Entra-service-principal-object waarmee Microsoft Entra-id uw app kan verifiëren.

      • Power BI Pro-licentie : dit is uw hoofdgebruiker en uw app gebruikt deze om te verifiëren bij Power BI.

      • Een PPU-licentie (Power BI Premium Per User): dit is uw hoofdgebruiker en uw app gebruikt deze om te verifiëren bij Power BI.

      Notitie

      Als u naar productie wilt gaan, hebt u een capaciteit nodig.

  • Codeafhankelijkheden

Wijze

Voer de volgende stappen uit om een insluiting te maken voor de voorbeeld-app van uw klanten :

  1. Selecteer uw verificatiemethode.

  2. Registreer een Microsoft Entra-toepassing.

  3. Maak een Power BI-werkruimte.

  4. Een Power BI-rapport maken en publiceren.

  5. Haal de parameterwaarden voor insluiten op.

  6. Api-toegang tot service-principal

  7. Werkruimtetoegang inschakelen.

  8. Uw inhoud insluiten.

Stap 1: selecteer uw verificatiemethode

Uw ingesloten oplossing is afhankelijk van de verificatiemethode die u selecteert. Daarom is het belangrijk om inzicht te hebben in de verschillen tussen de verificatiemethoden en te bepalen welke methode het beste bij uw oplossing past.

In de onderstaande tabel worden enkele belangrijke verschillen beschreven tussen de verificatiemethoden van de service-principal en de hoofdgebruiker .

Overweging Service-principal Hoofdgebruiker
Mechanisme Met het service-principal-object van uw Microsoft Entra-app kan Microsoft Entra ID uw ingesloten oplossings-app verifiëren bij Power BI. Uw Microsoft Entra-app gebruikt de referenties (gebruikersnaam en wachtwoord) van een Power BI-gebruiker om te verifiëren bij Power BI.
Beveiliging Service-principal is de door Microsoft Entra ID aanbevolen autorisatiemethode. Als u een service-principal gebruikt, kunt u zich verifiëren met behulp van een toepassingsgeheim of een certificaat.

In deze zelfstudie wordt alleen beschreven hoe u een service-principal gebruikt met een toepassingsgeheim. Als u een service-principal en een certificaat wilt insluiten, raadpleegt u de service-principal met een certificaatartikel .
Deze verificatiemethode is niet zo veilig als een service-principal. U moet voorzichtig zijn met de referenties van de hoofdgebruiker (gebruikersnaam en wachtwoord). Stel ze niet beschikbaar in uw insluitingstoepassing en wijzig het wachtwoord regelmatig.
Gedelegeerde machtigingen voor Microsoft Entra-id Niet vereist. Uw hoofdgebruiker of beheerder moet toestemming verlenen voor uw app om toegang te krijgen tot Power BI REST API-machtigingen (ook wel bereiken genoemd). Bijvoorbeeld Report.ReadWrite.All.
Power BI-service toegang U hebt geen toegang tot Power BI-service met een service-principal. U hebt toegang tot Power BI-service met de referenties van uw hoofdgebruiker.
Licentie Hiervoor is geen Pro-licentie vereist. U kunt inhoud gebruiken vanuit elke werkruimte waarvan u lid of beheerder bent. Hiervoor is een PPU-licentie (Power BI Pro of Premium Per User) vereist.

Stap 2: Een Microsoft Entra-toepassing registreren

Als u uw toepassing registreert bij Microsoft Entra ID, kunt u het volgende doen:

  • Een identiteit voor uw app instellen
  • Uw app toegang verlenen tot de Power BI REST API's
  • Als u een hoofdgebruiker gebruikt: geef de Power BI REST-machtigingen van uw app op

Als u uw toepassing wilt registreren bij Microsoft Entra ID, volgt u de instructies in Uw toepassing registreren.

Notitie

Voordat u uw toepassing registreert, moet u beslissen welke verificatiemethode moet worden gebruikt, service-principal of hoofdgebruiker.

Stap 3: Een Power BI-werkruimte maken

Power BI bewaart uw rapporten, dashboards en tegels in een werkruimte. Als u deze items wilt insluiten, moet u ze maken en uploaden naar een werkruimte.

Tip

Als u al een werkruimte hebt, kunt u deze stap overslaan.

Ga als volgt te werk om een werkruimte te maken:

  1. Meld u aan bij Power BI.

  2. Selecteer Werkruimten.

  3. Selecteer Maak een werkruimte.

  4. Geef uw werkruimte een naam en selecteer Opslaan.

Stap 4: Een Power BI-rapport maken en publiceren

De volgende stap is het maken van een rapport en het uploaden naar uw werkruimte. U kunt uw eigen rapport maken met Behulp van Power BI Desktop en het vervolgens publiceren naar uw werkruimte. U kunt ook een voorbeeldrapport uploaden naar uw werkruimte.

Tip

Als u al een werkruimte met een rapport hebt, kunt u deze stap overslaan.

Voer de volgende stappen uit om een voorbeeldrapport te downloaden en naar uw werkruimte te publiceren:

  1. Open de map met GitHub Power BI Desktop-voorbeelden .

  2. Selecteer Code en selecteer vervolgens Zip downloaden.

    A screenshot showing the ZIP download option in the Power B I desktop samples GitHub

  3. Pak het gedownloade ZIP-bestand uit en navigeer naar de map Samples Reports .

  4. Selecteer een rapport dat u wilt insluiten en publiceer het naar uw werkruimte.

Stap 5: de parameterwaarden voor insluiten ophalen

Als u uw inhoud wilt insluiten, moet u bepaalde parameterwaarden verkrijgen. In de onderstaande tabel ziet u de vereiste waarden en wordt aangegeven of deze van toepassing zijn op de verificatiemethode van de service-principal , de verificatiemethode van de hoofdgebruiker of beide.

Voordat u uw inhoud insluit, moet u ervoor zorgen dat u alle onderstaande waarden hebt. Sommige waarden verschillen, afhankelijk van de verificatiemethode die u gebruikt.

Parameter Service-principal Hoofdgebruiker
Client ID Applies to. Applies to.
Werkruimte-id Applies to. Applies to.
Rapport-id Applies to. Applies to.
Client secret Applies to. Does not apply to.
Tenant ID Applies to. alleen vereist voor Node JS
Power BI-gebruikersnaam Does not apply to. Applies to.
Power BI-wachtwoord Does not apply to. Applies to.

Client ID

Tip

Van toepassing op:Applies to. Hoofdgebruiker van service-principal Applies to.

Voer de volgende stappen uit om de GUID van de client-id (ook wel toepassings-id genoemd) op te halen:

  1. Meld u aan bij Microsoft Azure.

  2. Zoek App-registraties en selecteer de koppeling App-registraties.

  3. Selecteer de Microsoft Entra-app die u gebruikt voor het insluiten van uw Power BI-inhoud.

  4. Kopieer in de sectie Overzicht de GUID van de toepassings-id (client).

Werkruimte-id

Tip

Van toepassing op:Applies to. Hoofdgebruiker van service-principal Applies to.

Voer de volgende stappen uit om de GUID van de werkruimte-id op te halen:

  1. Aanmelden bij Power BI-service.

  2. Open het rapport dat u wilt insluiten.

  3. Kopieer de GUID uit de URL. De GUID is het getal tussen /groups/ en /reports/.

    A screenshot showing workspace ID GUID in the Power B I service U R L

U kunt ook de werkruimte-id vinden in de instellingen van de Beheer portal door Details naast de naam van de werkruimte te selecteren.

A screenshot showing how to find the workspace I D from the admin settings.

Rapport-id

Tip

Van toepassing op:Applies to. Hoofdgebruiker van service-principal Applies to.

Voer de volgende stappen uit om de GUID van de rapport-id op te halen:

  1. Aanmelden bij Power BI-service.

  2. Open het rapport dat u wilt insluiten.

  3. Kopieer de GUID uit de URL. De GUID is het getal tussen /reports/ en /ReportSection.

    A screenshot showing report ID GUID in the Power B I service U R L

Clientgeheim

Tip

Van toepassing op:Applies to. Hoofdgebruiker van service-principal Does not apply to.

Voer de volgende stappen uit om het clientgeheim op te halen:

  1. Meld u aan bij Microsoft Azure.

  2. Zoek App-registraties en selecteer de koppeling App-registraties.

  3. Selecteer de Microsoft Entra-app die u gebruikt voor het insluiten van uw Power BI-inhoud.

  4. Selecteer onder Beheren de optie Certificaten en geheimen.

  5. Selecteer onder Clientgeheimen het nieuwe clientgeheim.

  6. Geef in het pop-upvenster Een clientgeheim toevoegen een beschrijving op voor uw toepassingsgeheim, selecteer wanneer het toepassingsgeheim verloopt en selecteer Toevoegen.

  7. Kopieer in de sectie Clientgeheimen de tekenreeks in de kolom Waarde van het zojuist gemaakte toepassingsgeheim. De waarde van het clientgeheim is uw client-id.

Notitie

Zorg ervoor dat u de waarde van het clientgeheim kopieert wanneer deze voor het eerst wordt weergegeven. Nadat u van deze pagina bent verwijderd, wordt het clientgeheim verborgen en kunt u de waarde ervan niet ophalen.

Tenant-id

Tip

Van toepassing op:Applies to. Hoofdgebruiker van service-principal Does not apply to.

Voer de volgende stappen uit om de GUID van de tenant-id op te halen:

  1. Meld u aan bij Microsoft Azure.

  2. Zoek App-registraties en selecteer de koppeling App-registraties.

  3. Selecteer de Microsoft Entra-app die u gebruikt voor het insluiten van uw Power BI-inhoud.

  4. Kopieer in de sectie Overzicht de GUID van de map-id (tenant).

Gebruikersnaam en wachtwoord voor Power BI

Tip

Van toepassing op:Does not apply to. Hoofdgebruiker van service-principal Applies to.

Haal de gebruikersnaam en het wachtwoord op van de Power BI-gebruiker die u gebruikt als hoofdgebruiker. Dit is dezelfde gebruiker die u hebt gebruikt om een werkruimte te maken en een rapport te uploaden naar, in Power BI-service.

Stap 6: API-toegang tot service-principal

Tip

Van toepassing op:Applies to. Hoofdgebruiker van service-principal Does not apply to.

Deze stap is alleen relevant als u de verificatiemethode voor de service-principal gebruikt. Als u een hoofdgebruiker gebruikt, slaat u deze stap over en gaat u verder met stap 7: werkruimtetoegang inschakelen.

Voor een Microsoft Entra-app die toegang heeft tot de Power BI-inhoud en API's, moet een Power BI-beheerder toegang tot de service-principal inschakelen in de Power BI-beheerportal. Als u niet de beheerder van uw tenant bent, vraagt u de tenantbeheerder om de tenantinstellingen voor u in te schakelen.

  1. Selecteer in Power BI-service Instellingen> Instellingen> Beheer portal.

    A screenshot showing the admin settings menu option in the Power B I service settings menu.

  2. Selecteer Tenantinstellingen en schuif omlaag naar de sectie Ontwikkelaarsinstellingen .

  3. Vouw Service-principals toestaan uit om API van Power BI s te gebruiken en schakel deze optie in.

    A screenshot showing how to enable the developer settings option, in the tenant settings menu option, in Power B I service.

Notitie

Wanneer u een service-principal gebruikt, is het raadzaam om de toegang tot de tenantinstellingen te beperken met behulp van een beveiligingsgroep. Zie de volgende secties in het artikel over de service-principal voor meer informatie over deze functie:

Stap 7: werkruimtetoegang inschakelen

Als u uw Microsoft Entra-app toegang wilt geven tot objecten zoals rapporten, dashboards en semantische modellen in de Power BI-service, voegt u de service-principal of hoofdgebruiker toe als lid of beheerder aan uw werkruimte.

  1. Aanmelden bij Power BI-service.

  2. Schuif naar de werkruimte waarvoor u toegang wilt inschakelen en selecteer in het menu Meer de optie Werkruimtetoegang.

    Screenshot showing the workspace access button in the more menu of a Power B I workspace.

  3. Kopieer in het deelvenster Access , afhankelijk van de verificatiemethode die u gebruikt, de service-principal of hoofdgebruiker naar het tekstvak E-mailadres invoeren.

    Notitie

    Als u een service-principal gebruikt, is de naam de naam die u uw Microsoft Entra-app hebt gegeven.

  4. Selecteer Toevoegen.

Stap 8: uw inhoud insluiten

Met de ingesloten Power BI-voorbeeldtoepassing kunt u een insluiting voor uw klanten maken in de Power BI-app.

Volg deze stappen om de insluiting voor de voorbeeldtoepassing van uw klanten te wijzigen om uw Power BI-rapport in te sluiten.

  1. Open de map met Voorbeelden van Power BI-ontwikkelaars .

  2. Selecteer Code en selecteer vervolgens Zip downloaden.

    A screenshot showing the ZIP download option in the Power B I developer samples GitHub

  3. Pak het gedownloade ZIP-bestand uit en navigeer naar de map PowerBI-Developer-Samples-master .

  1. Open een van de volgende mappen, afhankelijk van de taal die u wilt gebruiken voor uw app:

    • .NET Core
    • .NET Framework
    • Java
    • Node JS
    • Python

    Notitie

    De insluiting voor de voorbeeldtoepassingen van uw klanten ondersteunt alleen de hierboven vermelde frameworks. De React-voorbeeldtoepassing ondersteunt alleen het insluiten van de oplossing van uw organisatie .

  2. Open de map Insluiten voor uw klanten .

  1. Open het insluiten voor de voorbeeld-app van uw klanten met behulp van een van de volgende methoden:

  2. Open appsettings.json.

  3. Vul, afhankelijk van uw verificatiemethode, de volgende parameterwaarden in:

    Parameter Service-principal Hoofdgebruiker
    AuthenticationMode ServicePrincipal MasterUser
    ClientId De client-id van uw Microsoft Entra-app De client-id van uw Microsoft Entra-app
    TenantId Uw Microsoft Entra-tenant-id N.v.t.
    PbiUsername N.v.t. De gebruikersnaam en het wachtwoord van uw hoofdgebruiker , raadpleegt u de gebruikersnaam en het wachtwoord van Power BI
    PbiPassword N.v.t. Uw hoofdgebruikerswachtwoord , zie de gebruikersnaam en het wachtwoord van Power BI
    ClientSecret Uw Microsoft Entra ID-clientgeheim N.v.t.
    WorkspaceId De id van de werkruimte met uw ingesloten rapport, zie werkruimte-id De id van de werkruimte met uw ingesloten rapport, zie werkruimte-id
    ReportId De id van het rapport dat u insluit, zie rapport-id De id van het rapport dat u insluit, zie rapport-id
  4. Voer het project uit door de juiste optie te selecteren:

    • Als u Visual Studio gebruikt, selecteert u IIS Express (afspelen).

    • Als u Visual Studio Code gebruikt, selecteert u > Start-foutopsporing uitvoeren.

Uw toepassing ontwikkelen

Nadat u de insluiting voor de voorbeeldtoepassing van uw klanten hebt geconfigureerd en uitgevoerd, kunt u beginnen met het ontwikkelen van uw eigen toepassing.

Probeer de speeltuin voor ingesloten analyses van Power BI uit om aan de slag te gaan met ontwikkelen en om alle nieuwe functies en updates van Power BI Embedded bij te houden.

Wanneer u klaar bent, controleert u de overstap naar productievereisten . U hebt ook een capaciteit nodig en moet het artikel over capaciteitsplanning bekijken om te bepalen welke SKU het beste bij uw behoeften past.

Belangrijk

Als u gratis insluittokens hebt gebruikt voor ontwikkeling, moet u een capaciteit kopen voor productie. Totdat een capaciteit is aangeschaft, wordt de banner met de gratis proefversie nog steeds boven aan het ingesloten rapport weergegeven.

Meer vragen? Vraag het Power BI-community.