如何通过ASPOSE为启用MFA的Office365用户获取邮件？

核心思路 #

ROPC流不支持MFA，必须切换为授权码流（Authorization Code Flow）——这是微软官方推荐的支持MFA的用户委托授权方式，同时通过offline_access scope获取刷新令牌，实现令牌过期自动刷新。

步骤实现 #

1. 注册Azure AD应用 #

• 在Azure门户创建应用注册：
  • 设置重定向URI（桌面应用推荐用https://login.microsoftonline.com/common/oauth2/nativeclient）
  • 添加委托权限：Microsoft Graph > Mail.Read（用于读取邮件），企业租户需完成管理员同意
  • 记录客户端ID、租户ID（可选，用common适配所有租户），Web应用额外记录客户端密钥

2. 获取初始访问令牌与刷新令牌 #

• 引导用户访问微软授权页面完成MFA登录，获取授权码：

  https://login.microsoftonline.com/common/oauth2/v2.0/authorize?
  client_id={你的客户端ID}
  &response_type=code
  &redirect_uri={你的重定向URI}
  &scope=Mail.Read offline_access
  &response_mode=query
  

• 用授权码换取令牌（POST请求）：

  POST https://login.microsoftonline.com/common/oauth2/v2.0/token
  Content-Type: application/x-www-form-urlencoded
  
  client_id={你的客户端ID}
  &code={用户授权后返回的code}
  &redirect_uri={你的重定向URI}
  &grant_type=authorization_code
  &scope=Mail.Read offline_access
  &client_secret={你的客户端密钥} // Web应用必填，桌面应用可省略
  

  响应中会包含access_token（访问令牌）、refresh_token（刷新令牌）和expires_in（过期时长）

3. 配置Aspose.Email并处理令牌刷新 #

以C#为例，通过Aspose.Email的ImapClient实现OAuth认证及自动刷新：

using Aspose.Email.Clients.Imap;

var imapClient = new ImapClient("outlook.office365.com", 993, true);
imapClient.SecurityOptions = SecurityOptions.SSLImplicit;

// 初始化令牌
string accessToken = "获取到的初始访问令牌";
string refreshToken = "获取到的刷新令牌";
string clientId = "你的客户端ID";
string clientSecret = "你的客户端密钥";

imapClient.AccessToken = accessToken;

// 绑定令牌过期事件，自动刷新
imapClient.TokenExpired += (sender, e) =>
{
    var newTokens = RefreshTokens(refreshToken, clientId, clientSecret);
    imapClient.AccessToken = newTokens.AccessToken;
    refreshToken = newTokens.RefreshToken;
};

// 连接并操作邮件
imapClient.Connect();
// 示例：获取收件箱邮件
var inbox = imapClient.SelectFolder(ImapFolderInfo.InBox);
var messages = imapClient.ListMessages();
// ...后续业务逻辑

4. 刷新令牌的实现 #

编写刷新令牌的方法，调用微软令牌端点获取新令牌：

private static (string AccessToken, string RefreshToken) RefreshTokens(string refreshToken, string clientId, string clientSecret)
{
    var httpClient = new HttpClient();
    var requestContent = new FormUrlEncodedContent(new Dictionary<string, string>
    {
        ["client_id"] = clientId,
        ["refresh_token"] = refreshToken,
        ["grant_type"] = "refresh_token",
        ["scope"] = "Mail.Read offline_access",
        ["client_secret"] = clientSecret
    });

    var response = httpClient.PostAsync("https://login.microsoftonline.com/common/oauth2/v2.0/token", requestContent).Result;
    response.EnsureSuccessStatusCode();
    var tokenData = response.Content.ReadFromJsonAsync<Dictionary<string, object>>().Result;

    return (
        tokenData["access_token"].ToString(),
        tokenData["refresh_token"].ToString()
    );
}

注意事项 #

• 必须请求offline_access scope，否则无法获取刷新令牌
• 桌面应用建议使用公共客户端模式，无需客户端密钥；Web应用需妥善保管客户端密钥
• 确保使用Aspose.Email的最新版本，旧版本对OAuth2的支持可能存在缺陷

内容的提问来源于stack exchange，提问作者Matthieu Planté