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

• Completamento dei prerequisiti e dei passaggi descritti in Esercitazione: Registrare l'API Web con Microsoft Identity Platform.
• È possibile scaricare gli IDE usati in questa esercitazione dalla pagina Download .
  • Visual Studio 2022
  • Visual Studio Code
  • Visual Studio 2022 per Mac

• Requisito minimo di .NET 6.0 SDK.

Creare un progetto ASP.NET Core

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

Visual Studio

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.

Visual Studio Code

1. Aprire Visual Studio Code, selezionare File > Apri cartella.... Passare a e selezionare il percorso in cui creare il progetto.

2. Aprire un nuovo terminale selezionando Terminale nella barra superiore e quindi Nuovo terminale.

3. Creare una nuova cartella usando l'icona Nuova cartella ... nel riquadro Esplora risorse . Specificare un nome simile a quello registrato in precedenza, ad esempio NewWebAPILocal.

4. Aprire un nuovo terminale selezionando Terminale > Nuovo terminale.

5. Per creare un modello core vuoto di ASP.NET, eseguire i comandi seguenti nel terminale per passare alla directory e creare il progetto:

   cd NewWebAPILocal
   dotnet new web
   

Visual Studio per Mac

1. Aprire Visual Studio e quindi selezionare Nuovo.
2. In Web e console nella barra di spostamento a sinistra selezionare App.
3. In ASP.NET Core selezionare API e assicurarsi che C# sia selezionato nel menu a discesa e quindi selezionare Continua.
4. Accettare il valore predefinito per Framework di destinazione e Avanzate, quindi selezionare Continua.
5. Immettere un nome per il nome del progetto, che verrà visualizzato in Nome soluzione. Specificare un nome simile a quello registrato nell'interfaccia di amministrazione di Microsoft Entra, ad esempio NewAPI1.
6. Accettare il percorso predefinito per il progetto o scegliere un percorso diverso e quindi selezionare Crea.

Nota

Visual Studio per Mac è pianificata per il ritiro entro il 31 agosto 2024 in conformità con Microsoft Criteri moderni relativi al ciclo di vita. Visual Studio per Mac 17.6 continuerà a essere supportato fino al 31 agosto 2024, con aggiornamenti di manutenzione per problemi di sicurezza e piattaforme aggiornate da Apple. Per altre informazioni, vedere What's happening to Visual Studio per Mac (Cosa sta accadendo a Visual Studio per Mac).

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.

Visual Studio

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.

Visual Studio Code

1. Nel terminale aperto nella sezione precedente immettere il comando seguente:

   dotnet add package Microsoft.Identity.Web
   

Visual Studio per Mac

1. Nel menu in alto selezionare Strumenti>Gestisci pacchetti NuGet.
2. Cercare Microsoft.Identity.Web, selezionare il Microsoft.Identity.Web pacchetto, selezionare Progetto e quindi selezionare Aggiungi pacchetto.
3. Nella finestra popup verificare che il progetto corretto sia selezionato e quindi selezionare OK.
4. Selezionare Accetta se vengono visualizzate altre finestre di accettazione della licenza.

Passaggi successivi

Esercitazione: Implementare un endpoint protetto nell'API