Inicio rápido de Fabric API

Introducción

Para trabajar con las API de Fabric, como muchos otros servicios de Microsoft, primero debe obtener un token de Microsoft Entra para el servicio Fabric y, a continuación, usar ese token en el encabezado de autorización de la llamada API.

En este tutorial de inicio rápido, creará una aplicación de consola de C#, que adquirirá un token de ID de Entra mediante la biblioteca MSAL.Net y, a continuación, usará HttpClient de C# para llamar a la API de lista de áreas de trabajo.

Creación de un registro de aplicaciones

Para obtener un token de Microsoft Entra, primero debe registrar una aplicación con el identificador de Microsoft Entra.

Para obtener más información sobre cómo registrar una aplicación y diferentes propiedades de la aplicación y cómo podría aplicarse a su escenario, consulte Registro de una aplicación en la plataforma de identidad de Microsoft.

En este tutorial de inicio rápido, creará un cliente público con URI de redirección = http://localhost

1. Inicie sesión en el Centro de administración de Microsoft Entra siendo al menos un Administrador de aplicaciones en la nube.

2. Vaya a Registros de aplicaciones > .

3. Haga clic en Nuevo registro.

4. Escriba un nombre para mostrar para la aplicación y agregue el URI de redirección de cliente público. http://localhost

   

5. Seleccione Registrar.

6. Copie el identificador de aplicación (cliente) y péguelo en un Bloc de notas que se usará más adelante.

Obtener el token

En este tutorial, utilizará MSAL.Net para adquirir un token de Entra ID para el servicio Fabric con los siguientes ámbitos: Workspace.ReadWrite.All, Item.ReadWrite.All.

Para obtener más información sobre la adquisición de tokens con MSAL.Net, consulte Adquisición de tokens: Biblioteca de autenticación de Microsoft para .NET.

Pegue el identificador de aplicación (cliente) que copió anteriormente y péguelo para la variable ClientId.

Ejemplo de código de C# para adquirir un token de acceso de Microsoft Entra

#region parameters section 
string ClientId = "YourApplicationId"; 
string Authority = "https://login.microsoftonline.com/organizations"; 
string RedirectURI = "http://localhost"; 
#endregion 

#region Acquire a token for Fabric APIs 
// In this sample we acquire a token for Fabric service with the scopes  
// Workspace.ReadWrite.All and Item.ReadWrite.All 
string[] scopes = new string[] { "https://api.fabric.microsoft.com/Workspace.ReadWrite.All https://api.fabric.microsoft.com/Item.ReadWrite.All" }; 

PublicClientApplicationBuilder PublicClientAppBuilder = 
        PublicClientApplicationBuilder.Create(ClientId) 
        .WithAuthority(Authority) 
        .WithRedirectUri(RedirectURI); 

IPublicClientApplication PublicClientApplication = PublicClientAppBuilder.Build(); 

AuthenticationResult result = await PublicClientApplication.AcquireTokenInteractive(scopes) 
        .ExecuteAsync() 
        .ConfigureAwait(false); 

Console.WriteLine(result.AccessToken); 
#endregion 

API de espacios de trabajo para listas de llamadas

En esta sección, podrá:

1. Cree el HttpClient de C# con el token que se adquirió en la sección anterior.
2. Agregue https://api.fabric.microsoft.com/v1/ como dirección URL base para el cliente.
3. Llamar a la API de espacios de trabajo y escribir la respuesta en la consola.

Ejemplo de código de C# para crear un cliente http y llamar a List Workspaces API

// Create client 
HttpClient client = new HttpClient(); 
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", result.AccessToken); 
string baseUrl = "https://api.fabric.microsoft.com/v1/"; 
client.BaseAddress = new Uri(baseUrl); 

// Call list workspaces API 
HttpResponseMessage response = await client.GetAsync("workspaces"); 
string responseBody = await response.Content.ReadAsStringAsync(); 
Console.WriteLine(responseBody); 

Ejemplo completo de código de aplicación de consola de C#

using Microsoft.Identity.Client; 
using System.Net.Http.Headers; 

#region parameters section 
string ClientId = "YourApplicationId";  
string Authority = "https://login.microsoftonline.com/organizations"; 
string RedirectURI = "http://localhost";  
#endregion 

#region Acquire a token for Fabric APIs 
// In this sample we acquire a token for Fabric service with the scopes Workspace.ReadWrite.All and Item.ReadWrite.All 
string[] scopes = new string[] { "https://api.fabric.microsoft.com/Workspace.ReadWrite.All https://api.fabric.microsoft.com/Item.ReadWrite.All" }; 

PublicClientApplicationBuilder PublicClientAppBuilder = 
        PublicClientApplicationBuilder.Create(ClientId) 
        .WithAuthority(Authority) 
        .WithRedirectUri(RedirectURI); 

IPublicClientApplication PublicClientApplication = PublicClientAppBuilder.Build(); 

AuthenticationResult result = await PublicClientApplication.AcquireTokenInteractive(scopes) 
        .ExecuteAsync() 
        .ConfigureAwait(false); 

Console.WriteLine(result.AccessToken); 
#endregion 

#region Create an HTTP client and call the Fabric APIs 
// Create client 
HttpClient client = new HttpClient(); 
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", result.AccessToken); 
string baseUrl = "https://api.fabric.microsoft.com/v1/"; 
client.BaseAddress = new Uri(baseUrl); 

// Call list workspaces API 
HttpResponseMessage response = await client.GetAsync("workspaces"); 
string responseBody = await response.Content.ReadAsStringAsync(); 
Console.WriteLine(responseBody); 
#endregion