获取 IP 白名单

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

获取已认证用户的 IP 白名单配置，包括是否启用强制执行以及白名单条目列表。

鉴权

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

请求参数

无需请求参数。

请求示例

无需请求体。

成功响应

成功 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"
    ]
  }
}

字段	类型	说明
enabled	boolean	IP 白名单强制执行是否激活
entries	string[]	白名单 IP 地址和/或 CIDR 范围列表

错误响应

未授权 401

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

说明

• 同时返回强制执行状态和白名单条目。
• 条目支持精确 IP 地址（如 "10.0.0.1"）和 CIDR 表示法（如 "192.168.1.0/24"）。
• 使用 启用 IP 白名单 / 禁用 IP 白名单 切换强制执行状态。
• 使用 替换 IP 白名单 更新条目。