Sdílet prostřednictvím

Nastavení aplikace Microsoft Entra ID

  • Článek

Aby bylo možné používat rozhraní API pro ověřování, musí isV nejprve zaregistrovat aplikaci v Microsoft Entra ID, aby se podporoval každý cloud, a předem autorizovat aplikace Power BI s vyhrazeným oborem pro každý vizuál. Správce tenanta pak musí udělit souhlas. Tento článek popisuje všechny tyto základní kroky.

Rozhraní API pro ověřování je podporováno v následujících cloudech:

  • COM (povinné) – Komerční cloud
  • CN – Čínský cloud
  • GCC – Komunitní cloud pro státní správu USA
  • GCCHIGH – Us Government Community Cloud High
  • DOD – Ministerstvo obrany USA

Registrace aplikace v Microsoft Entra ID

Pro každý cloud je vizuál určený k podpoře, postupujte takto:

  1. Přejděte na příslušný web Azure Portal a přejděte na Registrace aplikací.

  2. Výběr + nová registrace

    Snímek obrazovky s novým registračním uživatelským rozhraním aplikace Microsoft Entra

  3. Na stránce Registrace aplikace postupujte takto:

    1. Do části Název zadejte požadovaný název aplikace.
    2. V části Podporované typy účtů vyberte Účty v libovolném organizačním adresáři (Libovolný adresář Azure AD – Víceklient).
    3. Vyberte Zaregistrovat.

    Snímek obrazovky se stránkou Registrace aplikace v registrační aplikaci Microsoft Entra ID

  4. Po úspěšné registraci aplikace vyberte v nabídce na levé straně zveřejnit rozhraní API .

    Snímek obrazovky se stránkou Zveřejnit rozhraní API registrační aplikace Microsoft Entra ID

  5. V poli Identifikátor URI ID aplikace vyberte Přidat.

    Snímek obrazovky se stránkou Zveřejnit rozhraní API s možností přidat identifikátor URI ID aplikace

  6. Do pole Upravit identifikátor URI ID aplikace zadejte ověřenou vlastní doménu, ujistěte se, že začíná na "https://" a neobsahuje "onmicrosoft.com" a vyberte Uložit.

    Přidání vlastní domény:

    1. Přejděte na vlastní názvy domén Microsoft Entra ID.
    2. Přidejte vlastní doménu.

    Snímek obrazovky se stránkou Zveřejnit rozhraní API s otevřenou stránkou Upravit identifikátor URI ID aplikace

    Poznámka:

    Identifikátor URI aplikace lze ručně přidat do manifestu aplikace v poli IdentifikátorUris .

    Snímek obrazovky znázorňující příklad kódu pro přidání identifikátoru URI aplikace

  7. Vyberte + Přidat obor.

  8. Do pole Název oboru zadejte <visual_guid>_CV_ForPBI a přidejte požadované informace. Vyplňte pole souhlasu správce. Pak vyberte tlačítko Přidat obor . (Existuje omezení délky rozsahu 40 znaků, ale název oboru v registrovaném manifestu aplikace můžete upravit ručně, aby bylo možné toto omezení spravovat).

    Snímek obrazovky s oknem upravit obor s poli pro název oboru a dalšími informacemi

  9. Předběžné ověření aplikací Power BI:

    1. Vyberte + Přidat klientskou aplikaci.

      Snímek obrazovky s oknem upravit obor s poli pro přidání klientské aplikace

    2. Do pole ID klienta v pravém okně zadejte appId aplikace Power BI WFE.

      • COM (povinné) a CN: "871c010f-5e61-4fb1-83ac-98610a7e9110".
      • GCC, GCCHIGH a DOD: "ec04d7d8-0476-4acd-bce4-81f438363d37".

    3. Vyberte požadovaný obor.

    4. Vyberte Přidat aplikaci.

      Snímek obrazovky s uživatelským rozhraním pro přidání klientské aplikace

    5. Tento proces opakujte takto:

      • Power BI Desktop:

        • COM (povinné) a CN: "7f67af8a-fedc-4b08-8b4e-37c4d127b6cf".
        • GCC, GCCHIGH a DOD: "6807062e-abc9-480a-ae93-9f7deee6b470".

      • Power BI Mobile:

        • COM (povinné) a CN: "c0d2a505-13b8-4ae0-aa9e-cddd5eab0b12".
        • GCC, GCCHIGH a DOD: "ce76e270-35f5-4bea-94ff-eab975103dc6".

Správce tenanta může určit, jestli uživatelé mohou souhlasit sami za sebe. Tento proces vyjádření souhlasu probíhá mimo Power BI.

Back-endová aplikace isV (například https://contoso.com) by měla být v souladu se standardními pravidly AAD odsouhlasena rozhraní Graph API a další závislosti (uživateli nebo správci tenanta):

Pokud je aplikace nezávislých výrobců softwaru spuštěná v jiném tenantovi než tenant vizuálu, udělte souhlas pro aplikaci nezávislých výrobců softwaru jedním z následujících způsobů:

  • Předběžné informace správce:

    Postupujte podle pokynů v části Udělení souhlasu správce celého tenanta s aplikací. Nahraďte adresu URL souhlasu správce celého tenanta příslušným odkazem pro každý cloud:

    • COM a GCC: https://login.microsoftonline.com/{organization}/adminconsent?client_id={clientId}
    • CN: https://login.partner.microsoftonline.cn/{organization}/adminconsent?client_id={clientId}
    • GCCHIGH a DOD: https://login.microsoftonline.us/{organization}/adminconsent?client_id={clientId}

  • Interaktivní souhlas:

    Pokud správce tenanta nepřekondčil, obdrží každý uživatel, který používá vizuál, který aktivuje rozhraní API, při vykreslování vizuálu výzvu k vyjádření jednorázového souhlasu. Další informace najdete v tématu Prostředí pro vyjádření souhlasu s aplikací.

Související obsah