Comment configurer Winbiz pour envoyer des e-mails depuis Microsoft Office 365 (OAuth2)
Introduction
L’envoi de courriels à partir de Winbiz9 nécessite pour les détenteurs de comptes auprès de Microsoft Office 365, l’utilisation d’une authentification OAuth2. L’utilisation d’une connexion SMTP n’est plus autorisée pour les comptes Office 365 et l’utilisateur doit dorénavant « autoriser » l’envoi de courriels à partir de Winbiz9.
La mise en place de cette authentification nécessite d’enregistrer auprès de Microsoft l’application qui effectue le pont entre Winbiz9 et Microsoft, que nous appelons Winbiz9-MailBridge.
Le but de ce document est d’expliquer la procédure d’enregistrement pour l’obtention d’un identifiant unique (Client ID) auprès de Microsoft pour cette application. Cet identifiant est utilisé pour les échanges entre Winbiz9-MailBridge et Microsoft Office 365 pour identifier l’application.
Etape 1 – Inscription de l’application dans Microsoft 365
Tout se fait dans Microsoft Entra (anciennement Azure AD).
URL : https://entra.microsoft.com
⚠️ Important : Cette configuration nécessite des droits d’administrateur sur votre environnement Microsoft 365.
Si vous ne disposez pas de ces droits ou si votre environnement Microsoft 365 est géré par un prestataire externe, nous vous invitons à vous rapprocher de votre service informatique ou de votre prestataire IT afin de réaliser les étapes de configuration décrites ci-dessous.
Accéder à l’inscription d’application
Les menus sont indiqués ci-dessous dans la version anglaise du site Microsoft, les copies d’écrans qui suivent présentent le site Microsoft en version française.
1. Se connecter avec son compte Microsoft 365 (celui qui servira à créer l’application).
2. Menu de gauche -> Applications
3. Cliquer sur App Registrations
4. Cliquer sur New Registration.
Paramétrage de l’application
- Nom :
Par exemple Winbiz9-MailBridge, mais vous pouvez donner un autre nom à cette application.
- Supported account types :
Cela permettra à tous les clients Microsoft 365 d’autoriser l’application.
Sinon elle ne fonctionne que dans le tenant du compte qui a créé l’application.
- Redirect URI :
Pour le Device Code Flow (méthode utilisée pour la communication MailBridge-Office 365) :
Mais pour éviter tout souci, mettre :
Puis cliquer sur Register.
Etape 2 – Configuration après création
Activer Client credentials / app-only
Menu gauche Authentication
Dans la section Advanced Settings.
Désactiver :
Cliquer sur le bouton Register pour que les modifications soient prises en compte.
Etape 3 – Ajouter les permissions Graph
Menu gauche API permissions
Cliquer sur Add a permission
Cliquer sur Microsoft Graph
Puis Application permissions
Ajouter :
- Mail.Send
Cliquer sur Add autorisations
Autorisations d’application :
Autorisations déléguées :
Etape 4 – Secret Client
Menu gauche Certificats & secrets
Cliquer sur Nouveau secret client
Renseigner la description et la date d’expiration
Etape 5 – Admin consent
Il faut accorder un consentement d’administrateur pour l’application.
Menu de gauche Applications
Cliquer sur App Registrations
Puis sur l’application Winbiz9-MailBridge (ou le nom que vous avez donné)
Lorsque vous êtes dans l’écran de l’application, cliquez sur Autorisations
S’il apparaît dans l’onglet « Admin consent » la phrase suivante :
Cela montre qu’actuellement il n’y a pas encore de consentement approuvé ici.
Il faut utiliser le bouton :
Afin de donner le consentement pour le tenant de votre société.
Etape 6 – Utilisateurs et groupes
Il faut ajouter les utilisateurs/groupes qui pourront utiliser cette application, c’est-à-dire envoyer des e-mails via Microsoft Graph.
Menu de gauche Applications
Cliquer sur Utilisateurs et groupes
Ajouter les utilisateurs/groupes.
A la fin de cette étape, les utilisateurs peuvent maintenant paramétrer Winbiz pour envoyer des emails via Microsoft Graph.
Etape 7 – Paramétrage Winbiz
Lancer Winbiz et ouvrir les options communes du serveur de messagerie.
Menu de gauche Outils / Options
Ou les options utilisateur : Outils / E-mail, puis Options / Options spécifiques à l’utilisateur
Sélectionnez Microsoft OAuth2.0
Cliquez sur l’onglet Microsoft OAuth2 pour renseigner les paramètres :
Correspondance des paramètres avec Microsoft Entra :
- Adresse e-mail
Cette adresse doit figurer dans la liste des utilisateurs / groupes définie pour votre application dans Microsoft Entra (voir page 10).
- Application Microsoft Entra
C’est le nom de l’application que vous avez créée dans Microsoft Entra. Dans l’exemple ci-dessus, il s’agit de Winbiz9-MailBridge, défini en page 3.
- ID de l’annuaire (Tenant ID)
Cet ID de tenant est indiqué dans votre Microsoft Entra.
Menu de gauche Vue d’ensemble
- ID de l’application (Client ID)
Cet ID d’application se trouve dans les propriétés de l’application créée dans votre Microsoft Entra.
Menu de gauche Applications d’entreprise
Cliquer sur Toutes les applications
Puis sur l’application Winbiz9-MailBridge (ou le nom que vous avez donné)
- Secret Code (Client Secrets)
Il s’agit du Secret Client défini à l’étape 4 en page 7