🐝
蜂巢OPENAPI
  • 蜂巢TNest
  • 产品介绍
    • 产品概述
    • 产品功能
    • 产品优势
    • 应用场景
  • 快速入门
    • 入门概述
    • 部署
    • 快速接入
    • 应用开发及编译
    • 应用部署
  • API
    • 接口规范
    • 终端数据查询
      • 系统基本信息上报
      • 系统运行数据上报
        • 采样频率、上报频率设置
        • CPU温度定时上报
        • CPU使用率定时上报
        • 内存使用率定时上报
        • 磁盘使用率定时上报
        • 4G模组信息定时上报
        • 有线网卡流量信息定时上报
      • 容器数据上报
      • 微应用数据上报
      • 进程数据上报
      • 服务数据上报
      • 网络端口数据上报
      • 终端在线状态
      • 链路跟踪
    • 终端告警
      • 告警规则下发
      • CPU使用率告警
      • 内存使用率告警
      • 磁盘使用率告警
      • CPU温度告警
      • 证书过期告警
      • 证书修改告警
      • 插入网线告警
      • 网线拔出告警
      • 网络链路时延告警
      • 网络链路中断告警
      • 网络链路丢包率告警
    • 运行诊断
      • 网络诊断
      • 工况诊断
      • 系统诊断
      • 进程诊断
    • 容器管理
      • 下载容器
      • 安装容器
      • 启动容器
      • 停止容器
      • 替换容器
      • 卸载容器
      • 克隆容器
    • 应用管理
      • 下载微应用
      • 安装微应用
      • 启动微应用
      • 停止微应用
      • 卸载微应用
      • 使能微应用
      • 去使能微应用
      • 微应用升级
    • 设备管理
      • 物理接口管理
        • 网口管理
      • 终端校时
      • 终端重启
      • 命令行
      • 网络访问黑名单
      • 网络访问白名单
      • 网络接口封堵
    • 连接管理
      • 网络访问黑名单
      • 网络访问白名单
    • 系统更新
      • 下载固件
      • 固件升级
      • 下载补丁包
      • 安装补丁包
      • 下载配置文件
      • 部署配置文件
    • 日志管理
      • 日志提取
      • 日志监控
        • 监控规则下发
        • 监控日志上报
        • 系统操作日志上报(审计日志)
  • 用户指南
    • 蜂巢部署
    • 安全接入
    • 可观测性
      • 系统基本信息上报
      • 运行数据监控
      • 终端告警
      • 运行诊断
    • 设备管理
      • 网络接口封堵
      • 终端校时
      • 终端重启
      • 命令行
    • 日志管理
      • 日志提取
      • 监控日志上报
      • 系统操作日志审计
    • 连接管理
      • 访问黑名单
      • 访问白名单
    • 容器管理
      • 容器下载
      • 容器安装/卸载
      • 容器启动/停止
      • 容器替换
      • 容器克隆
    • 应用管理
      • 应用下载
      • 应用安装/卸载
      • 应用使能/去使能
      • 应用启动/停止
      • 应用升级
    • 系统更新
      • 固件升级
      • 补丁包安装
      • 配置更新
  • 常见问题
    • 蜂巢部署相关问题
    • 设备注册相关问题
    • API调用相关问题
    • 应用编译相关问题
由 GitBook 提供支持
在本页
  • 功能描述
  • 1. 请求消息
  • 1.1 topic
  • 1.2 请求消息payload
  • 请求示例
  • 2. 应答消息
  • 2.1 Topic
  • 2.2  应答消息payload
  1. API
  2. 设备管理

网络访问黑名单

功能描述

现使用内置的 iptables 为基础:黑名单为拒绝(DROP),白名单为(ACCEPT)。

下发后会默认将 INPUT与OUTPUT 链的默认策略置为DROP,并且在其中增加自定义链用于白名单和黑名单和默认规则。其中,默认规则为将mqtt 地址和端口放开。

下发后会写入一条或者多条iptables 规则,根据iptables的版本可支持:对应的单个IP、多个IP、IP段,单个端口、多个端口、端口段。

1. 请求消息

1.1 topic

Topic
/v1/devices/{DeviceSn}/security/command

消息发送方

物联网平台

消息接收方

网关设备

1.2 请求消息payload

数据域
数据类型
是否必选
描述

mid

stirng

是

消息ID,推荐使用uuid, 请求和应答匹配,用来匹配请求和应答消息和去重

msgTime

string

是

消息发送时间戳,RFC3339标准,例如:1985-04-12T23:20:50.52Z

zone

string

否

设备部署的区域,例如ZONE3

node

string

否

设备部署的节点,例如440000

requestId

string

否

微服务链路追踪用的标识

deviceSn

string

是

设备ESN码,用于唯一标识设备

deviceId

string

否

统一物联网平台分配的设备id,据说可能会重复,不能唯一标识设备

service

string

是

服务名称。这里固定为:security

cmd

string

是

具体操作方法,这里固定为:setNetworkBlacklist

params

List<Params>

是

对象内容

params结构体说明

字段名
必选/可选
类型
参数描述

dstIp

可选

String

远程ip

dstPort

可选

String

远程端口,其余同 srcPort

srcIp

可选

String

本地ip

srcPort

可选

String

本地端口,可选择为:

"8080" 为单个网口

"1080:1090" 为网口段

protocol

可选

String

协议,默认为tcp

priority

必选

Uint16

规则优先级

请求示例

{
    "mid": 54132,
    "service": "security",
    "cmd": "setNetworkBlacklist",
    "params": [{
        "dstIp": "192.168.0.1",
        "dstPort": 1234,
        "srcIp": "192.168.1.1",
        "srcPort": 8080,
        "protocol": "tcp",
        "priority": 1
    }],
    "zone":"设备部署的区域",
    "node":"设备部署的节点",
    "deviceSn": "D23pigXo",
    "deviceId": "A1234456",
    "requestId":"xxxxxxxxxx",
    "msgTime": "1985-04-12T23:20:50.52Z "
}

2. 应答消息

2.1 Topic

Topic
/v1/devices/security/response

消息发送方

网关设备

消息接收方

物联网平台

2.2  应答消息payload

数据域
数据类型
是否必选
描述

mid

string

是

消息ID,用于消息去重。

replyId

string

是

表示响应的是哪条请求指令,为该指令的mid,用来匹配请求和应答

msgTime

string

是

消息发送时间戳,采用RFC3339标准,例如:1985-04-12T23:20:50.52Z。

zone

string

否

设备部署的区域,例如ZONE3

node

string

否

设备部署的节点,例如440000

requestId

string

否

微服务链路追踪用的标识

deviceSn

string

是

设备ESN码,用于唯一标识设备

deviceId

string

否

统一物联网平台分配的设备id,据说可能会重复,不能唯一标识设备

code

uint16

是

标识应答的返回码批处理请求时,如果所有处理都成功,返回200如果有部分失败,返回400。

取值如下:

•200:请求成功。

•400:请求消息错误,例如消息格式错误等。

•404:不支持该操作。

•429:请求太多。

•500:服务端内部错误,由应用定义。

body

JsonObject

否

(可选)对象内容。

上一页命令行下一页网络访问白名单

最后更新于1年前