PowerBI-widget – konfigurasjonsveiledning

Denne veiledningen dekker to sikkerhetstilnærminger for utrulling av PowerBI-widgeten i bedriftsmiljøer.

Oversikt

PowerBI-widgeten støtter to autentiserings- og autorisasjonsmønstre:

• Alternativ 1: Direkte tjenesteprinsipp – Enkel oppsett, tjenesteprinsipp direkte tilordnet
• Alternativ 2: Sikkerhetsgruppe – Anbefalt av bedrifter, ved bruk av Entra ID-sikkerhetsgrupper

Forutsetninger (begge alternativer)

Gjennomgå følgende trinn, ettersom de gjelder for begge alternativene.

2. Konfigurer appregistrering

Etter registrering, noter ned:

• Søknad (klient) ID
• Katalog (leietaker) ID

3. Opprett klienthemmelighet

1. Gå til Administrer > Sertifikater og hemmeligheter
2. Klikk på + Ny klienthemmelighet
3. Konfigurer:

• Beskrivelse: PowerBI-Widget-Secret
• Utløper: 24 måneder (anbefalt)
• Klikk på Legg til

4. Kopier den hemmelige verdien umiddelbart – du vil ikke se den igjen

Når du har fullført trinnene ovenfor, velger du alternativet du vil fortsette med og følger de tilhørende instruksjonene.

Alternativ 1: Direkte tjenesteprinsipp (enkelt oppsett)

Konfigurasjon av Power BI-administrasjonssenteret

1. Gå til Power BI-administratorportal > Leietakerinnstillinger

2. Konfigurer disse innstillingene:

Utviklerinnstillinger

• ✅ Aktivert: Tjenesteprinsipper kan kalle offentlige Fabric API-er
• Gjelder for: Hele organisasjonen

Innstillinger for innebygging av innhold

• ✅ Aktivert: Bygg inn innhold i apper
• Gjelder for: Hele organisasjonen

Konfigurasjon av tilgang til arbeidsområde

1. Gå til din PowerBI-arbeidsområde

2. Klikk Administrer tilgang

3. Klikk +Legg til personer eller grupper

4. Søk etter tjenesteprinsippet ditt:

• Format: [Appnavn] (App-ID: [Applikasjonsklient-ID])

5. Velg tillatelsesnivå:

• Medlem (anbefales) – Full tilgang til innhold i arbeidsområdet
• Bidragsyter – Kan opprette/redigere innhold
• Leser – Skrivebeskyttet tilgang (minimum kreves)

6. Klikk på Legg til

Alternativ 2: Sikkerhetsgruppe (anbefalt for bedrifter)

Trinn 3: Konfigurasjon av Power BI-administrasjonssenteret

1. Gå til Power BI-administratorportal > Leietakerinnstillinger

2. Konfigurer disse innstillingene:

Utviklerinnstillinger

• ✅ Aktivert: Tjenesteprinsipper kan kalle offentlige Fabric API-er
• Gjelder for: Spesifikke sikkerhetsgrupper
• Sikkerhetsgrupper: Legg til sikkerhetsgruppen din:
  • PowerBI-tjenesteprinsipper

Innstillinger for innebygging av innhold

• ✅ Aktivert: Bygg inn innhold i apper
• Gjelder for: Spesifikke sikkerhetsgrupper
• Sikkerhetsgrupper: Samme sikkerhetsgruppe som ovenfor:
  • PowerBI-tjenesteprinsipper

Trinn 4: Konfigurasjon av tilgang til arbeidsområde

1. Gå til PowerBI-arbeidsområdet ditt

2. Klikk på Administrer tilgang

3. Klikk +Legg til personer eller grupper

4. Søk etter sikkerhetsgruppen din:

• PowerBI-tjenesteprinsipper

5. Velg tillatelsesnivå:

• Medlem (anbefales) – Full tilgang til innhold i arbeidsområdet
• Bidragsyter – Kan opprette/redigere innhold
• Leser – Skrivebeskyttet tilgang (minimum kreves)

6. Klikk på Legg til

Widget-konfigurasjon

Nødvendige parametere

{
“tenantID”: “your-tenant-id”,
“clientID”: “your-application-client-id”,
“clientSecret”: “your-client-secret”,
“inputUrl”: “https://app.powerbi.com/groups//reports/”
}

Støttede URL-formater

• Rapporter: https://app.powerbi.com/groups//reports/
• Spesifikke sider: https://app.powerbi.com/groups//reports//ReportSection
• Dashbord: https://app.powerbi.com/groups//dashboards/

Sikkerhetssammenligning

Feilsøking

Vanlige problemer

Feil: «Uautorisert» eller «Token utløpt»

• Bekreft at klienthemmeligheten ikke er utløpt
• Sjekk at API-tillatelser er gitt med administratorsamtykke
• Sørg for at tjenesteoppdragsgiveren/sikkerhetsgruppen har tilgang til arbeidsområdet

Feil: «Tjenesteprinsipper ikke funnet»

• Vent 10–15 minutter etter at du har opprettet appregistreringen
• Bekreft at tjenesteprinsippet er lagt til sikkerhetsgruppen (alternativ 2)
• Kontroller at Power BI-administratorinnstillingene tillater tjenesteprinsipper

Feil: «Ingen tilgang til arbeidsområde»

• Bekreft tillatelser for arbeidsområde (minimum: Viewer)
• Sjekk synligheten av arbeidsområdet (må ikke være et personlig arbeidsområde)
• Sørg for at sikkerhetsgruppen har riktig tilgang til arbeidsområdet (alternativ 2)

Feil: «Minst ett datasett kreves» (Dashboards)

• Dette håndteres automatisk av widgeten
• Forekommer med statiske dashbord (bilder, kun tekst)
• Widgeten inkluderer håndtering av reserve

Beste praksis

1. Bruk sikkerhetsgrupper for bedriftsmiljøer

2. Roter klienthemmeligheter regelmessig (hver 12.–24. måned)

3. Gi minimum nødvendige tillatelser (tilstrekkelig visningsnivå for innebygging)

4. Overvåk bruken av tjenesteprinsipper gjennom revisjonslogger for Azure AD

5. Dokumenter medlemskap i sikkerhetsgruppen for samsvar

6. Test med brukere som ikke er administratorer for å bekrefte at tillatelsene er riktige

Sikkerhetsnotater

• Klientlegitimasjonsflyt gir tilgang på applikasjonsnivå (ikke brukerspesifikk)
• Tillatelser knyttet til arbeidsområde begrenser kun tilgang til tildelte arbeidsområder
• Ingen interaktiv autentisering kreves – egnet for serverside-widgeter
• Sikkerhetsgrupper gir bedre styrings- og revisjonsmuligheter
• Regelmessig hemmelig rotasjon opprettholder sikkerhetsposisjonen