Web API'lerini çağıran bir web API'si: API çağırma

Belirteciniz olduktan sonra korumalı bir web API'sini çağırabilirsiniz. Aşağı akış API'lerini genellikle web API'nizin denetleyicisinden veya sayfalarından çağırırsınız.

Denetleyici kodu

ASP.NET Core

Microsoft.Identity.Web kullandığınızda üç kullanım senaryonuz vardır:

• 1. Seçenek: SDK ile Microsoft Graph'ı çağırma
• Seçenek 2: Yardımcı sınıfıyla aşağı akış web API'sini çağırma
• Seçenek 3: Yardımcı sınıfı olmadan aşağı akış web API'sini çağırma

1. Seçenek: SDK ile Microsoft Graph'ı çağırma

Bu senaryoda, Microsoft.Identity.Web.GraphServiceClient NuGet paketini eklediniz ve Kod yapılandırmasında belirtildiği gibi Startup.cs'a eklediniz .AddMicrosoftGraph() ve doğrudan eylemlerde kullanmak üzere denetleyicinize veya sayfa oluşturucunuza öğesini ekleyebilirsiniz.GraphServiceClient Aşağıdaki örnek Razor sayfasında oturum açmış kullanıcının fotoğrafı görüntülenir.

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

Seçenek 2: Yardımcı sınıfıyla aşağı akış web API'sini çağırma

Bu senaryoda, Kod yapılandırmasında belirtildiği gibi Startup.cs eklediniz .AddDownstreamApi() ve doğrudan denetleyicinize veya sayfa oluşturucunuza bir IDownstreamWebApi hizmet ekleyebilir ve eylemlerde kullanabilirsiniz:

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

yöntemi CallApiForUserAsync , doğrudan bir nesne almanıza olanak tanıyan kesin olarak belirlenmiş genel geçersiz kılmalara da sahiptir. Örneğin, aşağıdaki yöntem, web API'sinin döndürdiği JSON'un kesin olarak belirlenmiş bir gösterimi olan bir Todo örnek aldı.

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

Seçenek 3: Yardımcı sınıfı olmadan aşağı akış web API'sini çağırma

Arabirimi kullanarak IAuthorizationHeaderProvider bir yetkilendirme üst bilgisi almaya karar verdiyseniz, aşağıdaki kod Web API'lerini çağıran bir web API'sinde gösterilen örnek koda devam eder: Uygulama için belirteç alma. Kod, API denetleyicilerinin eylemlerinde çağrılır. Todolist adlı bir aşağı akış API'sini çağırır.

Belirteci aldıktan sonra, aşağı akış API'sini çağırmak için taşıyıcı belirteç olarak kullanın.

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 kullandığınızda, API çağırmak için üç kullanım seçeneğiniz vardır:

• 1. Seçenek: Microsoft Graph SDK'sı ile Microsoft Graph'ı çağırma
• Seçenek 2: Yardımcı sınıfıyla aşağı akış web API'sini çağırma
• Seçenek 3: Yardımcı sınıfı olmadan aşağı akış web API'sini çağırma

1. Seçenek: OWIN uygulamasından SDK ile Microsoft Graph'ı çağırma

Microsoft Graph'ı aramak istiyorsunuz. Bu senaryoda kod yapılandırmasında belirtildiği gibi Startup.cs eklediniz AddMicrosoftGraph ve denetleyicideki uzantı yöntemini kullanarak GetGraphServiceClient() denetleyicinizde veya sayfa oluşturucunuzdaki öğesini eylemlerde kullanmak üzere alabilirsiniz.GraphServiceClient Aşağıdaki örnekte oturum açmış kullanıcının fotoğrafı görüntülenir.

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

Seçenek 2: OWIN uygulamasından yardımcı sınıfıyla aşağı akış web API'sini çağırma

Microsoft Graph dışında bir web API'sini çağırmak istiyorsunuz. Bu durumda kod yapılandırmasında belirtildiği gibi Startup.cs eklediniz AddDownstreamApi ve denetleyicide uzantı yöntemini çağırarak GetDownstreamApi denetleyicinize hizmet alabilirsinizIDownstreamApi:

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

ayrıca CallApiForUserAsync , doğrudan bir nesne almanıza olanak tanıyan kesin olarak belirlenmiş genel geçersiz kılmalara sahiptir. Örneğin, aşağıdaki yöntem, web API'sinin döndürdiği JSON'un kesin olarak belirlenmiş bir gösterimi olan bir Todo örneği alır.

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

Seçenek 3: OWIN uygulamasından yardımcı sınıfı olmadan aşağı akış web API'sini çağırma

Hizmeti kullanarak IAuthorizationHeaderProvider bir yetkilendirme üst bilgisi almaya karar verdiniz ve şimdi bunu veya HttpRequestiçinde HttpClient kullanmanız gerekiyor. Bu durumda, aşağıdaki kod Web API'lerini çağıran bir web API'sinde gösterilen örnek koda devam eder: Uygulama için belirteç alma. Kod, web API denetleyicilerinin eylemlerinde çağrılır.

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

Aşağıdaki kod, Web API'lerini çağıran bir web API'sinde gösterilen örnek koda devam eder: Uygulama için belirteç alma. Kod, API denetleyicilerinin eylemlerinde çağrılır. Aşağı akış API'sini MS Graph olarak çağırır.

Belirteci aldıktan sonra, aşağı akış API'sini çağırmak için taşıyıcı belirteç olarak kullanın.

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

MSAL Python ile bu akışı gösteren bir örnek, ms-identity-python-on-half-of adresinde bulunabilir.

Sonraki adımlar

• Aşağıdaki çok bölümlü öğretici serisinde kullanıcıların oturumunu kuran bir ASP.NET Core web uygulaması oluşturarak daha fazla bilgi edinin

• Microsoft kimlik platformu web API'si örneklerini keşfetme