Llamada a una API web de ASP.NET Core con cURL

Requisitos previos

Registro de una aplicación en la plataforma de identidad de Microsoft

En la plataforma de identidad de Microsoft es necesario que la aplicación se registre para poder proporcionar servicios de administración de identidades y acceso. El registro de la aplicación permite indicar su nombre y su tipo de la aplicación y el público de inicio de sesión. El público de inicio de sesión especifica qué tipos de cuentas de usuario pueden iniciar sesión en una aplicación determinada.

Registro de la aplicación web

Sin embargo, tener una API web no es suficiente, ya que también se necesita una aplicación web para obtener un token de acceso para acceder a la API web que ha creado.

Siga estos pasos para crear el registro de la aplicación de la aplicación web:

Una vez completado el registro, el registro de la aplicación se muestra en el panel Información general . Registre el identificador de directorio (inquilino) y el identificador de aplicación (cliente) que se usará en pasos posteriores.

Agregar un secreto de cliente

Un secreto de cliente es un valor de cadena que la aplicación puede usar para identificarse y, a veces, se conoce como contraseña de aplicación. La aplicación web usa el secreto de cliente para demostrar su identidad al solicitar tokens.

Siga estos pasos para configurar un secreto de cliente:

1. En el panel Información general, en Administrar, seleccione Certificados y secretos Nuevo secreto de cliente.

2. Agregue una descripción para el secreto de cliente, por ejemplo , Mi secreto de cliente.

3. Seleccione una expiración para el secreto o especifique una duración personalizada.

   • La duración de un secreto de cliente se limita a dos años (24 meses) o menos. No se puede especificar una duración personalizada superior a 24 meses.
   • Microsoft recomienda establecer un valor de expiración de menos de 12 meses.

4. Seleccione Agregar.

5. Asegúrese de registrar el valor del secreto de cliente. Este valor secreto nunca se muestra de nuevo después de salir de esta página.

Adición de permisos de aplicación para permitir el acceso a una API web

Al especificar los ámbitos de una API web en el registro de aplicación web, la aplicación web puede obtener un token de acceso que contenga esos ámbitos proporcionados por la plataforma de identidad de Microsoft. En el código, la API web puede proporcionar acceso basado en permisos a sus recursos en función de los ámbitos que se encuentran en el token de acceso.

Siga estos pasos para configurar los permisos de la aplicación web en la API web:

1. En el panel Información general de la aplicación web (web-app-that-calls-web-api), en Administrar, seleccione Permisos> de APIAgregar una>API que usa mi organización.
2. Seleccione NewWebAPI1 o la API a la que desea agregar permisos.
3. En Seleccionar permisos, active la casilla situada junto a Forecast.Read. Es posible que tenga que expandir la lista De permisos . Esto selecciona los permisos que la aplicación cliente debe tener en nombre del usuario que ha iniciado sesión.
4. Seleccione Agregar permisos para completar el proceso.

Después de agregar estos permisos a la API, debería ver los permisos seleccionados en Permisos configurados.

También puede observar el permiso User.Read para Microsoft Graph API. Este permiso se agrega automáticamente al registrar una aplicación.

Solicitud de un código de autorización

El flujo del código de autorización comienza con el cliente dirigiendo al usuario al punto de conexión /authorize . En esta solicitud, el cliente solicita el permiso Forecast.Read del usuario.

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. Copie la dirección URL, reemplace los parámetros siguientes y péguela en el explorador:

   • {tenant_id} es la ID del directorio (inquilino) de la aplicación web.
   • {web-app-calls-web-api_application_client_id}es el identificador de aplicación (cliente) del panel información general de la aplicación web (web-app-calls-web-api).
   • {web_API_application_client_id}es el identificador de aplicación (cliente) en el panel información general de la API web (NewWebAPI1).

2. Inicie sesión como usuario en el inquilino de Microsoft Entra en el que se registran las aplicaciones. Dé su consentimiento a las solicitudes de acceso, si es necesario.

3. El explorador se redirige a http://localhost/. Consulte la barra de navegación del explorador y copie {authorization_code} para usarlo en los pasos siguientes. La dirección URL tiene la forma del siguiente fragmento de código:

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

Uso de un código de autorización y cURL para obtener un token de acceso

cURL ahora se puede usar para solicitar un token de acceso desde la Plataforma de identidad de Microsoft.

1. Copie el comando cURL en el siguiente fragmento de código. Reemplace los valores entre paréntesis por los parámetros siguientes en el terminal. Asegúrese de quitar los paréntesis:

   • Juerga
   • Símbolo del sistema de 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} es la ID del directorio (inquilino) de la aplicación web.
   • client_id={web-app-calls-web-api_application_client_id}, y session_state={web-app-calls-web-api_application_client_id} es el identificador de aplicación (cliente) del panel información general de la aplicación web (web-app-calls-web-api).
   • api://{web_API_application_client_id}/Forecast.Reades el identificador de aplicación (cliente) en el panel información general de la API web (NewWebAPI1).
   • code={authorization_code} es el código de autorización que se recibió en Solicitud de un código de autorización. Esto permite que la herramienta cURL solicite un token de acceso.
   • client_secret={client_secret} es el valor del secreto de cliente registrado en Agregar un secreto de cliente.

2. Ejecute el comando cURL y, si se ha escrito correctamente, debe recibir una respuesta JSON similar a la siguiente salida:

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

Llamar a la API web con el token de acceso

Al ejecutar el comando cURL anterior, la Plataforma de identidad de Microsoft ha proporcionado un token de acceso. El token adquirido ahora se puede usar como portador en una solicitud HTTP para llamar a la API web.

1. Para llamar a la API web, copie el siguiente comando cURL, reemplace los valores siguientes entre paréntesis y péguelos en el terminal:

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

   • {access_token} el valor del token de acceso registrado en la salida JSON de la sección anterior.
   • {port} el número de puerto de la API web registrada al ejecutar la API en el terminal. Asegúrese de que es el número de puerto https.

2. Con un token de acceso válido incluido en la solicitud, la respuesta esperada es HTTP/2 200 con una salida similar a la siguiente:

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

Pasos siguientes

Para más información sobre el flujo de código de autorización de OAuth 2.0 y los tipos de aplicación, consulte:

• Flujo de código de autorización de OAuth 2.0 y la plataforma de identidad de Microsoft
• Tipos de aplicación para la plataforma de identidad de Microsoft