IsiNeva

Windev – Mail via Microsoft 365 avec OAuth 2.0

,
windev Microsoft 365 OAuth

Envoyer des emails via Microsoft 365 en toute sécurité depuis une application Windev est aujourd’hui possible grâce au protocole OAuth 2.0. Cette méthode remplace les anciennes authentifications de base (login / mot de passe), désormais dépréciées pour des raisons de sécurité. Pour permettre cette intégration, une configuration préalable sur le portail Azure est indispensable. Cet article vous guide pas à pas pour créer votre environnement OAuth chez Microsoft 365.

Prérequis

  • Un abonnement Microsoft 365 avec un accès administrateur à Azure AD.
  • Un compte avec les droits suffisants pour créer une application enregistrée.
  • Le projet Windev sur le github IsiNeva (classe cl_IsiNeva_MicrosoftMailEnvoi).

1 : Accéder au portail Azure

  1. Rendez-vous sur https://portal.azure.com
  2. Connectez-vous avec un compte disposant des droits d’administration.
  3. Dans le menu de gauche, accédez à Azure Active Directory.

2 : Enregistrement de l’application

  1. Cliquez sur « Inscriptions d’applications » puis sur « Nouvelle inscription ».
  2. Donnez un nom à votre application (ex: Windev Mailer).
  3. Choisissez « Comptes dans cet annuaire organisationnel uniquement ».
  4. Pour le champ URI de redirection, entrez http://localhost (utile pour les tests ou selon l’implémentation Windev).
  5. Cliquez sur « Enregistrer ».

3 : Génération du Client Secret

  1. Une fois l’application créée, allez dans « Certificats et secrets ».
  2. Cliquez sur « Nouveau secret client ».
  3. Entrez une description (ex: Windev Secret) et une durée de validité (1 an, 2 ans, etc).
  4. Cliquez sur « Ajouter ».
  5. Copiez immédiatement la valeur du secret. Elle ne sera plus visible ensuite.

4 : Permissions API

  1. Allez dans « Autorisations API ».
  2. Cliquez sur « Ajouter une autorisation ».
  3. Choisissez Microsoft Graph > Autorisation d’application.
  4. Recherchez et ajoutez :
    • Mail.Send
    • Mail.ReadWrite
    • (optionnel) User.Read
  5. Cliquez sur « Ajouter les autorisations ».
  6. Cliquez ensuite sur « Accorder le consentement de l’administrateur ».

5 : Récupération des identifiants OAuth

Une fois l’application configurée, notez les éléments suivants qui seront nécessaires dans votre code Windev :

  • ID client (client_id) : visible dans la page de l’application.
  • Secret client (client_secret) : copié à l’étape précédente.
  • ID de locataire (tenant_id) : visible dans Azure Active Directory > Vue d’ensemble.

6 : et dans Windev…

IsiNeva met à disposition un repository github avec un projet contenant une classe en exemple pour envoyer des emails via M365.

oISINEVA_Mail	est un cl_IsiNeva_MicrosoftMailEnvoi dynamique
sTenantId est une chaîne= "XXXXXXXX-XXX-XXXX-XXXX-XXXXXXXXXXXX"
sCLientID est une chaîne= "YYYYYYYY-YYY-YYYY-YYYY-YYYYYYYYYYYY"
sClientSecret est une chaîne= "ZZZZZZZZ-ZZZ-ZZZZ-ZZZZ-ZZZZZZZZZZZZ"

oISINEVA_Mail = new cl_IsiNeva_MicrosoftMailEnvoi(sTenantId, sCLientID , sClientSecret)

SI PAS oISINEVA_Mail.bMailEnvoi(sExpediteur,asDestinataires,asCopieA,
                                sObjet,sContenu,asFichiersJoints,Vrai, sErreur) ALORS
	Erreur(sErreur)
SINON
	Info("Envoi Ok")
FIN

Remplacez les valeurs de sTenantId, sCLientID et sClientSecret par vos valeurs, et les mails seront envoyés.

URL du repository : https://github.com/LG-IsiNeva/WindevMicrosoft365Email

Conclusion

Vous avez maintenant toutes les clés pour intégrer l’envoi de mails via OAuth dans vos applications Windev. Cette méthode assure une meilleure sécurité et compatibilité avec les standards modernes de Microsoft 365.

Chez IsiNeva, nous intégrons cette configuration directement dans vos projets pour vous garantir une délégation sécurisée et une expérience utilisateur transparente.

Liens externes