SSL 证书更新后“underlyingError: Error Domain=NSURLErrorDomain Code=-999 'cancelled'”错误解决指南

2024-03-13 11:58:27

如何解决 SSL 证书更新后的“underlyingError: Error Domain=NSURLErrorDomain Code=-999 'cancelled'”错误

背景

在更新应用程序平台上的域 SSL 证书后，应用程序可能出现“underlyingError: Error Domain=NSURLErrorDomain Code=-999 'cancelled'”错误。本文将深入探讨这个问题，并提供解决该问题的详细步骤。

问题原因

此错误通常是由 SSL 证书更改引起的。当客户端应用程序尝试连接到服务器时，它需要验证服务器证书的真实性。如果应用程序不信任已添加到平台的新根 CA，则连接将被取消并显示错误。

解决步骤

1. 验证客户端应用程序信任新的根 CA

确保客户端应用程序信任已添加到平台的新根 CA。
将根 CA 证书安装到客户端应用程序的受信任存储区，或配置应用程序以明确信任该 CA。

2. 上传完整的证书链

除了服务器证书和中间 CA，还要确保已将根 CA 证书上传到平台。
客户端应用程序需要获得完整的证书链才能验证服务器证书。

3. 检查平台配置

验证平台是否正确配置为使用新 SSL 证书。
确保平台已更新为支持新的根 CA。

4. 确保使用正确的证书文件

检查是否使用了正确的服务器证书和 CA 文件。
确保文件是有效的且包含正确的证书数据。

5. 联系平台支持

如果上述解决方案不起作用，请联系平台支持团队。
他们可能拥有解决此特定问题的附加信息或建议。

提示

使用 SSL 检查工具（例如 Qualys SSL Labs）来验证新证书的配置和安装。
测试应用程序以确保在新证书后它可以正常工作。
监控应用程序错误，以识别任何潜在问题。

常见问题解答

1. 如何安装根 CA 证书到客户端应用程序？

安装过程因应用程序而异。请查阅应用程序文档或联系开发人员以获取说明。

2. 如何上传完整的证书链到平台？

平台的配置过程可能不同。请查阅平台文档或联系平台支持团队以获取指导。

3. 如何检查平台配置？

平台配置通常可以在平台控制面板或管理界面中找到。请查阅平台文档或联系平台支持团队以获取具体说明。

4. 如何联系平台支持？

平台支持团队通常可以通过电子邮件、电话或聊天联系。请查阅平台文档或网站以获取联系信息。

5. 为什么需要完整的证书链？

完整的证书链使客户端应用程序能够验证服务器证书的真实性并建立安全连接。

结论

通过遵循这些步骤，你可以解决“underlyingError: Error Domain=NSURLErrorDomain Code=-999 'cancelled'”错误，并恢复应用程序的正常功能。始终确保客户端应用程序信任新的根 CA，并上传完整的证书链。如有需要，请联系平台支持团队以获得进一步的协助。