Lucee应用适配O365 OAuth2认证实现邮件读取功能求助

一、前置准备 #

• 在Azure AD注册企业应用：账户类型选择"仅限我的组织目录中的账户"，注册后记录Client ID、Client Secret、Tenant ID
• 配置API权限：添加Microsoft Graph的Mail.Read应用权限，完成管理员同意（必须由租户管理员操作）

二、获取OAuth2访问令牌 #

Lucee中通过cfhttp调用微软令牌端点获取令牌，代码示例：

<cfset tenantId = "你的租户ID">
<cfset clientId = "你的客户端ID">
<cfset clientSecret = "你的客户端密钥">
<cfset tokenEndpoint = "https://login.microsoftonline.com/#tenantId#/oauth2/v2.0/token">

<cfhttp url="#tokenEndpoint#" method="post">
    <cfhttpparam type="formfield" name="grant_type" value="client_credentials">
    <cfhttpparam type="formfield" name="client_id" value="#clientId#">
    <cfhttpparam type="formfield" name="client_secret" value="#clientSecret#">
    <cfhttpparam type="formfield" name="scope" value="https://graph.microsoft.com/.default">
</cfhttp>

<cfset tokenResponse = deserializeJson(cfhttp.fileContent)>
<cfset accessToken = tokenResponse.access_token>

三、替换原cfmail逻辑，改用Microsoft Graph API读取邮件 #

原cfmail标签不支持OAuth2，需通过Graph API获取邮件及附件，代码示例：

<!--- 筛选目标邮件：可根据主题、是否有附件等条件调整filter --->
<cfset graphEndpoint = "https://graph.microsoft.com/v1.0/users/目标邮箱地址/messages?$filter=hasAttachments eq true and subject contains 'XML目标信息'">

<cfhttp url="#graphEndpoint#" method="get">
    <cfhttpparam type="header" name="Authorization" value="Bearer #accessToken#">
    <cfhttpparam type="header" name="Accept" value="application/json">
</cfhttp>

<cfset mailResponse = deserializeJson(cfhttp.fileContent)>
<cfloop array="#mailResponse.value#" index="mail">
    <!--- 获取邮件附件 --->
    <cfset attachmentEndpoint = "https://graph.microsoft.com/v1.0/users/目标邮箱地址/messages/#mail.id#/attachments">
    <cfhttp url="#attachmentEndpoint#" method="get">
        <cfhttpparam type="header" name="Authorization" value="Bearer #accessToken#">
    </cfhttp>
    <cfset attachments = deserializeJson(cfhttp.fileContent).value>
    
    <cfloop array="#attachments#" index="attachment">
        <cfif attachment.contentType eq "application/xml">
            <!--- 解码Base64格式的XML附件内容 --->
            <cfset xmlContent = toString(toBinary(attachment.contentBytes))>
            <!--- 复用原有XML解析与数据库存储逻辑 --->
            <cfset xmlData = xmlParse(xmlContent)>
            <cfquery datasource="你的数据源">
                INSERT INTO target_table (field1, field2)
                VALUES (<cfqueryparam value="#xmlData.root.node1#" cfsqltype="cf_sql_varchar">,
                        <cfqueryparam value="#xmlData.root.node2#" cfsqltype="cf_sql_varchar">)
            </cfquery>
        </cfif>
    </cfloop>
</cfloop>

四、Lucee特定注意事项 #

• 确保Lucee服务器的Java环境支持TLS 1.2及以上版本（微软OAuth端点强制要求）
• 令牌缓存：access_token有效期为1小时，用Lucee的cachePut/cacheGet缓存令牌，避免重复请求
• 权限验证：确认Azure AD应用的Mail.Read权限已获得租户管理员同意，否则API调用会返回权限错误

五、调试排查技巧 #

• 用cfdump输出cfhttp的响应内容，快速定位令牌获取或API调用的错误信息
• 查看Azure AD的应用日志，检查权限请求、令牌发放的异常记录
• 调整Graph API的filter参数，验证邮件筛选逻辑是否准确

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