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

Artigo
04/04/2024

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.

Abra o Visual Studio e selecione Criar projeto.
Pesquise e escolha o modelo ASP.NET Core Empty e selecione Next.
Insira um nome para o projeto, como NewWebAPILocal.
Escolha um local para o projeto ou aceite a opção padrão e, em seguida, selecione Avançar.
Aceite o padrão para a Estrutura e a Configuração para HTTPS.
Selecione Criar.

Abra o Visual Studio Code, selecione Arquivo > Abrir Pasta.... Navegue e selecione o local no qual criar seu projeto.
Abra um novo terminal selecionando Terminal na barra superior e Novo Terminal.
Crie uma nova pasta usando o ícone Nova Pasta... no painel Explorer. Forneça um nome semelhante ao registrado anteriormente, por exemplo, NewWebAPILocal.
Abra um novo terminal selecionando Terminal > Novo Terminal.
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
```

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.

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.
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.

No menu superior, selecione Ferramentas>Gerenciador de pacotes NuGet>Gerenciar pacotes NuGet para Solução.
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.
Selecione Ok ou Aceito em outras janelas que possam aparecer.

Próximas etapas

Tutorial: implementar um ponto de extremidade protegido na sua API

Compartilhar via