Delen via


Zelfstudie: Power BI-inhoud insluiten met behulp van een voorbeeld insluiten voor uw klantentoepassing

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 de volgende Power BI- en codeafhankelijkheden hebt:

  • 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 volgende 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

Microsoft Fabric 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 Fabric.

  2. Selecteer Werkruimten.

  3. Selecteer + Nieuwe 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.

    Een schermopname met de optie ZIP-download in de GitHub-voorbeelden van Power BI Desktop

  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 volgende 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 kunnen verschillen, afhankelijk van de verificatiemethode die u gebruikt.

Parameter Service-principal Hoofdgebruiker
Client ID Van toepassing op. Van toepassing op.
Werkruimte-id Van toepassing op. Van toepassing op.
Rapport-id Van toepassing op. Van toepassing op.
Client secret Van toepassing op. Is niet van toepassing op.
Tenant ID Van toepassing op. alleen vereist voor Node JS
Power BI-gebruikersnaam Is niet van toepassing op. Van toepassing op.
Power BI-wachtwoord Is niet van toepassing op. Van toepassing op.

Client ID

Tip

Van toepassing op: Van toepassing op.Hoofdgebruiker voor service-principal Van toepassing op.

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: Van toepassing op.Hoofdgebruiker voor service-principal Van toepassing op.

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/.

    Een schermopname van de GUID van de werkruimte-id in de Power BI-service-URL

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

Een schermopname die laat zien hoe u de werkruimte-id kunt vinden vanuit de beheerinstellingen.

Rapport-id

Tip

Van toepassing op: Van toepassing op.Hoofdgebruiker voor service-principal Van toepassing op.

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.

    Een schermopname van de GUID van de rapport-id in de Power BI-service-URL

Clientgeheim

Tip

Van toepassing op: Van toepassing op.Hoofdgebruiker voor service-principal Is niet van toepassing op.

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: Van toepassing op.Hoofdgebruiker voor service-principal Is niet van toepassing op.

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: Is niet van toepassing op.Hoofdgebruiker voor service-principal Van toepassing op.

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: Van toepassing op.Hoofdgebruiker voor service-principal Is niet van toepassing op.

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 de beheerportal Instellingen>>.

    Een schermopname van de menuoptie Beheerinstellingen in het menu Instellingen van de Power BI-service.

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

  3. Vouw service-principals uit en schakel deze optie in.

    Een schermopname van het inschakelen van de optie instellingen voor ontwikkelaars, in de menuoptie Tenantinstellingen, in de Power BI-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. Meld u aan bij Fabric.

  2. Schuif naar de werkruimte waarvoor u toegang wilt inschakelen en selecteer Toegang beheren.

    Schermopname van de knop Toegang tot werkruimte in het menu Meer van een Power BI-werkruimte.

  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.

    Een schermopname van de zip-downloadoptie in de GitHub-voorbeelden van Power BI-ontwikkelaars

  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.