Webové rozhraní API, které volá webová rozhraní API: Volání rozhraní API

Jakmile budete mít token, můžete volat chráněné webové rozhraní API. Podřízená rozhraní API obvykle voláte z kontroleru nebo stránek webového rozhraní API.

Kód kontroleru

ASP.NET Core

Pokud používáte Microsoft.Identity.Web, máte tři scénáře použití:

• Možnost 1: Volání Microsoft Graphu pomocí sady SDK
• Možnost 2: Volání podřízeného webového rozhraní API s pomocnou třídou
• Možnost 3: Volání podřízeného webového rozhraní API bez pomocné třídy

Možnost 1: Volání Microsoft Graphu pomocí sady SDK

V tomto scénáři jste přidali balíček NuGet Microsoft.Identity.Web.GraphServiceClient a přidali .AddMicrosoftGraph() jste do Startup.cs , jak je uvedeno v konfiguraci kódu, a můžete přímo vložit GraphServiceClient do kontroleru nebo konstruktoru stránky pro použití v akcích. Následující příklad stránky Razor Page zobrazuje fotku přihlášeného uživatele.

 [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;
         }
     }
 }

Možnost 2: Volání podřízeného webového rozhraní API s pomocnou třídou

V tomto scénáři jste přidali .AddDownstreamApi() Startup.cs, jak je uvedeno v konfiguraci kódu, a můžete přímo vložit IDownstreamWebApi službu do konstruktoru kontroleru nebo stránky a použít ji v akcích:

 [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);
     }

Metoda CallApiForUserAsync má také přepsání silného typu, které umožňují přímo přijímat objekt. Například následující metoda přijala Todo instanci, což je reprezentace JSON se silným typem vráceného webovým rozhraním API.

 // 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);
 }

Možnost 3: Volání podřízeného webového rozhraní API bez pomocné třídy

Pokud jste se rozhodli získat autorizační hlavičku pomocí IAuthorizationHeaderProvider rozhraní, následující kód pokračuje v ukázkovém kódu zobrazeném ve webovém rozhraní API, které volá webová rozhraní API: Získání tokenu pro aplikaci. Kód se volá v akcích kontrolerů rozhraní API. Volá podřízené rozhraní API s názvem todolist.

Po získání tokenu ho použijte jako nosný token k volání podřízeného rozhraní API.

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

Pokud používáte Microsoft.Identity.Web, máte tři možnosti použití pro volání rozhraní API:

• Možnost 1: Volání Microsoft Graphu pomocí sady Microsoft Graph SDK
• Možnost 2: Volání podřízeného webového rozhraní API s pomocnou třídou
• Možnost 3: Volání podřízeného webového rozhraní API bez pomocné třídy

Možnost 1: Volání Microsoft Graphu pomocí sady SDK z aplikace OWIN

Chcete volat Microsoft Graph. V tomto scénáři jste přidali AddMicrosoftGraph Startup.cs, jak je uvedeno v konfiguraci kódu, a můžete získat GraphServiceClient v kontroleru nebo konstruktoru stránky pro použití v akcích pomocí GetGraphServiceClient() metody rozšíření na kontroleru. Následující příklad zobrazí fotku přihlášeného uživatele.

[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;
  }
 }
}

Možnost 2: Volání podřízeného webového rozhraní API s pomocnou třídou z aplikace OWIN

Chcete volat jiné webové rozhraní API než Microsoft Graph. V takovém případě jste přidali AddDownstreamApi Startup.cs, jak je uvedeno v konfiguraci kódu, a službu v kontroleru můžete získat IDownstreamApi voláním GetDownstreamApi metody rozšíření na kontroleru:

[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);
  }
}

Obsahuje CallApiForUserAsync také obecné přepsání silného typu, které umožňují přímo přijímat objekt. Například následující metoda obdrží Todo instanci, což je silné vyjádření JSON vrácené webovým rozhraním API.

    // 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);
    }

Možnost 3: Volání podřízeného webového rozhraní API bez pomocné třídy z aplikace OWIN

Rozhodli jste se získat autorizační hlavičku IAuthorizationHeaderProvider pomocí služby a teď ji musíte použít ve svém HttpClient nebo HttpRequest. V takovém případě následující kód pokračuje v ukázkovém kódu uvedeném ve webovém rozhraní API, které volá webová rozhraní API: Získání tokenu pro aplikaci. Kód se volá v akcích kontrolerů webového rozhraní API.

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

Následující kód pokračuje v ukázkovém kódu, který je zobrazený ve webovém rozhraní API, který volá webová rozhraní API: Získání tokenu pro aplikaci. Kód se volá v akcích kontrolerů rozhraní API. Volá podřízené rozhraní API MS Graph.

Po získání tokenu ho použijte jako nosný token k volání podřízeného rozhraní API.

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

Ukázka demonstrující tento tok pomocí MSAL Pythonu je k dispozici na webu ms-identity-python-on-behalf-of.

Další kroky

• Další informace o vytvoření webové aplikace ASP.NET Core, která přihlašuje uživatele v následující sérii kurzů s více částmi

• Prozkoumání ukázek webového rozhraní API platformy Microsoft Identity Platform