Вызов веб-API ASP.NET Core с помощью cURL

Необходимые условия

Регистрация приложения с помощью платформа удостоверений Майкрософт

Платформа удостоверений Майкрософт требует, чтобы ваше приложение было зарегистрировано перед предоставлением служб управления удостоверениями и доступом. Регистрация приложения позволяет указать имя и тип приложения, а также аудиторию входа. Аудитория входа указывает, какие типы учетных записей пользователей разрешены для входа в данное приложение.

Регистрация веб-приложения

Однако наличие веб-API недостаточно, так как веб-приложение также необходимо для получения маркера доступа для доступа к созданному веб-API.

Выполните следующие действия, чтобы создать регистрацию веб-приложения:

После завершения регистрации регистрация приложения отображается на панели обзора . Запишите идентификатор каталога (клиента) и идентификатор приложения (клиента), который будет использоваться в последующих шагах.

Добавление секрета клиента

Секрет клиента — это строковое значение, которое приложение может использовать для идентификации себя и иногда называется паролем приложения. Веб-приложение использует секрет клиента, чтобы подтвердить свое удостоверение при запросе маркеров.

Выполните следующие действия, чтобы настроить секрет клиента:

1. В области "Обзор" в разделе "Управление" выберите "Сертификаты" и "Секреты>клиента">"Создать секрет клиента".

2. Добавьте описание секрета клиента, например "Мой секрет клиента".

3. Выберите срок действия секрета или укажите пользовательское время существования.

   • Срок жизни секрета клиента ограничен двумя годами (24 месяцами) или меньше. Вы не можете указать настраиваемое время существования дольше 24 месяцев.
   • Корпорация Майкрософт рекомендует задать значение срока действия менее 12 месяцев.

4. Нажмите кнопку "Добавить".

5. Обязательно запишите значение секрета клиента. Это значение секрета никогда не отображается снова после выхода из этой страницы.

Добавление разрешений приложения для разрешения доступа к веб-API

Указав области веб-API в регистрации веб-приложения, веб-приложение может получить маркер доступа, содержащий области, предоставляемые платформа удостоверений Майкрософт. В коде веб-API может предоставить доступ на основе разрешений к своим ресурсам на основе областей, найденных в маркере доступа.

Выполните следующие действия, чтобы настроить разрешения веб-приложения для веб-API:

1. В области "Обзор" веб-приложения (веб-app-that-calls-web-api) в разделе "Управление" выберите разрешения API", чтобы добавить API разрешений>>, которые используются в моей организации.
2. Выберите NewWebAPI1 или API, к которому требуется добавить разрешения.
3. В разделе "Выбор разрешений" установите флажок " Прогноз.Чтение". Возможно, потребуется развернуть список разрешений . При выборе разрешений клиентское приложение должно быть от имени пользователя, вошедшего в систему.
4. Нажмите кнопку "Добавить разрешения" для завершения процесса.

После добавления этих разрешений в API вы увидите выбранные разрешения в разделе "Настроенные разрешения".

Вы также можете заметить разрешение User.Read для API Microsoft Graph. Это разрешение добавляется автоматически при регистрации приложения.

Запрос кода авторизации

Поток кода авторизации начинается с клиента, направляюющего пользователя в конечную точку /authorize . В этом запросе клиент запрашивает Forecast.Read разрешение от пользователя.

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. Скопируйте URL-адрес, замените следующие параметры и вставьте его в браузер:

   • {tenant_id}— это идентификатор каталога веб-приложения (клиента).
   • {web-app-calls-web-api_application_client_id}— это идентификатор приложения (клиента) в области обзора веб-приложения (web-app-calls-web-api).
   • {web_API_application_client_id}— это идентификатор приложения (клиента) в области обзора веб-API (NewWebAPI1).

2. Войдите в качестве пользователя в клиенте Microsoft Entra, в котором зарегистрированы приложения. При необходимости согласиться на любые запросы на доступ.

3. Браузер будет перенаправлен в http://localhost/. Перейдите на панель навигации браузера и скопируйте его {authorization_code} , выполнив указанные ниже действия. URL-адрес имеет форму следующего фрагмента кода:

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

Использование кода авторизации и cURL для получения маркера доступа

CURL теперь можно использовать для запроса маркера доступа из платформа удостоверений Майкрософт.

1. Скопируйте команду cURL в следующем фрагменте кода. Замените значения в скобках следующими параметрами в терминале. Не забудьте удалить скобки:

   • Бить
   • Командная строка 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}— это идентификатор каталога веб-приложения (клиента).
   • client_id={web-app-calls-web-api_application_client_id}, и session_state={web-app-calls-web-api_application_client_id} является идентификатором приложения (клиента) в области обзора веб-приложения (web-app-calls-web-api).
   • api://{web_API_application_client_id}/Forecast.Read— это идентификатор приложения (клиента) в области обзора веб-API (NewWebAPI1).
   • code={authorization_code} — код авторизации, полученный в запросе кода авторизации. Это позволяет средству cURL запрашивать маркер доступа.
   • client_secret={client_secret}— значение секрета клиента, записанное в разделе "Добавление секрета клиента".

2. Выполните команду cURL и при правильном вводе необходимо получить ответ JSON, аналогичный следующим выходным данным:

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

Вызов веб-API с маркером доступа

Выполнив предыдущую команду cURL, платформа удостоверений Майкрософт предоставил маркер доступа. Полученный маркер теперь можно использовать в качестве носителя в HTTP-запросе для вызова веб-API.

1. Чтобы вызвать веб-API, скопируйте следующую команду cURL, замените следующие значения в скобках и вставьте его в терминал:

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

   • {access_token} Значение маркера доступа, записанное из выходных данных JSON в предыдущем разделе.
   • {port} номер порта из веб-API, записанный при запуске API в терминале. Убедитесь, https что это номер порта.

2. При наличии допустимого маркера доступа, включенного в запрос, ожидаемый ответ содержит HTTP/2 200 выходные данные, аналогичные следующим выходным данным:

   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}]
   

Дальнейшие действия

Дополнительные сведения о потоке кода авторизации oAuth 2.0 и типах приложений см. в следующих примерах:

• поток кода авторизации платформа удостоверений Майкрософт и OAuth 2.0
• Типы приложений для платформа удостоверений Майкрософт