OAuth IMAP

Prérequis (auto-hébergé)

Services de messagerie pris en charge

Support OAuth IMAP :

• Gmail : https://developers.google.com/gmail/imap/xoauth2-protocol?hl=fr

• Entra : https://learn.microsoft.com/fr-fr/power-platform/admin/connect-gmail-oauth2

Installer le plugin

• Rendez-vous sur le marketplace. Téléchargez Oauth IMAP et activez-le

• Ouvrez le Portail Azure de votre tenant

• Dans la barre de recherche tapez registration

• puis sélectionnez App registrations

Voici les étapes de configuration incluant les phases de configuration côté Entra.

Enregistrer votre application Entra

Créer l'application

• Cliquez sur New registration

• Entrez le nom souhaité, sélectionnez le type de compte pris en charge puis entrez l'URL de redirection (présente dans la configuration du plugin depuis votre interface GLPI : https://XXXXXXXXXXXXXX/marketplace/oauthimap/front/authorization.callback.php) en spécifiant l'option Web

• Puis cliquez sur Register.

Ajouter un secret

• Dans l'onglet Certificates and secrets

• Cliquez sur Client secrets

• Puis New client secret

• Entrez une description puis une date d'expiration

• Une value de secret est alors générée. Conservez bien cette valeur car une fois que vous aurez quitté cette page, elle ne sera plus récupérable

• Revenez dans l'onglet Overview et copiez les valeurs suivantes ainsi que le secret vu précédemment

Ajouter des autorisations API

• Dans l'onglet API Permissions

• Cliquez sur your API (Microsoft Graph dans ce cas)

• Puis sélectionnez Delegated permission

• Sélectionnez :

  • email

  • offline_access

  • openid

  • profile

Configuration GLPI

• Revenez maintenant sur votre interface GLPI Setup > Application Aouth IMAP et indiquez les informations collectées précédemment :

• Cliquez sur Add

• Maintenant dans l'onglet Oauth authorization, cliquez sur Create an authorization

• Lorsque vous cliquerez sur Create authorization, vous serez redirigé vers la page de connexion des services Microsoft

• Entrez l'adresse email et le mot de passe du compte qui sera utilisé pour le collecteur

• Vous devrez également accepter les permissions nécessaires relatives au plugin.

FAQ

Si vous avez des questions concernant l'utilisation du plugin, n'hésitez pas à consulter notre FAQ