Pour les clients autres que Gmail, Gmail est compatible avec les protocoles IMAP, POP et SMTP standards. Les serveurs IMAP, POP et SMTP de Gmail ont été compatibles avec l'autorisation via le protocole OAuth 2.0, un standard dans l'industrie.
Protocole
Les protocoles IMAP, POP et SMTP utilisent la norme Simple Authentication and Security Layer (SASL) standard, à l'aide des commandes intégrées IMAP AUTHENTICATE
, POP AUTH
et SMTP AUTH
pour authentifier les utilisateurs. Le mécanisme SASL XOAUTH2 permet aux clients de fournir des identifiants OAuth 2.0 pour l'authentification. La documentation sur le protocole SASL XOAUTH2 décrit le mécanisme SASL XOAUTH2 en détail. Des bibliothèques et exemples de mise en œuvre du protocole sont disponibles.
Les connexions entrantes au serveur IMAP à l'adresse imap.gmail.com:993
et au serveur POP à l'adresse pop.gmail.com:995
nécessitent le protocole SSL. Le serveur SMTP sortant, smtp.gmail.com
, est compatible avec le protocole TLS. Si votre client commence par du texte brut, utilisez le port 465
(pour SSL) ou 587
(pour TLS) avant d'émettre la commande STARTTLS.
Limites de durée des sessions
Les sessions POP Gmail sont limitées à environ 7 jours. Les sessions IMAP de Gmail sont limitées à environ 24 heures. Si la session a été authentifiée à l'aide d'identifiants OAuth, elle est limitée à la période de validité du jeton d'accès utilisé (généralement une heure). Dans ce contexte, une session est une connexion TCP continue.
Une fois le temps écoulé et la session expirée, Gmail ferme la connexion et envoie un message indiquant que la session a expiré. Le client peut ensuite se reconnecter, s'authentifier à nouveau et continuer. Si vous utilisez OAuth, assurez-vous que le jeton d'accès utilisé est valide (si vous essayez d'utiliser un jeton de plus d'une heure, il peut ne pas être valide).
Bibliothèques et exemples
Pour plus de commodité, l'accès aux messages avec IMAP ou POP et l'envoi de messages via SMTP sont souvent effectués à l'aide des bibliothèques IMAP et SMTP existantes. Tant que ces bibliothèques sont compatibles avec Simple Authentication and Security Layer (SASL), elles devraient être compatibles avec le mécanisme SASL XOAUTH2 de Gmail.
Outre la documentation sur le protocole SASL XOAUTH2, vous pouvez également consulter Utiliser OAuth 2.0 pour accéder aux API Google pour en savoir plus sur l'implémentation d'un client OAuth 2.0.
La page Bibliothèques et exemples fournit des exemples de code dans plusieurs langages courants à l'aide du mécanisme SASL XOAUTH2 avec IMAP ou SMTP.