SMTP via OAuth per le caselle di posta di Microsoft Office 365

1. Registrazione dell'applicazione EntraID

• Accedere all'EntraID Admin Center https://entra.microsoft.com ed effettuare il login al proprio tenant.
• Nell'area Applicazioni, fare clic su Registrazioni app e poi su Nuova registrazione.
  
• Nella sezione successiva, è sufficiente assegnare un nome all'app; i valori predefiniti per i tipi di Conto Supportati e l' URI di reindirizzamento possono essere mantenuti.

2. Creare la chiave segreta del client

• Rimanere nella vista dell'app creata e fare clic su Certificati e segreti, quindi su Nuovo segreto cliente.
  
• Assegnare un nome al segreto del cliente e selezionare 24 mesi come data di scadenza. Ricordare la data di scadenza, perché è necessario creare un nuovo segreto client dopo la scadenza dei 24 mesi, affinché l'invio SMTP in DocuWare funzioni senza interruzioni.
• Per la configurazione in DocuWare Client è necessaria solo la chiave segreta del cliente, ovvero il valore, non l'ID segreto. Tenere presente che il valore è visibile solo dopo la creazione; non appena si esce dalla pagina, il valore non è più visibile.
  

3. Assegnare le autorizzazioni SMTP

• Rimanere all'interno dell'applicazione e passare alla scheda Autorizzazioni API. Fare clic su Aggiungi un'autorizzazione per assegnare all'applicazione le autorizzazioni necessarie per le funzioni SMTP.
  
• Nell'area Request API permissions, fare clic su APIs my organization uses e cercare "Office 365 Exchange Online".
  
• Selezionare il risultato, quindi fare clic su Autorizzazioni per le applicazioni e selezionare SMTP.SendAsApp dall'elenco. Quindi fare clic su Aggiungi autorizzazioni
  
• L'utente o l'amministratore EntraID deve ora approvare la richiesta di autorizzazione.
  

4. Creare il principio di servizio per l'applicazione EntraID

• Per questo passaggio è necessario un PowerShell con accesso di amministratore e alcuni ID dell'EntraID Admin Center.
• Nell'EntraID Admin Center, andare alla sezione Identità e poi a Panoramica. Copiare l'ID del tenant.
• Tornate all'area Applicazioni, ma ora su Applicazioni aziendali e selezionate l'applicazione creata in precedenza. Copiate l'ID applicazione e l'ID oggetto.
  
  Importante: per ottenere l'ID oggetto corretto, è necessario passare dalla visualizzazione della registrazione delle app a quella delle applicazioni aziendali, altrimenti verrà visualizzato l'ID oggetto sbagliato!
• Ora aprite PowerShell e connettetevi al vostro tenant con i seguenti comandi:
  Install-Module -Name ExchangeOnlineManagement
  Import-module ExchangeOnlineManagement
  Connect-ExchangeOnline -Organization <tenantId>
• Ora create un nuovo principio di servizio con il seguente comando:
  New-ServicePrincipal -AppId [Your appID] -ObjectId [Ihre objectID]
  
• È possibile verificare l'inserimento visualizzando il principio di servizio con Get-ServicePrincipal | fl
• Ora aggiungete la casella di posta elettronica con cui desiderate inviare le e-mail in DocuWare:
  Add-MailboxPermission -Identity "invoices@example.com" -User [vostro objectID] -AccessRights FullAccess
  

5. Configurazione in DocuWare

L'ultimo passo consiste nel trasferire le informazioni da EntraID a DocuWare.

• A tale scopo, accedere a DocuWare Configurazione -> Servizi di posta -> Invio e fare clic su Nuove impostazioni SMTP.
• Assegnare un nome alla nuova configurazione, selezionare il nome visualizzato e l'indirizzo e-mail con cui inviare le e-mail. Selezionare quindi Usa autenticazione SMTP OAuth.
• I dettagli SMTP sono obbligatori:
  • Indirizzo SMTP: smtp-mail.outlook.com
  • Nome utente: l'indirizzo e-mail inserito al punto 4.
  • Crittografia: STARTTLS
  • Porta 587
• Nell'area inferiore, fare clic su Microsoft e inserire l'ID dell'applicazione EntraID e il corrispondente segreto del client creato in precedenza.
  
• È possibile trovare l'endpoint del token OAuth 2.0 (v2) dell'applicazione EntraID nell'Admin Center EntraID in Applicazioni -> Registrazioni di applicazioni -> Nome dell'applicazione -> Endpoint.
  
• Infine, verificare la configurazione con il pulsante Invia e-mail di prova.

Si prega di notare: Questo articolo è una traduzione dall'inglese. Le informazioni contenute in questo articolo si basano sulla versione originale in inglese del/i prodotto/i. Potrebbero esserci piccoli errori, ad esempio nella grammatica utilizzata nella versione tradotta dei nostri articoli. Sebbene non possiamo garantire la completa accuratezza della traduzione, nella maggior parte dei casi la troverete sufficientemente informativa. In caso di dubbi, si prega di fare riferimento alla versione inglese di questo articolo.