Configurare Microsoft 365
Per Microsoft 365 / Exchange Online selezionare Office365 come versione Exchange.
Quando il campo Mail Server è vuoto, il connettore propone normalmente outlook.office365.com.
Requisito di rete per Microsoft Graph
Con Microsoft 365/Graph il connettore utilizza notifiche push per ricevere gli eventi e le modifiche da Microsoft. L'endpoint pubblico di vtenext utilizzato dal connettore deve quindi essere raggiungibile via Internet dai server Microsoft. Se Microsoft non riesce a raggiungere l'endpoint, la gestione standard degli eventi in ricezione non funziona correttamente.
Prima di mettere in produzione il connettore verificare quindi che l'istanza vtenext sia pubblicata in modo corretto, raggiungibile dall'esterno tramite HTTPS e che firewall, reverse proxy o altri sistemi di sicurezza non impediscano a Microsoft di contattare l'endpoint del connettore.
È tecnicamente possibile predisporre manualmente una modalità di sincronizzazione basata su controlli periodici via cron anziché sulle notifiche push. Questa configurazione è fortemente sconsigliata, non rappresenta il funzionamento standard del connettore e non è prevista come configurazione self-service: richiede una configurazione specifica ad hoc.
Scegliere la modalità di collegamento
Sono disponibili due modalità.
È la modalità più semplice quando non si vuole configurare e gestire direttamente una propria applicazione Microsoft. Non richiede l'inserimento manuale di Tenant ID, Client ID e Client Secret. Ogni utente dovrà comunque effettuare il proprio login Microsoft tramite Connect.
App Microsoft personalizzata
Utilizzare questa modalità quando il cliente vuole gestire direttamente la propria applicazione nel tenant Microsoft.
Devono essere inseriti:
- Tenant ID;
- Client ID;
- Client Secret.
L'app Microsoft deve essere configurata con il redirect URI dell'istanza vtenext:
https://VOSTRO-VTENEXT/modules/Exchange/oAuth2/AuthorizationCode.php
Sostituire https://VOSTRO-VTENEXT con l'indirizzo reale del CRM.
Permessi richiesti
L'app deve consentire all'utente di autorizzare l'accesso a:
- Calendario;
- Contatti;
- Attività / To Do;
- accesso offline necessario al rinnovo della sessione.
L'autorizzazione è delegata al singolo utente: ogni utente collega il proprio account Microsoft.
Attenzione quando si cambia modalità
Se si passa da Proxy vtenext ad App personalizzata, o viceversa, i collegamenti Microsoft esistenti devono essere riautorizzati.
Dopo il cambio:
- salvare la nuova configurazione;
- aprire i profili degli utenti Exchange;
- ripetere Connect;
- verificare nuovamente le cartelle;
- eseguire un test di sincronizzazione.
Programmare prima la riautorizzazione degli utenti e i test di verifica.