Anropa ett ASP.NET Core-webb-API med cURL

Förutsättningar

Registrera ett program med Microsofts identitetsplattform

Microsofts identitetsplattform kräver att ditt program registreras innan du tillhandahåller identitets- och åtkomsthanteringstjänster. Med programregistreringen kan du ange namnet och typen av programmet och inloggningspubliken. Inloggningspubliken anger vilka typer av användarkonton som tillåts logga in på ett visst program.

Registrera webbappen

Att ha ett webb-API räcker dock inte eftersom en webbapp också behövs för att hämta en åtkomsttoken för att få åtkomst till webb-API:et som du har skapat.

Följ dessa steg för att skapa registrering av webbappar:

När registreringen är klar visas appregistreringen i fönstret Översikt . Registrera katalog-ID:t (klient)-ID:t och program-ID:t (klient) som ska användas i senare steg.

Lägga till en klienthemlighet

En klienthemlighet är ett strängvärde som appen kan använda för själva identiteten och kallas ibland för ett programlösenord. Webbappen använder klienthemligheten för att bevisa sin identitet när den begär token.

Följ dessa steg för att konfigurera en klienthemlighet:

1. I fönstret Översikt går du till Hantera och väljer Certifikat och hemligheter>Klienthemligheter>Ny klienthemlighet.

2. Lägg till en beskrivning för din klienthemlighet, till exempel Min klienthemlighet.

3. Välj en förfallotid för hemligheten eller ange en anpassad livslängd.

   • En klienthemlighets livslängd är begränsad till två år (24 månader) eller mindre. Du kan inte ange en anpassad livslängd som är längre än 24 månader.
   • Microsoft rekommenderar att du anger ett förfallovärde på mindre än 12 månader.

4. Välj Lägg till.

5. Se till att registrera värdet för klienthemligheten. Det här hemliga värdet visas aldrig igen när du har lämnat den här sidan.

Lägga till programbehörigheter för att tillåta åtkomst till ett webb-API

Genom att ange webb-API:ets omfång i webbappregistreringen kan webbappen hämta en åtkomsttoken som innehåller de omfång som tillhandahålls av Microsofts identitetsplattform. I koden kan webb-API:et sedan ge behörighetsbaserad åtkomst till dess resurser baserat på de omfång som finns i åtkomsttoken.

Följ dessa steg för att konfigurera webbappens behörigheter till webb-API:et:

1. I fönstret Översikt i webbprogrammet (web-app-that-calls-web-api) under Hantera väljer du API-behörigheter>Lägg till behörighets-API>:er som min organisation använder.
2. Välj NewWebAPI1 eller det API som du vill lägga till behörigheter till.
3. Markera kryssrutan bredvid Forecast.Read under Välj behörigheter. Du kan behöva expandera behörighetslistan. Detta väljer de behörigheter som klientappen ska ha för den inloggade användarens räkning.
4. Välj Lägg till behörigheter för att slutföra processen.

När du har lagt till dessa behörigheter i ditt API bör du se de valda behörigheterna under Konfigurerade behörigheter.

Du kan också märka behörigheten User.Read för Microsoft Graph-API:et. Den här behörigheten läggs till automatiskt när du registrerar en app.

Begära en auktoriseringskod

Auktoriseringskodflödet börjar med att klienten dirigerar användaren till /authorize slutpunkten. I den här begäran begär klienten behörigheten Forecast.Read från användaren.

https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/authorize?client_id={web-app-calls-web-api_application_client_id}&response_type=code&redirect_uri=http://localhost&response_mode=query&scope=api://{web_API_application_client_id}/Forecast.Read

1. Kopiera URL:en, ersätt följande parametrar och klistra in den i webbläsaren:

   • {tenant_id} är webbappens katalog-ID (klientorganisation).
   • {web-app-calls-web-api_application_client_id}är program-ID:t (klient) i webbappens översiktsfönster (web-app-calls-web-api).
   • {web_API_application_client_id}är program-ID :t (klient) i webb-API:ets översiktsfönster (NewWebAPI1).

2. Logga in som en användare i Microsoft Entra-klientorganisationen där apparna är registrerade. Godkänn eventuella begäranden om åtkomst, om det behövs.

3. Webbläsaren omdirigeras till http://localhost/. Läs webbläsarens navigeringsfält och kopiera det som {authorization_code} ska användas i följande steg. URL:en har formen av följande kodfragment:

   http://localhost/?code={authorization_code}
   

Använda en auktoriseringskod och cURL för att hämta en åtkomsttoken

cURL kan nu användas för att begära en åtkomsttoken från Microsofts identitetsplattform.

1. Kopiera cURL-kommandot i följande kodfragment. Ersätt värdena i parenteser med följande parametrar till terminalen. Se till att ta bort parenteserna:

   • Våldsamt slag
   • Kommandotolken för Windows

   curl -X POST https://login.microsoftonline.com/{tenant_id}/oauth2/v2.0/token \
   -d 'client_id={web-app-calls-web-api_application_client_id}' \
   -d 'api://{web_API_application_client_id}/Forecast.Read' \
   -d 'code={authorization_code}&session_state={web-app-calls-web-api_application_client_id}' \
   -d 'redirect_uri=http://localhost' \
   -d 'grant_type=authorization_code' \
   -d 'client_secret={client_secret}'
   

   • {tenant_id} är webbappens katalog-ID (klientorganisation).
   • client_id={web-app-calls-web-api_application_client_id}, och session_state={web-app-calls-web-api_application_client_id} är program-ID:t (klient) i webbprogrammets översiktsfönster (web-app-calls-web-api).
   • api://{web_API_application_client_id}/Forecast.Readär program-ID :t (klient) i webb-API:ets översiktsfönster (NewWebAPI1).
   • code={authorization_code} är auktoriseringskoden som togs emot i Begär en auktoriseringskod. På så sätt kan cURL-verktyget begära en åtkomsttoken.
   • client_secret={client_secret}är det värde för klienthemlighet som registrerats i Lägg till en klienthemlighet.

2. Kör cURL-kommandot och om det anges korrekt bör du få ett JSON-svar som liknar följande utdata:

   {
      "token_type": "Bearer",
      "scope": "api://{web_API_application_client_id}/Forecast.Read",
      "expires_in": 3600,
      "ext_expires_in": 3600,
      "access_token": "{access_token}"
   }
   

Anropa webb-API med åtkomsttoken

Genom att köra föregående cURL-kommando har Microsofts identitetsplattform angett en åtkomsttoken. Den förvärvade token kan nu användas som en bärare i en HTTP-begäran för att anropa webb-API:et.

1. Om du vill anropa webb-API:et kopierar du följande cURL-kommando, ersätter följande värden inom parenteser och klistrar in det i terminalen:

   curl -X GET https://localhost:{port}/weatherforecast -ki \
   -H 'Content-Type: application/json' \
   -H "Authorization: Bearer {access_token}"
   

   • {access_token} värdet för åtkomsttoken som registrerats från JSON-utdata i föregående avsnitt.
   • {port} portnumret från webb-API:et som registrerades när API:et kördes i terminalen. Kontrollera att det är https portnumret.

2. Med en giltig åtkomsttoken som ingår i begäran är HTTP/2 200 det förväntade svaret med utdata som liknar följande utdata:

   HTTP/2 200
   content-type: application/json; charset=utf-8
   date: Day, DD Month YYYY HH:MM:SS
   server: Kestrel
   [{"date":"YYYY-MM-DDTHH:MM:SS","temperatureC":36,"summary":"Hot","temperatureF":96},{"date":"YYYY-MM-DDTHH:MM:SS","temperatureC":43,"summary":"Warm","temperatureF":109},{"date":"YYYY-MM-DDTHH:MM:SS","temperatureC":18,"summary":"Warm","temperatureF":64},{"date":"YYYY-MM-DDTHH:MM:SS","temperatureC":50,"summary":"Chilly","temperatureF":121},{"date":"YYYY-MM-DDTHH:MM:SS","temperatureC":3,"summary":"Bracing","temperatureF":37}]
   

Nästa steg

Mer information om OAuth 2.0-auktoriseringskodflöde och programtyper finns i:

• Microsofts identitetsplattform- och OAuth 2.0-auktoriseringskodflöde
• Programtyper för Microsofts identitetsplattform