Esercitazione: Creare e configurare un progetto ASP.NET Core per l'autenticazione

Questa esercitazione illustra come creare un progetto ASP.NET Core usando un IDE e configurarlo per l'autenticazione e l'autorizzazione. Questa esercitazione è la seconda parte di una serie che illustra come proteggere un'API Web usando Microsoft Identity Platform. Nell'articolo precedente è stata registrata un'applicazione nel tenant microsoft Entra ID. In questo articolo, l'utente;

  • Creare un progetto core vuoto ASP.NET nell'IDE
  • Configurare le impostazioni per l'applicazione
  • Identificare e installare i pacchetti NuGet necessari

Prerequisiti

Creare un progetto ASP.NET Core

Usare le schede seguenti per creare un progetto ASP.NET Core all'interno di un IDE.

  1. Aprire Visual Studio e quindi selezionare Crea un nuovo progetto.
  2. Cercare e scegliere il modello core vuoto ASP.NET e quindi selezionare Avanti.
  3. Immettere un nome per il progetto, ad esempio NewWebAPILocal.
  4. Scegliere un percorso per il progetto o accettare l'opzione predefinita e quindi selezionare Avanti.
  5. Accettare il valore predefinito per Framework e Configurare per HTTPS.
  6. Seleziona Crea.

Configurare il progetto ASP.NET Core

I valori registrati in precedenza verranno usati in appsettings.json per configurare l'applicazione per l'autenticazione. appsettings.json è un file di configurazione usato per archiviare le impostazioni dell'applicazione usate durante il runtime.

  1. Aprire appsettings.json e sostituire il contenuto del file con il frammento di codice seguente:

    {
      "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 - Endpoint del provider di servizi cloud. Verificare i diversi endpoint disponibili nei cloud nazionali.
    • TenantId - Identificatore del tenant in cui è registrata l'applicazione. Sostituire il testo tra virgolette con il valore ID directory (tenant) registrato in precedenza dalla pagina di panoramica dell'applicazione registrata.
    • ClientId - Identificatore dell'applicazione, detto anche client. Sostituire il testo tra virgolette con il valore ID applicazione (client) registrato in precedenza dalla pagina di panoramica dell'applicazione registrata.
    • Scopes - Ambito usato per richiedere l'accesso all'applicazione. Per questa esercitazione, l'ambito è Forecast.Read.
  2. Salvare le modifiche apportate al file.

Installare i pacchetti Identity

I pacchetti NuGet correlati all'identità devono essere installati nel progetto per abilitare l'autenticazione degli utenti.

  1. Nel menu in alto selezionare Strumenti>NuGet Gestione pacchetti> Gestisci pacchetti NuGet per la soluzione.
  2. Con la scheda Sfoglia selezionata, cercare Microsoft.Identity.Web, selezionare il Microsoft.Identity.Web pacchetto, selezionare la casella di controllo Progetto e quindi selezionare Installa.
  3. Selezionare OK o Accetto per altre finestre che possono essere visualizzate.

Passaggi successivi