Del via

Installasjon av Microsoft Entra ID-program

  • Artikkel

Hvis du vil bruke godkjennings-API-en, må ISV først registrere et program i Microsoft Entra ID for at hver sky skal støttes, og forhåndsautorisere Power BI-programmene med et dedikert omfang for hvert visualobjekt. Leieradministratoren må deretter gi samtykke. Denne artikkelen beskriver alle disse viktige trinnene.

Godkjennings-API-en støttes i følgende skyer:

  • COM (obligatorisk) – kommersiell sky
  • CN - Kina Cloud
  • GCC – US Government Community Cloud
  • GCCHIGH – US Government Community Cloud High
  • DOD – US Department of Defense Cloud

Registrere appen i Microsoft Entra ID

Følg disse trinnene for hver sky visualobjektet er ment å støtte:

  1. Gå til den respektive Azure-portalen, og gå til appregistreringer.

  2. Velg + ny registrering

    Skjermbilde av Microsoft Entra-appens nye registreringsgrensesnitt.

  3. Gjør følgende på siden Registrer et program :

    1. Skriv inn ønsket programnavn i Navn-delen .
    2. Velg Kontoer i en hvilken som helst organisasjonskatalog (Hvilken som helst Azure AD-katalog – multitenant) i delen Støttede kontotyper .
    3. Velg Registrer.

    Skjermbilde av Siden Registrer en app i registreringsappen for Microsoft Entra ID.

  4. Når programmet er registrert, velger du Vis en API på menyen til venstre.

    Skjermbilde av Vise en API-side i Registreringsappen for Microsoft Entra ID.

  5. Velg Legg til i URI-feltet program-ID.

    Skjermbilde av Vise en API-side med alternativet for å legge til en program-ID-URI.

  6. Skriv inn det bekreftede egendefinerte domenet i URI-feltet Rediger program-ID, slik at det begynner med «https://» og ikke inneholder «onmicrosoft.com», og velg Lagre.

    Slik legger du til et egendefinert domene:

    1. Gå til egendefinerte domenenavn for Microsoft Entra ID.
    2. Legg til det egendefinerte domenet.

    Skjermbilde av Vis en API-side med Rediger program-ID-URI-siden åpen.

    Merk

    Program-URI-en kan legges til manuelt i programmanifestet under identifikator-matrisen.

    Skjermbilde som viser et eksempel på kode for å legge til en program-URI.

  7. Velg + Legg til et omfang.

  8. Skriv inn <visual_guid>_CV_ForPBI i Områdenavn-feltet, og legg til den nødvendige informasjonen. Fyll ut feltene for administratorsamtykke. Velg deretter Legg til omfang-knappen . (Det er en begrensning av omfangslengde på 40 tegn, men du kan manuelt endre omfangsnavnet i det registrerte programmanifestet for å administrere denne begrensningen).

    Skjermbilde av rediger et omfangsvindu med felt for omfangsnavn og annen informasjon.

  9. Slik forhåndsautoriserer du Power BI-programmer:

    1. Velg + Legg til et klientprogram.

      Skjermbilde av rediger et omfangsvindu med felt for å legge til et klientprogram.

    2. Skriv inn Power BI WFE-programapp-ID-en i Klient-ID-feltet i vinduet til høyre.

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

    3. Velg ønsket omfang.

    4. Velg Legg til program.

      Skjermbilde som viser brukergrensesnittet for å legge til et klientprogram.

    5. Gjenta denne prosessen med:

      • Power BI Desktop:

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

      • Power BI for mobilenheter:

        • COM (obligatorisk) og CN: «c0d2a505-13b8-4ae0-aa9e-cddd5eab0b12».
        • GCC, GCCHIGH og DOD: "ce76e270-35f5-4bea-94ff-eab975103dc6".

Leieradministratoren kan avgjøre om brukere har lov til å samtykke for seg selv. Denne samtykkeprosessen foregår utenfor Power BI.

ISV-serverdelprogram (for eksempel https://contoso.com) må samtykkes til Graph API og andre avhengigheter (av brukere eller leieradministratorer) i henhold til standard AAD-regler:

Hvis ISV-programmet kjører på en annen leier enn den visuelle forbrukerens tenant, kan du gi samtykke til ISV-programmet på én av følgende måter:

  • Administratorpreconsent:

    Følg instruksjonene i gi administratorsamtykke for hele leieren til et program. Erstatt url-adressen for administratorsamtykke for hele tenanten med den respektive koblingen for hver sky:

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

  • Interaktivt samtykke:

    Hvis leieradministratoren ikke forhåndskonsentrerte, mottar alle brukere som bruker et visualobjekt som utløser API-en, en engangssamtykkemelding når visualobjektet gjengis. Se opplevelsen for programsamtykke hvis du vil ha mer informasjon.

Relatert innhold