---
title: osTicket 集成 Microsoft 365 OAuth 邮件收发配置指南
description: 面向企业 IT 运维，说明在 osTicket 中通过 Microsoft 365 OAuth 替代基础认证的完整流程：应用注册、API 权限授予、插件安装、邮箱认证配置、后台定时取信与验证回退，并给出常见故障排查方向。
url: "https://www.lanever.com/docs/osticket-%e9%9b%86%e6%88%90-microsoft-365-oauth-%e9%82%ae%e4%bb%b6%e6%94%b6%e5%8f%91%e9%85%8d%e7%bd%ae%e6%8c%87%e5%8d%97/"
updated: "2026-10-12"
category: Office365
---

# osTicket 集成 Microsoft 365 OAuth 邮件收发配置指南

> **参考来源与致谢**
>
>
>
> - **引用来源：**[How to setup OAuth on osTicket using Microsoft 365 – How To HelpDesk](https://howtohelpdesk.com/how-to-setup-oauth-on-osticket-using-microsoft-365/)
> - **原作者：**原页面署名作者或发布机构（剪藏记录未保存可核验的个人署名）
> - **感谢词：**感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写，并非原文转载；如权利人需要更正署名或来源信息，请联系本站。

## 适用场景

Microsoft 365 已停止支持基础认证（Basic Authentication），继续使用账号密码方式让 osTicket 收发邮件会失败。若企业使用 osTicket 作为工单系统，并希望以 OAuth 2.0 方式连接 Microsoft 365 邮箱，可参考本文流程。该方案同样适用于配置了多个部门、多个支持邮箱的场景。

前提条件：osTicket 版本需支持 OAuth2 插件（通常为 v1.17 及以上，具体以对应版本文档为准）；操作者需具备应用注册与授予 API 权限的管理员权限。不同版本界面与字段可能存在差异，请以官方文档为准。

## 准备与风险

- 准备 Microsoft 365 全局管理员或应用管理员账号。
- 准备 osTicket 管理员账号及服务器文件系统访问权限。
- 准备支持邮箱地址列表（多部门需逐一配置）。
- 记录 osTicket 访问地址，用于拼接回调地址。

> 风险提醒：修改邮箱认证方式会导致取信中断。操作前请备份 osTicket 数据库与配置文件，并在测试环境先行验证。客户端密钥（Secret）仅在创建时可见一次，离开页面后无法再次查看，务必妥善保存；密钥属于敏感凭据，不得写入工单、聊天或公开文档。

## 处理步骤

### 1. 创建应用注册

1. 登录 Azure 门户，进入“Azure Active Directory”下的“应用注册”。
2. 选择“新注册”，填写名称。
3. 账户类型按需选择，单租户场景选择“仅此组织目录中的账户”。
4. 重定向 URL 选择 Web 类型，填写 `[外部链接已移除]`（以实际插件路径为准）。
5. 注册完成后，在“概述”页记录应用程序（客户端）ID 与目录（租户）ID，并查看授权端点与令牌端点。

### 2. 配置 API 权限

1. 进入“API 权限”>“添加权限”>“Microsoft Graph”。
2. 选择“委托的权限”，添加邮件收发相关权限，例如 `IMAP.AccessAsUser.All`、`POP.AccessAsUser.All`、`SMTP.Send`、`Mail.ReadWrite`、`offline_access`、`User.Read`。
3. 点击“代表[组织名称]授予管理员同意”，确认所有权限状态为已授予。

### 3. 启用隐式授权

在“身份验证”页勾选“ID 令牌（用于隐式和混合流）”，保存。

### 4. 分配应用管理员角色

若需支持用户同意，可在“企业应用程序”中为每个支持邮箱对应的用户分配“应用程序管理员”角色。多部门场景需逐个邮箱用户执行。

### 5. 创建客户端密钥

1. 在“证书和密码”>“客户端密码”中新建密钥，设置名称与有效期。
2. 立即复制密钥值并安全保存，离开页面后无法再次获取。

### 6. 安装并启用 OAuth 插件

1. 将 OAuth2 插件上传至 `[osTicket安装目录]/include/plugins`。
2. 在管理面板“插件”中点击“添加新插件”，安装并启用。此处不要直接配置。

### 7. 配置邮箱认证

1. 进入“邮件”>选择支持邮箱>“远程邮箱”。
2. 认证方式选择“OAuth2 – Microsoft”。
3. 填入应用程序 ID、租户 ID、客户端密钥及端点地址，提交后跳转至 Microsoft 登录页完成授权同意。
4. 授权成功后启用取信，并按需配置发信设置。

### 8. 配置后台定时取信

在服务器计划任务中调用 osTicket 的 cron 脚本，例如每分钟执行一次：

```
* * * * * [运行用户] php [osTicket安装目录]/api/cron.php
```

具体路径与运行用户按实际环境替换。

## 验证方法

- 向支持邮箱发送测试邮件，确认工单自动创建。
- 在 osTicket 中回复工单，确认外发邮件正常送达。
- 查看计划任务日志，确认 cron 无报错。
- 在 Azure 应用注册中确认权限状态正常。

## 回退建议

若配置失败，可暂时切回原有认证方式（若仍可用），或恢复备份的数据库与配置文件。删除新建的应用注册与客户端密钥前，确认无其他系统依赖。回退后重新验证取信与发信功能。

## 常见问题

- 页面空白或持续转圈：清理浏览器缓存，确认服务器 URL 重写已启用，必要时检查 Web 服务器配置中的目录覆盖设置。
- 授权后仍无法取信：确认管理员同意已授予，密钥未过期，回调地址与应用注册一致。
- 多部门配置：每个支持邮箱需单独完成授权与角色分配。
- 版本差异：插件路径、字段名称可能随版本变化，请查阅对应版本官方文档。
