【待评审】高危命令防呆设计新增资源协作接口与北向接口属性

高危操作二次鉴权接口评审

背景

高危操作(上下电、改盘、恢复出厂等)目前仅有页面确认,或「当前登录用户再输一次自己的密码」。需要支持管理员可开关的二次鉴权:命中高危策略时,必须再输入已配置的鉴权管理员用户名和密码后,业务才执行。

关联 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"] }
    ]
  }
]

评审结论

(待填)


遗留问题

(待填)