DB32∕T 4318.2-2022 电子政务外网 安全大数据和运维保障平台接入规范 第2部分：运维保障平台

1、ICS 35.020 CCS L72DB32江苏省地方标准DB 32/T 4318.22022 电子政务外网 安全大数据和运维保障平台接入规范2E-government networkAccess specification of secure big data and operation and maintenance support platformPart 2: Operation and maintenance support platform 2022-07-19发布2022-08-19实施江苏省市场监督管理局发布DB 32/T 4318.22022DB 32/T 4318.2202

2、2I I 目次 HYPERLINK l _bookmark0 前言II HYPERLINK l _bookmark1 1 1 HYPERLINK l _bookmark2 2 范引文件1 HYPERLINK l _bookmark3 3 语定义1 HYPERLINK l _bookmark4 4 略语1 HYPERLINK l _bookmark5 5 体求1 HYPERLINK l _bookmark6 对架构1 HYPERLINK l _bookmark7 对数据2 HYPERLINK l _bookmark8 数传架构2 HYPERLINK l _bookmark9 对模式3 HYPER

3、LINK l _bookmark10 6 接容要求3 HYPERLINK l _bookmark11 对范围3 HYPERLINK l _bookmark12 对技术4 HYPERLINK l _bookmark13 对开发4 HYPERLINK l _bookmark14 附录A（范） 数接口范6 HYPERLINK l _bookmark15 A.1 接功能6 HYPERLINK l _bookmark16 A.2 接说明10 HYPERLINK l _bookmark16 A.3 数 码19 DB 32/T 4318.22022DB 32/T 4318.22022II II 前言本文按G

4、B/T 化工作导则第1部分：化文件的结构和起草规则的规定草。DB32/T 4318电子政务外网 安全大数据和运维保障平台接入规范分为2个部分：第1部分：安全大数据平台；第2部分：运维保障。本部分为电子政务外网 安全大数据和运维保障平台接入要求的第2部分。 本文件起草单位：江苏省大数据管理中心。 DB 32/T 4318.22022DB 32/T 4318.220221 1 电子政务外网 安全大数据和运维保障平台接入规范第 2 部分：运维保障平台范围（ 本文件适用于指导各设区市电子政务外网管理单位对接省级运维平台。 本文件没有规范性引用文件。本文件没有需要界定的术语和定义。 缩略语下列缩略语适用

5、于本文件。 CI（ConfigurationItem）IAM身识与问理 (Identityand Access Management ) vCPU虚化央理器(virtualized CPU)1 DB 32/T 4318.22022DB 32/T 4318.220222 2 图1省市级台接体架图 表1接入点据接入节点数据（见附录A.3.2）拓扑关系数据（见附录A.1.2.4）资源类性能类告警类资源类型（参考A.1.2.1）（参考A.1.4）资源告警（参考A.3.3）子资源类型（参考A.3.1）端口性能指标（参考A.1.4）端口告警（参考A.3.3）DB 32/T 4318.22022DB 32/

6、T 4318.220223 3 报送数据从市级平台向省级平台传输，报送数据传输架构见图2。 图2运维据输构 3 使用相同数据结构的运维平台，无需额外接口开发，通过平台配置即可完成分级对接； 图3对接式图DB 32/T 4318.22022DB 32/T 4318.220224 4 省市两级平台对接应包括：路由器、交换机、防火墙等网络设备相关信息，以及vCPU、云硬盘、虚拟机等云平台相关信息。 各市级平台应按照省级平台定义的数据接口规范提供相应数据。 监控对象的资源、性能、告警、以及对象之间的拓扑关系。 市级平台按照省级平台的接口规范报送数据，应通过 HTTPS 协议加密数据。省级平台接口规范见

7、附录A的A.2。 数据频率应符合下列规定： 15 24 数据安全应符合下列规定： 市级平台对接省级平台的主要功能应包括数据报送功能和报送记录功能，具体要求应符合下列规定： 6.2 （6 DB 32/T 4318.22022DB 32/T 4318.220225 5 99%；响应速度：在发送或接收数据请求时，平台接口的数据报送和接收响应时间应最长不超过 3秒；100010 1 DB 32/T 4318.22022DB 32/T 4318.220226 6 附录A（） 省级平台提供接口类型见表A.1。表A.1口型序号接口名称数据内容功能1资源数据报送接口资源对象新增/修改一个或多个资源对象删除一个

8、或多个资源对象资源对象之间的关系新增一条或多条资源对象之间的关系删除一条或多条资源对象之间的关系2告警数据报送接口告警数据新增对象的告警数据3性能数据报送接口性能数据新增对象的性能数据资源类报送的类型见表A.2。表A.2源型名称资源类型说明报送的资源类型，如机房、网络设备数据字典值名称含义City地市Department单位Room机房NetworkDevice网络设备Port端口Cloud云资源对象的共有属性见表A.3。DB 32/T 4318.22022DB 32/T 4318.220227 7 表A.3源有性名称资源公有属性说明资源对象的公有属性，如：名称、类型、状态数据字典值名称含义N

9、ame资源对象名称Name_en别名(英文)Name_cn别名(中文)Type类型Subtype子类型（参考 A.3.1）资源对象的自定义属性见表A.4。表A.4源定属性名称资源自定义属性说明资源对象的自定义属性数据字典值资源类型属性名称含义City/城市department管理单位dept_addr单位地址contact_name联系人contact_information联系方式Room/机房access_node接入节点（参考 A.3.2）latitude地理纬度longitude地理经度NetworkDevice/网络设备access_node接入节点（参考 A.3.2）ip_addr

10、ess设备 IP 地址mac设备 MAC 地址asset_tag资产编号serial_no序列号company设备厂商model设备型号Port/端口access_node接入节点（参考 A.3.2）speed端口速率(bps)Cloud/云access_node接入节点（参考 A.3.2）level云层级（level=1 为最高级）site_name云管平台名称DB 32/T 4318.22022DB 32/T 4318.220228 8 资源对象之间的关系类型见表A.5。表A.5源系型名称关系类型说明资源对象之间的关系类型数据字典值前端业务模型后端业务模型关系类型对应形式RoomCityL

11、ocaten-1CloudCityManagen-1PortNetworkDeviceLocaten-1NetworkDeviceRoomLocaten-1PortPortLink1-1注1：对应形式：n-1：n个对象关联1个对象；1-1：1个对象关联1个对象。注2：关系类型：Locate：表示物理所属关系；Manage：表示逻辑管理关系；Link：表示链接关系。注3：前端后端：前端通常依赖于后端，比如NetworkDevice属于某个Room；每个端口名称应确保唯一性， 建议端口名+设备名标识。告警类应上报的信息见表A.6。表A.6警信息名称告警类信息说明应上报告警时间、告警对象、告警类型、

12、告警状态、告警级别等信息。报送告警数据时应加上告警类型编码，详见附录 A.3.3数据字典值类型含义告警级别告警事件的分级，参照 A.3.5告警状态告警事件的处置状态，参照 A.3.4告警类型告警类型描述，参照 A.3.3告警对象告警的对象信息告警时间告警发生的时间监管对象的性能指标见表A.7。表A.7能性指标名称性能类性能指标说明监管对象的性能指标名称数据字典值类型指标名称含义City/城市room_no机房总数rack_no机柜总数DB 32/T 4318.22022DB 32/T 4318.220229 9 networkdevice_no网络设备总数physicalserver_no服务

13、器总数storage_no存储设备总数表A.7能性指（续）数据字典值类型指标名称含义Room/机房rack_no机柜总数networkdevice_no网络设备总数physicalserver_no服务器总数storage_no存储设备总数NetworkDevice/网络设备cpu_usagecpu 使用率ne_ping_resp_time网络延迟memory_usage内存使用率Port/端口if_in_band_rate端口流入带宽利用率if_out_band_rate端口流出带宽利用率if_in_discard_rate端口接收包丢弃率if_in_discard_rate端口发送包丢弃率

14、if_hc_in_octets_speed当前端口入网速率if_hc_out_octets_speed当前端口出网速率if_in_pkt_speed端口接收包速率if_out_pkt_speed端口发送包速率if_in_discards端口丢弃接收包数if_out_discards端口丢弃发送包数if_in_errors端口接收错误包数if_out_errors端口发送错误包数Cloud/云total_cpu_coresCPU 总量（核）cpu_ratioCPU 分配率（%）cpu_allocated已分配 CPU 量（核）cpu_usageCPU 分配后的使用率（%）cpu_usedCPU

15、分配后的使用量（核）total_disk磁盘大小（TB）disk_ratio磁盘分配率（%）disk_allocated已分配磁盘空间（TB）disk_usage磁盘分配后的使用率（%）disk_used磁盘分配后的使用量（TB）total_memory内存总量（GB）memory_ratio内存分配率（%）memory_allocated已分配内存量（GB）memory_usage内存使用率（%）memory_used内存使用量（GB）DB 32/T 4318.22022DB 32/T 4318.2202210 10 vdc_no上云单位数量project_no上云应用数量ecs_no业务虚

16、机总数physicalhost_no宿主机总数 传输协议建议使用HTTP1.1（RFC2616）版本。HTTP 1.1 支持持久连接，在一个 TCP 连接上可以传送多个HTTP 请求和响应，减少了建立和关闭连接的消耗和延迟。以下所有URL 中的 ServerName 应根据省级平台的实际域名进行修改。直接调用时，header 中应包含的参数见表 A.8。表A.8header参数名称值描述Content-Typeapplication/json固定值iam_user用户名调用接口使用的用户名iam_tenant租户该用户所属租户iam_akvalue用户的 AK 认证值该用户的 AK 值，上级平

17、台提供skvalue用户的 SK 认证值该用户的 SK 值，上级平台提供iam_tokeniam_token调用接口时应带上 iam_token，获取方法参考 A.2.2.1x-csrf-tokencsrf 的 token 值调用接口时应带上 x-csrf-token，获取方法参考 A.2.2.2iam_token获取iam_token程序见表A.9。表A.9取iam_token程序URLhttps:/ServerName/iam-auth/rest/v2/token/iamtoken功能获取 iam_token，有效期 30 分钟，单次调用无影响HTTP 方法POST请求头Content-T

18、ype:application/json请求消息体akvalue:,skvalue:,tenant: ,user: 消息体参数说明参数名必须类型备注akvalue是String上级平台提供skvalue是String上级平台提供tenant是String租户名user是String用户名DB 32/T 4318.22022DB 32/T 4318.2202211 11 返回值success:,data: ,msg: 返回值说明参数名类型备注successBooleantrue 请求成功，false 请求失败dataStringiam_token值msgString请求返回信息csrf_toke

19、n获取csrf_token程序见表A.10。表A.10获取csrf_token程序URLhttps:/ServerName/iam/v2/org/getxtoken功能获取csrf token，一次有效HTTP 方法POST请求头Content-Type:application/jsoniam_user:/用户名请求消息体无消息体参数说明无返回值success: ,data: 返回值说明参数名类型备注successBooleantrue 请求成功，false 请求失败dataStringx-crsf-token值上报资源数据的接口格式见表A.11。表A.11报资对口格式URLhttps:/Se

20、rverName/eCMDB_Mgmt/rest/add-ci-relation-new功能上报资源数据，支持一次上报多条HTTP 方法POST请求头参考A.2.1请求消息体user: , data: ci: assignment: ,comments: ,contact_name: ,istatus: ,name: ,DB 32/T 4318.22022DB 32/T 4318.2202212 12 site_name: ,subtype: ,type: ,_tenant: , /一次请求建议上报100条表A.11报资对口格（）消息体参数说明参数名必须类型备注user是String用户名ci

21、否String要新增的对象信息，多个应使用assignment否String群组名（默认“Default”）comments否String备注contact_name否String联系人istatus是String状态name是String对象名称site_name是String站点名称，命名应保证唯一性，建议使用接入节点名称+自定义标识subtype是String对象子类型type是StringCI类型_tenant是String租户名返回值success: ,data: ,msg: 返回值说明参数名类型备注successBooleantrue 请求成功，false 请求失败dataJSON

22、Array请求结果详情msgString请求返回信息删除资源对象接口格式见表A.12。表A.12删资对口格式URLhttps:/ServerName/eCMDB_Mgmt/rest/data/delCI功能删除资源对象，可同时删除多个资源。在删除资源前可通过A.2.6接口获取资源的idHTTP 方法POST请求头参考A.2.1DB 32/T 4318.22022DB 32/T 4318.2202213 13 请求消息体id: ,type: , user: _tenant: ,u_cn: ,groupName:,assignment: 表A.12删资对口格（）消息体参数说明参数名必须类型备注id

23、是String要删除的资源对象 id，可传多个，通过 A.2.7 接口获取type是StringCi CI 时类型必须一致user是JSON用户信息：_tenant：租户名u_cn:用户名groupName：资源对象群组（默认“Default”）assignment否String校验用户在当前群组是否有删除权限（ 默认“Default”）返回值success: data: ,msg: 返回值说明参数名类型备注successBooleantrue 请求成功，false 请求失败dataJSONArray请求结果详情msgString请求返回信息上报资源与资源之间的关系数据接口格式见表A.13。表

24、A.13报关数口格式URLhttps:/ServerName/eCMDB_Mgmt/rest/add-ci-relation-new功能上报资源与资源之间的关系数据，支持同时上报多条关系HTTP 方法POST请求头参考A.2.1请求消息体user: , data: DB 32/T 4318.22022DB 32/T 4318.2202214 14 relations: e_name: ,e_subtype: ,e_type: ,s_name: ,s_subtype: ,s_type: ,_tenant: ,type: , /一次请求建议上报100条表A.13报关数口格（）消息体参数说明参数名必

25、须类型备注user是String用户名relations否String要新增的对象关系信息，多个应使用e_name是String下级对象名称e_subtype是String下级子类型e_type是String下级类型s_name是String上级对象名称s_subtype是String上级子类型s_type是String上级类型_tenant是String租户名type是String关系类型（参考A.1.2.4）返回值success: data: ,msg: 返回值说明参数名类型备注successBooleantrue 请求成功，false 请求失败dataJSONArray请求结果详情msg

26、String请求返回信息删除资源对象与其他资源对象之间的关系数据接口格式见表A.14。表A.14删关数口格式URLhttps:/ServerName/eCMDB_Mgmt/v1/relation/ci_id?user=user功能删除资源对象与其他资源对象之间的所有关系HTTP 方法DELETE请求头参考A.2.1路径参数参数名必须类型备注DB 32/T 4318.22022DB 32/T 4318.2202215 15 ci_id是String对象的ID，通过“根据类型查询资源对象”的结果中的id中获得user是String用户名，资源对象类型名称(支持多类型查询)请求消息体无消息体参数说明

27、无返回值success: data: ,msg: 返回值说明参数名类型备注successBooleantrue 请求成功，false 请求失败dataJSONArray删除关系列表msgString请求返回信息根据条件查询设备信息和id的接口格式见表A.15。表A.15根条查象接格式URLhttps:/ServerName/eCMDB_Mgmt/rest/data/getCIList/callback功能根据条件查询设备信息和idHTTP 方法POST请求头参考A.2.1search:type:,name: ,subtype: ,istatus: ,请求消息体contact_name: ,as

28、signment: 其它可检索字段(按类型不同检索字段不同),page:pageNo:,pageSize:消息体参数说明参数名必须类型备注search是JSON搜索条件type是String资源类型name是String资源名称subtype是String资源的子类型istatus是String状态contact_name否String联系人DB 32/T 4318.22022DB 32/T 4318.2202216 16 assignment是String群组名（默认“Default”）pageNo否String页码pageSize否String每页数量返回值success: ,data:

29、,msg: 返回值说明参数名类型备注successBooleantrue 请求成功，false 请求失败dataJSONArray请求返回内容msgString请求返回信息报送告警数据接口格式见表A.16。表A.16报告数口格式URLhttps:/ServerName/services/data_access/metricAlarmService/putAlarm功能全量告警接口，下级平台每次上报的告警为当前所有未处理告警，本接口根据下级平台相邻的两次报送告警进行比对，自动判断哪些告警已恢复HTTP 方法POST请求头参考A.2.1请求消息体metricName: ,namespace:,ti

30、mestamp:,value: , tags:key: monitorObject,value: ,key: ecureProxyServer,value: ,key: tenantName,value: ,key: metricData,value: ,key: units,value: ,key: alarmLevel,value: ,key: alarmDescription,value: ,key:alarmType,value:消息体参数说明参数名必须类型备注metricName是String告警所属指标名称namespace是String资源类型timestamp是String告警

31、发生时间，10位或13位时间戳value否String告警状态（参考A.3.4）tags是JsonArray告警字段信息monitorObject是String资源名称ecureProxyServer是String告警来源唯一标识，用于平台告警清DB 32/T 4318.22022DB 32/T 4318.2202217 17 除的最小单元，命名建议使用接入节点名称+自定义标识tenantName是String租户名metricData否String当前的告警值units否String告警值的单位alarmLevel是String告警级别（参考A.3.5）alarmDescription是St

32、ring告警描述alarmType是String告警类型（参考A.3.3）返回值returnCode: ,returnMsg: ,data: ,pageVO: 返回值说明参数名类型备注returnCodeString返回状态码，具体参考A.2.11returnMsgString返回消息dataString接口返回数据，推送成功无返回数据，为nullpageVOString分页信息清除告警数据接口格式见表A.17。表A.17清告数口格式URLhttps:/ServerName/services/data_access/metricAlarmService/putAlarm功能当网管无告警数据时，

33、应调用该接口将该来源告警数据清除HTTP 方法POST请求头参考A.2.1请求消息体 metricName:,namespace:, tags:key:monitorObject,value:,key:alarmLevel,value:, key:alarmDescription,value:,key:units,value:,key:metricData,value:,key:metricType,value:,key:ecureProxyServer,value:,key:clearAll,value:, timestamp:,value:消息体参数说明参数名必须类型备注metricNam

34、e是String告警所属指标名称，固定值：Fixed_Template_MetricNamenamespace是String资源类型,固定值Fixed_Template_Namespacetags是JsonArray告警字段信息monitorObject是String资源名称，固定值：Fixed_Template_MonitorObjectalarmLevel是String告警级别（参考A.3.5）DB 32/T 4318.22022DB 32/T 4318.2202218 18 alarmDescription是String告警描述，固定值：Fixed_Template_AlarmDescr

35、iptionunits否String告警值的单位：固定值：Fixed_Template_UnitsmetricData否String当前的告警值，固定值：Fixed_Template_MetricDatametricType否String指标分类：固定值：Fixed_Template_MetricTypesecureProxyServer是String指标来源唯一标识，用于平台告警清除的最小单元clearAll是String删除告警标记，固定值：ytimestamp是String告警发生时间，10位或13位时间戳value否String告警状态（参考A.3.4）返回值returnCode: ,

36、returnMsg: ,data: ,pageVO: 返回值说明参数名类型备注returnCodeString返回状态码，具体参考A.2.11returnMsgString返回消息dataString接口返回数据，推送成功无返回数据，为nullpageVOString分页信息报送性能数据接口格式见表A.18。表A.18报性数口格式URLhttps:/ServerName/services/data_access/metricDataService/putData功能上报性能数据，支持同时上报多条性能数据HTTP 方法POST请求头参考A.2.1metricName: ,tags: key: u

37、nits,value: ,key: monitorObject,value: ,key: namespace,value: ,请求消息体key: tenantName,value: ,key: ecureProxyServer,value: ,timestamp: ,value: ,/一次请求最多可以上传4000条指标数据消息体参数说明参数名必须类型备注metricName是String指标名称（参考A.1.4）DB 32/T 4318.22022DB 32/T 4318.2202219 19 tags是JsonArray指标所属对象的信息units否String指标单位（参考A.1.4）mo

38、nitorObject是String资源名称namespace是String资源类型tenantName是String租户名ecureProxyServer否String指标来源唯一标识，用于平台告警清除的最小单元timestamp是String发生时间value是String指标监控值返回值returnCode: ,returnMsg: ,data: ,pageVO: 返回值说明参数名类型备注returnCodeString返回状态码，具体参考A.2.11returnMsgString返回消息dataString接口返回数据，推送成功无返回数据，为nullpageVOString分页信息接口

39、返回码详解见表A.19。表A.19接返码解状态码错误返回message备注2000SUCCESS调用接口成功2001InternalFailure: The request processing has failed because of an unknown error, exception or failure.内部失败：请求处理失败,未知异常或失败2002InvalidParameterValue: An invalid or out-of-range value was supplied for the input parameter.无效的参数取值： 无效或超出范围值是提供的输入参数

40、2003InvalidParameterCombination: Parameters that must not be used together were used together.无效的参数组合：不能同时使用的参数一起使用2004MissingParameter: A required parameter for the specifiedaction is not supplied.参数缺失：此方法需要指定的参数2005MissingAuthenticationToken: The request must containeither a valid (registered) access key ID.缺少鉴权令牌2006InvalidClientTokenId:The access key ID provided does no