Share via

Tutorial: Creación y configuración de un proyecto de ASP.NET Core para la autenticación

  • Artículo

En este tutorial, descubrirás cómo crear un proyecto de ASP.NET Core con un IDE y cómo configurarlo para la autenticación y autorización. Este tutorial es la segunda parte de una serie que muestra cómo proteger una API web mediante la plataforma de identidad de Microsoft. En el artículo anterior, has registrado una aplicación en tu inquilino de Microsoft Entra ID. En este artículo, descubrirás cómo:

  • Crea un proyecto de ASP.NET Core vacío en tu IDE
  • Configure las opciones de la aplicación
  • Identificación e instalación de los paquetes NuGet necesarios

Prerrequisitos

Crear un proyecto de ASP.NET Core

Use las pestañas siguientes para crear un proyecto de ASP.NET Core dentro de un IDE.

  1. Abra Visual Studio y seleccione Crear un proyecto.
  2. Busque la plantilla ASP.NET Core vacío, selecciónela y, luego, seleccione Siguiente.
  3. Escriba un nombre para el proyecto, como NewWebAPILocal.
  4. Elija una ubicación para el proyecto o acepte la opción predeterminada y, luego, seleccione Siguiente.
  5. Acepte el valor predeterminado para el Marco y seleccione Configurar para HTTPS.
  6. Seleccione Crear.

Configuración del proyecto de ASP.NET Core

Los valores registrados anteriormente se usarán en appsettings.json para configurar la aplicación para la autenticación. appsettings.json es un archivo de configuración que se usa para almacenar la configuración de la aplicación usada durante el tiempo de ejecución.

  1. Abra appsettings.json y reemplace el contenido del archivo por el siguiente fragmento de código:

    {
  "AzureAd": {
    "Instance": "https://login.microsoftonline.com/",
    "ClientId": "Enter the client ID here",
    "TenantId": "Enter the tenant ID here",
    "Scopes": "Forecast.Read"
  },
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*"
}
    • Instance: el punto de conexión del proveedor de nube. Consulte los diferentes puntos de conexión disponibles en nubes nacionales.
    • TenantId - El identificador del inquilino donde se registra la aplicación. Reemplace el texto entre comillas por el valor de identificador del directorio (inquilino) que se registró anteriormente en la página de información general de la aplicación registrada.
    • ClientId - El identificador de la aplicación, también denominado cliente. Reemplace el texto entre comillas por el valor de identificador del directorio (inquilino) que se registró anteriormente en la página de información general de la aplicación registrada.
    • Scopes : el ámbito que se usa para solicitar acceso a la aplicación. Para este tutorial, el ámbito es Forecast.Read.

  2. Guarde los cambios en el archivo.

Instalación de paquetes de identidad

Los paquetes NuGet relacionados con la identidad deben instalarse en el proyecto para que se habilite la autenticación de los usuarios.

  1. En el menú superior, seleccione Herramientas>Administrador de paquetes NuGet>Administrar paquetes NuGet para la solución.
  2. Con la pestaña Examinar seleccionada, busque Microsoft.Identity.Web, seleccione el paquete Microsoft.Identity.Web, active la casilla Proyecto y, a continuación, seleccione Instalar.
  3. Seleccione Aceptar o Acepto para otras ventanas que pueden aparecer.

Pasos siguientes

Tutorial: Implementación de un punto de conexión protegido en la API