Connectez Gmail à Odoo en utilisant Google OAuth¶
Odoo est compatible avec OAuth de Google pour Gmail. Afin d’envoyer des e-mails sécurisés depuis un domaine personnalisé, il suffit de configurer quelques paramètres sur la plateforme Workspace de Google, ainsi que sur le back-end de la base de données Odoo. Cette configuration fonctionne en utilisant soit une adresse e-mail personnelle, soit une adresse créée par un domaine personnalisé.
Astuce
Pour plus d’informations, consultez la documentation de Google sur la configuration d’OAuth.
Configuration dans Google¶
Créer un nouveau projet¶
Pour commencer, accédez à la « Console API Google <https://console.developers.google.com>`_. Connectez-vous avec votre compte Google Workspace si vous en avez un, sinon connectez-vous avec votre compte Gmail personnel (celui-ci doit correspondre à l’adresse email que vous souhaitez configurer dans Odoo).
Après cela, cliquez sur Create Project, situé à l’extrême droite de OAuth consent screen. Si un projet a déjà été créé dans ce compte, alors l’option Nouveau projet sera située en haut à droite sous le menu déroulant Sélectionner un projet.
Sur l’écran , renommez le Nom du projet en Odoo et recherchez le Location. Définissez Location comme organisation Google Workspace. Si vous utilisez un compte Gmail personnel, laissez Location comme No Organization.
Cliquez sur Create pour terminer cette étape.
Écran de consentement OAuth¶
Si la page ne redirige pas vers les options , cliquez sur OAuth consent screen dans le menu de gauche.
Sous les options User Type, sélectionnez le User Type approprié, puis cliquez à nouveau sur Create, ce qui vous mènera enfin à la page .
Avertissement
Les comptes Gmail personnels ne peuvent être que de type utilisateur externe, ce qui signifie que Google peut exiger une approbation ou que des portées soient ajoutées. Cependant, l’utilisation d’un compte Google WorkSpace permet d’utiliser le type d’utilisateur Interne.
Notez également que même si la connexion API est en mode de test Externe, aucune approbation de la part de Google n’est nécessaire. Les limites d’utilisateurs dans ce mode de test sont définies sur 100 utilisateurs.
Modifier l’enregistrement de l’application¶
Ensuite, nous configurerons l’enregistrement de l’application du projet.
À l’étape OAuth consent screen, sous la section App information, saisissez Odoo dans le champ App name. Sélectionnez l’adresse e-mail de l’organisation dans le champ e-mail Support utilisateur.
Ensuite, sous , cliquez sur Add Domain et saisissez odoo.com.
Après cela, dans la section Informations de contact du développeur, entrez l’adresse e-mail de l’organisation. Google utilise cette adresse e-mail pour informer l’organisation de toute modification apportée à votre projet.
Ensuite, cliquez sur le bouton Enregistrer et continuer. Ensuite, sautez la page en faisant défiler vers le bas et en cliquant sur Save and Continue.
Si vous continuez en mode test (Externe), ajoutez les adresses email en cours de configuration à l’étape Test users, en cliquant sur Add Users, puis sur le bouton Save and Continue. Un résumé de l’enregistrement de l’application apparaît.
Enfin, faites défiler vers le bas et cliquez sur Back to Dashboard pour terminer la configuration du projet.
Créer des informations d’identification¶
Maintenant que le projet est configuré, les informations d’identification doivent être créées, qui incluent l”ID client et le Secret client. Tout d’abord, cliquez sur Credentials dans le menu latéral de gauche.
Ensuite, cliquez sur Create Credentials dans le menu du haut et sélectionnez OAuth client ID dans le menu déroulant.
Sous Application Type, sélectionnez Web Application dans le menu déroulant.
Dans le champ Name, saisissez
Odoo.Sous l’étiquette Authorized redirect URIs, cliquez sur le bouton ADD URI, puis saisissez
https://yourdbname.odoo.com/google_gmail/confirmdans le URIs 1 champ. Assurez-vous de remplacer la partie yourdbname de l’URL par le nom réel de la base de données Odoo.Ensuite, cliquez sur Create pour générer un OAuth Client ID et Client Secret. Enfin, copiez chaque valeur générée pour une utilisation ultérieure lors de la configuration dans Odoo, puis accédez à la base de données Odoo.
Configuration dans Odoo¶
Entrez les informations d’identification Google¶
Tout d’abord, ouvrez Odoo et accédez au module Apps. Ensuite, supprimez le filtre Apps de la barre de recherche et tapez Google. Installez le module appelé Google Gmail.
Ensuite, accédez à , et sous la section Discuss, assurez-vous que la case à cocher pour Serveurs de messagerie personnalisés ou Serveurs de messagerie externes est vérifié. Cela remplit une nouvelle option pour Gmail Credentials ou Utiliser un serveur Gmail. Ensuite, copiez et collez les valeurs respectives dans les champs Client ID et Client Secret et Save les paramètres.
Configurer le serveur de messagerie sortant¶
Pour configurer le compte Gmail externe, revenez en haut du paramètre Custom Email Servers, puis cliquez sur le lien Outgoing Email Servers.
Cliquez ensuite sur New ou Create pour créer un nouveau serveur de messagerie, et renseignez le Name, Description, et l’email :guilabel:`Username ` (si nécessaire).
Cliquez ensuite sur Gmail OAuth Authentication ou Gmail (sous la section Authenticate with ou Connection). Enfin, cliquez sur Connectez votre compte Gmail.
Une nouvelle fenêtre intitulée Google s’ouvre pour terminer le processus d’autorisation. Sélectionnez l’adresse e-mail appropriée en cours de configuration dans Odoo.
Si l’adresse e-mail est un compte personnel, une étape supplémentaire apparaît, alors cliquez sur Continuer pour autoriser la vérification et connecter le compte Gmail à Odoo.
Ensuite, autorisez Odoo à accéder au compte Google en cliquant sur Continuer ou Allow. Après cela, la page revient au serveur de messagerie sortant nouvellement configuré dans Odoo. La configuration charge automatiquement le token dans Odoo, et une balise indiquant Gmail Token Valid apparaît en vert.
Enfin, Testez la connexion. Un message de confirmation devrait apparaître. La base de données Odoo peut désormais envoyer des e-mails sûrs et sécurisés via Google en utilisant l’authentification OAuth.
FAQ Google OAuth¶
Statut de publication de la production VS des tests¶
Choisir Production comme Publishing Status (au lieu de Testing) affichera le message d’avertissement suivant :
Pour corriger cet avertissement, accédez à « Google API Platform <https://console.cloud.google.com/apis/credentials/consent>`_. Si le Publishing status est In Production, cliquez sur Back to Testing pour corriger le problème.
Aucun utilisateur de test ajouté¶
Si aucun utilisateur test n’est ajouté à l’écran de consentement OAuth, une erreur d’accès refusé 403 s’affichera.
Pour corriger cette erreur, revenez à l’écran de consentement OAuth consent sous APIs & Services et ajoutez des utilisateurs test à l’application. Ajoutez l’e-mail que vous configurez dans Odoo.
Module Gmail non mis à jour¶
Si le module Google Gmail dans Odoo n’a pas été mis à jour vers la dernière version, alors un message d’erreur Forbidden s’affiche.
Pour corriger cette erreur, accédez au module et effacez les termes de recherche. Ensuite, recherchez Gmail ou Google et mettez à niveau le module Google Gmail. Enfin, cliquez sur les trois points en haut à droite du module et sélectionnez Upgrade.
Type de demande¶
Lors de la création des informations d’identification (OAuth Client ID et Client Secret), si Desktop App est sélectionné pour le Application Type, un Authorization Error apparaît.
Pour corriger cette erreur, supprimez les informations d’identification déjà créées et créez de nouvelles informations d’identification, en sélectionnant Web Application pour le Application Type. Ensuite, sous Authorized redirect URIs, cliquez sur ADD URI et tapez : https://yourdbname.odoo.com/google_gmail/confirm dans le champ, en veillant à remplacer yourdbname dans l’URL avec le nom de la base de données Odoo.