Tutorial: Criar um aplicativo shell .NET MAUI

Aplica-se a: Locatários da força de trabalho Inquilinos externos (saiba mais)

Este tutorial é a parte 1 de uma série que demonstra como criar um aplicativo shell .NET Multi-platform App UI (.NET MAUI) e prepará-lo para autenticação usando o centro de administração do Microsoft Entra. Neste tutorial, você adicionará um auxiliar de cliente personalizado da Microsoft Authentication Library (MSAL) para inicializar o SDK do MSAL, instalar as bibliotecas necessárias e incluir um recurso de imagem.

Neste tutorial, você:

• Crie um aplicativo shell .NET MAUI.
• Adicione suporte ao SDK do MSAL usando classes auxiliares do MSAL.
• Instale os pacotes necessários.
• Adicionar recurso de imagem.

Pré-requisitos

• Registre um novo aplicativo Web cliente no centro de administração do Microsoft Entra, configurado para Contas em qualquer diretório organizacional e contas pessoais da Microsoft. Consulte Registar uma candidatura para obter mais detalhes. Registre os seguintes valores na página Visão geral do aplicativo para uso posterior:
  • ID da aplicação (cliente)
  • ID do diretório (inquilino)
• Adicione os URIs de redirecionamento a seguir usando a configuração da plataforma de aplicativos móveis e de desktop . Consulte Como adicionar um URI de redirecionamento em seu aplicativo para obter mais detalhes.
  • URI de redirecionamento: msal{client_id}://auth onde {client_id} é a ID do aplicativo (cliente) do seu aplicativo.
• SDK do .NET
• Visual Studio 2022 com a carga de trabalho MAUI instalada:
  • Instruções para a Configuração do Visual Studio

Criar aplicação shell .NET MAUI

1. Na janela Iniciar do Visual Studio 2022, selecione Criar um novo projeto.
2. Na janela Criar um novo projeto, selecione MAUI na lista suspensa Todos os tipos de projeto, selecione o modelo Aplicativo .NET MAUI e selecione Próximo.
3. Na janela Configurar o seu novo projeto, Nome do Projeto deve ser definido como SignInMaui. Atualize o nome da Solução para sign-in-maui e selecione Avançar.
4. Na janela Informações adicionais, escolha o SDK .NET mais recente e selecione Criar.

Aguarde até que o projeto seja criado e suas dependências sejam restauradas.

Adicionar suporte ao SDK do MSAL usando classes auxiliares do MSAL

O cliente MSAL permite que os desenvolvedores adquiram tokens de segurança de um locatário externo para autenticar e acessar APIs da Web seguras. Nesta seção, você baixa arquivos que compõem o MSALClient.

Transfira os seguintes ficheiros para uma pasta no seu computador:

• AzureAdConfig.cs - Este arquivo obtém e define os identificadores exclusivos do aplicativo Microsoft Entra do arquivo de configuração do aplicativo.
• DownStreamApiConfig.cs - Este arquivo obtém e define os escopos para chamada do Microsoft Graph.
• DownstreamApiHelper.cs - Este arquivo lida com as exceções que ocorrem ao chamar a API downstream.
• Exception.cs - Este arquivo oferece alguns métodos de extensão relacionados ao lançamento e tratamento de exceções.
• IdentityLogger.cs - Este ficheiro mostra como usar o registo de logs MSAL.NET.
• MSALClientHelper.cs - Este arquivo contém métodos para inicializar o SDK do MSAL.
• PlatformConfig.cs - Este arquivo contém métodos para lidar com uma plataforma específica. Por exemplo, o Windows.
• PublicClientSingleton.cs - Este arquivo contém uma implementação singleton para encapsular o MSALClient e classes associadas para suportar o modelo de inicialização estática para plataformas.
• WindowsHelper.cs - Este arquivo contém métodos para recuperar o identificador da janela.

Importante

Não ignore o download dos arquivos MSALClient, eles são necessários para concluir este tutorial.

Mover os arquivos MSALClient com o Visual Studio

1. No painel Explorador de Soluções, clique com o botão direito no projeto SignInMaui e selecione Adicionar>Nova Pasta. Nomeie a pasta MSALClient.
2. Clique com botão direito do mouse na pasta MSALClient, selecione Adicionar>item existente....
3. Navegue até a pasta que contém os arquivos MSALClient baixados que você baixou anteriormente.
4. Selecione todos os arquivos MSALClient que você baixou e, em seguida, selecione Adicionar

Instalar pacotes necessários

Você precisa instalar os seguintes pacotes:

• Microsoft.Identity.Client - Este pacote contém os binários da Biblioteca de Autenticação da Microsoft para .NET (MSAL.NET).
• Microsoft.Extensions.Configuration.Json - Este pacote contém a implementação do provedor de configuração JSON para Microsoft.Extensions.Configuration.
• Microsoft.Extensions.Configuration.Binder - Este pacote contém funcionalidade para vincular um objeto a dados em provedores de configuração para Microsoft.Extensions.Configuration.
• Microsoft.Extensions.Configuration.Abstractions - Este pacote contém abstrações de configuração baseada em par chave-valor.
• Microsoft.Identity.Client.Extensions.Msal - Este pacote contém extensões para a Biblioteca de Autenticação da Microsoft para .NET (MSAL.NET).

Gerenciador de Pacotes NuGet

Para usar o Gestor de Pacotes NuGet para instalar o pacote Microsoft.Identity.Client no Visual Studio, siga estas etapas:

1. Selecione Ferramentas>Gerenciador de Pacotes NuGet>Gerenciar Pacotes NuGet para Solução....
2. Na guia Procurar, procure Microsoft.Identity.Client.
3. Selecione Microsoft.Identity.Client na lista.
4. Selecione SignInMaui no painel de lista de Projetos .
5. Selecione Instalar.
6. Se você for solicitado a verificar a instalação, selecione OK.

Repita o processo para instalar os pacotes necessários restantes.

Adicionar recurso de imagem

Nesta seção, você baixa uma imagem que usa em seu aplicativo para aprimorar a forma como os usuários interagem com ela.

Faça o download da seguinte imagem:

• Ícone: Microsoft Entra ID - Esta imagem é usada como ícone na página principal.

Mover a imagem com o Visual Studio

1. No painel Explorador de Soluções do Visual Studio, expanda a pasta Recursos, a qual revela a pasta Imagens.
2. Clique com o botão direito do mouse em Imagens e selecione Adicionar>Item Existente....
3. Navegue até a pasta que contém as imagens baixadas.
4. Altere o filtro para filtro de tipo de arquivo para Arquivos de imagem.
5. Selecione a imagem que você baixou.
6. Selecione Adicionar.

Próximo passo

Parte 3: Tutorial: Iniciar sessão de utilizadores na aplicação shell do .NET MAUI usando uma entidade externa