Pour les administrateurs
← Tous les sujets

Google Workspace : connecter les boîtes mail

La connexion avec le compte de la boîte mail (client de l’organisation), en plus un compte de service pour les boîtes partagées – et ce qu’il faut configurer dans Google Cloud et Google Admin, étape par étape.

Pour que l’assistant puisse lire les e-mails dans Google Workspace et y créer des brouillons, il a besoin d’un accès via la Gmail API. Pour cela, l’organisation crée ce qu’il faut dans son propre Google Cloud ; draften n’a pas d’application commune à laquelle il vous suffirait de donner votre consentement. Cela vaut pour notre service comme pour une installation sur votre propre serveur.

Tout ce qui suit ne vaut que pour les comptes Google Workspace avec votre propre domaine. Un compte personnel @gmail.com ne permet pas de se connecter à draften ; un Gmail personnel peut toutefois être connecté via IMAP avec un mot de passe d’application – voir Fournisseurs pris en charge et limites.

Ce que vous voulez et ce qu’il faut configurer

Ce que vous voulezCe qu’il faut configurer
Les membres se connectent avec leur compte Google et chacun a sa propre boîte maille client de l’organisation – cela suffit
En plus, des boîtes mail auxquelles personne ne se connecte (par exemple info@), ou un accès aux boîtes mail configuré de façon centralisée, sans leurs propriétairesen plus, l’inscription de l’organisation (compte de service)
Vous ne voulez pas de connexion avec un compte Googleles membres se connectent avec le mot de passe défini via l’invitation ; les e-mails sont connectés par l’inscription de l’organisation (ou IMAP)

Deux choses distinctes chez Google

Le client de l’organisation et l’inscription de l’organisation sont deux choses distinctes dans Google Cloud. Chacune a son propre rôle, et l’une ne remplace pas l’autre :

Client de l’organisationInscription de l’organisation
Ce que c’estun client OAuth avec un écran de consentement de type Internalun compte de service avec une clé et domain-wide delegation
Rôlela connexion des membres avec le bouton Se connecter avec Google et le bouton Connecter Gmail sur leur propre boîte maill’accès de l’assistant aux boîtes mail sans que leurs propriétaires se connectent
Où dans draftenOrganisation → Connexion et accès aux e-mails → carte Connexion des comptes et des boîtes mailOrganisation → Connexion et accès aux e-mails → carte Inscriptions pour les boîtes mail partagées et la gestion centrale
Qui s’en charge dans draftenle propriétaire de l’organisationle propriétaire ou un gestionnaire de l’organisation
Qui le crée chez Googleun administrateur Google Cloudun administrateur Google Cloud et un super-administrateur Google Admin
Qui se connecte à la boîte maille propriétaire de chaque boîte mail, une foispersonne
Boîtes mail atteintesuniquement celles que les membres connectent eux-mêmestoutes les boîtes mail du domaine

Ce sont délibérément deux choses. Le consentement au client ne donne des droits que sur les boîtes mail que les membres connectent eux-mêmes – jamais sur les e-mails de tout le domaine. Le compte de service, lui, atteint chaque boîte mail du domaine ; c’est pourquoi draften ne l’utilise que pour l’accès aux boîtes mail, jamais pour la connexion. Ne les fusionnez pas.

Chaque boîte mail utilise l’un des deux accès ; vous pouvez avoir les deux en même temps. draften ne demande que le champ d’application gmail.modify – lire et créer des brouillons ; il n’envoie rien.

Client de l’organisation : connexion et Connecter Gmail

Le propriétaire de la boîte mail se connecte avec son compte Google et n’autorise l’accès qu’à ses propres e-mails. Le même client sert aussi à la connexion à draften avec un compte Google.

Dans Google Cloud

Vous travaillez dans https://console.cloud.google.com, connecté avec un compte d’administrateur de votre domaine Workspace. Tout se passe dans un seul projet – le projet sélectionné est affiché en haut à gauche, à côté du logo Google Cloud ; c’est aussi là que vous en changez ou que vous en créez un nouveau. Le menu principal s’ouvre avec l’icône ☰ en haut à gauche.

  1. Dans draften, ouvrez d’abord Organisation → Connexion et accès aux e-mails, carte Connexion des comptes et des boîtes mail. Elle affiche deux Redirect URIs établies exactement pour votre adresse draften – elles se terminent par /auth/google/callback et /mailboxes/connect/google/callback. Copiez-les depuis cette carte ; elles doivent correspondre caractère pour caractère.
  2. Choisissez un projet ou créez-en un nouveau (par exemple draften), et activez-y la Gmail API : ☰ → APIs & Services → Library, recherchez Gmail API, ouvrez-la et cliquez sur Enable. Lien direct : https://console.cloud.google.com/apis/library/gmail.googleapis.com
  3. Définissez comment l’application se présente aux utilisateurs (écran de consentement) : ☰ → APIs & Services → OAuth consent screen. La page Google Auth Platform s’ouvre ; lien direct : https://console.cloud.google.com/auth/overview (vérifiez que le bon projet est sélectionné en haut). Cliquez sur Get started et suivez les étapes :
    • App Information – App name draften et User support email (votre adresse e-mail ou un groupe d’administrateurs). Next.
    • Audience – choisissez Internal. Seul un compte de votre domaine Workspace peut alors se connecter, et Google n’a pas besoin de valider l’application. Next.
    • Contact Information – l’adresse e-mail à laquelle Google vous envoie les notifications concernant l’application. Next.
    • Finish – cochez la case d’acceptation des règles de Google (I agree to the Google API Services: User Data Policy), cliquez sur Continue puis sur Create.
  4. Autorisez les champs d’application pour l’application. Dans Google Auth Platform, ouvrez Data Access dans le menu de gauche (lien direct : https://console.cloud.google.com/auth/scopes) → Add or remove scopes. Dans la liste, cochez openid, .../auth/userinfo.email et .../auth/userinfo.profile. Collez le champ d’application pour Gmail dans la zone Manually add scopes : https://www.googleapis.com/auth/gmail.modify → Add to table. Cliquez sur Update puis, en bas, sur Save.
  5. Créez le client. Dans Google Auth Platform, ouvrez Clients dans le menu de gauche (lien direct : https://console.cloud.google.com/auth/clients) → Create client. Application type : Web application, un nom, par exemple draften. Sous Authorized redirect URIs, cliquez sur Add URI et collez la première adresse de la carte, puis de nouveau Add URI et la deuxième. Cliquez sur Create.
  6. Le Client ID et le Client secret s’affichent – copiez-les tout de suite tous les deux. Google n’affichera plus le Client secret par la suite ; si vous le perdez, créez-en un nouveau au niveau du client.

Dans draften

  1. Le propriétaire de l’organisation ouvre Organisation → Connexion et accès aux e-mails et renseigne, dans la carte Connexion des comptes et des boîtes mail, sous Client OAuth Google, les valeurs Client ID et Client secret de l’étape 6, puis clique sur Enregistrer.
  2. Il active la connexion avec un compte Google sur la même page, dans la carte Comment les membres se connectent : dans Domaines e-mail de l’organisation, il saisit le domaine Workspace – le domaine principal, pas un domaine d’alias (Google ne l’envoie pas lors de la connexion). Dès que l’organisation a le client et le domaine, les membres se connectent avec leur compte Google et leurs mots de passe cessent de fonctionner – voir Comment les membres se connectent.
  3. Le propriétaire de la boîte mail ouvre la page de la boîte mail et, dans la carte Accès aux e-mails, sur la ligne Connecter avec le compte de la boîte mail :, clique sur Connecter Gmail. Il se connecte avec le compte de cette boîte mail – draften refuse tout autre compte – et autorise l’accès. Le bouton n’est visible que pour le propriétaire de la boîte mail, et seulement si l’organisation a le client ; sans lui, la carte indique à la place du bouton que la connexion avec un compte sera possible dès que le propriétaire de l’organisation aura ajouté le client.
  4. Puis Tester la connexion.

Quand une boîte mail se déconnecte

Inscription de l’organisation : accès sans connexion

Un compte de service avec domain-wide delegation donne à l’assistant l’accès aux boîtes mail du domaine sans que personne ne se connecte. Il convient aux boîtes mail auxquelles personne ne se connecte (par exemple info@) et aux organisations qui veulent gérer l’accès de façon centralisée. Il n’a rien à voir avec la connexion à draften.

Dans Google Cloud

Vous travaillez dans https://console.cloud.google.com, dans le même projet où la Gmail API est activée (étape 2 du client de l’organisation ; sans client, activez-la de la même façon). Vérifiez le projet en haut à gauche, à côté du logo Google Cloud.

  1. Ouvrez la liste des comptes de service : ☰ → IAM & Admin → Service accounts. Lien direct : https://console.cloud.google.com/iam-admin/serviceaccounts
  2. En haut, cliquez sur + Create service account et suivez les trois étapes :
    • Service account details – Service account name, par exemple draften-emails (l’ID se remplit tout seul). Cliquez sur Create and continue.
    • Permissions (optional) – ne choisissez rien ; il n’a besoin d’aucun rôle dans le projet, c’est la délégation dans Google Admin qui lui donne accès aux e-mails. Cliquez sur Continue.
    • Principals with access (optional) – ne remplissez rien, cliquez sur Done.
  3. Dans la liste, cliquez sur le nouveau compte de service. Dans l’onglet Details, copiez l’Unique ID – un long nombre ; c’est le Client ID pour Google Admin.
  4. Onglet Keys → Add key → Create new key → Key type : JSON → Create. Le navigateur télécharge un fichier contenant la clé (….json).

Si Google refuse de créer la clé, votre organisation a activé la règle Disable service account key creation (iam.disableServiceAccountKeyCreation ; les nouvelles organisations l’ont par défaut). Un administrateur de l’organisation la désactive pour ce projet : ☰ → IAM & Admin → Organization policies (https://console.cloud.google.com/iam-admin/orgpolicies), recherche iam.disableServiceAccountKeyCreation → Manage policy → Override parent's policy → Enforcement : Off → Set policy. Répétez ensuite l’étape 4.

Dans Google Admin

Il vous faut un compte de super-administrateur Google Workspace.

  1. Ouvrez https://admin.google.com → dans le menu de gauche Security → Access and data control → API controls → en bas Domain wide delegation → Manage domain wide delegation. Lien direct : https://admin.google.com/ac/owl/domainwidedelegation
  2. Cliquez sur Add new et remplissez :
    • Client ID – l’Unique ID numérique de l’étape 3,
    • OAuth scopes (comma-delimited) – https://www.googleapis.com/auth/gmail.modify.

    Cliquez sur Authorize. La délégation apparaît dans la liste. Elle prend effet en général en quelques minutes, exceptionnellement au bout de plusieurs heures.

Dans draften

  1. Ouvrez Organisation → Connexion et accès aux e-mails, carte Inscriptions pour les boîtes mail partagées et la gestion centrale. Les inscriptions sont gérées par le propriétaire ou les gestionnaires de l’organisation.
  2. Système : Google Workspace. Remplissez Nom, choisissez le fichier téléchargé sous Clé du compte de service (JSON) et cliquez sur Ajouter une inscription. La clé est stockée chiffrée ; la carte n’affiche ensuite que l’e-mail du compte de service et son Client ID.
  3. Sur la page de chaque boîte mail, dans la carte Accès aux e-mails, choisissez cette inscription sous Inscription de l’organisation, cliquez sur Appliquer puis sur Tester la connexion. Le guide Ajouter et connecter une boîte mail montre la marche à suivre avec des captures d’écran.

Supprimez ensuite le fichier de clé téléchargé. Quiconque le possède accède à toutes les boîtes mail du domaine. Vous importez une nouvelle clé du même compte de service (étape 4 ci-dessus) au niveau de l’inscription avec nouvelle clé (JSON) ; ajoutez la clé d’un autre compte de service comme nouvelle inscription. Supprimez alors l’ancienne clé dans Google Cloud : compte de service → onglet Keys → icône de corbeille à côté de l’ancienne clé.

Avec la Boîte mail automatique activée (Comment les membres se connectent), une nouvelle boîte mail est liée d’elle-même à l’inscription lorsqu’il y en a exactement une active pour Google Workspace.

Erreurs du test de connexion

Le test vérifie trois étapes : Accès, Jeton et autorisation et Lecture de la boîte de réception.

Dans le messageCe que cela signifieQue faire
délégation non autorisée pour le champ d’application (unauthorized_client)la domain-wide delegation manque dans Google Admin, ou elle a un autre Client ID ou un autre champ d’applicationvérifier la délégation dans Google Admin : l’ID numérique et le champ d’application exact gmail.modify
invalid_grant pour un compte de servicecette boîte mail n’existe pas dans le domaine Workspacevérifier l’adresse de la boîte mail
« Gmail API has not been used… »la Gmail API n’est pas activée dans le projetactiver la Gmail API
jeton sans gmail.modifyla délégation ou l’écran de consentement n’a pas le champ d’application gmail.modifyajouter le champ d’application
invalid_grant, deleted_client pour un compte connectéla connexion a été révoquée ou le client suppriméReconnecter Gmail

Les autres erreurs sont décrites dans Résolution des problèmes.

Version texte