CSR配置字典之ChannelConfig类 ​

📋 文档信息 ​

📋 变更历史记录 ​

🎯 类概览 ​

📊 属性定义详表 ​

必选属性 ​

可选属性 ​

• 无可选属性

🔗 动态关联机制 ​

语法规范 ​

# 通道配置
Id: 1
PrivilegeLimit: 4
AccessSet: 1
PEFEnable: 1
AuthMethod: 0
UserAuthEnable: 0
AccessMode: 2
PrivilegeSet: 1
StandardPayloadSupport: 3
SessionPayloadSupport: 63
OEMPayloadSupport: 0
KGValue: ""

关联说明 ​

• Id: 唯一标识通道配置实例
• PrivilegeLimit: 通道的最大特权级别限制
• AccessSet: 通道访问控制设置
• PEFEnable: 平台事件过滤功能使能
• AuthMethod: 支持的认证方法
• UserAuthEnable: 用户认证使能
• AccessMode: 通道访问模式
• PrivilegeSet: 通道特权级别设置
• StandardPayloadSupport: 标准载荷支持
• SessionPayloadSupport: 会话载荷支持
• OEMPayloadSupport: OEM载荷支持
• KGValue: 密钥值

📂 分类标准 ​

硬件属性 ​

• 定义：当前版本无硬件属性
• 特点：所有属性都是软件管理相关
• 示例：无

软件属性 ​

• 定义：由软件管理和维护的通道配置参数
• 特点：通道管理、权限控制、载荷管理等
• 示例：所有属性都是软件属性

📝 配置示例 ​

标准通道配置 ​

{
  "ChannelConfig": {
    "Id": 1,
    "PrivilegeLimit": 4,
    "AccessSet": 1,
    "PEFEnable": 1,
    "AuthMethod": 0,
    "UserAuthEnable": 0,
    "AccessMode": 2,
    "PrivilegeSet": 1,
    "StandardPayloadSupport": 3,
    "SessionPayloadSupport": 63,
    "OEMPayloadSupport": 0,
    "KGValue": ""
  }
}

🔧 使用指南 ​

配置步骤 ​

1. 设置通道ID：配置Id属性
2. 设置权限级别：配置PrivilegeLimit和PrivilegeSet
3. 设置访问控制：配置AccessSet和AccessMode
4. 设置认证：配置AuthMethod和UserAuthEnable
5. 设置PEF：配置PEFEnable
6. 设置载荷：配置StandardPayloadSupport、SessionPayloadSupport和OEMPayloadSupport
7. 设置密钥：配置KGValue

特权级别说明 ​

说明：PrivilegeLimit 表示该通道允许的最大特权级别，用户会话的实际权限取“用户自身权限”和“通道 PrivilegeLimit”中的较小值。rmcpd 校验时不接受大于 4（Administrator）的值，配置 5（OEM）会被 Set Channel Access 命令拒绝并返回 SetNotSupportedOnSelectedChannel；0 为保留级，实际可用取值为 1 ~ 4。

访问模式（AccessMode）说明 ​

布尔/位域类属性说明 ​

说明：AccessSet、PrivilegeSet 在 IPMI 报文中均为 2 bit（SetChange/LevelChange），0 表示不改变、1 表示永久设置、2 表示临时设置、3 为保留；只有取值为 1 时 rmcpd 才会把配置持久化。PEFEnable、AuthMethod、UserAuthEnable 是位域中的单 bit，语义与 IPMI 规范一致。

载荷支持位图说明 ​

StandardPayloadSupport、SessionPayloadSupport、OEMPayloadSupport 均为按位表示的载荷支持位图：

因此 StandardPayloadSupport = 3 表示同时支持 IPMI 和 SOL；SessionPayloadSupport = 63 表示 bit0~bit5 全部支持。KGValue 为密钥加密密钥（KEK）字符串，空字符串表示未配置。

通道类型说明 ​

使用场景 ​

• 通道管理：配置IPMI通信通道
• 权限控制：设置通道访问权限
• 认证配置：配置通道认证方式
• 载荷管理：配置支持的载荷类型

注意事项 ​

• 通道唯一性：每个通道的Id必须唯一
• 权限一致性：PrivilegeLimit应大于等于PrivilegeSet
• 密钥安全：KGValue应妥善保管
• 载荷支持：确保载荷支持与系统功能匹配
• 认证方式：根据安全需求选择合适的认证方式

故障排除 ​

1. 通道访问失败：

   • 检查AccessMode和AccessSet配置
   • 确认用户权限是否足够 -验证通道状态

2. 认证失败：

   • 检查AuthMethod配置
   • 确认UserAuthEnable设置 -验证用户凭据

3. 载荷不支持：

   • 检查SessionPayloadSupport配置
   • 确认StandardPayloadSupport设置 -验证载荷类型