SMTP via OAuth pour les boîtes aux lettres Microsoft Office 365

1. Enregistrer l'application EntraID

• Rendez-vous tout d'abord dans le centre d'administration EntraID https://entra.microsoft.com et connectez-vous à votre locataire.
• Dans la section Applications, cliquez sur App registrations et ensuite sur New registration.
  
• Dans la section suivante, vous n'avez qu'à donner un nom à l'app ; les valeurs par défaut pour les types de Compte Supporté et l' URI de Redirection peuvent être conservées.

2. créer la clé secrète du client

• Restez dans la vue de l'application créée et cliquez sur Certificats & secrets puis sur Nouveau secret client.
  
• Donnez un nom au secret client et sélectionnez 24 mois comme date d'expiration. N'oubliez pas la date d'expiration, car vous devez créer un nouveau secret client après l'expiration des 24 mois pour que l'envoi SMTP dans DocuWare fonctionne sans interruption.
• Pour la configuration dans DocuWare, seule la clé du secret du client, c'est-à-dire la valeur, est nécessaire ; l'ID du secret n'est pas nécessaire. Veuillez noter que la valeur n'est visible qu'après la création, dès que vous quittez la page, vous ne pouvez plus la voir.
  

3. Attribuer les Autorisations SMTP

• Restez dans l'application et passez à l'onglet Autorisations API. Là, cliquez sur Ajouter une autorisation pour donner à l'app les autorisations nécessaires pour les fonctions SMTP.
  
• Dans la zone Request API permissions, cliquez sur APIs my Organisations uses, puis recherchez "Office 365 Exchange Online"
  
• Sélectionnez le résultat, puis cliquez sur Autorisations d'applications et sélectionnez SMTP.SendAsApp dans la liste. Cliquez ensuite sur Ajouter des Autorisations.
  
• Vous ou l'administrateur d'EntraID devez maintenant approuver la demande d'autorisation.
  

4. Créer le principe de service pour l'application EntraID

• Pour cette étape, nous avons besoin d'un PowerShell avec un accès administrateur et quelques identifiants du centre d'administration EntraID.
• Dans le centre d'administration EntraID, allez dans la section Identité et ensuite dans Vue d'ensemble. Copiez l'ID du locataire à cet endroit.
• Retournez dans la section Applications, mais maintenant dans Applications d'entreprise et sélectionnez l'application que vous avez créée plus tôt. Copiez l'ID de l'application et l'ID de l'objet.
  
  Important: Pour obtenir l'ID d'objet correct, vous devez basculer la vue de l'enregistrement des apps vers les applications d'entreprise, sinon l'ID d'objet erroné s'affichera !
• Maintenant ouvrez PowerShell et connectez-vous à votre locataire avec les commandes suivantes :
  Install-Module -Name ExchangeOnlineManagement
  Import-module ExchangeOnlineManagement
  Connect-ExchangeOnline -Organisation <tenantId>
• Créez maintenant un nouveau principe de service avec la commande suivante :
  New-ServicePrincipal -AppId [Your appID] -ObjectId [Ihre objectID]
  
• Vous pouvez vérifier votre entrée en affichant le principe de service avec Get-ServicePrincipal | fl
• Ajoutez maintenant la boîte aux lettres avec laquelle vous souhaitez envoyer des e-mails dans DocuWare :
  Add-MailboxPermission -Identity "invoices@example.com" -User [Your objectID] -AccessRights FullAccess
  

5. Configuration dans DocuWare

La dernière étape consiste à transférer les informations de l'EntraID vers DocuWare.

• Pour ce faire, allez dans DocuWare Configuration -> Services de messagerie -> Envoi et cliquez sur Nouveaux paramètres SMTP.
• Donnez un nom à la nouvelle configuration, sélectionnez le nom d'affichage et l'adresse e-mail avec laquelle les e-mails doivent être envoyés. Ensuite, sélectionnez Utiliser l'authentification SMTP OAuth.
• Les détails SMTP sont obligatoires :
  • Adresse SMTP : smtp-mail.outlook.com
  • Nom d'utilisateur : l'adresse e-mail que vous avez saisie à l'étape 4
  • Cryptage : STARTTLS
  • Port 587
• Dans la partie inférieure, cliquez sur Microsoft et entrez l'ID de l'application EntraID et le secret client correspondant que vous avez créé précédemment.
  
• Vous pouvez trouver le point de terminaison du jeton OAuth 2.0 (v2) de votre application EntraID dans le centre d'administration EntraID sous Applications -> Enregistrements d'applications -> Nom de votre application -> Points de terminaison.
  
• Enfin, veuillez tester votre configuration à l'aide du bouton Envoyer un e-mail de test.

Veuillez noter : Cet article est une traduction de l'anglais. Les informations contenues dans cet article sont basées sur la ou les versions originales des produits en langue anglaise. Il peut y avoir des erreurs mineures, notamment dans la grammaire utilisée dans la version traduite de nos articles. Bien que nous ne puissions pas garantir l'exactitude complète de la traduction, dans la plupart des cas, vous la trouverez suffisamment informative. En cas de doute, veuillez revenir à la version anglaise de cet article.