Come passare all'autenticazione oAuth2 per Connect to Mail

Domanda:
Come posso passare al meglio le mie configurazioni di Connect to Mail all'utilizzo dell'autenticazione OAuth2?

Risposta:
Fare riferimento alla seguente guida su come abilitare l' autenticazione OAuth2 per Connect to Mail:

Informazioni di base
Microsoft ha dichiarato che l'Autenticazione di base è ufficialmente annunciata come deprecata a partire dal 1° ottobre 2022. Dopo questa data, non sarà più possibile configurare l'Autenticazione di base per i sistemi Exchange Online.

Con l'imminente deprecazione, sarà necessario implementare l'autenticazione OAuth2 per garantire che i lavori Connect to Mail rimangano funzionanti. Le modifiche possono variare a seconda della situazione del sistema DocuWare in uso.Considerare i seguenti scenari per iniziare a utilizzare OAuth2.

Per ulteriori informazioni sulla deprecazione dell'autenticazione di base, vedere: Deprecazione dell'autenticazione di base/exchange-online

***Nota: anche quando l'Autenticazione di base è disattivata, SMTP Auth sarà ancora disponibile.***

Per i clienti Cloud che non hanno creato un'applicazione autonoma in Azure
Non è necessario creare una configurazione del servizio di posta poiché forniamo già tutto ciò che serve per connettersi all'account di posta di Office 365 con OAuth2.Andate al vostro plugin "General Email" e connettetevi direttamente con il vostro account Office 365 selezionando l'opzione "Exchange Online".


Per i clienti Cloud che utilizzano un'app creata autonomamente in Azure
Se volete connettervi a Office 365 con la vostra app creata autonomamente, seguite i passaggi seguenti:

Registrate l'app OAuth nell'Azure Active Directory della vostra organizzazione.

1. Passare alla registrazione delle app dell'organizzazione e fare clic sull'icona Nuova registrazione più[https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RegisteredApps].
   
2. Assegnare un nome di visualizzazione e fornire un URI di reindirizzamento, ad esempio "https://my-company.com/DocuWare/Settings?link=MailCapture"
   Nota: l'URI di reindirizzamento è sensibile alle maiuscole e deve essere accessibile da Internet. Questo URI di reindirizzamento sarà richiamato da Microsoft dopo che l'utente si è autenticato con successo.
   
   
3. Aprire il menu "Autenticazione" da sinistra e scorrere fino all'intestazione "Concessione implicita". Assicuratevi che siano spuntati sia "Token di accesso" che "Token ID" , quindi salvate le modifiche.
   
4. Passare al menu "Certificati e segreti" e creare un nuovo segreto del cliente. Conservare il segreto del cliente in modo sicuro. Ci servirà in seguito per registrare l'app in DocuWare Mail Services.
5. Successivamente, nel menu di registrazione dell'app, selezionare "Autorizzazioni API" e aggiungere una nuova autorizzazione.
   • Selezionare "Microsoft Graph" dalle API Microsoft e fare clic su "Autorizzazioni delegate".
   • Aggiungere le seguenti autorizzazioni e memorizzare le modifiche:
     • accesso offline
     • openid
     • EWS.AccessAsUser.All
     • Utente.Leggi
       
6. Infine, fare clic su "Concedi il consenso di amministrazione per IL NOME DELLA TUA AZIENDA" nella panoramica delle autorizzazioni configurate. Questo passo è facoltativo. Se non si concede l'accesso ora, un amministratore dell'organizzazione dovrà farlo in seguito.In caso contrario, l'utente non sarà in grado di concedere l'autorizzazione per Connect to Mail.
7. Congratulazioni! L'applicazione OAuth2 personale è stata configurata con successo. Passare alla panoramica e copiare i valori di "Application (client) ID", "OAuth 2.0 authorization endpoint (v2)" e "OAuth 2.0 token endpoint (v2)" (dal menu Endpoints). Ci serviranno per registrarci nel plugin dei servizi di posta.
   

1. Da Azure Active Directory, aprite la sezione "Applicazioni aziendali".
2. Passare quindi a "Consenso e autorizzazioni"[https://portal.azure.com/?l=en.en-us#blade/Microsoft_AAD_IAM/ConsentPoliciesMenuBlade/UserSettings].
3. Nel sottomenu "Impostazioni del consenso dell'utente (Anteprima)", selezionate "Consenti il consenso dell'utente per le app di editori verificati, per le autorizzazioni selezionate (Consigliato)".
   
4. Le autorizzazioni per i clic sono classificate come a basso impatto e le API di Exchange Web Services dovrebbero essere visualizzate come segue:
   
   Permissions
   EWS.AccessAsUse.All
   Offline_access
   profile
   openid
   email
   User.Read
   
   
5. Ricordate di salvare le modifiche e gli utenti potranno ora concedere l'accesso a questa applicazione. Procedere con la sezione seguente.

1. Aprire le Configurazioni di DocuWare[https://your-DocuWare/DocuWare/Settings].
2. Aprire il plugin Mail Service e selezionare Crea un nuovo servizio di posta di Exchange.
3. Assicurarsi che il tipo di autenticazione sia impostato su "Usa autenticazione OAuth2".
4. Compilare tutti i dettagli annotati durante la creazione della nuova registrazione dell'applicazione Azure Active Directory.
5. Non dimenticate di inserire lo stesso URI di reindirizzamento della registrazione (ad esempio, "https://my-company.com/DocuWare/Settings?link=MailCapture").
6. Potrebbe essere necessario modificare l'URL di Exchange Web Services.
7. Memorizzare e salvare la configurazione
8. Ora è possibile utilizzare la nuova connessione al servizio di posta di Exchange nel plugin General Email.

1. Aprite un browser e visitate il centro di amministrazione di Azure Active Directory, accedendovi con un account personale (alias: Microsoft Conto) o con un account di lavoro o scolastico.
2. Selezionate Azure Active Directory nella navigazione a sinistra, quindi selezionate Registrazioni app in Gestione.
3. Selezionare Nuova registrazione. Nella pagina Registra un'applicazione impostate i valori come segue.
   • Impostate Nome con un nome amichevole per la vostra applicazione.
   • Impostate Supported account types (Tipi di conto supportati ) sulla scelta più adatta al vostro scenario.
   • Per URI di reindirizzamento, cambiare il menu a tendina in Web e impostare il valore su "https://my-company.com/DocuWare/Settings?link=MailCapture".
4. Scegliere Registra. Nella pagina successiva, copiare il valore dell'ID applicazione (client), che servirà in seguito.

• ID applicazione (client)
• Segreto del client
• Endpoint di autorizzazione OAuth 2.0
• Endpoint token OAuth 2.0
• URI di reindirizzamento

1. Aprire le Configurazioni di DocuWare[https://your-DocuWare/DocuWare/Settings].
2. Aprire il plugin Mail Service e selezionare Crea un nuovo servizio di posta di Exchange.
3. Assicurarsi che il tipo di autenticazione sia impostato su "Usa autenticazione OAuth2".
4. Compilare tutti i dettagli annotati durante la creazione della nuova registrazione dell'applicazione Azure Active Directory.
5. Non dimenticate di inserire lo stesso URI di reindirizzamento della registrazione (ad esempio, "https://my-company.com/DocuWare/Settings?link=MailCapture").
6. Potrebbe essere necessario modificare l'URL di Exchange Web Services.
7. Memorizzare e salvare la configurazione
8. Ora è possibile utilizzare la nuova connessione al servizio di posta Exchange nel plugin General Email.