Esercizio: connettere un'app ASP.NET Core per Microsoft 365

  • 5 minuti

In questo esercizio si userà un'applicazione ASP.NET Core e la si connetterà a Microsoft 365. Si userà un assembly .NET Core denominato Microsoft.Identity.Web per consentire agli utenti di accedere all'app con l'account Microsoft 365. Il nome e l'immagine del profilo degli utenti verranno quindi visualizzati con Microsoft Graph .NET Core SDK.

Configurare ed eseguire l'app di esempio

Questo esercizio semplifica la creazione di un'app Web di base. Per ottenere il codice dell'app iniziale che si userà, passare a https://github.com/microsoftdocs/mslearn-m365-microsoftgraph-dotnetcorerazor e scegliere una delle opzioni seguenti:

  • Se si usa Git, clonare il progetto usando il comando Git Clone:

    git clone https://github.com/microsoftdocs/mslearn-m365-microsoftgraph-dotnetcorerazor.git

  • Se non si usa Git, selezionare il pulsante Codice seguito da Scarica ZIP. Estrarre il file *.zip nel computer.

Dopo aver creato l'app iniziale nel computer, seguire questa procedura per aprire l'app nell'editor di codice.

  1. Passare alla cartella con il codice sorgente dell'app e selezionare una delle opzioni seguenti a seconda dell'editor di codice.

    • Visual Studio (2019 versione 16.11.0 o successiva)

      Fare doppio clic su MicrosoftGraph-DotNetCoreRazor.sln nella cartella mslearn-m365-microsoftgraph-dotnetcorerazor/Begin per aprire il progetto.

    • Visual Studio Code o un altro editor di codice

      Aprire la cartella mslearn-m365-microsoftgraph-dotnetcorecoreor/Begin nell'editor di codice.

  2. Nell'editor di codice aprire il file appsettings.json ed esaminare alcune delle impostazioni.

  3. Modificare il valore della proprietà Scopes nel modo seguente per consentire l'accesso alla lettura del profilo e della presenza di un utente, delle impostazioni della cassetta postale (per le informazioni sul fuso orario) e dei calendari.

    user.read presence.read mailboxsettings.read calendars.read

  4. Salvare appsettings.json prima di continuare.

  5. Per aggiungere i valori ClientId e ClientSecret di Microsoft Entra ID, si useranno ASP.NET segreti dell'app Core.

  6. Aprire una finestra del terminale nella radice della cartella mslearn-m365-microsoftgraph-dotnetcorerazor/Begin ed eseguire i comandi seguenti, sostituendo YOUR_APP_ID con l'ID applicazione (client) dal portale di Azure e YOUR_APP_SECRET con il segreto dell'applicazione creato.

    dotnet user-secrets init
dotnet user-secrets set "AzureAd:ClientId" "YOUR_APP_ID"
dotnet user-secrets set "AzureAd:ClientSecret" "YOUR_APP_SECRET"

    Importante

    In un'applicazione di produzione è possibile archiviare le informazioni riservate in un percorso sicuro, ad esempio Azure Key Vault.

  7. In questo progetto vengono usati gli assembly Microsoft Identity Platform e Microsoft Graph seguenti:

    • Microsoft.Identity.Web: utilizzato per richiedere e gestire i token di accesso.
    • Microsoft.Identity.Web.UI: fornisce l'interfaccia utente per accedere e disconnettersi.
    • Microsoft.Identity.Web.MicrosoftGraph: fornisce l'inserimento delle dipendenze per Microsoft Graph SDK.

  8. Eseguire il passaggio seguente in base all'Editor di codice:

    • Visual Studio

      Premere F5 per compilare ed eseguire il progetto.

    • Visual Studio Code o un altro Editor di codice

      Aprire una finestra del terminale nella cartella Begin ed eseguire il comando seguente:

      dotnet run

    Importante

    Se viene visualizzato un avviso che indica che il certificato per localhost non è attendibile, vedere Considerare attendibile il certificato di sviluppo HTTPS di ASP.NET Core in Windows e macOS per istruzioni sull'uso dell'interfaccia della riga di comando di .NET Core per considerare attendibile il certificato di sviluppo. Se si usa Visual Studio e non è già stato approvato un certificato per sviluppatore nel computer, potrebbe essere richiesto di approvare un certificato.

  9. Aprire un browser e passare a https://localhost:5001

    Consiglio

    Se si usa Microsoft 365 nel lavoro quotidiano e si prevede di eseguire questa esercitazione in un tenant di sviluppo (come consigliato), potrebbe essere utile lavorare in modalità privata o anonima nel browser. Si può anche scegliere di usare un browser o un profilo di browser diverso da quello usato normalmente nell'ambiente di produzione.

  10. Accedi con il tuo account Microsoft 365.

  11. Dopo aver eseguito l'accesso, verrà richiesto di fornire il consenso per le autorizzazioni necessarie. Selezionare la casella di controllo per fornire il consenso alle autorizzazioni per l'organizzazione e quindi selezionare Accetta.

  12. L'app dovrebbe mostrare un messaggio di benvenuto con il nome utente e l'immagine del profilo.

  13. Chiudere il browser e premere CTRL+Cnella finestra del terminale per arrestare il server.

    Nota

    Se il progetto è stato aperto in Visual Studio, è possibile chiudere il browser o selezionare MAIUSC+F5 in Visual Studio per arrestare il server. Chiudere la finestra del terminale creata da Visual Studio se è ancora aperta.