高危操作二次鉴权接口评审
背景
高危操作(上下电、改盘、恢复出厂等)目前仅有页面确认,或「当前登录用户再输一次自己的密码」。需要支持管理员可开关的二次鉴权:命中高危策略时,必须再输入已配置的鉴权管理员用户名和密码后,业务才执行。
关联 ISSUE
[需求]: 支持高危命令防呆设计-account-AtomGit
整体方案
高危防呆需完成「总开关 / 鉴权用户 / 高危操作目录 / 每用户勾选范围」四类能力的北向配置与运行时判定:
- 总开关、鉴权用户、每用户范围:落 account 资源协作属性持久化;Web / CLI 均经 rackmount mapping 读写。
- 高危操作目录:不落 account DBus。由 rackmount 侧新增一份 Lua 配置文件,定义高危场景 Id、接口组名、ZH/EN 描述及 Web/Cli 的 URI+Method 列表;独立 Web GET(评审点五)据此返回目录。该文件与 mapper、CLI 同源(同内容加载),供执行侧命中判定,避免多处维护。
命中条件:开关开 ∧ 操作者 PerUser 含对应场景 Id ∧ 本次 URI+Method 在目录中(Web/Cli 分列)。验密复用现有 Authenticate,不新增 DBus 方法。
评审点
评审点一:资源协作接口 bmc.kepler.AccountService 新增属性
评审点二:资源协作接口 bmc.kepler.AccountService.ManagerAccount 新增属性
评审点三:webrest 接口 /UI/Rest/AccessMgnt/AdvancedSecurity 新增属性
评审点四:webrest 接口 /UI/Rest/AccessMgnt/Accounts/:accountid 新增属性
评审点五:webrest 新增URI接口 /UI/Rest/AccessMgnt/HighRiskOperationInterfaces(高危目录 GET)
评审点一 资源协作接口 bmc.kepler.AccountService 新增属性
详细描述
- path:
/bmc/kepler/AccountService - interface:
bmc.kepler.AccountService - 变化类型:新增属性
| 变更类型 | 属性名称 | 类型 | 只读 | 变化通知 | 属性描述 | 访问权限(读/写) | 属性来源 | 示例/取值约束/默认值 | 持久化 |
|---|---|---|---|---|---|---|---|---|---|
| 新增 | HighRiskOperationReauthEnabled | Bool | false | true | 高危操作二次鉴权总开关;未配置鉴权用户时不可开启 | Read: ReadOnly; Write: UserMgmt | 默认配置/用户设置 | 取值:[true,false],默认:false | 复位持久化 |
| 新增 | HighRiskOperationReauthUserId | Integer | false | true | 鉴权用户账户 Id;规则对齐紧急登录用户(EmergencyLoginAccountId):须为已存在且已启用的 Administrator | Read: UserMgmt; Write: UserMgmt | 默认配置/用户设置 | 取值:0~17,默认:0;0 表示未配置 | 复位持久化 |
评审点二 资源协作接口 bmc.kepler.AccountService.ManagerAccount 新增属性
详细描述
- path:
/bmc/kepler/AccountService/Accounts/:id - interface:
bmc.kepler.AccountService.ManagerAccount - 变化类型:新增属性
| 变更类型 | 属性名称 | 类型 | 只读 | 变化通知 | 属性描述 | 访问权限(读/写) | 属性来源 | 示例/取值约束、默认值 | 持久化 |
|---|---|---|---|---|---|---|---|---|---|
| 新增 | HighRiskOperationPerUserInterfacesScope | 数组 Array(元素 Integer) | false | true | 该用户启用的高危场景 Id 列表 | Read: ConfigureSelf; Write: UserMgmt | 默认配置/用户设置 | 元素为场景 Id(与高危目录 Id 对齐,当前 1~5);默认空数组;未知/越界 Id 过滤后写入 | 复位持久化 |
元素语义:高危场景 Id(1=PowerControl,2=PowerOnLock,3=LogicalDisk,4=RaidPhysicalDisk,5=RestoreFactory),不是 URI 或组名字符串。
HighRiskOperationPerUserInterfacesScope 示例:
[1, 5]
评审点三 webrest 接口 /UI/Rest/AccessMgnt/AdvancedSecurity 新增属性
详细描述
- URI:
/UI/Rest/AccessMgnt/AdvancedSecurity - 接口类型:GET / PATCH
- 变化类型:新增属性
| 属性 | 类型 | 示例/默认值/取值约束 | readonly | 易变属性 | 实现 PATCH | 操作权限 | 描述 |
|---|---|---|---|---|---|---|---|
| HighRiskOperationReauthEnabled | Bool | 取值:[true,false],默认值:false | false | 否 | 是 | GET: ReadOnly; PATCH: UserMgmt | 高危鉴权总开关(映射 DBus HighRiskOperationReauthEnabled) |
| HighRiskOperationReauthUser | String | 默认值:空字符串;空表示未配置 | false | 否 | 是 | GET: UserMgmt; PATCH: UserMgmt | 鉴权用户名(映射 DBus HighRiskOperationReauthUserId;空则写 0;非空须为已启用 Administrator,Id 落在 0~17 合法账户) |
评审点四 webrest 接口 /UI/Rest/AccessMgnt/Accounts/:accountid 新增属性
详细描述
- URI:
/UI/Rest/AccessMgnt/Accounts/:accountid - 接口类型:GET / PATCH /POST
- 变化类型:新增属性
| 属性 | 类型 | 示例/默认值/取值约束 | readonly | 易变属性 | 实现 PATCH | 操作权限 | 描述 |
|---|---|---|---|---|---|---|---|
| PerUserInterfacesScope | 字符串数组 | 取自目录 InterfaceGroup;默认空数组 | false | 否 | 是 | GET: ConfigureSelf; PATCH: UserMgmt | 该用户需做高危二次鉴权的接口组列表;mapping 按组名↔场景 Id 与 DBus HighRiskOperationPerUserInterfacesScope(整型数组)互转 |
PerUserInterfacesScope 示例:
[
"PowerControl",
"PowerOnLock",
"LogicalDisk",
"RaidPhysicalDisk",
"RestoreFactory"
]
评审点五 webrest 新增URI接口 /UI/Rest/AccessMgnt/HighRiskOperationInterfaces(高危目录 GET)
详细描述
- URI:
/UI/Rest/AccessMgnt/HighRiskOperationInterfaces - 接口类型:GET
- 变化类型:新增接口
- 操作权限:ReadOnly
- 实现:Plugin 读取 rackmount 侧上述同源 Lua 目录配置并返回,只读,不持久化到 account。
RspBody: 目录数组,元素字段如下。
| 属性 | 类型 | 描述 | 取值约束/说明 |
|---|---|---|---|
| [ | |||
| Id | Integer | 场景 Id(只增不改语义) | 当前 1~5;与 DBus PerUser 元素一致 |
| InterfaceGroup | String | 高危接口组名 | 如 PowerControl |
| InterfaceDescriptionZH | String | 接口组中文描述 | / |
| InterfaceDescriptionEN | String | 接口组英文描述 | / |
| Interfaces | 数组 Array | 该组下的具体接口列表 | / |
| [ | |||
| Interface | String | 接口路径(URI,可含 * 通配) |
/ |
| InterfaceType | String | 接口类型 | [Web, Cli] |
| RequestTypes | 字符串数组 | 方法集合 | 如 [POST]、[PATCH]、[POST,PATCH,DELETE] |
| ] | |||
| ] |
目录示例(Web URI 为 Storage 单数):
[
{
"Id": 1,
"InterfaceGroup": "PowerControl",
"InterfaceDescriptionZH": "上下电/重启",
"InterfaceDescriptionEN": "Power on/off and restart",
"Interfaces": [
{ "Interface": "/UI/Rest/System/PowerControl", "InterfaceType": "Web", "RequestTypes": ["POST"] },
{ "Interface": "/UI/Rest/Chassis/PowerControl", "InterfaceType": "Web", "RequestTypes": ["POST"] },
{ "Interface": "/cli/v1/fru0/powerstate", "InterfaceType": "Cli", "RequestTypes": ["PATCH"] },
{ "Interface": "/cli/v1/_/powerstate", "InterfaceType": "Cli", "RequestTypes": ["PATCH"] }
]
},
{
"Id": 2,
"InterfaceGroup": "PowerOnLock",
"InterfaceDescriptionZH": "上电锁定",
"InterfaceDescriptionEN": "Power-on lock",
"Interfaces": [
{ "Interface": "/UI/Rest/System/PowerControl", "InterfaceType": "Web", "RequestTypes": ["PATCH"] }
]
},
{
"Id": 3,
"InterfaceGroup": "LogicalDisk",
"InterfaceDescriptionZH": "逻辑盘",
"InterfaceDescriptionEN": "Logical disk",
"Interfaces": [
{ "Interface": "/UI/Rest/System/Storage/*/Volumes", "InterfaceType": "Web", "RequestTypes": ["POST", "PATCH", "DELETE"] },
{ "Interface": "/UI/Rest/System/Storage/*/Volumes/*", "InterfaceType": "Web", "RequestTypes": ["POST", "PATCH", "DELETE"] },
{ "Interface": "/cli/v1/storage/addld", "InterfaceType": "Cli", "RequestTypes": ["PATCH"] },
{ "Interface": "/cli/v1/storage/createld", "InterfaceType": "Cli", "RequestTypes": ["PATCH"] },
{ "Interface": "/cli/v1/storage/deleteld", "InterfaceType": "Cli", "RequestTypes": ["PATCH"] },
{ "Interface": "/cli/v1/storage/ldconfig", "InterfaceType": "Cli", "RequestTypes": ["PATCH"] }
]
},
{
"Id": 4,
"InterfaceGroup": "RaidPhysicalDisk",
"InterfaceDescriptionZH": "RAID/物理盘",
"InterfaceDescriptionEN": "RAID / physical disk",
"Interfaces": [
{ "Interface": "/UI/Rest/System/Storage/*", "InterfaceType": "Web", "RequestTypes": ["PATCH"] },
{ "Interface": "/UI/Rest/System/Storage/Drives/*", "InterfaceType": "Web", "RequestTypes": ["PATCH"] },
{ "Interface": "/cli/v1/storage/ctrlconfig", "InterfaceType": "Cli", "RequestTypes": ["PATCH"] },
{ "Interface": "/cli/v1/storage/pdconfig", "InterfaceType": "Cli", "RequestTypes": ["PATCH"] }
]
},
{
"Id": 5,
"InterfaceGroup": "RestoreFactory",
"InterfaceDescriptionZH": "恢复出厂",
"InterfaceDescriptionEN": "Restore factory settings",
"Interfaces": [
{ "Interface": "/UI/Rest/RestoreFactory", "InterfaceType": "Web", "RequestTypes": ["POST"] },
{ "Interface": "/cli/v1/_/restore", "InterfaceType": "Cli", "RequestTypes": ["PATCH"] }
]
}
]
评审结论
(待填)
遗留问题
(待填)