SSO对接排障指南
更新时间:2026-04-27 05:57:48

1. 网络连通性确认

  1. UC 平台:需确保 UC 能正常访问统一认证平台的 web 网页端口,SSO 基于 HTTP 请求,需保证可访问对应 HTTP/HTTPS 端口(以 UC 实际 SSO 配置页面服务器地址为准)。
  2. 统一认证平台:需确保能正常访问 UC 主管理节点地址的 HTTPS 端口。
  3. 用户侧:需确保电脑或手机能正常访问 UC 主管理节点 HTTPS 端口和统一认证平台 HTTP/HTTPS 端口。

2. 配置项确认

  • SSO 对接支持 3 种协议:

    • OAuth2.0:V43/V44/V45/V46 支持
    • Saml:V46 开始支持
    • CAS:V46 开始支持
  • 对接前需阅读 SSO 对接指导文档,了解交互流程,按配置详解表核对 UC 侧 SSO 配置。

3. 回调地址核对

  • V46 版本(46.x.0.x)及以上:回调地址在 web 页面自动生成并展示。
  • V45 及之前版本:不支持 web 页面查看,建议升级至 V46 以上。
  • 仅对接 OAuth2.0 且必须使用 V45 及以下版本时,回调地址格式:

    https://域名或ip:端口/api/v1/auth/sso/web/callback?partyId=xxx

  • partyId 获取方式:登录 UC 企业管理平台,按 F12 打开浏览器日志,在企业成员列表任意用户详情中获取(企业固定值)。
  • 获取partyid

4. 故障资料获取

UC 平台日志获取步骤

  1. 访问 UC 系统管理平台,登录 admin 账号。
  2. 进入系统运维 - 日志管理 - 系统日志,勾选网页服务
  3. 选择包含故障时间点的时间范围,点击导出。
  4. 将导出日志与故障时间点提供给亿联技术支持人员。 获取web日志
本页目录