Registrer et Azure AD-program, som skal bruges sammen med Power BI

I disse trin beskrives det, hvordan du registrerer et Microsoft Azure Active Directory-program til løsningen integrering for dine kunder i Power BI.

1. Åbn værktøjet Power BI App Registration.

2. Vælg Integrer indhold for dine kunder i afsnittet Vælg en integreringsløsning.

3. Log på med en bruger, der tilhører din Power BI lejer, i Trin 1 – log på Power BI. Microsoft Azure Active Directory-appen registreres under denne bruger.

   Hvis du allerede er logget på, skal du kontrollere, at du er logget på med den bruger, du vil bruge til at oprette Microsoft Azure Active Directory-appen. Hvis du vil ændre en bruger, skal du vælge linket Log af og logge på igen, når værktøjet er genstartet.

4. Udfyld følgende felter i Trin 2 – Registrer din app:

   • Programnavn – Angiv et navn til appen.

   • API-adgang – Vælg de Power BI-API'er (også kaldet områder), din app har brug for. Du kan bruge Vælg alle for at vælge alle API'erne. Du kan få flere oplysninger om Power BI-adgangstilladelser i Tilladelser og indhold i slutpunktet for Microsoft-identitetsplatformen.

5. Vælg Registrer.

   Microsoft Azure Active Directory-program-id'et vises i feltet Oversigt. Kopiér denne værdi til senere brug.

6. (Valgfrit) I Trin 3 – Opret et arbejdsområde kan du oprette et arbejdsområde i Power BI-tjenesten.

   • Hvis du allerede har et Power BI-arbejdsområde, skal du vælge Spring over.

   • Hvis du vil oprette et arbejdsområde, skal du angive et navn til arbejdsområdet og vælge Opret arbejdsområde. Dit arbejdsområdes navn og id vises i feltet Oversigt. Kopiér disse værdier til senere brug.

   Bemærk

   For at eksempelappen til integreret analyse kan fungere som forventet, skal du oprette et arbejdsområde ved hjælp af værktøjet.

7. (Valgfrit) I Trin 4 – Importer indhold kan du vælge en af følgende indstillinger:

   • Hvis du har din egen Power BI-app, kan du vælge Spring over.

   • Hvis du vil oprette en Power BI-eksempelapp ved hjælp af en eksempelrapport, skal du vælge Power BI-eksempelrapport og derefter vælge Importér.

   • Hvis du vil oprette en Power BI-eksempelapp ved hjælp af din egen rapport, skal du vælge Overfør en .pbix-fil, søge efter filen og derefter vælge Importér.

8. Vælg Giv tilladelser, og vælg Accepter i pop op-vinduet i Trin 5 – Giv tilladelser. Dette gør det muligt for dit Microsoft Azure Active Directory-program at få adgang til de API'er, du har valgt (også kaldet områder) med den bruger, der er logget på. Denne bruger kaldes også masterbruger.

9. (Valgfrit) Hvis du har oprettet et Power BI-arbejdsområde og overført indhold til det ved hjælp af værktøjet, kan du nu vælge Hent prøveprogram. Sørg for at kopiere alle oplysningerne i feltet Oversigt.

I disse trin beskrives det, hvordan du registrerer en Microsoft Azure Active Directory-app til løsningen Integrer indhold for din organisation i Power BI.

1. Åbn værktøjet Power BI App Registration.

2. Vælg Integrer indhold for din organisation i afsnittet Vælg en integreringsløsning.

3. Log på med en bruger, der tilhører din Power BI lejer, i Trin 1 – log på Power BI. Microsoft Azure Active Directory-appen registreres under denne bruger.

   Hvis du allerede er logget på, skal du kontrollere, at du er logget på med den bruger, du vil bruge til at oprette Microsoft Azure Active Directory-appen. Hvis du vil ændre en bruger, skal du vælge linket Log af og logge på igen, når værktøjet er genstartet.

4. Udfyld følgende felter i Trin 2 – Registrer din app:

   • Programnavn – Angiv et navn til appen.

   • URL-adresse til startsiden – Angiv en URL-adresse til din startside.

   • URL-adresse til omdirigering – ved logon kan dine programbrugere omdirigeres til denne adresse, mens dit program modtager en godkendelseskode fra Azure. Vælg en af disse indstillinger:

     • Brug en standard-URL-adresse – Denne indstilling vil automatisk oprette og downloade et prøveprogram til integreret analyse. Standard-URL-adressen er http://localhost:13526/.

     • Brug en brugerdefineret URL-adresse – Vælg denne indstilling, hvis du allerede har et program til integreret analyse, og du ved, hvad du vil bruge som URL-adresse til omdirigering.

   • API-adgang – Vælg de Power BI-API'er (også kaldet områder), din app har brug for. Du kan bruge Vælg alle for at vælge alle API'erne. Du kan få flere oplysninger om Power BI-adgangstilladelser i Tilladelser og indhold i slutpunktet for Microsoft-identitetsplatformen.

5. Vælg Registrer.

   Værdierne for Program-id og Programhemmelighed for Microsoft Azure Active Directory-appen vises i feltet Oversigt. Kopiér disse værdier til senere brug.

6. (Valgfrit) I Trin 3 – Opret et arbejdsområde kan du oprette et arbejdsområde i Power BI-tjenesten.

   • Hvis du allerede har et Power BI-arbejdsområde, skal du vælge Spring over.

   • Hvis du vil oprette et arbejdsområde, skal du angive et navn til arbejdsområdet og vælge Opret arbejdsområde. Dit arbejdsområdes navn og id vises i feltet Oversigt. Kopiér disse værdier til senere brug.

   Bemærk

   For at eksempelappen til integreret analyse kan fungere som forventet, skal du oprette et arbejdsområde ved hjælp af værktøjet.

7. (Valgfrit) I Trin 4 – Importer indhold kan du vælge en af følgende indstillinger:

   • Hvis du har din egen Power BI-app, kan du vælge Spring over.

   • Hvis du vil oprette en Power BI-eksempelapp ved hjælp af en eksempelrapport, skal du vælge Power BI-eksempelrapport og derefter vælge Importér.

   • Hvis du vil oprette en Power BI-eksempelapp ved hjælp af din egen rapport, skal du vælge Overfør en .pbix-fil, søge efter filen og derefter vælge Importér.

8. (Valgfrit) Hvis du har oprettet et Power BI-arbejdsområde og overført indhold til det ved hjælp af værktøjet, kan du nu vælge Hent prøveprogram. Sørg for at kopiere alle oplysningerne i feltet Oversigt.

Brug kun manuel registrering af Azure AD-programmet, hvis du opretter en af følgende løsninger:

• Et program til integrering for din organisation.

• Et program til integrering for dine kunder med en tjenesteprincipal.

  Bemærk

  Hvis du vælger denne mulighed, skal du føje Power BI-tilladelser til det, efter du har registreret dit Azure AD-program.

Du kan finde flere oplysninger om, hvordan du registrerer programmer i Microsoft Azure Active Directory i Registrer et program med Azure Active Directory.

1. Log på Azure-portalen.

2. Vælg din Microsoft Azure Active Directory-lejer ved at vælge din konto i øverste højre hjørne af siden.

3. Vælg Programregistreringer. Hvis du ikke kan se denne indstilling, skal du søge efter den.

4. Vælg Ny registrering i Programregistreringer.

5. Udfyld følgende felter:

   • Navn – Angiv et navn på programmet.

   • Understøttet kontotype – Vælg, hvem der kan bruge programmet.

6. (Valgfrit) Tilføj en URL-adresse til omdirigering i Omdirigerings-URI.

7. Vælg Registrer. Når din app er registreret, sendes du videre til appens oversigtsside, hvor du kan hente program-id'et.

I Azure Portal kan du få vist din app og foretage ændringer af dens tilladelser.

1. Log på Azure-portalen.

2. Vælg din Microsoft Azure Active Directory-lejer ved at vælge din konto i øverste højre hjørne af siden.

3. Vælg Programregistreringer. Hvis du ikke kan se denne indstilling, skal du søge efter den.

4. Vælg dit program på fanen Ejede programmer. Programmet åbnes under fanen Oversigt, hvor du kan gennemse program-id'et.

5. Vælg fanen API-tilladelser.

6. Følg disse trin for at tilføje tilladelser:

   1. Vælg Tilføj en tilladelse, og vælg derefter Power BI-tjeneste.

   2. Vælg Delegerede tilladelser, og tilføj eller fjern de specifikke tilladelser, du har brug for.

   3. Vælg Tilføj tilladelser, når du er færdig, for at gemme dine ændringer.

7. Følg disse trin for at fjerne en tilladelse:

   1. Vælg ellipsen (...) til højre for tilladelsen.

   2. Vælg Fjern tilladelse.

   3. Vælg Ja, fjern i pop op-vinduet Fjern tilladelse.

Hvis du vil ændre dine Microsoft Azure Active Directory-apptilladelser via programmering, skal du hente de eksisterende tjeneste principaler (brugere) i din lejer. Du kan finde oplysninger om, hvordan du gør det, i servicePrincipal.

1. Hvis du vil hente alle tjenesteprincipalerne i din lejer, skal du kalde Get servicePrincipalAPI'en uden {ID}.

2. Kig efter en tjenesteprincipal med appens program-id som appId-egenskaben.

   Post https://graph.microsoft.com/v1.0/servicePrincipals HTTP/1.1
   Authorization: Bearer ey..qw
   Content-Type: application/json
   {
   "accountEnabled" : true,
   "appId" : "{App_Client_ID}",
   "displayName" : "{App_DisplayName}"
   }
   

   Bemærk

   displayName er valgfri.

3. Tildel Power BI-tilladelser til din app ved at tildele en af disse værdier til consentType:

   • AllPrincipals – Kan kun bruges af en Power BI-administrator til at tildele tilladelser på vegne af alle brugerne i lejeren.

   • Principal – Bruges til at give tilladelser på vegne af en bestemt bruger. Hvis du bruger denne indstilling, skal du føje egenskaben principalId={User_ObjectId} til anmodningens brødtekst.

   Post https://graph.microsoft.com/v1.0/OAuth2PermissionGrants HTTP/1.1
   Authorization: Bearer ey..qw
   Content-Type: application/json
   {
   "clientId":"{Service_Plan_ID}",
   "consentType":"AllPrincipals",
   "resourceId":"c78a3685-1ce7-52cd-95f7-dc5aea8ec98e",
   "scope":"Dataset.ReadWrite.All Dashboard.Read.All Report.Read.All Group.Read Group.Read.All Content.Create Metadata.View_Any Dataset.Read.All Data.Alter_Any",
   "expiryTime":"2018-03-29T14:35:32.4943409+03:00",
   "startTime":"2017-03-29T14:35:32.4933413+03:00"
   }
   

   Bemærk

   • Hvis du bruger en masterbruger for at undgå at blive bedt om samtykke af Microsoft Azure Active Directory, skal du give tilladelser til masterkontoen.
   • resourceId c78a3685-1ce7-52cd-95f7-dc5aea8ec98e er lejerafhængig og ikke universel. Denne værdi er objectId for programmet Power BI-tjeneste i Microsoft Azure Active Directory. Hvis du vil hente denne værdi fra Azure Portal, skal du gå til Virksomhedsprogrammer > Alle programmer og søge efter Power BI-tjeneste.

4. Tildel apptilladelser til Microsoft Azure Active Directory ved at tildele en værdi til consentType.

   Post https://graph.microsoft.com/v1.0/OAuth2PermissionGrants HTTP/1.1
   Authorization: Bearer ey..qw
   Content-Type: application/json
   {
   "clientId":"{Service_Plan_ID}",
   "consentType":"AllPrincipals",
   "resourceId":"61e57743-d5cf-41ba-bd1a-2b381390a3f1",
   "scope":"User.Read Directory.AccessAsUser.All",
   "expiryTime":"2018-03-29T14:35:32.4943409+03:00",
   "startTime":"2017-03-29T14:35:32.4933413+03:00"
   }
   

Du kan også ændre tilladelser til din Microsoft Azure Active Directory-app ved hjælp af C#. Du kan finde flere oplysninger under API'en oAuth2PermissionGrant. Denne metode kan være nyttig, hvis du overvejer at automatisere nogle af dine processer.

Du kan finde flere oplysninger om HTTP-anmodninger under fanen HTTP.

var graphClient = GetGraphClient();

currentState.createdApp = await graphClient.Applications
    .Request()
    .AddAsync(application);

System.Threading.Thread.Sleep(2000);

var passwordCredential = new PasswordCredential
{
    DisplayName = "Client Secret Created in C#"
};

currentState.createdSecret = await graphClient.Applications[currentState.createdApp.Id]
    .AddPassword(passwordCredential)
    .Request()
    .PostAsync();

var servicePrincipal = new ServicePrincipal
{
    AppId = currentState.createdApp.AppId
};

currentState.createdServicePrincipal = await graphClient.ServicePrincipals
    .Request()
    .AddAsync(servicePrincipal);

GraphServiceClient graphClient = new GraphServiceClient(authProvider);

// Use oAuth2PermissionGrant to change permissions
var oAuth2PermissionGrant = await graphClient.Oauth2PermissionGrants["{id}"]
               .Request()
               .GetAsync();