OAuth2 连接 Outlook 的 IMAP / POP3：实现方法与原理

前言

除了 Microsoft Graph，Outlook 邮箱也可以通过传统邮件协议读取，例如 IMAP 和 POP3。本文结合一个 Python 示例脚本，说明如何使用 OAuth2 的 access_token 配合 XOAUTH2 认证登录 Outlook 邮箱，并解释这套接入方式背后的原理。

整体流程

这个脚本整体分成三段：

用 refresh_token 向微软换取 access_token
生成 XOAUTH2 认证串
分别连接 IMAP 和 POP3 服务，读取邮箱数据

对应关系如下：

OAuth2 负责颁发令牌
XOAUTH2 负责把令牌包装成邮件协议可识别的认证格式
IMAP / POP3 负责真正访问邮件服务

第一步：刷新 access_token

脚本先请求微软令牌接口：

import requestsdef get_access_token(refresh_token: str, client_id: str) -> str:
    data = {        "client_id": client_id,        "grant_type": "refresh_token",        "refresh_token": refresh_token,
    }
    resp = requests.post(        "https://login.microsoftonline.com/consumers/oauth2/v2.0/token",
        data=data,
        timeout=15,
    )
    resp.raise_for_status()    return resp.json()["access_token"]

这一步和 Graph API 的思路一致：

refresh_token 用来续期
access_token 用来真正访问资源

区别只是后面访问的不是 Graph，而是 IMAP / POP3 服务。

第二步：生成 XOAUTH2 认证串

脚本里有一个很关键的方法：

def generate_auth_string(user: str, token: str) -> str:    return f"user={user}\x01auth=Bearer {token}\x01\x01"

这里的 \x01 是控制字符 SOH，XOAUTH2 认证内容本质上是一个特殊格式的字符串。服务端收到后，会把其中的：

用户邮箱
Bearer Token

拆出来校验。

第三步：连接 IMAP

原脚本使用 imaplib.IMAP4_SSL 连接 Outlook：

import imaplibdef connect_imap(email_addr: str, access_token: str):
    mail = imaplib.IMAP4_SSL("outlook.live.com")
    mail.authenticate("XOAUTH2", lambda _: generate_auth_string(email_addr, access_token))    return mail

认证成功以后，脚本继续：

选择 INBOX 收件箱
选择 Junk 垃圾箱
执行 search(None, 'ALL')
再逐封 fetch(..., '(RFC822)')

这里抓到的是完整原始邮件内容，也就是 RFC822 格式报文。

邮件正文是怎么解析出来的

原脚本使用 Python 内置 email 模块解析返回结果：

import emaildef fetch_email_body(mail, item):
    status, msg_data = mail.fetch(item, "(RFC822)")    for response_part in msg_data:        if isinstance(response_part, tuple):
            msg = email.message_from_bytes(response_part[1])
            subject = msg.get("Subject")
            sender = msg.get("From")
            ...

后面又进一步判断：

如果是多部分邮件 multipart
就遍历每个 part
找到 text/plain 且不是附件的部分
再解码正文

这一步其实就是在做 MIME 报文拆解。

为什么比 Graph API 麻烦

因为 IMAP 返回的是原始邮件内容，不是已经整理好的 JSON。开发者必须自己处理：

主题编码
发件人字段
多部分正文
附件判断
字符集解码

也正因如此，传统协议更灵活，但实现成本也更高。

POP3 部分是怎么做的

脚本里的 POP3 连接方式是：

import base64import poplibdef connect_pop3(email_addr: str, access_token: str):
    server = poplib.POP3_SSL("outlook.live.com")
    auth = generate_auth_string(email_addr, access_token)
    encoded = base64.b64encode(auth.encode("utf-8")).decode("utf-8")
    server._shortcmd("AUTH XOAUTH2")
    server._shortcmd(encoded)    return server

这里比 IMAP 多了一步 Base64 编码，因为 POP3 的认证交换格式通常需要把认证串编码后发给服务端。

脚本最后调用 server.list() 打印邮件列表，说明连接与认证已经成功。