替换 IP 白名单

POST/web/v1/system/security/ip-whitelist JWT

替换已认证用户安全配置中的整个 IP 白名单。此操作为原子替换——所有现有条目将被移除并替换为提供的列表。

鉴权

Auth Chain: WEB Chain — 需要 Authorization: Bearer <jwt> 以下请求头由系统自动注入（前端无需处理）： X-PORTAL-ACCESS-CODE (Nginx), X-Request-Id (Gateway)

请求参数

Name	Type	Required	In	Description
entries	String[]	Required	body	白名单 IP 地址或 CIDR 范围列表（不可为 null）

请求示例

{
  "entries": ["192.168.1.0/24", "10.0.0.1"]
}

成功响应

成功 200

{
  "version": "1.3.0",
  "timestamp": 1709337600000,
  "success": true,
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "enabled": true,
    "entries": [
      "192.168.1.0/24",
      "10.0.0.1"
    ]
  }
}

返回更新后的 IpWhitelistResponse——字段说明参见 获取 IP 白名单。

错误响应

未授权 401

{
  "success": false,
  "code": "4010",
  "message": "Invalid or expired token"
}

说明

• 以原子操作替换整个白名单。如需清除所有条目，传入空数组：{"entries": []}。
• 条目支持精确 IP 地址和 CIDR 表示法。
• 通过安全通道进行加密通信。
• 此接口不改变 enabled 状态——请使用 启用 / 禁用 端点。