参考来源与致谢
- 引用来源:How to setup OAuth on osTicket using Microsoft 365 – How To HelpDesk
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
Microsoft 365 已停止支持基础认证(Basic Authentication),继续使用账号密码方式让 osTicket 收发邮件会失败。若企业使用 osTicket 作为工单系统,并希望以 OAuth 2.0 方式连接 Microsoft 365 邮箱,可参考本文流程。该方案同样适用于配置了多个部门、多个支持邮箱的场景。
前提条件:osTicket 版本需支持 OAuth2 插件(通常为 v1.17 及以上,具体以对应版本文档为准);操作者需具备应用注册与授予 API 权限的管理员权限。不同版本界面与字段可能存在差异,请以官方文档为准。
准备与风险 #
- 准备 Microsoft 365 全局管理员或应用管理员账号。
- 准备 osTicket 管理员账号及服务器文件系统访问权限。
- 准备支持邮箱地址列表(多部门需逐一配置)。
- 记录 osTicket 访问地址,用于拼接回调地址。
风险提醒:修改邮箱认证方式会导致取信中断。操作前请备份 osTicket 数据库与配置文件,并在测试环境先行验证。客户端密钥(Secret)仅在创建时可见一次,离开页面后无法再次查看,务必妥善保存;密钥属于敏感凭据,不得写入工单、聊天或公开文档。
处理步骤 #
1. 创建应用注册 #
- 登录 Azure 门户,进入“Azure Active Directory”下的“应用注册”。
- 选择“新注册”,填写名称。
- 账户类型按需选择,单租户场景选择“仅此组织目录中的账户”。
- 重定向 URL 选择 Web 类型,填写
[外部链接已移除](以实际插件路径为准)。 - 注册完成后,在“概述”页记录应用程序(客户端)ID 与目录(租户)ID,并查看授权端点与令牌端点。
2. 配置 API 权限 #
- 进入“API 权限”>“添加权限”>“Microsoft Graph”。
- 选择“委托的权限”,添加邮件收发相关权限,例如
IMAP.AccessAsUser.All、POP.AccessAsUser.All、SMTP.Send、Mail.ReadWrite、offline_access、User.Read。 - 点击“代表[组织名称]授予管理员同意”,确认所有权限状态为已授予。
3. 启用隐式授权 #
在“身份验证”页勾选“ID 令牌(用于隐式和混合流)”,保存。
4. 分配应用管理员角色 #
若需支持用户同意,可在“企业应用程序”中为每个支持邮箱对应的用户分配“应用程序管理员”角色。多部门场景需逐个邮箱用户执行。
5. 创建客户端密钥 #
- 在“证书和密码”>“客户端密码”中新建密钥,设置名称与有效期。
- 立即复制密钥值并安全保存,离开页面后无法再次获取。
6. 安装并启用 OAuth 插件 #
- 将 OAuth2 插件上传至
[osTicket安装目录]/include/plugins。 - 在管理面板“插件”中点击“添加新插件”,安装并启用。此处不要直接配置。
7. 配置邮箱认证 #
- 进入“邮件”>选择支持邮箱>“远程邮箱”。
- 认证方式选择“OAuth2 – Microsoft”。
- 填入应用程序 ID、租户 ID、客户端密钥及端点地址,提交后跳转至 Microsoft 登录页完成授权同意。
- 授权成功后启用取信,并按需配置发信设置。
8. 配置后台定时取信 #
在服务器计划任务中调用 osTicket 的 cron 脚本,例如每分钟执行一次:
* * * * * [运行用户] php [osTicket安装目录]/api/cron.php
具体路径与运行用户按实际环境替换。
验证方法 #
- 向支持邮箱发送测试邮件,确认工单自动创建。
- 在 osTicket 中回复工单,确认外发邮件正常送达。
- 查看计划任务日志,确认 cron 无报错。
- 在 Azure 应用注册中确认权限状态正常。
回退建议 #
若配置失败,可暂时切回原有认证方式(若仍可用),或恢复备份的数据库与配置文件。删除新建的应用注册与客户端密钥前,确认无其他系统依赖。回退后重新验证取信与发信功能。
常见问题 #
- 页面空白或持续转圈:清理浏览器缓存,确认服务器 URL 重写已启用,必要时检查 Web 服务器配置中的目录覆盖设置。
- 授权后仍无法取信:确认管理员同意已授予,密钥未过期,回调地址与应用注册一致。
- 多部门配置:每个支持邮箱需单独完成授权与角色分配。
- 版本差异:插件路径、字段名称可能随版本变化,请查阅对应版本官方文档。
