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

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

• Complete los requisitos previos y los pasos descritos en Tutorial: Registro de una API web la plataforma de identidad de Microsoft.
• Puede descargar los IDE usados en este tutorial desde la página Descargas.
  • Visual Studio 2022
  • Visual Studio Code
  • Visual Studio 2022 para Mac

• Se requiere como mínimo el SDK de NET 6.0.

Crear un proyecto de ASP.NET Core

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

Visual Studio

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.

Visual Studio Code

1. Abra Visual Studio Code, seleccione Archivo > Abrir carpeta.... Navegue y seleccione la ubicación en la que se va a crear el proyecto.

2. Para abrir un nuevo terminal, seleccione Terminal en la barra superior y, a continuación, Nuevo terminal.

3. Cree una carpeta con el icono Nueva carpeta... en el panel Explorador. Proporcione un nombre similar al registrado anteriormente, por ejemplo, NewWebAPILocal.

4. Abra una terminal nueva seleccionando Terminal > Crear terminal.

5. Para crear una plantilla de ASP.NET Core vacío, ejecute los siguientes comandos en el terminal para cambiar al directorio y crear el proyecto:

   cd NewWebAPILocal
   dotnet new web
   

Visual Studio para Mac

1. Abra Visual Studio y seleccione Nuevo.
2. En Web y Consola de la barra de navegación de la izquierda, seleccione Aplicación.
3. En ASP.NET Core, seleccione API y asegúrese de que C# está seleccionado en el menú desplegable y, luego, seleccione Continuar.
4. Acepte el valor predeterminado para la plataforma de destino y Avanzado y, a continuación, seleccione Continuar.
5. Escriba un nombre para Nombre del proyecto, esto se reflejará en el Nombre de la solución. Proporcione un nombre similar al registrado en el Centro de administración de Microsoft Entra, como NewAPI1.
6. Acepte la ubicación predeterminada del proyecto o elija otra ubicación y, luego, seleccione Crear.

Nota:

Visual Studio para Mac está programado para su retirada antes del 31 de agosto de 31, 2024 de acuerdo con la directiva de ciclo de vida moderno de Microsoft. Visual Studio para Mac 17.6 seguirá siendo compatible hasta el 31 de agosto de 2024, con actualizaciones de mantenimiento para problemas de seguridad y plataformas actualizadas de Apple. Consulte ¿Qué ocurre Visual Studio para Mac? para obtener más información.

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.

Visual Studio

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.

Visual Studio Code

1. En el terminal abierto en la sección anterior, escriba el siguiente comando:

   dotnet add package Microsoft.Identity.Web
   

Visual Studio para Mac

1. En el menú superior, seleccione Herramientas>Administrar paquetes NuGet.
2. Busque Microsoft.Identity.Web, seleccione el paquete Microsoft.Identity.Web, seleccione Proyecto y, después, seleccione Agregar paquete.
3. En el elemento emergente, asegúrese de que está seleccionado el proyecto correcto y, luego, seleccione Aceptar.
4. Seleccione Aceptar si aparecen otras ventanas de aceptación de la licencia.

Pasos siguientes

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