Tutorial: Creación y configuración de un proyecto de ASP.NET Core para la autenticación
Artikulua
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
Abra Visual Studio y seleccione Crear un proyecto.
Busque la plantilla ASP.NET Core vacío, selecciónela y, luego, seleccione Siguiente.
Escriba un nombre para el proyecto, como NewWebAPILocal.
Elija una ubicación para el proyecto o acepte la opción predeterminada y, luego, seleccione Siguiente.
Acepte el valor predeterminado para el Marco y seleccione Configurar para HTTPS.
Seleccione Crear.
Abra Visual Studio Code, seleccione Archivo > Abrir carpeta.... Navegue y seleccione la ubicación en la que se va a crear el proyecto.
Para abrir un nuevo terminal, seleccione Terminal en la barra superior y, a continuación, Nuevo terminal.
Cree una carpeta con el icono Nueva carpeta... en el panel Explorador. Proporcione un nombre similar al registrado anteriormente, por ejemplo, NewWebAPILocal.
Abra una terminal nueva seleccionando Terminal > Crear terminal.
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:
PowerShell
cd NewWebAPILocal
dotnet new web
Abra Visual Studio y seleccione Nuevo.
En Web y Consola de la barra de navegación de la izquierda, seleccione Aplicación.
En ASP.NET Core, seleccione API y asegúrese de que C# está seleccionado en el menú desplegable y, luego, seleccione Continuar.
Acepte el valor predeterminado para la plataforma de destino y Avanzado y, a continuación, seleccione Continuar.
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.
Acepte la ubicación predeterminada del proyecto o elija otra ubicación y, luego, seleccione Crear.
Oharra
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.
Abra appsettings.json y reemplace el contenido del archivo por el siguiente fragmento de código:
JSON
{
"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.
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.
En el menú superior, seleccione Herramientas>Administrador de paquetes NuGet>Administrar paquetes NuGet para la solución.
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.
Seleccione Aceptar o Acepto para otras ventanas que pueden aparecer.
En el terminal abierto en la sección anterior, escriba el siguiente comando:
PowerShell
dotnet add package Microsoft.Identity.Web
En el menú superior, seleccione Herramientas>Administrar paquetes NuGet.
Busque Microsoft.Identity.Web, seleccione el paquete Microsoft.Identity.Web, seleccione Proyecto y, después, seleccione Agregar paquete.
En el elemento emergente, asegúrese de que está seleccionado el proyecto correcto y, luego, seleccione Aceptar.
Seleccione Aceptar si aparecen otras ventanas de aceptación de la licencia.
Muestre las características de Microsoft Entra ID para modernizar las soluciones de identidad, implementar soluciones híbridas e implementar la gobernanza de identidades.