CloudOS7.0（7117 版本）开启 U‑KEY 登录、关闭密码登录后 UKEY 无法登录，平台 Web 页面无法进入修复方案

现象：密评配置开启 U‑KEY 强制登录，关闭用户名密码登录；UKEY 证书 / 驱动 / 电脑环境异常，导致Web 综合运管平台完全无法登录，没有密码登录入口，无法从界面关闭 UKEY 强制策略。 ⚠️重要提醒：下面操作需要登录 CloudOS管理节点后台 SSH（opsadmin 账号）；禁止随意直接修改数据库，优先官方维护方式，修改前务必做配置备份。

前置排查（先确认 UKEY 本身能不能修好，优先不碰后台）

1. 换客户端电脑，安装国密 UKEY 驱动，确认证书有效期、PIN 码正确；
2. 浏览器使用 Chrome，关闭拦截插件，导入 UKEY 根证书；

如果 UKEY 硬件损坏、证书过期、证书绑定错误，UKEY 方式本身无法登录，只能走后台命令修复。

方案一：后台命令关闭 UKEY 强制登录，恢复密码登录入口（7117）

1. SSH 登录 CloudOS 管理节点，使用opsadmin账号登录，切换 root

2. 备份平台认证配置（必须先备份！）

3. 修改认证配置，关闭ukeyForceLogin强制 UKEY 登录开关 编辑 auth_config.json

找到参数：

修改为

参数说明：ukeyForceLogin=true就是 “关闭密码登录，强制 UKEY 登录”；改为 false 后登录页面重新出现账号密码登录框。

4. 重启 plat 认证服务使配置生效

集群多管理节点场景：所有管理节点都要同步修改该文件，全部重启 plat‑auth 服务，否则负载均衡轮询访问到未修改节点依旧只有 UKEY 登录。

5. 测试：刷新浏览器综合运管登录页，此时密码登录选项恢复，可以 admin 账号密码登录 Web 界面。

Web 登录成功后后续操作

进入：云运营 → 配置管理 → Ukey 管理

1. 检查 UKEY 证书列表，把异常 / 过期证书解除账号绑定；
2. 确认 UKEY 证书有效后，再按需重新开启强制UKEY登录，不要直接关闭密码登录，建议保留双登录方式，规避再次锁死风险H3C。

方案二：如果上面 json 配置不生效（数据库持久存储场景）

7117 版本部分配置持久化到 mongodb 数据库，修改本地 json 不生效，需要联系 H3C400 工程师，通过平台内置运维脚本修改数据库中 ukeyForceLogin 字段。 ⚠️不建议客户自行直连修改 MongoDB，容易数据库损坏，优先 400 介入。

风险与避坑清单

1. 修改配置文件必须每个管理节点全部同步；只改一个节点，LB 轮询访问其他节点问题依旧；
2. 修改前务必备份原 json 文件，出错可以直接回退备份：

3. 密评环境建议最佳实践：开启 UKEY 登录，不要关闭密码登录，作为应急兜底；等确认 UKEY 全部客户端验证 100% 正常运行，再关闭密码登录；
4. 操作完成后检查版本为 7117，确认是否存在已知 bug，400 可获取对应补丁包。

紧急求助路径

1. 优先登录后台 opsadmin 执行方案一；
2. 如果后台 SSH 也无法登录，需要到服务器本地 Console 口登录服务器；
3. 无法处理直接拨打 H3C 400‑810‑0504，提供版本 7117，现象：开启 ukeyForceLogin 后 UKEY 不可用，Web 无法登录，申请远程运维支持。

补充：如果是仅仅是 admin 账号绑定了错误 UKEY 证书，恢复密码登录进 Web 后，在 Ukey 管理页面解除 admin 账号的证书绑定即可。