Prima di avviare il processo di sincronizzazione tra Microsoft Outlook e InterAction utilizzando GraphAPI, assicurati di avere un account Microsoft Developer, il .NET Framework 4.8 e le autorizzazioni corrette per la registrazione dell'app su Azure AD. Inoltre, verifica la connettività del server a graph.microsoft.com sulla porta 443, abilita il supporto TLS 1.2 nel Framework .NET di Windows, installa il certificato necessario e scegli una porta interna di lavoro appropriata per garantire un'esecuzione fluida della sincronizzazione.
Prima di iniziare il processo di configurazione della sincronizzazione tra Microsoft Outlook e InterAction, assicurati che siano soddisfatti i seguenti prerequisiti:
- Un account Microsoft Developer
- Microsoft .NET Framework 4.8
-
Accesso al portale Azure Directory con permessi per creare e modificare le registrazioni delle app
Si consiglia agli utenti di registrare l'account utente nella registrazione dell'app su Azure AD per ottenere Application ID, Tenant ID e Secret Key necessari per utilizzare il processo di sincronizzazione da Microsoft Outlook a InterAction tramite GraphAPI.
Verifica l’accesso del server a MS Graph su Internet
Per verificare che il server possa connettersi al sito Microsoft graph.microsoft.com sulla porta 443:
- Apri PowerShell e inserisci il comando `tnc graph.microsoft.com -port 443` per testare la connettività. Premi Invio.
- Controlla i risultati per confermare la connettività riuscita al sito Microsoft Graph sulla porta 443. I risultati dovrebbero mostrare 'TcpTestSucceeded : True'. Se compare False, il server non ha accesso a graph.microsoft.com. Contatta gli amministratori di rete per ottenere l’accesso.
Abilita il supporto alla crittografia TLS 1.2 nel Framework .NET di Windows
La sincronizzazione con MS Graph richiede una connessione crittografata TLS 1.2 per funzionare correttamente. Senza questa, la sincronizzazione non funzionerà in modo corretto.
Microsoft fornisce istruzioni su come abilitare TLS 1.2 per il Framework .NET qui.
Per le applicazioni a 32 bit che girano su sistemi operativi a 32 bit e per le applicazioni a 64 bit che girano su sistemi operativi a 64 bit, aggiorna i seguenti valori delle sottochiavi:
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v2.0.50727]
"SystemDefaultTlsVersions" = dword:00000001
"SchUseStrongCrypto" = dword:00000001
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\v4.0.30319]
"SystemDefaultTlsVersions" = dword:00000001
"SchUseStrongCrypto" = dword:00000001Per le applicazioni a 32 bit che girano su sistemi operativi a 64 bit, aggiorna i seguenti valori delle sottochiavi:
[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\v2.0.50727]
"SystemDefaultTlsVersions" = dword:00000001
"SchUseStrongCrypto" = dword:00000001
[HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\.NETFramework\v4.0.30319]
"SystemDefaultTlsVersions" = dword:00000001
"SchUseStrongCrypto" = dword:00000001Installa il certificato
Non è richiesta l’installazione di IIS sul server.
La sincronizzazione utilizzerà un certificato per crittografare la comunicazione con Microsoft Graph. Puoi acquistare un certificato da una terza parte come DigiCert, crearne uno tramite l’autorità di certificazione della tua azienda, oppure utilizzare un certificato autofirmato con lo strumento LexisNexis Certificate Maintenance Tool.
- Accedi come amministratore sul server.
- Apri la finestra di dialogo Esegui premendo Start > Esegui, poi digita `certlm.msc` e premi Invio. Potrebbero volerci alcuni secondi per il caricamento.
- Nel Gestore Certificati, espandi la cartella Personale e poi seleziona Certificati.
- Scegli il certificato da installare. Può essere autofirmato, creato da una CA privata o da una CA pubblica.
- Assicurati che i campi Subject e Subject Alternative Name siano compilati con un carattere jolly o con il nome del server.
-
Dopo aver installato il certificato, fai doppio clic su di esso e seleziona la scheda Dettagli. Scorri verso il basso e trova il valore Thumbprint. Prendine nota o copialo su Blocco Note, poiché sarà richiesto durante l’installazione dello strumento Admin.
Se IQ è installato anche su questo server, puoi utilizzare il certificato IQ per la sincronizzazione con MS Graph. Basta recuperare il valore del suo thumbprint.
Scegli una porta interna di lavoro
- Scegli una porta interna su cui lavorare. Non sono necessarie modifiche al firewall poiché questa porta non viene utilizzata per la comunicazione.
- Apri il prompt dei comandi ed esegui il comando `netstat -ano` e premi Invio per vedere l’elenco delle porte attualmente in uso.
- Controlla l’elenco delle porte visualizzato dal comando `netstat -ano`.
- Seleziona una porta che non è presente nell’output. Le porte consigliate sono 8150 o 8231.
È fondamentale verificare che tutti i prerequisiti siano soddisfatti per garantire un’esecuzione fluida e senza problemi del processo.