• Obtenir les identifiants client
  • Google OAuth
  • Microsoft OAuth
• Configurer l'authentification OAuth

L'authentification SMTP via OAuth pour l'envoi d'emails consiste à utiliser le protocole OAuth 2.0 pour sécuriser l'accès au serveur SMTP de Google (smtp.gmail.com) ou Microsoft sans avoir besoin d'utiliser un mot de passe traditionnel.
Ainsi, au lieu de votre adresse email et de votre mot de passe, un jeton d'accès OAuth est utilisé pour vous authentifier auprès du serveur SMTP.

Pour configurer OAuth, il est nécessaire de récupérer les identifiants client.

Une fois l'authentification OAuth configurée, vous pourrez l'utiliser lors de la configuration de votre serveur email.

Obtenir les identifiants client

L'authentification OAuth est disponible pour Google et Microsoft.
Vous trouverez ci-dessous comment récupérer vos identifiants client.

Google OAuth

Dans le cas de Google, procédez comme suit :

1. Connectez-vous à Google Console Cloud et créez un nouveau projet.
2. Ouvrez le projet et accédez à API & Services > Écran de consentement oAuth pour configurer le projet.
3. Allez ensuite sur la page Clients depuis le menu de navigation.
4. Cliquez sur Créer un client.
5. Sur la page Créer un ID client OAuth, remplissez les champs requis :
   • Dans le champ Type d'application, sélectionnez Application Web.
   • Entrez un nom de client.
   • Dans la section URI de redirection autorisés, cliquez sur Ajouter un URI et entrez l'URI sous la forme :
     http://localhost:8080/ddenterpriseapi/v2/oauth/redirect
     
     
6. Cliquez sur Créer.
   ➡ Le client OAuth est créé. Vous obtenez ainsi l'identifiant et le code secret du client.
7. Copiez-les afin d'en disposer pour la configuration DigDash.
   
   

Microsoft OAuth

Dans le cas de Microsoft, procédez comme suit :

1. Connectez-vous au Portail Azure.
2. Dans le menu de navigation, accédez à Microsoft Entra ID (ou Azure Active Directory).
3. Cliquez sur Inscriptions d’applications puis sur Nouvelle inscription pour créer une nouvelle application.
4. Remplissez les champs requis :
   • Nom : entrez un nom pour identifier votre application (ex. ddenterpriseapi).
   • Types de comptes pris en charge : choisissez qui pourra se connecter :
     • Comptes dans ce répertoire uniquement (single tenant)
     • Comptes dans tous les annuaires (multi-tenant)
     • Comptes Microsoft personnels
   • URI de redirection : ajoutez l’URI de redirection autorisée, par exemple :
     http://localhost:8080/ddenterpriseapi/v2/oauth/redirect
5. Validez en cliquant sur Enregistrer.
6. Une fois l’application enregistrée, récupérez vos identifiants :
   • ID d’application (client) : correspond à ID client.
   • ID du répertoire (tenant) : correspond au tenant Microsoft.
7. Dans le menu de gauche, ouvrez Certificats et secrets, puis cliquez sur Nouveau secret client.
   • Donnez une description, choisissez une durée de validité, puis validez.
   • Copiez le secret généré immédiatement (il ne sera plus affiché après).
   • Ce secret correspond au Secret client.

8. Dans Autorisations API, configurez les permissions nécessaires à votre application (ex. User.Read, Mail.Read).
   Certaines permissions peuvent nécessiter un consentement administrateur.

Configurer l'authentification OAuth

Une fois vos identifiants récupérés, vous pouvez configurer l'authentification OAuth. Pour cela :

1. Allez sur la page Configuration > Paramètres serveur > Paramètres supplémentaires > OAuth.
2. Sélectionnez le Fournisseur OAuth : Google ou Microsoft.
3. Dans le cas de Microsoft, renseignez le champ Tenant avec l'ID du répertoire (tenant) récupéré précédemment.
4. Les champs URL sont renseignés par défaut et grisés.
5. Renseignez l'ID client et le Secret client obtenus précédemment.
6. Dans le champ URI de redirection autorisés, entrez l'URI sous la forme :
   http://localhost:8080/ddenterpriseapi/v2/oauth/redirect
7. Le champ Jeton de rafraîchissement sera rempli automatiquement après utilisation de l'OAuth pour le serveur email.
8. Cliquez sur Enregistrer.
   ➡ Vous pouvez à présent utiliser OAuth pour votre serveur email.
   Consultez la page Serveur email pour plus de détails.