Pour les administrateurs
← Tous les sujets

Microsoft 365 : connecter les boîtes mail

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

Pour que l’assistant puisse lire les e-mails dans Microsoft 365 et y créer des brouillons, il a besoin d’un accès via Microsoft Graph. Pour cela, l’organisation inscrit une application dans son propre Microsoft Entra ID ; 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 professionnels et scolaires Microsoft 365. Les comptes personnels outlook.com, hotmail.com et live.com ne peuvent pas du tout être connectés – 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 Microsoft et chacun a sa propre boîte maille client de l’organisation – cela suffit
En plus, des boîtes mail partagées (info@, ventes@), ou un accès aux boîtes mail configuré de façon centralisée, sans leurs propriétairesen plus, l’inscription de l’organisation
Vous ne voulez pas de connexion avec un compte Microsoftles 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 applications distinctes

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

Client de l’organisationInscription de l’organisation
Rôlela connexion des membres avec le bouton Se connecter avec Microsoft et le bouton Connecter Outlook 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
Autorisations dans Entradéléguées (Delegated)d’application (Application)
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êmesles boîtes mail de l’annuaire (restriction possible)
Boîtes mail partagéesnon – elles n’ont pas de connexion propreoui
Quand quelqu’un quitte l’entreprisela boîte mail se déconnecte dès que son compte est bloquérien ne change

Ce sont délibérément deux applications. 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 toute l’organisation. L’inscription de l’organisation, elle, atteint toutes les boîtes mail ; c’est pourquoi draften ne l’utilise que pour l’accès aux boîtes mail, jamais pour la connexion. Ne les fusionnez pas en une seule.

Chaque boîte mail utilise l’un des deux accès. Vous pouvez avoir les deux applications en même temps : par exemple le client pour la connexion et les boîtes mail personnelles, et l’inscription pour la boîte mail partagée info@.

Ne donnez jamais l’autorisation Mail.Send à aucune des deux applications. draften n’envoie rien, et sans cette autorisation il ne le peut même pas – c’est tout l’intérêt.

Client de l’organisation : connexion et Connecter Outlook

Le client a des autorisations déléguées : l’application ne peut faire que ce que peut faire la personne connectée, et uniquement dans sa propre boîte mail. Vous le créez une fois ; les propriétaires des boîtes mail se connectent ensuite eux-mêmes et n’ont plus besoin de l’administrateur Entra.

Dans Microsoft Entra

Vous travaillez dans le Microsoft Entra admin center, https://entra.microsoft.com, connecté avec un compte d’administrateur de votre annuaire Microsoft 365.

  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/callback et /mailboxes/connect/callback. Copiez-les depuis cette carte ; elles doivent correspondre caractère pour caractère.
  2. Ouvrez la liste des applications inscrites : dans le menu de gauche, Entra ID → App registrations (dans l’ancienne version du menu, Identity → Applications → App registrations). Lien direct : https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade
  3. En haut, cliquez sur + New registration et remplissez :
    • Name – par exemple draften – connexion,
    • Supported account types – Accounts in this organizational directory only (… only - Single tenant),
    • Redirect URI – dans la liste déroulante Select a platform, choisissez Web et collez à côté la première adresse de la carte (elle se termine par /auth/callback).

    Cliquez sur Register. La page de la nouvelle application s’ouvre.

  4. Sur la page Overview, copiez l’Application (client) ID et le Directory (tenant) ID (icône de copie à côté de la valeur).
  5. Dans le menu de l’application à gauche, ouvrez Authentication. Pour la plateforme Web, dans la partie Redirect URIs, cliquez sur Add URI, collez la deuxième adresse de la carte (elle se termine par /mailboxes/connect/callback) et cliquez en bas sur Save.
  6. Certificates & secrets → onglet Client secrets → + New client secret. Description par exemple draften, sous Expires choisissez la durée de validité (24 mois au maximum) et cliquez sur Add. Dans le tableau, copiez tout de suite la valeur de la colonne Value – elle n’est affichée qu’à ce moment-là ; draften n’a pas besoin du Secret ID. Notez aussi la date de la colonne Expires.
  7. API permissions → + Add a permission → Microsoft Graph → Delegated permissions. Dans la recherche, saisissez et cochez l’une après l’autre openid, profile, email, offline_access, User.Read, Mail.ReadWrite et MailboxSettings.ReadWrite, puis cliquez en bas sur Add permissions. User.Read figure généralement dans la liste dès la création. Sans offline_access, la connexion ne tient pas – draften ne recevrait pas de jeton d’actualisation.
  8. Sur la même page, cliquez sur Grant admin consent for … et confirmez avec Yes. Chaque ligne doit porter une coche verte dans la colonne Status. Si votre organisation interdit aux utilisateurs de consentir à des applications, la connexion échouerait sans cette étape avec un message indiquant que le consentement a été refusé.

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 Inscription Entra pour « Se connecter avec Microsoft » et « Connecter Outlook », les valeurs Application (client) ID (étape 4) et Client secret (étape 6), puis clique sur Enregistrer.
  2. Il active la connexion avec un compte Microsoft sur la même page, dans la carte Comment les membres se connectent : il colle le Directory (tenant) ID dans ID de l’annuaire Microsoft (Entra). Dès que l’organisation a le client et l’ID de l’annuaire, les membres se connectent avec leur compte Microsoft 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 Outlook. 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

L’inscription a des autorisations d’application : l’assistant accède à la boîte mail sans que personne ne se connecte. Elle convient aux boîtes mail partagées et aux organisations qui veulent gérer l’accès aux boîtes mail de façon centralisée. Elle n’a rien à voir avec la connexion à draften.

Il vous faut un compte avec le rôle Administrateur général ou Administrateur de rôle privilégié – seuls ceux-ci peuvent accorder le consentement pour les autorisations d’application de Microsoft Graph. L’inscription elle-même peut aussi être créée par un administrateur d’application.

Dans Microsoft Entra

Vous travaillez dans le Microsoft Entra admin center, https://entra.microsoft.com.

  1. Ouvrez la liste des applications inscrites : dans le menu de gauche, Entra ID → App registrations (dans l’ancienne version du menu, Identity → Applications → App registrations). Lien direct : https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade
  2. En haut, cliquez sur + New registration et remplissez :
    • Name – par exemple draften – e-mails,
    • Supported account types – Accounts in this organizational directory only (… only - Single tenant),
    • Redirect URI – laissez vide.

    Cliquez sur Register. La page de la nouvelle application s’ouvre.

  3. Sur la page Overview, copiez l’Application (client) ID et le Directory (tenant) ID (icône de copie à côté de la valeur).
  4. Dans le menu de l’application à gauche, Certificates & secrets → onglet Client secrets → + New client secret. Description par exemple draften, sous Expires choisissez la durée de validité (24 mois au maximum) et cliquez sur Add. Dans le tableau, copiez tout de suite la valeur de la colonne Value – elle n’est affichée qu’à ce moment-là ; draften n’a pas besoin du Secret ID. Notez aussi la date de la colonne Expires.
  5. API permissions → + Add a permission → Microsoft Graph → Application permissions (pas Delegated). Dans la recherche, saisissez et cochez Mail.ReadWrite et MailboxSettings.ReadWrite, puis cliquez en bas sur Add permissions. MailboxSettings.ReadWrite sert uniquement à la couleur de la catégorie dans Outlook ; sans elle, la catégorie est ajoutée sans couleur. Vous pouvez aussi ajouter User.Read.All – draften s’en sert pour vérifier les alias de la boîte mail ; sans elle, le test de connexion indique pour les alias qu’il ne peut pas les vérifier.
  6. Sur la même page, cliquez sur Grant admin consent for … et confirmez avec Yes. Chaque ligne doit porter une coche verte dans la colonne Status.

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 : Microsoft 365 (Entra). Remplissez Nom, Directory (tenant) ID, Application (client) ID, Client secret (la valeur de l’étape 4, pas son ID) et Expiration du secret. Cliquez sur Ajouter une inscription. Le secret est stocké chiffré et n’est plus jamais affiché.
  3. L’inscription ne connecte rien à elle seule. 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. Ce choix n’est visible que pour qui est à la fois propriétaire de la boîte mail et propriétaire ou gestionnaire de l’organisation (le propriétaire de l’organisation est propriétaire de toutes les boîtes mail). Le guide Ajouter et connecter une boîte mail montre toute la marche à suivre avec des captures d’écran.

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 Microsoft 365.

Restreindre à certaines boîtes mail (facultatif)

Une autorisation d’application atteint toutes les boîtes mail de l’annuaire ; c’est draften qui fait office de garde (un membre ne peut pas ajouter de boîte mail, l’assistant n’envoie ni ne supprime rien). Si vous voulez en plus une barrière technique, restreignez l’application à un groupe de sécurité avec une stratégie ApplicationAccessPolicy dans Exchange Online. Il vous faut PowerShell et le rôle d’administrateur Exchange (ou d’administrateur général).

Étape 1 – le module Exchange Online. Installez-le une seule fois : lancez PowerShell en tant qu’administrateur de l’ordinateur et saisissez :

Install-Module ExchangeOnlineManagement

Étape 2 – le groupe et la stratégie. Connectez-vous à Exchange Online, créez un groupe de sécurité avec les boîtes mail auxquelles draften a le droit d’accéder, et une stratégie qui restreint l’application à ce seul groupe. Remplacez <Application (client) ID> par l’ID de l’inscription de l’étape 3 ci-dessus, et les adresses par celles de vos boîtes mail :

Connect-ExchangeOnline -UserPrincipalName admin@<tenant>.onmicrosoft.com
New-DistributionGroup -Name "draften - boîtes autorisées" -Alias draften-boites -Type Security -Members boite@firma.cz
New-ApplicationAccessPolicy -AppId <Application (client) ID> -PolicyScopeGroupId draften-boites@firma.cz -AccessRight RestrictAccess -Description "draften: boîtes autorisées seulement"

Étape 3 – la vérification. Pour une boîte mail du groupe, la commande doit afficher AccessCheckResult : Granted, pour une boîte mail hors du groupe Denied :

Test-ApplicationAccessPolicy -Identity boite@firma.cz -AppId <Application (client) ID>

Vous ajoutez ensuite une autre boîte mail au groupe dans l’Exchange admin center (https://admin.exchange.microsoft.com → Recipients → Groups), ou avec la commande Add-DistributionGroupMember -Identity draften-boites@firma.cz -Member autre@firma.cz. Une boîte mail hors du groupe échoue au test de connexion avec une erreur 403 (AppOnly AccessPolicy). La stratégie prend effet en général en moins d’une heure ; nous avons vu jusqu’à quatre heures. Microsoft propose comme alternative plus récente RBAC for Applications dans Exchange Online ; nous ne la décrivons pas encore.

Remplacer le secret

Le secret a une validité limitée et draften n’envoie aucun avertissement avant son expiration – la date dans la carte passe au jaune 30 jours avant l’expiration, puis au rouge. Mettez-vous un rappel dans votre agenda. Avant l’expiration :

  1. Dans Entra, ouvrez App registrations → votre inscription (par exemple draften – e-mails) → Certificates & secrets → + New client secret et copiez la nouvelle Value (comme à l’étape 4 ci-dessus).
  2. Dans draften, dans Organisation → Connexion et accès aux e-mails, choisissez Nouveau secret au niveau de l’inscription, saisissez la nouvelle valeur et la nouvelle date.
  3. Supprimez l’ancien secret dans Entra avec l’icône de corbeille sur sa ligne.

Si le secret expire avant, les boîtes mail se déconnectent (invalid_client) et les assistants les ignorent. Après le remplacement du secret, lancez Tester la connexion sur les boîtes mail – un test réussi réactive la boîte mail.

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. Chacune reçoit une coche, ou une croix avec la raison :

Dans le messageCe que cela signifieQue faire
AADSTS7000215, AADSTS7000222, invalid_clientclient secret erroné ou expirécréer un nouveau secret et l’enregistrer dans draften
AADSTS700016, AADSTS90002, unauthorized_clientApplication ID ou Directory ID erronérecopier les deux ID depuis Overview
AADSTS65001, AADSTS650057, consent_requiredle consentement de l’administrateur manqueGrant admin consent pour l’application
jeton sans Mail.ReadWritel’autorisation manque ou n’a pas été consentieajouter l’autorisation et accorder le consentement
invalid_grant, AADSTS50173, AADSTS700082, AADSTS70008la connexion du compte a expiré ou a été révoquéeReconnecter Outlook
HTTP 403 AppOnly AccessPolicyla boîte mail n’est pas dans le groupe de la stratégie d’accèsl’ajouter au groupe et patienter
HTTP 404cette boîte mail n’existe pasvérifier l’adresse ; la boîte mail doit disposer d’Exchange Online
HTTP 401autre annuaire, ou autorisation manquantevérifier le Directory ID et les autorisations

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

Version texte