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.
- Aprire Visual Studio e quindi selezionare Crea un nuovo progetto.
- Cercare e scegliere il modello core vuoto ASP.NET e quindi selezionare Avanti.
- Immettere un nome per il progetto, ad esempio NewWebAPILocal.
- Scegliere un percorso per il progetto o accettare l'opzione predefinita e quindi selezionare Avanti.
- Accettare il valore predefinito per Framework e Configurare per HTTPS.
- 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.
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
.
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.
- Nel menu in alto selezionare Strumenti>NuGet Gestione pacchetti> Gestisci pacchetti NuGet per la soluzione.
- 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. - Selezionare OK o Accetto per altre finestre che possono essere visualizzate.