Zelfstudie: Power BI-inhoud insluiten met een voorbeeld-app voor het insluiten voor uw klanten
Met ingesloten analyses en Power BI Embedded (het Azure-product) kunt u Power BI-inhoud zoals rapporten, dashboards en tegels insluiten in uw app.
In deze zelfstudie leert u het volgende:
- Uw embedded omgeving instellen.
- Een voorbeeld-app configureren voor het insluiten voor uw klanten (ook wel gegevens zijn eigendom van app (app owns data) genoemd).
Gebruikers hoeven zich niet aan te melden bij Power BI of een Power BI-licentie te hebben om uw app te gebruiken.
U kunt het beste de methode voor het insluiten voor uw klanten gebruiken om uw Power BI-inhoud in te sluiten, als u een onafhankelijke softwareleverancier (ISV) of een ontwikkelaar bent die apps voor derden wil maken.
Specificaties voor codevoorbeeld
Deze zelfstudie bevat instructies voor het configureren van een voorbeeldtoepassing voor insluiten voor 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 met deze zelfstudie begint, controleert u of u over de Power BI- en codeafhankelijkheden beschikt die hieronder worden vermeld:
Power BI-afhankelijkheden
Uw eigen Azure Active Directory-tenant.
Als u uw app wilt verifiëren bij Power BI, moet u van een van de volgende opties gebruikmaken:
Service-principal: een Azure AD-object voor service-principal (Microsoft Azure Active Directory), waarmee Azure AD uw app kan verifiëren.
Power BI Pro-licentie: dit is uw hoofdgebruiker en uw app gebruikt deze om zich bij Power BI te verifiëren.
Een Power BI Premium per gebruiker-licentie: dit is uw hoofdgebruiker en uw app gebruikt deze om zich bij Power BI te verifiëren.
Notitie
Als u wilt overgaan naar de productieomgeving hebt u een capaciteit nodig.
Codeafhankelijkheden
.NET Core 3.1 SDK (of hoger)
Een geïntegreerde ontwikkelomgeving (IDE of Integrated Development Environment). Het is raadzaam een van de volgende opties te gebruiken:
Methode
Als u een voorbeeld-app voor het insluiten voor uw klanten wilt maken, voert u de volgende stappen uit:
Stap 1: Uw verificatiemethode selecteren
Uw ingesloten oplossing varieert, afhankelijk van de verificatiemethode die u selecteert. Daarom is het belangrijk dat u de verschillen tussen de verificatiemethoden kent, zodat u kunt bepalen welke het beste past bij uw oplossing.
In de onderstaande tabel worden enkele belangrijke verschillen tussen de verificatiemethoden voor de service-principal en hoofdgebruiker beschreven.
| Overweging | Service-principal | Hoofdgebruiker |
|---|---|---|
| Mechanisme | Met het object voor service-principal van uw Azure AD-app kan Microsoft Azure Active Directory uw app voor de ingesloten oplossing verifiëren bij Power BI. | Uw Microsoft Azure Active Directory-app gebruikt de referenties (gebruikersnaam en wachtwoord) van een Power BI-gebruiker om zich te verifiëren bij Power BI. |
| Beveiliging | De service-principal is de aanbevolen verificatiemethode voor Microsoft Azure Active Directory. Als u een service-principal gebruikt,* kunt u de verificatie uitvoeren met behulp van een app-geheim of een certificaat.In deze zelfstudie wordt alleen beschreven hoe u een service-principal gebruikt met een app-geheim. Als u inhoud wilt insluiten met een service-principal en een certificaat, raadpleegt u het artikel Service-principal met een certificaat. | Deze verificatiemethode wordt niet zo veilig beschouwd als het gebruik van een service-principal. Dit komt omdat u behoedzaam moet zijn met de referenties (gebruikersnaam en wachtwoord) voor de hoofdgebruiker. U moet deze bijvoorbeeld niet blootstellen in de app voor het insluiten en u moet het wachtwoord regelmatig wijzigen. |
| Gedelegeerde machtigingen van Microsoft Azure Active Directory | Niet vereist. | Uw hoofdgebruiker of een beheerder moet voor uw app toegang verlenen tot Power BI REST API-machtigingen (ook wel bereiken genoemd). Bijvoorbeeld Report.ReadWrite.All. |
| Toegang tot de Power BI-service | U hebt geen toegang tot de Power BI-service met een service-principal. | U kunt toegang krijgen tot de Power BI-service met de referenties van uw hoofdgebruiker. |
| Licentie | Hiervoor is geen Pro-licentie vereist. U kunt inhoud gebruiken uit elke werkruimte waarvan u lid of beheerder bent. | Vereist een Power BI Pro of Premium PPU-licentie (per gebruiker). |
Stap 2: Een Azure AD-app registreren
Door uw app te registreren bij Microsoft Azure Active Directory kunt u het volgende doen:
- Een identiteit voor uw app instellen
- Uw app toegang bieden tot de Power BI REST API's
- Als u een hoofdgebruiker gebruikt: geef de Power BI REST-machtigingen van uw app op
Als u de app wilt registreren bij Microsoft Azure Active Directory, volgt u de instructies in Uw app registreren.
Notitie
Voordat u de app registreert, moet u beslissen welke verificatiemethode u 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 naar een werkruimte uploaden.
Tip
Als u al een werkruimte hebt, kunt u deze stap overslaan.
Als u een werkruimte wilt maken, doet u het volgende:
Meld u aan bij Power BI.
Selecteer Werkruimten.
Selecteer Een werkruimte maken.
Geef uw werkruimte een naam en selecteer Opslaan.
Stap 4: Een Power BI-rapport maken en publiceren
In de volgende stap maakt u een rapport en uploadt u dit 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.
Als u een voorbeeldrapport wilt downloaden en wilt publiceren naar uw werkruimte, voert u de volgende stappen uit:
Open de GitHub-map Power BI Desktop-voorbeelden.
Selecteer Code en vervolgens ZIP-bestand downloaden.
Pak het gedownloade ZIP-bestand uit en ga naar de map Voorbeeldrapporten.
Selecteer een rapport dat u wilt insluiten en publiceer het naar uw werkruimte.
Stap 5: De parameterwaarden voor het insluiten ophalen
Als u uw inhoud wilt insluiten, moet u bepaalde parameterwaarden ophalen. In de onderstaande tabel worden de vereiste waarden weergegeven en wordt aangegeven of ze van toepassing zijn op de verificatiemethode van de service-principal, de verificatiemethode voor de hoofdgebruiker of beide.
Zorg ervoor dat u over alle onderstaande waarden beschikt voordat u de inhoud insluit. Sommige waarden zullen verschillen, afhankelijk van de verificatiemethode die u gebruikt.
| Parameter | Service-principal | Hoofdgebruiker |
|---|---|---|
| Client ID |  |
|
| Werkruimte-id | |
|
| Rapport-id | |
|
| Clientgeheim | |
 |
| Tenant ID | |
|
| Power BI-gebruikersnaam | |
|
| Power BI-wachtwoord | |
|
Client-id
Tip
Van toepassing op: service-principal hoofdgebruiker
Als u de GUID van de client-id (ook wel de app-id genoemd) wilt ophalen, voert u de volgende stappen uit:
Meld u aan bij Microsoft Azure.
Ga naar App-registraties en selecteer de koppeling App-registraties.
Selecteer de Azure AD-app die u gebruikt voor het insluiten van uw Power BI-inhoud.
Kopieer in de sectie Overzicht de GUID van de app-id (client) .
Werkruimte-id
Tip
Van toepassing op: service-principal hoofdgebruiker
Als u de GUID van de werkruimte-id wilt ophalen, voert u de volgende stappen uit:
Meld u aan bij de Power BI-service.
Open het rapport dat u wilt insluiten.
Kopieer de GUID van de URL. De GUID is de tekenreeks tussen /groups/ en /reports/ .
Rapport-id
Tip
Van toepassing op: service-principal hoofdgebruiker
Volg deze stappen om de rapport-id-GUID op te halen:
Meld u aan bij de Power BI-service.
Open het rapport dat u wilt insluiten.
Kopieer de GUID van de URL. De GUID is de tekenreeks tussen /reports/ en /ReportSection.
Clientgeheim
Tip
Van toepassing op: service-principal hoofdgebruiker
Als u het clientgeheim wilt ophalen, voert u de volgende stappen uit:
Meld u aan bij Microsoft Azure.
Ga naar App-registraties en selecteer de koppeling App-registraties.
Selecteer de Azure AD-app die u gebruikt voor het insluiten van uw Power BI-inhoud.
Selecteer onder Beheren de optie Certificaten en geheimen.
Selecteer onder Clientgeheimen de optie Nieuw clientgeheim.
Geef in het pop-upvenster Een clientgeheim toevoegen een beschrijving op voor uw app-geheim, selecteer wanneer het app-geheim verloopt en selecteer Toevoegen.
Kopieer in de sectie Clientgeheimen de tekenreeks in de kolom Waarde van het zojuist gemaakte app-geheim. 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. Na het navigeren van deze pagina wordt het clientgeheim verborgen en kunt u de waarde ervan niet meer ophalen.
Tenant-id
Tip
Van toepassing op: service-principal hoofdgebruiker
Als u de GUID van de tenant-id wilt ophalen, voert u de volgende stappen uit:
Meld u aan bij Microsoft Azure.
Ga naar App-registraties en selecteer de koppeling App-registraties.
Selecteer de Azure AD-app die u gebruikt voor het insluiten van uw Power BI inhoud.
Kopieer in de sectie Overzicht de GUID van de directory-id (tenant) .
Gebruikersnaam en wachtwoord voor Power BI
Tip
Van toepassing op: service-principal hoofdgebruiker
Zorg dat u over de gebruikersnaam en het wachtwoord beschikt van de Power BI-gebruiker die u gebruikt als uw hoofdgebruiker. Dit is dezelfde gebruiker als die u hebt gebruikt voor het maken van een werkruimte en naar wie u een rapport hebt geüpload, in de Power BI-service.
Stap 6: API-toegang voor de service-principal
Tip
Van toepassing op: service-principal hoofdgebruiker
Deze stap is alleen relevant als u de verificatiemethode voor service-principal gebruikt. Als u een hoofdgebruiker gebruikt, slaat u deze stap over en gaat u door met Stap 7: De toegang tot de werkruimte inschakelen.
Voordat een Azure AD-app toegang kan krijgen 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 beheerder van de tenant om de tenantinstellingen voor u in te schakelen.
Selecteer in de Power BI-service de opties Instellingen > Instellingen > Beheerportal.
Selecteer Tenantinstellingen en schuif vervolgens omlaag naar de sectie Ontwikkelaarsinstellingen.
Vouw Toestaan dat service-principals gebruikmaken van Power BI-API's uit en schakel deze optie in.
Notitie
Wanneer u een service-principal gebruikt, kunt u het beste hiervoor de toegang tot de tenantinstellingen beperken met behulp van een beveiligingsgroep. Zie voor meer informatie over deze functie de volgende secties in het artikel over de service-principal:
Stap 7: De toegang tot de werkruimte inschakelen
Als u uw Azure AD-app toegang wilt verlenen tot artefacten zoals rapporten, dashboards en gegevenssets in de Power BI-service, voegt u de service-principal of hoofdgebruiker als lid of beheerder toe aan uw werkruimte.
Meld u aan bij de Power BI-service.
Ga naar de werkruimte waarvoor u toegang wilt inschakelen, en selecteer in het menu More de optie Workspace access.
Kopieer in het deelvenster Toegang, 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, heeft deze de naam die u voor de Azure AD-app hebt opgegeven.
Selecteer Toevoegen.
Stap 8: Uw inhoud insluiten
Met de voorbeeld-app van Power BI Embedded kunt u een Power BI-app voor het insluiten voor uw klanten maken.
Voer de volgende stappen uit om de voorbeeld-app voor het insluiten voor uw klanten te wijzigen om uw Power BI-rapport in te sluiten.
Open de map Voorbeelden voor Power BI-ontwikkelaars.
Selecteer Code en vervolgens ZIP-bestand downloaden.
Pak het gedownloade ZIP-bestand uit en ga naar de map PowerBI-Developer-Samples-master.
Afhankelijk van de taal die u voor de app wilt gebruiken, opent u een van de volgende mappen:
- .NET Core
- .NET Framework
- Java
- Node JS
- Python
Notitie
De voorbeeldtoepassingen voor insluiten voor uw klanten ondersteunen alleen de hierboven vermelde frameworks. De React-voorbeeldtoepassing ondersteunt alleen het insluiten voor uw organisatieoplossing.
Open de map Insluiten voor uw klanten.
Open de voorbeeld-app voor het insluiten voor uw klanten met een van de volgende methoden:
Als u Visual Studio gebruikt, opent u het bestand AppOwnsData.sln.
Als u code gebruikt Visual Studio Code,opent u de map AppOwnsData.
Open appsettings.json.
Afhankelijk van de verificatiemethode vult u de volgende parameterwaarden in:
Parameter Service-principal Hoofdgebruiker AuthenticationModeServicePrincipal MasterUser ClientIdDe client-id van uw Azure AD-app De client-id van uw Azure AD-app TenantIdDe tenant-id van Azure Active Directory N.v.t. PbiUsernameN.v.t. De gebruikersnaam voor uw hoofdgebruiker, zie Power BI-gebruikersnaam en -wachtwoord PbiPasswordN.v.t. Het wachtwoord voor uw hoofdgebruiker, zie Power BI-gebruikersnaam en -wachtwoord ClientSecretUw Azure AD-clientgeheim N.v.t. WorkspaceIdDe id van de werkruimte met uw ingesloten rapport, zie Werkruimte-id De id van de werkruimte met uw ingesloten rapport, zie Werkruimte-id ReportIdDe id van het rapport dat u wilt insluiten, zie Rapport-id De id van het rapport dat u wilt insluiten, zie Rapport-id 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 Uitvoeren > Foutopsporing starten.
Uw toepassing ontwikkelen
Na het configureren en uitvoeren van de voorbeeld-app voor het insluiten voor uw klanten, kunt u beginnen met het ontwikkelen van uw eigen app.
Wanneer u klaar bent, controleert u de vereisten voor het overgaan naar de productieomgeving. U hebt ook een capaciteit nodigen u moet het artikel over capaciteitsplanning lezen om vast te stellen welke SKU het beste bij uw behoeften past.