使用IMAPLIB结合OAuth2认证Office365 IMAP失败求助

核心问题排查与修复步骤 #

1. 确认Azure AD应用权限配置（必须满足） #

• 你的应用必须使用应用权限（而非委托权限）：
  • 在Azure门户中，找到你的应用注册 → 权限 → 添加权限 → 选择Office 365 Exchange Online → 应用权限 → 添加Mail.AccessAsApp（IMAP/SMTP核心权限），按需补充Mail.Read/Mail.ReadWrite等权限。
  • 点击授予管理员同意（必须由全局管理员操作，否则生成的token无法包含所需权限）。

2. 修正代码中的认证字符串编码错误 #

你的代码中生成的XOAUTH2认证字符串未做正确的Base64编码，且返回类型不符合imaplib要求。imaplib的authenticate方法要求回调函数返回Base64编码后的字节数据，而非原始字符串。

修正后的代码：

import imaplib
import base64
from msal import ConfidentialClientApplication

class IMAPLIB_Authenticator():
    def _get_access_token(self) -> str:
        client_id = 'my_secret_id'
        tenant_id = 'my_tenant_id'
        client_secret = 'my_client_secret'
        scope = ['https://outlook.office.com/.default']
        authority = f'https://login.microsoftonline.com/{tenant_id}'
        
        app = ConfidentialClientApplication(
            client_id,
            authority=authority,
            client_credential=client_secret
        )
        
        result = app.acquire_token_for_client(scopes=scope)
        # 检查token获取是否成功
        if 'access_token' not in result:
            raise Exception(f"获取token失败: {result.get('error_description', '未知错误')}")
        return result['access_token']
    
    def login(self, username):
        def _generate_auth_str(u: str, t: str) -> bytes:
            # 构造原始认证字符串
            auth_string = f"user={u}\x01auth=Bearer {t}\x01\x01"
            # 编码为UTF-8后做Base64编码，返回字节
            return base64.b64encode(auth_string.encode('utf-8'))
        
        self.mail = imaplib.IMAP4_SSL("outlook.office365.com", 993)
        self.mail.debug = 10
        # 获取token后再认证，避免重复请求
        access_token = self._get_access_token()
        self.mail.authenticate("XOAUTH2", lambda x: _generate_auth_str(username, access_token))

3. 额外验证点 #

• 解析token权限：用JWT解析工具查看你的access_token，确认roles字段包含Mail.AccessAsApp或相关IMAP权限。
• 用户名格式：确保传入的是完整的Office365邮箱地址（如user@domain.com）。
• 网络连通性：确认服务器能正常访问login.microsoftonline.com和outlook.office365.com，无防火墙拦截。

内容的提问来源于stack exchange，提问作者guilherme23