Tutorial: Criar e configurar um projeto ASP.NET Core para autenticação

Neste tutorial, você aprenderá a criar um projeto ASP.NET Core usando um IDE e configurá-lo para autenticação e autorização. Este tutorial é a segunda parte de uma série que demonstra como proteger uma API da Web usando a plataforma de identidade da Microsoft. No artigo anterior, você registrou um aplicativo em seu locatário do Microsoft Entra ID. Neste artigo, você;

• Criar um projeto ASP.NET Core Empty no seu IDE
• Definir as configurações para o aplicativo
• Identificar e instalar os pacotes NuGet necessários

Pré-requisitos

• Conclusão dos pré-requisitos e etapas em Tutorial: Registrar API da Web com a plataforma de identidade da Microsoft.
• Você pode baixar os IDEs usados neste tutorial na página Downloads .
  • Visual Studio 2022
  • Visual Studio Code
  • Visual Studio 2022 para Mac

• Um requisito mínimo do SDK do .NET 6.0.

Criar um projeto Web ASP.NET Core

Use as guias a seguir para criar um projeto ASP.NET Core dentro de um IDE.

Visual Studio

1. Abra o Visual Studio e selecione Criar um novo projeto.
2. Procure e escolha o modelo ASP.NET Core Empty e, em seguida, selecione Next.
3. Insira um nome para o projeto, como NewWebAPILocal.
4. Escolha um local para o projeto ou aceite a opção padrão e selecione Avançar.
5. Aceite o padrão para o Framework e configure para HTTPS.
6. Selecione Criar.

Visual Studio Code

1. Abra o Visual Studio Code, selecione File > Open Folder.... Navegue até o local para criar seu projeto e selecione-o.

2. Abra um novo terminal selecionando Terminal na barra superior e, em seguida , Novo Terminal.

3. Crie uma nova pasta usando o ícone Nova pasta... no painel Explorer. Forneça um nome semelhante ao registrado anteriormente, por exemplo, NewWebAPILocal.

4. Abra um novo terminal selecionando Terminal > New Terminal.

5. Para criar um modelo ASP.NET Core Empty , execute os seguintes comandos no terminal para mudar para o diretório e criar o projeto:

   cd NewWebAPILocal
   dotnet new web
   

Visual Studio para Mac

1. Abra o Visual Studio e selecione Novo.
2. Em Web e Console , na barra de navegação esquerda, selecione Aplicativo.
3. Em ASP.NET Core, selecione API e verifique se C# está selecionado no menu suspenso e, em seguida, selecione Continuar.
4. Aceite o padrão para o Target Framework e Advanced e selecione Continue.
5. Insira um nome para o nome do projeto, isso será refletido em Nome da solução. Forneça um nome semelhante ao registrado no centro de administração do Microsoft Entra, como NewAPI1.
6. Aceite o local padrão para o projeto ou escolha um local diferente e selecione Criar.

Nota

A desativação do Visual Studio para Mac está programada para 31 de agosto de 2024, de acordo com a Política de Ciclo de Vida Moderna da Microsoft. O Visual Studio para Mac 17.6 continuará a ser suportado até 31 de agosto de 2024, com atualizações de manutenção para problemas de segurança e plataformas atualizadas da Apple. Consulte O que está acontecendo com o Visual Studio para Mac para obter mais informações.

Configurar o projeto ASP.NET Core

Os valores registrados anteriormente serão usados em appsettings.json para configurar o aplicativo para autenticação. appsettings.json é um arquivo de configuração usado para armazenar as configurações do aplicativo usadas durante o tempo de execução.

1. Abra appsettings.json e substitua o conteúdo do arquivo pelo seguinte trecho 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 - O ponto de extremidade do provedor de nuvem. Verifique com os diferentes pontos finais disponíveis em Nuvens nacionais.
   • TenantId - O identificador do inquilino onde a aplicação está registada. Substitua o texto entre aspas pelo valor de ID do diretório (locatário) que foi registrado anteriormente na página de visão geral do aplicativo registrado.
   • ClientId - O identificador da aplicação, também referido como o cliente. Substitua o texto entre aspas pelo valor de ID do aplicativo (cliente) que foi registrado anteriormente na página de visão geral do aplicativo registrado.
   • Scopes - O âmbito que é utilizado para solicitar acesso à aplicação. Para este tutorial, o escopo é Forecast.Read.

2. Guarde as alterações ao ficheiro.

Instalar pacotes de identidade

Os pacotes NuGet relacionados à identidade devem ser instalados no projeto para que a autenticação dos usuários seja habilitada.

Visual Studio

1. No menu superior, selecione Ferramentas>Gerenciador de Pacotes>NuGet Gerenciar Pacotes NuGet para Solução.
2. Com a guia Procurar selecionada, procure Microsoft.Identity.Web, selecione o Microsoft.Identity.Web pacote, marque a caixa de seleção Projeto e selecione Instalar.
3. Selecione Ok ou Aceito para outras janelas que possam aparecer.

Visual Studio Code

1. No terminal aberto na seção anterior, digite o seguinte comando:

   dotnet add package Microsoft.Identity.Web
   

Visual Studio para Mac

1. No menu superior, selecione Ferramentas>para gerenciar pacotes NuGet.
2. Procure Microsoft.Identity.Web, selecione o Microsoft.Identity.Web pacote, selecione Projeto e, em seguida, selecione Adicionar Pacote.
3. No pop-up, verifique se o projeto correto está selecionado e selecione Ok.
4. Selecione Aceitar se outras janelas de Aceitação de Licença aparecerem.

Próximos passos

Tutorial: Implementar um ponto de extremidade protegido à sua API