Power BI-serviceprincipper (Beta)
Denne vejledning forklarer, hvilke trin der er nødvendige for at kunne bruge View Power BI Embedding-widget'en.
Hvis du vil gerne at bruge PowerShell scripts eller lære mere, tjek ud den officielle artikel fra Microsoft. Se følgende artikel Embed service principal for mere information.
Bemærk: Denne artikel er baseret på en artikel fra Microsofts hjælpecenter.
Understøttede enheder
Power BI Widget kan bruges på Windows eller Android, men bør ikke bruges på webOS-enheder. WebOS-enheder har begrænset understøttelse af browserfunktioner(mere information), og derfor kan Power BI-widgets holde op med at virke, hvis Microsoft opdaterer Power BI.
Trin 1 - Opret en Microsoft Entra-app
Log ind på Azure-portalen.
Søg efter og vælg App-registreringer.
Vælg Ny registrering.
Udfyld de nødvendige oplysninger:
- Navn - Indtast et navn til din applikation.
- Understøttede kontotyper - Vælg understøttede kontotyper.
- (Valgfrit) Redirect URI - Indtast en URI, hvis det er nødvendigt.
Vælg register.
Når du har registreret din app, er applikations-id 'et tilgængeligt på fanen Oversigt. Kopier og gem applikations-id 'et til senere brug.
Vælg Certifikater og hemmeligheder.
Vælg Ny klienthemmelighed.
I vinduet Tilføj en klienthemmelighed skal du indtaste en beskrivelse, angive, hvornår klienthemmeligheden skal udløbe, og vælge Tilføj.
Kopier og gem klientens hemmelige værdi.
Bemærk: Når du forlader dette vindue, er klientens hemmelige værdi skjult, og du kan ikke se eller kopiere den igen.
Trin 2 - Opret en Microsoft Entra-sikkerhedsgruppe
Din service principal har ikke adgang til noget af dit Power BI-indhold og dine API'er. For at give serviceprincipalen adgang skal du oprette en sikkerhedsgruppe i Microsoft Entra ID. Tilføj derefter den service principal, du har oprettet, til denne sikkerhedsgruppe.
Bemærk: Hvis du vil aktivere service principal-adgang for hele organisationen, skal du springe dette trin over. Hvis du vil oprette en Azure-sikkerhedsgruppe manuelt, skal du følge instruktionerne i Opret en basisgruppe. Tilføj ikke medlemmer til gruppen på dette tidspunkt.
Trin 3 - Aktivér administratorindstillingerne for Power BI-tjenesten
Åbn Power BI-administratorportalen ved at klikke på Indstillinger og derefter Administratorportal.
I Power BI Admin-portalen skal du gå til lejerindstillinger og rulle ned til udviklerindstillinger.
For at en Microsoft Entra-app kan få adgang til Power BI-indhold og API'er, skal en Power BI-administrator aktivere følgende indstillinger:
- Integrer indhold i apps
- Tillad serviceprincipper at bruge Power BI API'er
- Aktivér Embed content in apps enten for hele organisationen eller for den specifikke sikkerhedsgruppe, du har oprettet i Microsoft Entra ID.
- Aktivér Tillad serviceprincipper at bruge Power BI API'er enten for hele organisationen eller for den specifikke sikkerhedsgruppe, du har oprettet i Microsoft Entra ID.
Vigtigt: Serviceprincipper har adgang til alle lejerindstillinger, de er aktiveret til. Afhængigt af dine administratorindstillinger omfatter dette specifikke sikkerhedsgrupper eller hele organisationen. For at begrænse serviceprincipalers adgang til specifikke lejerindstillinger skal du kun give adgang til specifikke sikkerhedsgrupper. Alternativt kan du oprette en dedikeret sikkerhedsgruppe til serviceprincipaler og udelukke den fra de ønskede lejerindstillinger.
Trin 4 - Tilføj serviceprincippet til dit arbejdsområde
Din Microsoft Entra-app kan kun få adgang til dine Power BI-rapporter, dashboards og semantiske modeller, når den har adgang til dit Power BI-arbejdsområde som medlem eller administrator. Du giver den adgang ved at tilføje appens service principal eller dens sikkerhedsgruppe til dit arbejdsområde.
I Power BI-tjenesten skal du rulle til det arbejdsområde, du vil give adgang til. Vælg Adgang til arbejdsområde i menuen Mere.
I ruden Adgang under Tilføj administratorer, medlemmer eller bidragydere skal du tilføje en af følgende:
- Din service principal. Navnet på din service principal er visningsnavnet på din Microsoft Entra-app, som det vises i din Microsoft Entra-apps oversigtsfane.
- Den sikkerhedsgruppe, der omfatter din service principal.
Vælg Member eller Admin i dropdown-menuen.
Vælg Tilføj.
Trin 5 - Integrer dit indhold
Du kan integrere dit indhold i en eksempelapplikation eller i din egen applikation.
Når dit indhold er indlejret, er du klar til at gå i produktion.
Bemærk: Hvis du vil sikre dit indhold ved hjælp af et certifikat, skal du følge trinnene beskrevet i Indlejring af Power BI-indhold med service principal og et certifikat.
Trin 6 - Udgiv Power BI-rapporten
Nu kan du udgive din Power BI-rapport. Sørg for, at den er inden for det arbejdsområde, der er nævnt i det foregående trin.
Inden for synsvidde:
- Opret en ny skabelon eller et nyt slide, og tilføj Power BI-widget'en
-
Åbn widgetparametrene, og indtast alle de indsamlede oplysninger
Azure Tenant ID: Administratoren i Azure-miljøet skal finde dette token i portalen.
Azure-klient-id (applikations-id) : Det applikationstoken, som er blevet oprettet i trin 1
Klientens hemmelige værdi: Klientens hemmelige værdi er blevet oprettet i det første trin. (Klientens hemmelige værdi indeholder altid ~ (tildes).
Input-URL : Det direkte link til et dashboard/en rapport i et arbejdsområde.
- Gem skabelonen, og føj den til en afspilningsliste.
Placer rapporten i et arbejdsområde for at få den nødvendige URL.
Indlæsningstider
Det kan tage lang tid at indlæse rapporter, især på langsommere hardware. Derfor anbefaler vi at indstille afspilningstiden for et slide, der indeholder Power BI-widget, til mindst et minut. Hver gang widgetten afspilles, indlæses hele rapporten igen.
Azure-politikker
Hvis du har fulgt denne vejledning, og der stadig ikke indlæses nogen Power BI-rapport i GoBright View Portal: Tjek venligst, om der er aktive politikker i Azure, som kan blokere for adgang.