Prístupové tokeny k vloženej analýze

VZŤAHUJE SA NA: Aplikácia vlastní údaje Používateľ vlastní údaje

Používanie obsahu služby Power BI (napríklad zostáv, tabúľ a dlaždíc) vyžaduje prístupový token. V závislosti od vášho riešenia môže byť tento token Microsoft Entra, token na vloženie, alebo oboje.

V riešení Vloženie obsahu pre zákazníkov aplikácia vygeneruje vkladací token, ktorý udelí vašim webovým používateľom prístup k obsahu služby Power BI.

Poznámka

Pri použití riešenia Vloženie obsahu pre zákazníkov môžete použiť akúkoľvek metódu overovania na umožnenie prístupu k vašej webovej aplikácii.

V riešení Vloženie obsahu pre organizáciu sa používatelia webovej aplikácie overia pomocou vlastných poverení v službe Microsoft Entra ID. Vaši zákazníci majú prístup k obsahu služby Power BI, ku ktorému majú prístup v služba Power BI.

Token Microsoft Entra

Na vkladanie obsahu pre zákazníkov a vkladanie pre riešenia organizácie potrebujete token Microsoft Entra. Token Microsoft Entra sa vyžaduje pre všetky operácie rozhrania REST API a jeho platnosť vyprší po hodine.

• V riešení Vloženie obsahu pre zákazníkov sa na generovanie tokenu na vloženie používa token Microsoft Entra.

• V riešení Vloženie obsahu pre organizáciu sa na prístup k službe Power BI používa token Microsoft Entra.

Token Microsoft Entra môžete získať jedným z nasledujúcich spôsobov:

• Na získanie tokenu použite externý nástroj Postman . Ďalšie informácie nájdete v tomto postupnosti Komunita Power BI. URL adresa požiadavky pre objekt služby musí byť https://login.microsoftonline.com/{tenantID}/oauth2/v2.0/token, ale v prípade hlavného používateľa môže byť buď https://login.microsoftonline.com/{tenantID}/oauth2/v2.0/token , alebo https://login.microsoftonline.com/common/oauth2/token.

• Postupujte podľa vzorových riešení na lokalite PowerBI-Developer-Samples. Napríklad:

  • Ak chcete vložiť pre svojich zákazníkov , pozrite si tento súbor AadService.cs. authorityUrl Nájdite a scopeBase na lokalite AppOwnsData/Web.config.

  • Ak chcete vložiť pre svoju organizáciu, pozrite si tento súbor OwinOpenId Pripojenie.cs. Vyhľadajte authorityUrl lokalitu UserOwnsData/Web.config.

  Poznámka

  Hodnoty a scopeBase pre niektoré suverénne authorityUrl cloudy môžete nájsť v téme Vloženie obsahu do aplikácie pre cloudy štátnej správy a národné/regionálne cloudy.

Token na vloženie

Keď použijete riešenie Vloženie obsahu pre zákazníkov , webová aplikácia potrebuje vedieť, ku ktorému obsahu služby Power BI má používateľ prístup. Pomocou rozhraní REST API tokenu na vloženie vygenerujte vkladací token, ktorý určuje nasledujúce informácie:

• Obsah, ku ktorému má používateľ webovej aplikácie prístup

• Úroveň prístupu používateľa webovej aplikácie (zobrazenie, vytvorenie alebo úprava)

Ďalšie informácie nájdete v téme Dôležité informácie o generovaní vkladacieho tokenu.

Postupy overovania

Táto časť popisuje rôzne postupy overovania pre zákazníkova vkladanie obsahu pre riešenia organizácie .

Vloženie obsahu pre zákazníkov

Riešenie Vloženie obsahu pre zákazníkov používa neinteraktívny postup overovania. V riešení Vloženie obsahu pre zákazníkov sa používatelia neprihlásia do služby Microsoft Entra ID, aby získali prístup k Power BI. Namiesto toho vaša webová aplikácia používa na overenie v službe Microsoft Entra vyhradenú identitu Microsoft Entra a vygeneruje vložený token. Vyhradenou identitou môže byť buď objekt služby, alebo hlavný používateľ:

• Objekt služby Vaša webová aplikácia používa objekt služby Microsoft Entra na overenie v rámci ID služby Microsoft Entra a získanie tokenu Microsoft Entra len pre aplikáciu. Túto metódu overovania výhradne na úrovni aplikácie odporúča Microsoft Entra ID.

  Pri používaní objektu služby je potrebné povoliť prístup rozhranie API služby Power BI v nastaveniach správcu služba Power BI. Povolenie prístupu umožňuje vašej webovej aplikácii prístup k rozhraniam REST API služby Power BI. Ak chcete v pracovnom priestore používať operácie rozhrania API, objekt služby musí byť členom alebo správcom pracovného priestoru.

• Hlavný používateľ Vaša webová aplikácia používa používateľské konto na overenie v službe Microsoft Entra ID a získanie tokenu Microsoft Entra. Hlavné používateľské konto musí mať licenciu na Power BI Pro alebo licenciu na Premium na používateľa .

  Keď používate hlavné používateľské konto, musíte definovať delegované povolenia aplikácie (známe aj ako rozsahy). Hlavný používateľ alebo správca nájomníka musí udeliť súhlas s používaním týchto povolení pri používaní rozhraní REST API služby Power BI.

Po úspešnom overení v službe Microsoft Entra ID vygeneruje webová aplikácia vkladací token , aby jej používatelia mohli pristupovať ku konkrétnemu obsahu služby Power BI.

Poznámka

• Na vkladanie pomocou riešenia Vloženie obsahu pre zákazníkov potrebujete kapacitu so skladkou SKU A, EM alebo P.
• Ak chcete prejsť do produkčného prostredia, potrebujete kapacitu.

Nasledujúci diagram znázorňuje postup overenia pre riešenie vkladania obsahu pre zákazníkov .

1. Používateľ webovej aplikácie overí vašu webovú aplikáciu metódou overovania.

2. Vaša webová aplikácia používa objekt služby alebo hlavného používateľa na overenie v rámci ID služby Microsoft Entra.

3. Vaša webová aplikácia získa token Microsoft Entra z identifikátora Microsoft Entra ID a používa ho na prístup k rozhraniam Power BI REST API. Vybratá metóda overovania poskytuje prístup k rozhraniu REST APIS služby Power BI, čo závisí od toho, či je metóda overovania buď objektom služby, alebo hlavným používateľom.

4. Vaša webová aplikácia volá operáciu rozhrania REST API token na vloženie a požaduje token na vloženie. Token na vloženie určuje, ktorý obsah služby Power BI sa môže vložiť.

5. Rozhranie REST API vráti token na vloženie do webovej aplikácie.

6. Webová aplikácia odovzdá vkladací token webovému prehliadaču používateľa.

7. Používateľ webovej aplikácie používa na prístup k službe Power BI token na vloženie.

Vloženie obsahu pre organizáciu

Riešenie Vloženie obsahu pre organizáciu používa interaktívny postup overovania. Používatelia webovej aplikácie sa overujú v službe Microsoft Entra ID pomocou vlastných poverení služby Power BI. Musia udeliť súhlas s povoleniami rozhrania API, ktoré boli nastavené v prípade, keď bola aplikácia zaregistrovaná prostredníctvom ID Microsoft Entra. Dialógové okno Požadované povolenia spoločnosti Microsoft požiada používateľov o udelenie týchto povolení. Po udelení súhlasu môže používateľ vložiť obsah služby Power BI, ku ktorému má používateľ prístup.

Poznámka

• Riešenie Vloženie obsahu pre organizáciu nepodporuje jednotky A SKU.

• Ak chcete prejsť do produkčného prostredia, budete potrebovať jednu z nasledujúcich konfigurácií:

  • Všetci používatelia s licenciami Pro.
  • Všetci používatelia s licenciami na Premium na používateľa.
  • Kapacita alebo fabric F64 alebo väčšia kapacita. Táto konfigurácia umožňuje všetkým používateľom mať bezplatné licencie.

Tento diagram zobrazuje príklad postupu overovania pre riešenie vkladania obsahu pre organizáciu .

1. Používateľ webovej aplikácie pristupuje k webovej aplikácii.

2. Webová aplikácia presmeruje používateľa webovej aplikácie na id Microsoft Entra.

3. Používateľ webovej aplikácie overí použitie id služby Microsoft Entra pomocou svojich poverení služby Power BI.

4. Microsoft Entra ID presmeruje používateľa webovej aplikácie späť do webovej aplikácie pomocou tokenu Microsoft Entra. V scenári implicitného udelenia sa prístupový token vráti do prehliadača používateľa.

5. Webová aplikácia odovzdá token Microsoft Entra do webového prehliadača používateľa.

6. Vaša webová aplikácia Power BI používa token Microsoft Entra na vkladanie obsahu služby Power BI, ako sú napríklad zostavy a tabule, ku ktorým má používateľ webovej aplikácie povolenie na prístup.

Súvisiaci obsah

• Dôležité informácie o generovaní vkladacieho tokenu
• Kapacita a skladové jednotky SKU v analýze služby Power BI Embedded

Máte ďalšie otázky? Skúste sa spýtať Komunita Power BI