Usare SDK di Power BI con i profili del service principal

Questo articolo illustra come usare l'SDK con i profili del service principal.

Note

Questi esempi si applicano alle applicazioni che hanno selezionato la soluzione facoltativa Profili del service principal. Per le nuove soluzioni multi-tenancy, iniziare con i service principal dedicati del cliente, usando l'identità gestita e la federazione in base ai requisiti. Un ID profilo non è un ID principale di Microsoft Entra e non può essere usato come identità con le API REST di Fabric.

Se le limitazioni del profilo vincolano la soluzione, vedere Sostituire i profili dell'entità servizio con le entità servizio. In caso contrario, continuare a usare i modelli SDK basati su profilo in questo articolo.

Esistono due modi per connettere un client Power BI a un profilo del service principal. È possibile:

Dopo che il client è associato a un profilo, è possibile ottenere il profilo del service principal corrente dal client Power BI.

Creare un client Power BI con un profilo del service principal

var profileObjectId = new Guid("81f24a6d-7ebb-4478-99c7-2c36f7870a26"); 
var powerBIclient = new PowerBIClient(credentials, profileObjectId: profileObjectId);

Quando si crea un client Power BI con l'ID oggetto del profilo, ogni chiamata API che usa il client ha X-PowerBI-profile-id nell'intestazione della richiesta.

Ad esempio:

GET https://powerbiapi.analysis-df.windows.net/v1.0/myorg/groups


Authorization: Bearer eyJ0eXAiO.....5U_g
X-PowerBI-profile-id: 81f24a6d-7ebb-4478-99c7-2c36f7870a26

Impostare il profilo nella chiamata API

In alternativa, è possibile specificare l'ID del profilo nella richiesta API usando la proprietà customHeaders nel metodo PowerBIClient con overload dell'API WithHttpMessagesAsync.

var powerBIclient = new PowerBIClient(credentials); 
var profileHeader = new Dictionary<string, List<string>>(); 
profileHeader.Add("X-PowerBI-profile-id", new List<string> { "81f24a6d-7ebb-4478-99c7-2c36f7870a26" }); 
var groups = await powerBIclient.Groups.GetGroupsWithHttpMessagesAsync(customHeaders: profileHeader); 

Ad esempio:

GET https://powerbiapi.analysis-df.windows.net/v1.0/myorg/groups 

Authorization: Bearer eyJ0eXAiO.....5U_g 
X-PowerBI-profile-id: 81f24a6d-7ebb-4478-99c7-2c36f7870a26 

Nell'esempio di codice precedente, l'intestazione del profilo non fa parte delle intestazioni predefinite del client, perché il codice non aggiunge l'intestazione del profilo. È necessario specificare l'intestazione del profilo con ogni richiesta API.

Assicurarsi di evitare duplicazioni. Ad esempio, la creazione di un client con un ID oggetto profilo e la specifica dell'intestazione con la richiesta API genera errori non autorizzati.

Ottenere il profilo corrente del service principal dal client Power BI

Per recuperare il profilo del service principal corrente dal client SDK, chiamare GetServicePrincipalProfileObjectId.

var profileObjectId = new Guid("81f24a6d-7ebb-4478-99c7-2c36f7870a26"); 
var powerBIclient = new PowerBIClient(credentials, profileObjectId: profileObjectId); 
var currentProfileObjectId = powerBIclient.GetServicePrincipalProfileObjectId(); 

Considerazioni e limitazioni

Non è disponibile alcun supporto per i profili dell'entità servizio con Azure Analysis Services (AAS) in modalità di connessione live.

Per la governance delle identità, la compatibilità delle API e altre restrizioni, vedere Limitazioni di identità e API.

Dopo la migrazione di un cliente a un'entità servizio/service principal dedicata, autenticate le richieste usando il token di accesso dell'applicazione del cliente. Non configurare un ID oggetto profilo o inviare l'intestazione profile-selection per la route migrata. La modifica dell'intestazione da sola non è una migrazione: la nuova identità deve prima ricevere le autorizzazioni necessarie per l'area di lavoro e le risorse. Vedere Sostituire i profili del service principal con i service principal.

Multi-tenancy con service principal dedicati

Profili dell'entità servizio: una soluzione multitenancy facoltativa

Profili del service principal in Power BI Embedded

Sostituire i profili dell'entità servizio con le entità servizio