OpenBMC：WebUI 与后端接口交互流程

1. WebUI 的作用

OpenBMC WebUI 为管理员提供图形化管理界面，常见功能包括：

• 查看服务器状态
• 读取传感器数据
• 控制主机电源
• 查看事件日志
• 配置用户和网络
• 管理固件版本
• 使用远程控制台
• 查看硬件 Inventory

WebUI 本身通常不直接访问 D-Bus，也不会直接操作 GPIO、I2C 或其他硬件接口。

WebUI ↓ HTTPS bmcweb ↓ D-Bus OpenBMC 后台服务 ↓ 硬件驱动

2. WebUI 与 bmcweb

WebUI 通常以浏览器端单页应用的形式运行。页面所需的 HTML、JavaScript、CSS 和图片资源由 BMC Web 服务提供。

用户打开 BMC 地址时：

浏览器请求页面 ↓ bmcweb 返回静态资源 ↓ 浏览器加载 WebUI ↓ WebUI 调用 Redfish API ↓ 页面显示管理数据

bmcweb同时承担以下职责：

• 提供 HTTPS 服务
• 提供 WebUI 静态资源
• 实现 Redfish 接口
• 管理登录会话
• 检查用户权限
• 访问 D-Bus 后台服务
• 支持事件订阅和远程控制功能

3. 登录认证流程

WebUI 登录时，通常通过 Redfish Session Service 创建会话。

用户输入账号和密码 ↓ WebUI 发送登录请求 ↓ bmcweb 调用认证机制 ↓ 验证用户、密码和账号状态 ↓ 创建 Session ↓ 返回 X-Auth-Token

登录请求示例：

POST /redfish/v1/SessionService/Sessions Content-Type: application/json { "UserName": "admin", "Password": "password" }

后续请求携带 Token：

X-Auth-Token: <session-token>

bmcweb 收到请求后，还会检查当前用户角色是否拥有访问该接口的权限。

4. 数据查询流程

以 WebUI 显示温度传感器为例：

WebUI 请求 Sensors 资源 ↓ bmcweb 接收 Redfish GET 请求 ↓ 通过 ObjectMapper 查找 Sensor 对象 ↓ 读取 Sensor.Value 和 Threshold ↓ 读取 Sensor 与 Chassis 的关联关系 ↓ 转换为 Redfish JSON ↓ WebUI 更新页面

请求示例：

GET /redfish/v1/Chassis/chassis/Sensors

返回数据可能包含：

{ "Name": "CPU0 Temp", "Reading": 52.5, "ReadingUnits": "Cel", "Status": { "Health": "OK", "State": "Enabled" } }

WebUI 只处理 Redfish 数据，不需要了解传感器来自 hwmon、PMBus 还是其他接口。

5. 控制请求流程

以主机上电为例，WebUI 会发送一个 Redfish Action：

POST /redfish/v1/Systems/system/Actions/ComputerSystem.Reset { "ResetType": "On" }

完整流程如下：

用户点击上电 ↓ WebUI 发送 POST 请求 ↓ bmcweb 检查 Session 和权限 ↓ 解析 ResetType ↓ 设置 D-Bus 电源转换属性 ↓ 电源控制服务执行上电 ↓ 主机电源状态变化 ↓ WebUI 重新查询并刷新状态

网络设置、用户管理和日志清理等操作也采用类似模式，只是对应的 Redfish 路径和后台 D-Bus 服务不同。

6. 常用 HTTP 方法

WebUI 与 Redfish 后端交互时，主要使用以下方法：

例如修改 BMC 主机名：

PATCH /redfish/v1/Managers/bmc/NetworkProtocol

创建用户、启动固件升级和执行电源动作，则通常使用POST。

7. 异步任务与事件更新

固件升级、日志导出和大文件上传等操作无法立即完成，bmcweb 可以返回 Task 或 Job 资源。

WebUI 发起操作 ↓ bmcweb 创建异步任务 ↓ 返回任务地址 ↓ WebUI 周期查询任务状态 ↓ 显示进度和执行结果

任务状态可能包括：

New Starting Running Completed Exception Cancelled

实时状态也可以通过事件订阅或服务器推送机制更新，减少页面频繁轮询。

8. 总结

WebUI 与 OpenBMC 后端的交互链路为：

浏览器 WebUI ↓ HTTPS / JSON bmcweb ↓ D-Bus 传感器、电源、日志、用户和升级服务 ↓ Linux 内核及硬件

WebUI 负责界面和用户操作，bmcweb 负责认证、权限检查及 Redfish 转换，D-Bus 服务负责具体业务，内核驱动负责访问硬件。