Esercitazione: Preparare un'applicazione per l'autenticazione

Nell'esercitazione precedente è stata registrata un'applicazione Web nell'interfaccia di amministrazione di Microsoft Entra. Questa esercitazione illustra come creare un'app Web ASP.NET Core usando un IDE. Si creerà e caricherà anche un certificato autofirmato nell'interfaccia di amministrazione di Microsoft Entra per proteggere l'applicazione. Infine, si configurerà l'applicazione per l'autenticazione.

Contenuto dell'esercitazione:

Prerequisiti

• Completamento dei prerequisiti e dei passaggi descritti in Esercitazione: Registrare un'applicazione con Microsoft Identity Platform.
• È possibile scaricare un IDE usato in questa esercitazione qui.
  • 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.

Creare e caricare un certificato autofirmato

L'uso dei certificati è un modo consigliato per proteggere la comunicazione tra client e server. Ai fini di questa esercitazione, nella directory del progetto verrà creato un certificato autofirmato. Altre informazioni sui certificati autofirmato sono disponibili qui.

Caricare il certificato nell'interfaccia di amministrazione di Microsoft Entra

Per rendere il certificato disponibile per l'applicazione, è necessario caricarlo nel tenant.

1. A partire dalla pagina Panoramica dell'app creata in precedenza, in Gestisci selezionare Certificati e segreti e selezionare la scheda Certificati (0).

2. Selezionare Carica certificato.

   

3. Selezionare l'icona della cartella , quindi cercare e selezionare il certificato creato in precedenza.

4. Immettere una descrizione per il certificato e selezionare Aggiungi.

5. Registrare il valore identificazione personale , che verrà usato nel passaggio successivo.

   

Configurare l'applicazione per l'autenticazione e le informazioni di riferimento sulle API

I valori registrati in precedenza verranno usati per configurare l'applicazione per l'autenticazione. Il file di configurazione, appsettings.json, viene usato per archiviare le impostazioni dell'applicazione usate durante il runtime. Poiché l'applicazione chiamerà anche in un'API Web, deve contenere anche un riferimento.

1. Nell'IDE aprire appsettings.json e sostituire il contenuto del file con il frammento di codice seguente. Sostituire il testo tra virgolette con i valori registrati in precedenza.

   {
   "AzureAd": {
     "Instance": "https://login.microsoftonline.com/",
     "TenantId": "Enter the tenant ID obtained from the Microsoft Entra admin center",
     "ClientId": "Enter the client ID obtained from the Microsoft Entra admin center",
     "ClientCertificates": [
       {
         "SourceType": "StoreWithThumbprint",
         "CertificateStorePath": "CurrentUser/My",
         "CertificateThumbprint": "Enter the certificate thumbprint obtained the Microsoft Entra admin center"
       }   
     ],
     "CallbackPath": "/signin-oidc"
   },
     "DownstreamApi": {
       "BaseUrl": "https://graph.microsoft.com/v1.0/",
       "RelativePath": "me",
       "Scopes": [ 
         "user.read" 
       ]
     },
     "Logging": {
       "LogLevel": {
         "Default": "Information",
         "Microsoft.AspNetCore": "Warning"
       }
     },
     "AllowedHosts": "*"
   }
   

   • Instance - Endpoint di autenticazione. 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.
   • ClientCertificates - Viene usato un certificato autofirmato per l'autenticazione nell'applicazione. Sostituire il testo di CertificateThumbprint con l'identificazione personale del certificato registrato in precedenza.
   • CallbackPath - Identificatore che consente al server di reindirizzare una risposta all'applicazione appropriata.
   • DownstreamApi - Identificatore che definisce un endpoint per l'accesso a Microsoft Graph. L'URI dell'applicazione viene combinato con l'ambito specificato. Per definire la configurazione per un'applicazione di proprietà dell'organizzazione, il valore dell'attributo Scopes è leggermente diverso.

2. Salvare le modifiche apportate al file .

3. Nella cartella Proprietà aprire il file launch Impostazioni.json.

4. Trovare e registrare il valore all'interno dell'avvio httpsImpostazioni.json, ad esempio https://localhost:{port}.applicationURI Questo URL verrà usato quando si definisce l'URI di reindirizzamento. Non usare il http valore .

Aggiungere un URI di reindirizzamento della piattaforma

1. Nell'interfaccia di amministrazione di Microsoft Entra, in Gestisci selezionare Registrazioni app e quindi selezionare l'applicazione creata in precedenza.

2. Nel menu a sinistra, in Gestisci, selezionare Autenticazione.

3. In Configurazioni della piattaforma selezionare Aggiungi una piattaforma e quindi Selezionare Web.

   

4. In URI di reindirizzamento immettere applicationURL e CallbackPath/signin-oidc, sotto forma di https://localhost:{port}/signin-oidc.

5. In URL di disconnessione del canale anteriore immettere l'URL seguente per la disconnessione, https://localhost:{port}/signout-oidc.

6. Seleziona Configura.

Passaggi successivi