Boîte de réception OAuth

TrakIT peut lire une boîte aux lettres et agir sur les e-mails qui y sont envoyés, par exemple des tarifs envoyés par e-mail à une grille tarifaire. La page OAuth Inbox connecte TrakIT à cette boîte aux lettres : un compte Gmail, ou une boîte aux lettres Office 365.

Pour l’ouvrir, sélectionnez Admin > SysAdmin Pages > OAuth Inbox. Le titre de la page est Mailbox Authorisation. Seuls les administrateurs système peuvent l’ouvrir.

La page a deux onglets, Gmail et Office 365. Elle s’ouvre sur Gmail.

Comment TrakIT utilise la boîte aux lettres

Toutes les 5 minutes, TrakIT lit jusqu’à 50 e-mails de chaque boîte aux lettres connectée ici :

1. Il enregistre chaque e-mail, avec ses pièces jointes, dans l’onglet Emails Received du journal des messages.
2. Il retire l’e-mail de la boîte aux lettres : vers la corbeille dans Gmail, ou vers Éléments supprimés dans Office 365.
3. Il agit sur les e-mails dont l’objet est une commande TrakIT, et répond à l’expéditeur.

Comme TrakIT retire chaque e-mail de la boîte aux lettres, connectez une boîte aux lettres utilisée uniquement pour TrakIT. Dans Gmail, TrakIT lit tous les e-mails du compte à l’exception des spams et de la corbeille, et pas seulement la boîte de réception.

Onglet Gmail

Le support TrakIT configure d’abord la connexion Google pour votre installation. Vous autorisez ensuite TrakIT à lire le compte Gmail.

1. Sélectionnez l’onglet Gmail.
2. Sélectionnez Authorise. TrakIT vous amène chez Google.
3. Connectez-vous avec le compte Gmail que TrakIT doit lire, et autorisez l’accès que TrakIT demande.
4. Google vous ramène sur la page, qui affiche You have authorised your GMail account successfully.

Pour que TrakIT cesse de lire le compte, sélectionnez Disconnect et confirmez. TrakIT retire son accès chez Google et oublie le compte, et affiche GMail deauthorised successfully. Si Google ne confirme pas, TrakIT se déconnecte quand même, et vous demande de retirer vous-même TrakIT des connexions tierces du compte Google.

Message	Signification
Une erreur lorsque vous sélectionnez Authorise, au lieu de la page de Google	Le support TrakIT n’a pas encore configuré la connexion Google pour votre installation.
Invalid state parameter. Possible CSRF attack.	Le retour de Google ne correspondait pas à la demande que TrakIT avait envoyée, par exemple parce que votre session a pris fin entre-temps. Sélectionnez de nouveau Authorise.
Failed to obtain access token: …	Google a refusé de donner l’accès à TrakIT. Sélectionnez de nouveau Authorise.

Onglet Office 365

TrakIT lit une boîte aux lettres Office 365 partagée en arrière-plan avec un accès d’application uniquement, par l’inscription d’application Microsoft qu’utilise votre installation pour la connexion Microsoft. L’onglet affiche son Application (Client) ID et son Tenant. C’est le support TrakIT qui les configure : en attendant, ils affichent (not configured).

Configurer l’inscription d’application

Un administrateur Microsoft 365 (Entra ID) le fait une seule fois. L’onglet donne les mêmes étapes sous How to set up the app registration (app-only access).

1. Dans le Centre d’administration Microsoft Entra, ouvrez l’inscription d’application dont l’onglet affiche l’ID d’application (client).
2. Créez un nouveau secret client, et copiez immédiatement sa valeur : Microsoft ne l’affiche qu’une seule fois.
3. Ajoutez l’autorisation Microsoft Graph Mail.ReadWrite en tant qu’autorisation d’application, et non déléguée, et accordez le consentement de l’administrateur pour votre locataire.
4. Recommandé : limitez l’application à cette seule boîte aux lettres, avec une stratégie d’accès aux applications dans Exchange Online, afin qu’elle ne puisse pas lire toutes les boîtes aux lettres du locataire.
5. Vérifiez que le Tenant affiché dans l’onglet est l’ID de votre propre locataire, et non une valeur partagée comme « common ». Si ce n’est pas le cas, demandez au support TrakIT de le modifier.

Connecter la boîte aux lettres

1. Sélectionnez l’onglet Office 365.
2. Dans Mailbox to read, saisissez l’adresse de la boîte aux lettres.
3. Dans Client Secret, collez le secret. À côté, Configured ou Not configured indique si un secret est stocké. Laissez le champ vide pour conserver le secret stocké.
4. Sélectionnez Save. TrakIT affiche Office 365 mailbox settings saved.
5. Sélectionnez Test Connection. TrakIT affiche Connected successfully to suivi de la boîte aux lettres, ou Connection failed: suivi de la réponse de Microsoft.

Dès lors, TrakIT lit la boîte aux lettres toutes les 5 minutes. Pour la lire immédiatement, sélectionnez Check Now : TrakIT affiche Office 365 mailbox checked. See the Action Log for details. Les e-mails apparaissent dans l’onglet Emails Received, et TrakIT agit sur eux lors de son passage suivant. Le journal des actions des utilisateurs indique combien d’e-mails ont été lus, dans ses entrées Check O365.

Pour que TrakIT cesse de lire la boîte aux lettres, videz Mailbox to read et sélectionnez Save.

Message	Signification
Please specify a mailbox address.	Renseignez Mailbox to read avant Test Connection.
No Microsoft sign-in settings found …	Votre installation n’a pas de connexion Microsoft configurée. Adressez-vous au support TrakIT.
Connection failed: …	Microsoft a refusé l’accès. Vérifiez le secret client, l’autorisation Mail.ReadWrite et le consentement de l’administrateur, ainsi que l’adresse de la boîte aux lettres.

Qui peut utiliser cette page

Seuls les administrateurs système peuvent ouvrir la page OAuth Inbox. L’entrée de menu se trouve sous SysAdmin Pages, que seuls les administrateurs système voient.