可呼叫 Web API 的 Web API：呼叫 API

取得權杖之後，就可以呼叫受保護的 Web API。 您通常從 Web API 的控制器或頁面呼叫下游 API。

控制器程式碼

ASP.NET Core

當您使用 Microsoft.Identity.Web 時，有三種使用案例：

• 選項 1：使用 SDK 呼叫 Microsoft Graph
• 選項 2：使用協助程式類別呼叫下游 Web API
• 選項 3：在不使用協助程式類別的情況下呼叫下游 Web API

選項 1：使用 SDK 呼叫 Microsoft Graph

在此案例中，您已新增 Microsoft.Identity.Web.GraphServiceClient NuGet 套件，並已依照程式碼設定中的指定在 Startup.cs 中新增 .AddMicrosoftGraph()，您可以直接在控制器或頁面建構函式中插入 GraphServiceClient，並於動作中使用。 下列範例 Razor 頁面顯示已登入使用者的相片。

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

選項 2：使用協助程式類別呼叫下游 Web API

在此案例中，您已依照程式碼設定中的指示在 Startup.cs 中新增 .AddDownstreamApi()，您可以直接在控制器或頁面建構函式中插入 IDownstreamWebApi 服務，並於動作中使用：

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

CallApiForUserAsync 方法也有強型別泛型覆寫，可讓您直接接收物件。 例如，下列方法已接收 Todo 執行個體，此為 Web API 所傳回 JSON 的強型別表示法。

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

選項 3：在不使用協助程式類別的情況下呼叫下游 Web API

如果您決定使用 IAuthorizationHeaderProvider 介面取得授權標頭，則以下程式碼會繼續呼叫 Web API 的 Web API：取得應用程式的權杖中所示的範例程式碼。 Web API 控制器的動作中呼叫這段程式碼。 其會呼叫名為 todolist 的下游 API。

取得權杖之後，就當作為持有人權杖來呼叫下游 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

使用 Microsoft.Identity.Web 時，呼叫 API 有三種使用方式選項：

• 選項 1：使用 Microsoft Graph SDK 呼叫 Microsoft Graph
• 選項 2：使用協助程式類別呼叫下游 Web API
• 選項 3：在不使用協助程式類別的情況下呼叫下游 Web API

選項 1：使用 OWIN 應用程式中的 SDK 呼叫 Microsoft Graph

您想要呼叫 Microsoft Graph。 在此案例中，您已依照程式碼設定中的指定在 Startup.cs 中新增 AddMicrosoftGraph，您可以使用控制器上的 GetGraphServiceClient() 擴充方法在控制器或頁面建構函式中取得 GraphServiceClient 以在動作中使用。 下列範例顯示已登入使用者的相片。

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

選項 2：使用 OWIN 應用程式中的協助程式類別呼叫下游 Web API

您想要呼叫 Web API 而不是 Microsoft Graph。 在此情況下，您已依照程式碼設定中的指定在 Startup.cs 中新增 AddDownstreamApi，您可以透過呼叫控制器上的 GetDownstreamApi 擴充方法在控制器中取得 IDownstreamApi 服務。

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

CallApiForUserAsync 也有強型別泛型覆寫，可讓您直接接收物件。 例如，下列方法接收 Todo 執行個體，此為 Web API 所傳回 JSON 的強型別表示法。

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

選項 3：在不使用 OWIN 應用程式中的協助程式類別的情況下呼叫下游 Web API

您已決定使用 IAuthorizationHeaderProvider 服務取得授權標頭，現在您必須在 HttpClient 或 HttpRequest 中使用。 在此情況下，下列程式碼延續呼叫 Web API 的 Web API：取得應用程式的權杖中顯示的範例程式碼。 在 Web 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

下列程式碼延續呼叫 Web API 的 Web API：取得應用程式的權杖中顯示的範例程式碼。 Web API 控制器的動作中呼叫這段程式碼。 其會呼叫下游 API MS Graph。

取得權杖之後，就當作為持有人權杖來呼叫下游 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

您可在 ms-identity-python-on-behalf-of 中取得使用 MSAL Python 來示範此流程的範例。

下一步

• 若要深入了解，請在下列多部分教學課程系列中建置可登入使用者的 ASP.NET Core Web 應用程式

• 探索 Microsoft 身分識別平台 Web API 範例