Webklex\PHPIMAP Office 365新式身份验证失效求助

核心排查方向 #

• 令牌权限校验：确认获取access token时已申请IMAP.AccessAsUser.All权限，Office 365要求必须显式配置该权限才能通过IMAP协议访问邮箱。
• 连接参数配置：Webklex连接时需严格匹配Office 365的IMAP OAuth2要求：
  • 服务器地址固定为 outlook.office365.com，端口 993，加密方式 ssl
  • 认证方式指定为 oauth，将access token作为密码传入，用户名必须填写完整邮箱地址
• 令牌有效性验证：用JWT解析工具检查token的aud字段是否为https://outlook.office365.com，exp字段是否未过期，scp/roles字段是否包含IMAP.AccessAsUser.All权限。
• 版本兼容性：确认Webklex\PHPIMAP版本为最新稳定版，旧版本可能存在OAuth2适配缺陷。

修正后的连接代码示例 #

$client = new \Webklex\PHPIMAP\Client([
    'host' => 'outlook.office365.com',
    'port' => 993,
    'encryption' => 'ssl',
    'validate_cert' => true,
    'username' => 'your-full-email@domain.com',
    'password' => 'valid-access-token',
    'authentication' => 'oauth',
]);

try {
    $client->connect();
    // 后续邮箱操作逻辑
} catch (\Webklex\PHPIMAP\Exceptions\AuthFailedException $e) {
    echo "认证失败: " . $e->getMessage();
}

额外注意事项 #

• 若使用应用权限（非委派权限），需确保租户管理员已授予管理员同意，token获取采用客户端凭证流，权限需设置为IMAP.AccessAsApp。
• 检查Exchange Admin Center中对应邮箱的IMAP协议是否处于启用状态。

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