邮件服务器设置故障排除

邮件获取问题故障排除

配置邮件服务器后，通过获取示例邮件测试设置。为此，点击“获取示例邮件”按钮。

 

 

如果设置正确且连接成功，将会获取邮箱中最早的邮件及其属性。否则，屏幕上会显示错误信息。 

在 ServiceDesk Plus 中，邮件获取问题可分为以下几类：

• 用户名或密码错误。

• 无法访问主机。

• 无法连接到邮件服务器。请检查配置后重试。

• 目标的证书路径无效。请配置受信任或自签名证书后重试。

• 无法以读写模式打开邮箱。

• 无法连接到邮件服务器。请检查服务器 URL 后重试。
• 无法保存设置。

注意：对于所有邮件获取异常，请使用相同配置在其他第三方邮件客户端（如 Outlook 桌面应用和 Thunderbird 桌面应用）中检查连接性。

 

给定的用户名和密码认证失败 

• 检查配置的用户名和密码是否正确。
• 如果用户名和密码正确，检查邮件服务器配置是否正确。
• 如果配置的协议为 IMAP，打开的并发 IMAP 连接有时可能会用尽。在这种情况下，会间歇性抛出认证异常（每当连接用尽时）。一旦有可用的开放 IMAP 连接，邮件获取将恢复。了解更多，请访问链接： ServiceDesk Plus 中 IMAP 协议间歇性认证失败异常

 如果第三方应用没有连接问题，而仅 ServiceDesk Plus 存在认证问题， 请访问此处.

 

配置的邮件主机名未知或不可访问，或无法使用提供的配置连接到邮件服务器 

 

• 检查配置的服务器名称是否正确。
• 如果服务器名称正确，检查协议配置是否正确。
• 软件/硬件防火墙可能阻止了 POP/IMAP 端口。如果是这种情况，请尝试解封端口或尝试使用 EWS（Exchange Web Services）。

如果您能连接其他第三方应用，但无法通过 ServiceDesk Plus 服务器连接邮箱， 请访问此处.

 

找不到请求目标的有效证书路径，请配置受信任/自签名证书。 

• 您正在尝试与邮件服务器建立安全连接（例如 POPS 或 IMAPS），但应用程序（Java 密钥库）中未包含连接该邮件服务器的证书。
• 从以下链接下载文件，并解压到 ServiceDesk Plus 主页目录： https://uploads.zohocorp.com/Internal_Useruploads/dnd/ServiceDesk_Plus/2016_02_03_11_25_23_o_1acqu0dua1tidbq1kni1llri9g1.tar.gz
• 根据服务器操作系统，从命令提示符运行解压得到的批处理文件（Windows / Linux），命令格式如下：
• 语法： 

Windows - gencert.bat <hostname>:<port> 

例如：cmd> gencert.bat sdpexchange.com:995

Linux - sh gencert.sh <hostname>:<port>

例如：sh gencert.sh sdpexchange.com:995

• 服务器将在命令提示符下发送可用证书。系统会提示输入证书编号以继续。输入证书编号后，会在 ServiceDesk Plus 主页目录生成一个名为 jssecacerts 的文件（如果文件已存在，此证书将追加到文件中）。
• 将 jssecacerts 文件复制到 jre\lib\security 文件夹，并重启 ServiceDesk Plus 应用。
• 保存设置并测试邮件连接。

如果应用证书后仍遇到问题， 请点击此处.

 

无法以读写模式打开邮箱 

• 用户可能没有该邮箱的写权限。

• 请联系管理员为邮箱获取适当的写权限。写权限对于在邮件被获取后删除邮件是必要的。

 

无法连接到邮件服务器。请检查服务器 URL 后重试。 

• EWS 的连接 URL 可能不正确。请更正连接 URL。欲了解您的 Exchange Server 的 EWS URL，请访问以下链接：

了解您的 Exchange Web Services URL（连接 URL）

 

邮件发送问题故障排除

要检查邮件服务器连接性，请在发件选项卡中输入收件邮箱地址，然后点击“发送示例邮件”按钮。

 

 

 

如果设置正确且连接成功，示例邮件将发送至指定邮箱地址。否则，屏幕上会显示错误信息。 

ServiceDesk Plus 发送邮件时常见异常可分为以下几类：

1. 用户名或密码错误。
2. 无法访问主机。
3. 无法连接到邮件服务器。请检查连接 URL 后重试。
4. 发生未知错误。

 

用户名或密码错误

• 验证配置的用户名和密码是否正确。
• 检查邮件服务器配置（协议、TLS、端口）。
• 使用第三方邮件客户端配置账户，并向该账户发送示例邮件。如果凭证正确，将进入欢迎页面；否则会反复弹出警告提示。

注意：如果使用 SMTP/SMTPS，请勿通过 Outlook Web Access 检查账户配置，因为它使用 MAPI 协议。若使用 Exchange Web Services，请在隐身窗口打开连接 URL。

如果仍无法使用凭证登录， 请点击此处 用于调试邮件并发送日志报告以供分析。

 

无法访问主机

• 检查配置的服务器名称是否正确。
• 如果服务器名称正确，检查协议配置是否正确。使用 Exchange Web Services 时，确保连接 URL 正确。欲寻找 Exchange Server URL，请访问此 链接.
• 如果 使用 SMTP/SMTPS，软件/硬件防火墙可能阻止了 SMTP/SMTPS 端口。如果是这种情况，请解封端口或尝试使用 EWS（Exchange Web Services）。如果错误仍然存在，

用于启用邮件调试并发送日志报告以供分析。 请点击此处 无法连接到邮件服务器。请检查连接 URL 后重试。

 

EWS 的连接 URL 可能不正确。请更正连接 URL。欲了解您的 Exchange Server 的 EWS URL，请访问以下链接：

• 发生未知错误

了解您的 Exchange Web Services URL（连接 URL）

 

如果您使用 Exchange Server 和 SMTP 协议（SMTP+TLS），请确保 ServiceDesk Plus 中已更新 Exchange Server 证书。欲申请 Exchange Server 证书，请访问

• 此处 。如果使用 EWS，除非 Exchange Server 使用自签名证书，否则需在 ServiceDesk Plus 中申请证书。要在 ServiceDesk Plus 中申请 EWS 证书，请访问此处。 如果使用 Office 365，则无需申请证书。 如果使用 SMTP/SMTPS，请检查是否允许向输入的地址发送邮件。若要绕过邮件服务器域发送，您需要获得授权。请联系您的 IT 管理员处理此事。
• 如果第三方应用无连接问题，仅 ServiceDesk Plus 出现认证问题，请开启邮件调试并发送日志以供分析：

 

要调试邮件，勾选“启用邮件调试”框并保存设置。

1. 重新创建问题以在日志中生成调试打印信息。 
   
   
   
   
2. 调试打印信息保存在应用服务器的 logs 文件夹中。例如，在 Windows 中，logs 文件夹位于 C→ManageEngine→ServiceDesk→logs。
3. 将 logs 文件夹压缩为 zip 文件。
4. 将压缩包发送至 support@servicedeskplus.com 以供分析。
5. 无法保存设置

邮件限制针对每个应用 ID 和邮箱组合进行评估。ServiceDesk Plus MSP 防止用户在收发邮件服务器设置中配置相同的客户端 ID 和回复邮箱。

若要在收发邮件服务器设置中使用相同邮箱，请创建一个单独应用（不同的客户端 ID）。 

详情请参阅

microsoft 文档 了解 Microsoft Graph API 中的限制详情。