单点登录（SSO）配置指南

适用场景：内部系统预览、临时资源访问等特定场景的单点登录集成

一、平台配置流程

详情

1. 进入系统设置

登录平台管理后台 → 导航至 系统设置 > Web配置 模块

2. 配置单点登录参数

3. 登录地址：
   /#/jumpIframeLogin/ganwei-iotcenter-login/ssoLogin
   ⚠️ 注意：需确保该地址未被其他配置占用

4. 鉴权地址：
   /IoT/api/v3/LoginEncryp/SingleLogin?token=Ttp0QtJLzwYhnbrBvw5kfx%2bLw9Db%2bZSWMHTX6y5Sg%3d
   ⚠️token参数参考下面Token生成规范

二、Token生成规范

详情

1. 加密流程 步骤1：使用GWEncrypt工具加密

• 工具路径：平台内置工具 → GWEncrypt加密器
• 加密方式选择：[1]使用敢为许可加密字符串(新)
• 输入内容格式：账号;密码（例：admin;123456）

2. URL编码处理

将加密结果通过UrlEncode工具 (opens new window)处理

• 示例：
  原始加密值：Ttp0QtJLzwYhnbrBvw5kfx+Lw9DbSexWMHTX6y5Sg=
  编码后：Ttp0QtJLzwYhnbrBvw5kfx%2bLw9Db%2bexWMHTX6y5Sg%3d

三、访问地址构造

1. 基础URL

https://{服务器IP}:{端口}/ganwei-iotcenter-login/#/ssoLogin

2. 参数说明（需URL编码）

参数	示例值	说明
url	%2F%23%2FIndex%2FjumpIframe%2Fganwei-iotcenter-config-manage%2FwebConfig	目标跳转地址（需根据实际页面路径调整后进行UrlEncode）
isHideMenu	true	是否隐藏左侧菜单栏（true隐藏/false显示）
isHideHead	true	是否隐藏顶部导航栏（true隐藏/false显示）

3. 完整访问示例

https://192.168.1.100:8080/ganwei-iotcenter-login/#/ssoLogin?
url=%2F%23%2FIndex%2FjumpIframe%2Fganwei-iotcenter-config-manage%2FwebConfig
&isHideMenu=true&isHideHead=true

四、验证与排错

1. 登录地址冲突检测：配置前可通过浏览器直接访问登录地址，确认是否返回404或重复响应
2. Token有效性验证：使用Postman等工具直接调用鉴权地址，检查是否返回有效会话ID
3. 编码正确性检查：确保URL参数中特殊字符（如+→%2B，=→%3D）已完整编码