使用Office 365应用密码连接IMAP服务器失败求助

核心问题 #

你的代码在Gmail环境正常，但Office 365连接失败，本质是微软企业版租户的安全策略限制：即使启用2FA并使用应用密码，管理员通常会禁用"基本身份验证"（包括密码/应用密码登录IMAP），强制要求使用OAuth 2.0认证——这和Gmail允许应用密码的机制完全不同。

原因分析 #

• 企业版Office 365默认或管理员手动开启了安全默认值，禁用所有基于密码的基本认证方式。
• 应用密码仅适用于微软个人服务（如Outlook.com）或未强制限制的租户，企业租户几乎都会被管理员锁定该权限。

解决方案：改用OAuth 2.0认证 #

以下是基于msal库实现OAuth 2.0认证的修改代码，适配Office 365企业租户：

1. 前置准备 #

在Azure AD中完成应用注册：

• 获取客户端ID（Client ID）、客户端密钥（Client Secret）、租户ID（Tenant ID）
• 为应用授予IMAP.AccessAsUser.All的委托权限，并完成管理员同意（企业租户必须）

2. 修改后的代码 #

import imaplib
import logging
from config import imap_server, imap_port, my_email, client_id, client_secret, tenant_id
import msal

# 获取OAuth 2.0访问令牌
def get_oauth_token():
    authority = f"https://login.microsoftonline.com/{tenant_id}"
    app = msal.ConfidentialClientApplication(
        client_id, authority=authority, client_credential=client_secret
    )
    # 申请IMAP专属权限的令牌
    scopes = ["https://outlook.office365.com/IMAP.AccessAsUser.All"]
    result = app.acquire_token_for_client(scopes=scopes)
    
    if "access_token" in result:
        return result["access_token"]
    else:
        logging.error(f"令牌获取失败: {result.get('error')}, {result.get('error_description')}")
        return None

# 连接Office 365 IMAP服务器（OAuth认证）
def connect():
    try:
        imap = imaplib.IMAP4_SSL(imap_server, imap_port)
        access_token = get_oauth_token()
        if not access_token:
            raise Exception("无法获取有效OAuth令牌")
        
        # 构造XOAUTH2认证字符串
        auth_string = f"user={my_email}\x01auth=Bearer {access_token}\x01\x01"
        imap.authenticate("XOAUTH2", lambda x: auth_string)
        imap.select("Inbox")
        logging.info("成功连接Office 365 IMAP服务器")
        return imap
    except imaplib.IMAP4.error as e:
        logging.error("登录失败，请检查OAuth配置或权限", exc_info=True)
    except Exception as e:
        logging.error(f"服务器连接错误: {e}")
        return None

# 搜索邮件逻辑保持不变
def search_emails(imap, subject):
    status, mail_ids = imap.search(None, 'UNSEEN', 'FROM', "@domain.com", 'SUBJECT', f"{subject}")
    if status != 'OK':
        logging.error(f"IMAP搜索主题'{subject}'失败")
        return []
    else:
        logging.info("成功找到目标邮件")
    return [mail_id.decode() for mail_id in mail_ids[0].split()]

3. 额外检查项 #

• 确认Azure AD应用的权限已通过管理员同意（企业租户必须）
• 在Exchange Admin Center中检查IMAP协议是否被禁用
• 若为个人版Outlook.com，可尝试开启"允许低安全应用访问"（但企业版无此选项）

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