Compartir a través de

Tutorial: Creación de una aplicación de shell de .NET MAUI

  • Artículo

Este tutorial es la segunda parte de una serie en la que se muestra cómo crear una aplicación shell de interfaz de usuario de .NET Multi-platform App UI (.NET MAUI) y prepararla para la autenticación mediante el Centro de administración de Microsoft Entra. En la parte 1 de esta serie, registró una aplicación y configuró los flujos de usuario en el inquilino externo. En este tutorial, agregará un asistente de cliente personalizado de la Biblioteca de autenticación de Microsoft (MSAL) para inicializar el SDK de MSAL, instalar las bibliotecas necesarias e incluir un recurso de imagen.

En este tutorial, hará lo siguiente:

  • Crear una aplicación de shell de .NET MAUI
  • Agregar compatibilidad con el SDK de MSAL mediante clases auxiliares de MSAL.
  • Instalar los paquetes requeridos.
  • Agregar un recurso de imagen.

Requisitos previos

Crear una aplicación de shell de .NET MAUI

  1. En la ventana de inicio de Visual Studio 2022, seleccione Crear un nuevo proyecto.
  2. En la ventana Crear un proyecto, seleccione MAUI en la lista desplegable Todos los tipos de proyecto, seleccione la plantilla Aplicación de .NET MAUI y, luego, Siguiente.
  3. En la ventana Configurar el nuevo proyecto, Nombre del proyecto debe establecerse en SignInMaui. Actualice el Nombre de la solución para iniciar sesión en maui y seleccione Siguiente.
  4. En la ventana Información adicional, seleccione .NET 7.0 y, luego, Crear.

Espere a que se creen los proyectos y se restauren sus dependencias.

Agregar compatibilidad con el SDK de MSAL mediante clases auxiliares de MSAL

El cliente MSAL permite a los desarrolladores adquirir tokens de seguridad de un inquilino externo para autenticar y acceder a las API web protegidas. En esta sección, descargará los archivos que componen MSALClient.

Descargue los siguientes archivos en una carpeta del equipo:

  • AzureAdConfig.cs: este archivo obtiene y establece los identificadores únicos de la aplicación de Microsoft Entra a partir del archivo de configuración de la aplicación.
  • DownStreamApiConfig.cs: este archivo obtiene y establece los ámbitos de la llamada de Microsoft Graph.
  • DownstreamApiHelper.cs: este archivo controla las excepciones que se producen al llamar a la API de bajada.
  • Exception.cs: este archivo ofrece algunos métodos de extensión relacionados con la generación y control de excepciones.
  • IdentityLogger.cs: este identificador de archivo muestra cómo usar el registro de MSAL.NET.
  • MSALClientHelper.cs: este archivo contiene métodos para inicializar el SDK de MSAL.
  • PlatformConfig.cs: este archivo contiene métodos para controlar una plataforma específica. Por ejemplo, Windows.
  • PublicClientSingleton.cs: este archivo contiene una implementación singleton para encapsular MSALClient y las clases asociadas para admitir el modelo de inicialización estática para las plataformas.
  • WindowsHelper.cs: este archivo contiene métodos para recuperar el identificador de ventana.

Importante

No omita la descarga de los archivos MSALClient, son necesarios para completar este tutorial.

Mover los archivos MSALClient con Visual Studio

  1. En el panel Explorador de soluciones, haga clic con el botón derecho en el proyecto SignInMaui y seleccione Agregar>Nueva carpeta. Asigne a la carpeta el nombre MSALClient.
  2. Haga clic con el botón derecho en la carpeta MSALClient y seleccione Agregar>Elemento existente....
  3. Vaya hasta la carpeta que contiene los archivos MSALClient que descargó anteriormente.
  4. Seleccione todos los archivos MSALClient que descargó y, a continuación, seleccione Agregar.

Instalación de los paquetes requeridos

Deberá instalar los siguientes paquetes:

  • Microsoft.Identity.Client: este paquete contiene los archivos binarios de la Biblioteca de autenticación de Microsoft para .NET (MSAL.NET).
  • Microsoft.Extensions.Configuration.Json: este paquete contiene la implementación del proveedor de configuración JSON para Microsoft.Extensions.Configuration.
  • Microsoft.Extensions.Configuration.Binder: este paquete contiene funcionalidad para enlazar un objeto a datos de proveedores de configuración para Microsoft.Extensions.Configuration.
  • Microsoft.Extensions.Configuration.Abstractions: este paquete contiene abstracciones de la configuración basada en pares clave-valor.
  • Microsoft.Identity.Client.Extensions.Msal: este paquete contiene extensiones a la Biblioteca de autenticación de Microsoft para .NET (MSAL.NET).

Administrador de paquetes de NuGet

Para usar el Administrador de paquetes NuGet para instalar el paquete Microsoft.Identity.Client en Visual Studio, siga estos pasos:

  1. Seleccione Herramientas>Administrador de paquetes NuGet>Administrar paquetes NuGet para la solución... .
  2. En la pestaña Examinar, busque Microsoft.Identity.Client.
  3. Seleccione Microsoft.Identity.Client en la lista.
  4. Seleccione SignInMaui en el panel de lista Proyecto.
  5. Seleccione Instalar.
  6. Si se le pide que compruebe la instalación, seleccione Aceptar.

Repita el proceso para instalar los paquetes restantes necesarios.

Agregar un recurso de imagen

En esta sección, descargará una imagen que se usa en la aplicación para mejorar cómo interactúan los usuarios con ella.

Descargue la imagen siguiente:

Mover la imagen con Visual Studio

  1. En el panel de Visual Studio Explorador de soluciones, expanda la carpeta Recursos, que revela la carpeta Imágenes.
  2. Haga clic con el botón derecho en Imágenes y seleccione Agregar>Elemento existente....
  3. Navegue a la carpeta que contiene las imágenes descargadas.
  4. Cambie el filtro al filtro de tipo de archivo a Archivos de imagen.
  5. Seleccione la imagen que descargó.
  6. Seleccione Agregar.

Paso siguiente

Parte 3: Tutorial: Inicio de sesión de los usuarios en la aplicación de shell de .NET MAUI mediante un inquilino externo