Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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:
- Creare un client con un ID oggetto profilo
- Specificare l'ID del profilo nella chiamata di richiesta API
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.
Contenuti correlati
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