OAuth IMAP

---

Comment installer OAuth IMAP ?

Vous trouverez une procédure pour vous aider à installer et configurer le plugin.

---

Quelles sont les fonctionnalités d'OAuth IMAP ?

OAuth IMAP permet à l'un de vos comptes locataires d'utiliser les services IMAP de manière sécurisée. Avec OAuth IMAP vous pouvez, par exemple, utiliser le collecteur avec une boîte mail d'entreprise.

---

La MFA est-elle compatible avec OAuth IMAP ?

Oui, vous pouvez utiliser OAuth IMAP avec la MFA. Vous serez demandé pour la 1ère authentification lors de la demande de création d'autorisation.

---

J'ai une politique de sécurité exigeant une connexion quotidienne avec double authentification, cela affecte-t-il aussi le compte utilisant OAuth IMAP ?

Les tokens Oauth pour le collecteur, récupérés lors de l'authentification avec Azure par le plugin OauthIMAP, sont des tokens "hors ligne" qui délèguent l'autorisation à une application tierce (GLPI). Ces tokens fournissent un code de renouvellement qui sera utilisé par l'application pour les renouveler automatiquement sans intervention utilisateur. La stratégie de ré-authentification quotidienne ne concerne que l'authentification 'en ligne' et ne s'applique qu'aux services accessibles directement par l'utilisateur, par exemple via son navigateur Internet.

---

J'ai une erreur de connexion, comment puis-je la corriger ?

Depuis configuration > Applications OAuth IMAP, onglet Autorisation OAuth cliquez sur diagnostiquer. Dans la fenêtre qui s'ouvre, augmentez le timeout à 15 (minimum). Un message d'erreur apparaîtra en bas du log pour vous guider vers le problème que vous rencontrez.

Si vous avez changé le mot de passe pour le compte utilisant les services IMAP, n'oubliez pas de mettre à jour le compte depuis configuration > Applications OAuth IMAP, onglet Autorisation OAuth, bouton mettre à jour.

---

Où sont les logs de l'application (on-premise uniquement) ?

Si vous avez un problème, vous pouvez vérifier les logs php-errors.log dans le dossier files/_log avec la commande (par exemple) tail -f php-errors.log | grep "imap" -C5

glpi_files/_log$ tail -f php-errors.log | grep "imap" -C5
[2024-01-18 16:20:04] glpiphplog.CRITICAL: *** Uncaught Exception Laminas\Mail\Storage\Exception\RuntimeException: cannot login, user or password wrong in /myinstancemondomaine.fr/marketplace/oauthimap/inc/imap/imapoauthstorage.class.php at line 76
 Backtrace :
...authimap/inc/mailcollectorfeature.class.php:101 GlpiPlugin\Oauthimap\Imap\ImapOauthStorage->__construct()
src/Toolbox.php:2222 GlpiPlugin\Oauthimap\MailCollectorFeature::GlpiPlugin\Oauthimap\{closure}()
src/MailCollector.php:1434 Toolbox::getMailServerStorageInstance()
src/MailCollector.php:708 MailCollector->connect()
src/MailCollector.php:1921 MailCollector->collect()
src/CronTask.php:1037 MailCollector::cronMailgate()
front/cron.php:87 CronTask::launch()

Dans cet exemple, on peut voir qu'il y a un problème avec l'utilisateur et/ou le mot de passe.