Connecter les comptes Gmail à l’aide d’OAuth 2.0

  • Article

Suivez la procédure indiquée dans cet article pour configurer la synchronisation côté serveur afin d’envoyer et de recevoir des e-mails dans les applications Customer Engagement (telles que Dynamics 365 Sales, Dynamics 365 Customer Service, Dynamics 365 Marketing, Dynamics 365 Field Service et Dynamics 365 Project Service Automation) depuis les comptes Gmail à l’aide d’OAuth 2.0 en tant que mécanisme d’autorisation.

Note

Le profil du serveur de messagerie Gmail OAuth prend en charge jusqu’à 100 utilisateurs. Créez plusieurs profils OAuth (étapes 1 à 4) si vous souhaitez associer le même profil à plusieurs utilisateurs.

Étape 1. Activer IMAP ou POP dans Gmail

Note

Ces étapes doivent être effectuées par l’administrateur système.

Pour IMAP, suivez les étapes dans Consulter Gmail via d’autres plateformes de messagerie.

Pour POP, suivez les étapes dans Lire les messages Gmail sur d’autres clients de messagerie à l’aide de POP.

Étape 2. Créez un projet

Note

Ces étapes doivent être effectuées par l’administrateur système.

À l’aide d’un compte Google (cela peut être le même que celui que vous utiliserez pour envoyer et récupérer des e-mails, ou un autre), accédez à Google Developers Console et créez un projet.

Suivez les étapes pour Créer un projetdans Créer, arrêter et restaurer des projets.

Note

Ces étapes doivent être effectuées par l’administrateur système.

  1. Sélectionnez Écran de consentement OAuth, puis sélectionnez le type d’utilisateur :

    • Sélectionnez Interne si vous utilisez un locataire administrateur GSuite et que vous créerez l’application exclusivement pour votre organisation.
    • Sélectionnez Externe si vous testez en utilisant un compte Gmail autonome.

    Capture d’écran de l’écran de consentement OAuth.

  2. Sélectionnez Créer.

  3. Sous Nom de l’application, saisissez le nom de l’application. Sous Domaines autorisés, saisissez le premier nom de domaine privé de votre environnement (par exemple, dynamics.com). Sélectionnez Enregistrer.

    Capture d’écran de la saisie du nom et du domaine de l’application.

  4. Sélectionnez Informations d’identification>Créer des informations d’identification.

    Capture d’écran de la commande Créer des informations d’identification.

  5. Sélectionnez ID client OAuth.

  6. Sélectionnez Configurer l’écran de consentement.

  7. Entrez les paramètres suivants :

    Paramètre Utiliser
    Type d’application application Web
    Nom Nom de votre client Web.
    Origines JavaScript autorisées URL de votre environnement (par exemple, https://contoso.crm.dynamics.com)
    URI de redirection autorisés L’URL de votre environnement avec /_grid/cmds/dlg_gmailoauth.aspx en annexe (par exemple, https://contoso.crm.dynamics.com/_grid/cmds/dlg_gmailoauth.aspx)

    Capture d’écran de la création de l’ID client OAuth.

  8. Sélectionnez Créer. Dans l’écran qui apparaît, notez l’ID client et le secret client. Vous utiliserez ces informations à l’étape suivante.

Étape 4. Création de profils de serveur de messagerie

  1. Dans le centre d’administration Power Platform, sélectionnez un environnement.

  2. Sur la barre de commandes, sélectionnez Paramètres>E-mail>Profils de serveur.

    Capture d’écran des paramètres de profil du serveur de messagerie.

  3. Dans la barre de commandes, sélectionnez Nouveau profil de serveur.

    Capture d’écran de création d’un profil du serveur de messagerie.

  4. Pour Type de serveur de messagerie, sélectionnez Gmail, puis entrez une valeur significative pour le champ Nom du profil.

    Capture d’écran de création d’un profil du serveur de messagerie pour Gmail.

  5. Si vous souhaitez utiliser ce profil de serveur comme profil par défaut pour les nouvelles boîtes aux lettres, activez Définir comme profil par défaut pour les nouvelles boîtes aux lettres.

  6. Pour Type d’identification, sélectionnez Gmail OAuth.

  7. Pour ID client et Clé secrète client, saisissez les informations que vous avez notées à l’étape 8 de la procédure précédente.

    Note

    Les champs Emplacements et ports sont automatiquement renseignés.

    Capture d’écran de création d’un profil du serveur de messagerie pour Gmail à l’aide d’Oauth.

  8. Développez la section Avancé, puis utilisez les info-bulles pour choisir vos options de traitement des e-mails.

  9. Lorsque vous avez terminé, sélectionnez Enregistrer.

Étape 5. Configurer la boîte aux lettres

Note

Ces étapes doivent être effectuées par l’utilisateur de la boîte aux lettres.

  1. Dans l’application Web, accédez à Paramètres (Paramètres.) >Paramètres avancés.

  2. Sélectionnez Paramètres>Administration.

  3. Sélectionnez Paramètres>Configuration de la messagerie>Boîtes aux lettres.

  4. Sélectionnez la boîte aux lettres de l’utilisateur configuré dans les étapes précédentes.

  5. Utilisez les paramètres suivants :

    Paramètre Utiliser
    Profil de serveur Le profil créé à l’étape 4
    Courrier électronique entrant Synchronisation côté serveur ou E-mail Router
    Courrier électronique sortant Synchronisation côté serveur ou E-mail Router

    Capture d’écran des informations de boîte aux lettres OAuth.

  6. Sélectionnez Enregistrer.

  7. Sélectionnez Se connecter à Gmail.

  8. Parcourez les pages de connexion et d’autorisation Gmail.

Étape 6. Ajouter des utilisateurs de test

Dans Google Cloud Platform (Developer Console), ajoutez des utilisateurs dans la section Utilisateurs de test lors de la publication de l’application. Plus d’informations : Aide de la console Google Cloud Platform

Capture d’écran de l’ajout des utilisateurs de test.

Étape 7. Tester et activer

Note

Ces étapes doivent être effectuées par l’utilisateur de la boîte aux lettres.

Sélectionnez Tester et activer la boîte aux lettres pour tester la boîte aux lettres configurée à l’étape 6.

Capture d’écran montrant la commande du test et d’activation de la boîte aux lettres.