Uma API da Web que chama APIs da Web: chame uma API

Depois de ter um token, você pode chamar uma API da Web protegida. Você geralmente chama as APIs downstream do controlador ou das páginas da sua API da Web.

Código do controlador

ASP.NET Core

Quando você usa Microsoft.Identity.Web, você tem três cenários de uso:

• Opção 1: Chamar o Microsoft Graph com o SDK
• Opção 2: Chamar uma API da Web downstream com a classe auxiliar
• Opção 3: Chamar uma API da Web downstream sem a classe auxiliar

Opção 1: Chamar o Microsoft Graph com o SDK

Nesse cenário, você adicionou o pacote NuGet Microsoft.Identity.Web.GraphServiceClient e adicionou .AddMicrosoftGraph() Startup.cs conforme especificado em Configuração de código, e pode injetar diretamente o GraphServiceClient no controlador ou construtor de página para uso nas ações. A página Razor de exemplo a seguir exibe a foto do usuário conectado.

 [Authorize]
 [AuthorizeForScopes(Scopes = new[] { "user.read" })]
 public class IndexModel : PageModel
 {
     private readonly GraphServiceClient _graphServiceClient;

     public IndexModel(GraphServiceClient graphServiceClient)
     {
         _graphServiceClient = graphServiceClient;
     }

     public async Task OnGet()
     {
         var user = await _graphServiceClient.Me.GetAsync();
         try
         {
             using (var photoStream = await _graphServiceClient.Me.Photo.Content.GetAsync())
             {
                 byte[] photoByte = ((MemoryStream)photoStream).ToArray();
                 ViewData["photo"] = Convert.ToBase64String(photoByte);
             }
             ViewData["name"] = user.DisplayName;
         }
         catch (Exception)
         {
             ViewData["photo"] = null;
         }
     }
 }

Opção 2: Chamar uma API da Web downstream com a classe auxiliar

Nesse cenário, você adicionou .AddDownstreamApi() Startup.cs conforme especificado em Configuração de código e pode injetar diretamente um IDownstreamWebApi serviço em seu controlador ou construtor de página e usá-lo nas ações:

 [Authorize]
 [AuthorizeForScopes(ScopeKeySection = "TodoList:Scopes")]
 public class TodoListController : Controller
 {
     private IDownstreamWebApi _downstreamWebApi;
     private const string ServiceName = "TodoList";

     public TodoListController(IDownstreamWebApi downstreamWebApi)
     {
         _downstreamWebApi = downstreamWebApi;
     }

     public async Task<ActionResult> Details(int id)
     {
         var value = await _downstreamWebApi.CallApiForUserAsync(
             ServiceName,
             options =>
             {
                 options.RelativePath = $"me";
             });
         return View(value);
     }

O CallApiForUserAsync método também tem substituições genéricas fortemente tipadas que permitem que você receba diretamente um objeto. Por exemplo, o método a seguir recebeu uma Todo instância, que é uma representação fortemente tipada do JSON retornado pela API da Web.

 // GET: TodoList/Details/5
 public async Task<ActionResult> Details(int id)
 {
     var value = await _downstreamWebApi.CallApiForUserAsync<object, Todo>(
         ServiceName,
         null,
         options =>
         {
             options.HttpMethod = HttpMethod.Get;
             options.RelativePath = $"api/todolist/{id}";
         });
     return View(value);
 }

Opção 3: Chamar uma API da Web downstream sem a classe auxiliar

Se você decidiu obter um cabeçalho de autorização usando a IAuthorizationHeaderProvider interface, o código a seguir continua o código de exemplo mostrado em Uma API da Web que chama APIs da Web: Adquira um token para o aplicativo. O código é chamado nas ações dos controladores de API. Ele chama uma API downstream chamada todolist.

Depois de adquirir o token, use-o como um token de portador para chamar a API downstream.

private async Task CallTodoListService(string accessToken)
{
  // After the token has been returned by Microsoft.Identity.Web, add it to the HTTP authorization header before making the call to access the todolist service.
  authorizationHeader = await authorizationHeaderProvider.GetAuthorizationHeaderForUserAsync(scopes);
  _httpClient.DefaultRequestHeaders["Authorization"] = authorizationHeader;

  // Call the todolist service.
  HttpResponseMessage response = await _httpClient.GetAsync(TodoListBaseAddress + "/api/todolist");
  // ...
}

ASP.NET

Ao usar Microsoft.Identity.Web, você tem três opções de uso para chamar uma API:

• Opção 1: Chamar o Microsoft Graph com o SDK do Microsoft Graph
• Opção 2: Chamar uma API da Web downstream com a classe auxiliar
• Opção 3: Chamar uma API da Web downstream sem a classe auxiliar

Opção 1: Chamar o Microsoft Graph com o SDK do aplicativo OWIN

Você deseja chamar o Microsoft Graph. Nesse cenário, você adicionou Startup.cs conforme especificado em Configuração de código e pode obter o GraphServiceClient em seu controlador ou construtor de página para uso nas ações usando o GetGraphServiceClient() método extension no controlador. AddMicrosoftGraph O exemplo a seguir exibe a foto do usuário conectado.

[Authorize]
public class HomeController : Controller
{

 public async Task GetIndex()
 {
  var graphServiceClient = this.GetGraphServiceClient();
  var user = await graphServiceClient.Me.GetAsync();
  try
  {
   using (var photoStream = await graphServiceClient.Me.Photo.Content.GetAsync())
   {
    byte[] photoByte = ((MemoryStream)photoStream).ToArray();
    ViewData["photo"] = Convert.ToBase64String(photoByte);
   }
   ViewData["name"] = user.DisplayName;
  }
  catch (Exception)
  {
   ViewData["photo"] = null;
  }
 }
}

Opção 2: Chamar uma API da Web downstream com a classe auxiliar do aplicativo OWIN

Você deseja chamar uma API da Web diferente do Microsoft Graph. Nesse caso, você adicionou Startup.cs conforme especificado em Configuração de código e pode obter IDownstreamApi serviço em seu controlador chamando o GetDownstreamApi método de extensão no controlador: AddDownstreamApi

[Authorize]
public class TodoListController : Controller
{ 
  public async Task<ActionResult> Details(int id)
  {
    var downstreamApi = this.GetDownstreamApi();
    var value = await downstreamApi.CallApiForUserAsync(
      ServiceName,
      options =>
      {
        options.RelativePath = $"me";
      });
      return View(value);
  }
}

O CallApiForUserAsync também tem substituições genéricas fortemente tipadas que permitem que você receba diretamente um objeto. Por exemplo, o método a seguir recebe uma Todo instância, que é uma representação fortemente tipada do JSON retornado pela API da Web.

    // GET: TodoList/Details/5
    public async Task<ActionResult> Details(int id)
    {
        var downstreamApi = this.GetDownstreamApi();
        var value = await downstreamApi.GetForUserAsync<object, Todo>(
            ServiceName,
            null,
            options =>
            {
                options.RelativePath = $"api/todolist/{id}";
            });
        return View(value);
    }

Opção 3: Chamar uma API da Web downstream sem a classe auxiliar do aplicativo OWIN

Você decidiu adquirir um cabeçalho de autorização usando o IAuthorizationHeaderProvider serviço e agora precisa usá-lo no seu HttpClient ou HttpRequest. Nesse caso, o código a seguir continua o código de exemplo mostrado em Uma API da Web que chama APIs da Web: Adquira um token para o aplicativo. O código é chamado nas ações dos controladores de API da Web.

public async Task<IActionResult> Profile()
{
  // Acquire the access token.
  string[] scopes = new string[]{"user.read"};
  var IAuthorizationHeaderProvider = this.GetAuthorizationHeaderProvider();
  string authorizationHeader = await IAuthorizationHeaderProvider.GetAuthorizationHeaderForUserAsync(scopes);

  // Use the access token to call a protected web API.
  HttpClient httpClient = new HttpClient();
  client.DefaultRequestHeaders.Add("Authorization", authorizationHeader);

  var response = await httpClient.GetAsync($"{webOptions.GraphApiUrl}/beta/me");

  if (response.StatusCode == HttpStatusCode.OK)
  {
    var content = await response.Content.ReadAsStringAsync();

    dynamic me = JsonConvert.DeserializeObject(content);
    ViewData["Me"] = me;
  }

  return View();
}

Java

O código a seguir continua o código de exemplo mostrado em Uma API da Web que chama APIs da Web: Adquira um token para o aplicativo. O código é chamado nas ações dos controladores de API. Ele chama a API downstream de MS Graph.

Depois de adquirir o token, use-o como um token de portador para chamar a API downstream.

private String callMicrosoftGraphMeEndpoint(String accessToken){
    RestTemplate restTemplate = new RestTemplate();

    HttpHeaders headers = new HttpHeaders();
    headers.setContentType(MediaType.APPLICATION_JSON);

    headers.set("Authorization", "Bearer " + accessToken);

    HttpEntity<String> entity = new HttpEntity<>(null, headers);

    String result = restTemplate.exchange("https://graph.microsoft.com/v1.0/me", HttpMethod.GET,
            entity, String.class).getBody();

    return result;
}

Python

Um exemplo demonstrando esse fluxo com o MSAL Python está disponível em ms-identity-python-on-behalf-of.

Próximos passos

• Saiba mais criando um aplicativo Web ASP.NET Core que inicia sessão nos utilizadores na seguinte série de tutoriais com várias partes

• Explore exemplos de API da Web da plataforma de identidade da Microsoft