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

Neste tutorial, você vai aprender como 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 mostra como proteger uma API Web usando a plataforma de identidade da Microsoft. No artigo anterior, você registrou um aplicativo no locatário Microsoft Entra ID. Neste artigo, você:

• Cria um projeto ASP.NET Core Empty em seu ambiente de desenvolvimento integrado (IDE)
• Definir as configurações do aplicativo
• Identificar e instalar os pacotes NuGet necessários

Pré-requisitos

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

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

Criar um projeto ASP.NET Core

Use as guias a seguir para criar um projeto do ASP.NET Core em um IDE.

Visual Studio

1. Abra o Visual Studio e selecione Criar projeto.
2. Pesquise e escolha o modelo ASP.NET Core Empty e 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, em seguida, selecione Avançar.
5. Aceite o padrão para a Estrutura e a Configuração para HTTPS.
6. Selecione Criar.

Visual Studio Code

1. Abra o Visual Studio Code, selecione Arquivo > Abrir Pasta.... Navegue e selecione o local no qual criar seu projeto.

2. Abra um novo terminal selecionando Terminal na barra superior e 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 > Novo Terminal.

5. Para criar um modelo ASP.NET Core Empty, execute os seguintes comandos no terminal para alterar no 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 certifique-se de que C# está selecionado no menu suspenso e, em seguida, selecione Continuar.
4. Aceite o padrão da Estrutura de Destino e do Avançado e selecione Continuar.
5. Digite um nome para o Nome do projeto, isso será refletido no 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 do projeto ou escolha um local diferente e selecione Criar.

Observação

O Visual Studio para Mac está programado para ser desativado em 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á com suporte 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 do 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 de 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 de extremidade disponíveis nas Nuvens nacionais.
   • TenantId – O identificador do locatário em que o aplicativo está registrado. Substitua o texto entre aspas pelo valor da ID do Diretório (locatário) que foi registrado anteriormente na página de visão geral do aplicativo registrado.
   • ClientId – O identificador do aplicativo, também conhecido como cliente. Substitua o texto entre aspas pelo valor da ID do Aplicativo (locatário) que foi registrado anteriormente na página de visão geral do aplicativo registrado.
   • Scopes - O escopo usado para solicitar acesso ao aplicativo. Para esse tutorial, o escopo é Forecast.Read.

2. Salve as alterações no arquivo.

Instalar os pacotes de identidades

Os pacotes NuGet relacionados à identidade devem ser instalados no projeto para que a autenticação de 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, pesquise por Microsoft.Identity.Web, selecione o pacote Microsoft.Identity.Web, marque a caixa de seleção Projeto e selecione Instalar.
3. Selecione Ok ou Aceito em outras janelas que possam aparecer.

Visual Studio Code

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

   dotnet add package Microsoft.Identity.Web
   

Visual Studio para Mac

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

Próximas etapas

Tutorial: implementar um ponto de extremidade protegido na sua API