Configuration serveur de mail SMTP avec OAauth2

1. Configuration d’un serveur de mail SMTP Azure avec Oauth2

Pour les étapes de configuration du serveur de courriel, veuillez consulter cet article https://constellio.document360.io/preview/constellio-11/fr/2b8e9c0a-2b8c-41de-abca-da422c6717cf/4

 1.1 Configuration Azure

1. Se connecter sur le portail Azure. (https://portal.azure.com/#home)
2. Appuyer sur « Microsoft Entra ID »
3. Choisir « Inscriptions d’applications » dans le menu de gauche.
4. Si votre application n’est pas inscrite, suivre les étapes d’inscription d’application Microsoft avant de poursuivre. (https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app)
5. Si l’application est déjà inscrite, choisir l’onglet « Toutes les applications »
6. Sélectionnez votre application.
7. Notez les informations contenues dans le haut de la page. Vous aurez besoin des identifiants d’annuaire et d’application.
   1. ID d'application (client)
   2. ID de l'annuaire (locataire)
8. Appuyez sur « API autorisées » dans le menu de gauche.
9. Choisir « Ajouter une autorisation »
10. Dans la nouvelle fenêtre, choisir « API utilisées par mon organisation »
11. Tapez « Office 365 » dans la barre de recherche.
12. Choisir « Office 365 Exchange Online » dans les résultats.
13. Choisir « Autorisations d’application »
14. Ouvrir la section « Mail » et cocher la permission « Mail.Send »
15. Ouvrir la section « SMTP » et cochez la permission « SMTP.SendAsApp »
16. Appuyez sur « Ajouter des autorisations » au bas de la fenêtre.
17. Appuyez sur « Accorder un consentement d’administrateur pour … » à droite de l’option « Ajouter une autorisation »
18. Choisir « Oui » dans la nouvelle fenêtre et se connecter avec un compte admin si demandé.
19. Appuyez sur « Certificats & secrets » dans le menu de gauche.
20. Choisir « Nouveau secret client »
21. Donnez une description et une date d’expiration du secret.
22. Appuyez sur « Ajouter » au bas de la fenêtre.
23. Notez la « Valeur » du secret généré. Cette information n’est disponible que pour un temps limité après la création. Si cette information est perdue, il faudra regénérer un nouveau secret.

    ---

1.2 Configuration Exchange

1. Se connecter sur le portail Azure. (https://portal.azure.com/#home )
2. Appuyez sur « Microsoft Entra ID »
3. Choisissez « Applications d’entreprise » dans le menu de gauche.
4. Sélectionnez votre application.
5. Notez la valeur de « ID d’objet »
6. Ouvrez une fenêtre « Powershell » en tant qu'administrateur sur votre poste Windows.
7. Exécutez « Install-Module -Name ExchangeOnlineManagement -RequiredVersion 3.4.0 »
8. Exécutez « Set-ExecutionPolicy -ExecutionPolicy RemoteSigned »
9. Exécutez « Import-module ExchangeOnlineManagement »
10. Exécutez « Connect-ExchangeOnline -Organization [tenantId] » où [tenantId] est la valeur de « ID de l’annuaire » dans Azure ci-haut.
11. Connectez-vous à un compte admin dans la fenêtre qui s’ouvre.
12. Exécutez « New-ServicePrincipal -AppId [appId] -ObjectId [objId] » où [appId] est la valeur de « ID d’application » dans Azure ci-haut et [objId] est la valeur notée à l’étape 5.
13. Exécutez « Get-ServicePrincipal | fl » pour voir les infos du service créé.
14. Notez la valeur de « ExchangeObjectId »
15. Exécutez « Add-MailboxPermission -Identity “[username]” -User [exchangeId] -AccessRights FullAccess » où [username] est la valeur de la boîte de courriel de laquelle on veut envoyer les courriels et [exchangeId] est la valeur notée à l 'étape 14.
16. Validez que la permission a bien été ajoutée avec « Get-MailboxPermission -Identity “[username]” » et valider qu’il y a une entrée pour votre [objId] de l’étape 5
17. Exécutez « Set-TransportConfig -SmtpClientAuthenticationDisabled -$false »
18. Exécutez « Disconnect-ExchangeOnline

1.3 Configuration Constellio en mode "Application"

1. Connectez-vous à Constellio avec un compte disposant des autorisations pour configurer un serveur de courriel.
2. Sélectionnez « Pilotage » dans le menu de gauche.
3. Choisissez « Configurer le serveur de courriel » pour modifier votre configuration existante vers Oauth2.
4. Cocher la case « Activé »;
   
5. Choisissez « Application » comme mode d’authentification.
6. Remplissez les champs « Nom d’utilisateur » et « Courriel d’envoi par défaut » avec la valeur de la boîte configurée dans la partie Exchange ci-haut.
7. Remplir les champs « Identification du locataire » avec la valeur de « ID de l’annuaire » de la partie « Azure » ci-haut.
8. Remplir les champs « Identification de l’application » avec la valeur de « ID d’application » de la partie « Azure » ci-haut.
9. Remplir le champs « Secret client » avec la valeur du secret généré dans la partie « Azure » ci-haut.
10. Dans la section « Propriété du serveur », ajoutez la ligne « mail.smtp.auth.mechanisms=XOAUTH2 »
11. Appuyez sur « Enregistrer » au bas de la page.

1.4 Propriétés du serveur

Voici un exemple fonctionnel :

mail.smtp.port=587
 mail.smtp.starttls.required=true
 mail.smtp.auth=true
 mail.smtp.starttls.enable=true
 mail.smtp.socketFactory.port=587
 mail.smtp.host=smtp.office365.com
 mail.smtp.auth.mechanisms=XOAUTH2