Connettere un'app JavaScript a Microsoft 365
È possibile aumentare il valore delle app Web connettendole a Microsoft 365. Microsoft 365 contiene dati e informazioni dettagliate che le persone creano ogni giorno nel loro ambiente di lavoro sotto forma di messaggi di posta elettronica, file e chat. Visualizzando queste informazioni nel contesto dell'app, gli utenti possono accedere facilmente alle informazioni necessarie senza dover uscire dall'app. Combinando le funzionalità uniche con le informazioni aziendali di Microsoft 365, l'app può offrire più valore.
Autenticarsi per accedere ai dati da Microsoft 365
Microsoft Graph è un'API REST che espone dati e informazioni dettagliate archiviati in Microsoft 365. Le informazioni non sono disponibili pubblicamente. Per ottenere l'accesso, gli utenti devono dimostrare la propria identità (autenticazione) e il consenso che permetta all'applicazione di accedere ai dati. Questo processo viene eseguito da Microsoft Entra ID.This job is done by Microsoft Entra ID.
L'applicazione deve ottenere un token di accesso da Microsoft Entra ID e includerlo in ogni richiesta a Microsoft Graph. È possibile considerare il token di accesso come un biglietto del cinema. L'applicazione usa il protocollo OAuth per ottenere un biglietto. Presentandolo all'addetto (Microsoft Graph) ottiene l'accesso in sala per vedere il film (le risorse protette in Microsoft 365).
Dopo aver configurato questa disposizione, gli utenti possono accedere all'app usando l'account Microsoft 365 esistente. La funzionalità consente di non dover implementare l'autenticazione nell'app e mantenere le credenziali degli utenti. Offre inoltre vantaggi agli utenti, perché non è necessario usare un'altra credenziale per accedere all'app. Le organizzazioni possono anche controllare l'accesso dei dipendenti a diverse applicazioni, il che rappresenta un requisito importante.
Il diagramma mostra il flusso del token di accesso tra Microsoft Identity, l'app e Microsoft Graph.
Connessione a Microsoft 365 tramite SDK
Sia Microsoft Entra ID che Microsoft Graph sono servizi REST, quindi in teoria tutto in questo modulo potrebbe essere realizzato con richieste HTTP dirette. Per semplificare l'operazione, Microsoft offre due kit di sviluppo software (SDK) che gestiscono automaticamente le richieste. Gli SDK si occupano della compilazione delle richieste e della gestione delle eccezioni, il che consente di concentrarsi sulla compilazione dell'app.
| Servizio | SDK |
|---|---|
| Microsoft Entra ID | Microsoft Authentication Library |
| Microsoft Graph | Microsoft Graph SDK |
Microsoft Authentication Library gestisce i dettagli del protocollo OAuth con l'ID Microsoft Entra. Usando Microsoft Authentication Library l'applicazione consente agli utenti di accedere con il proprio account Microsoft 365 e di fornire il consenso per le autorizzazioni necessarie per l'applicazione. Dopo l'accesso, Microsoft Authentication Library fornisce il token di accesso necessario per comunicare con Microsoft Graph.
Passaggi successivi
Iniziamo creando una semplice app connessa a Microsoft 365 che mostra il nome dell'utente recuperato da Microsoft 365.