水利电子证照 第1部分：基本技术要求（2025版）

SL/T816.1-2025IIISL/T816.1-2025水利电子证照第1部分：基本技术要求目 次1范围 12规范性引用文件 13术语和定义 14水利电子证照系统 15水利电子证照服务 15.1服务概述 15.2电子证照对接核验服务 25.3电子证照新办服务 25.4电子证照延续服务 35.5电子证照变更服务 35.6电子证照注销服务 45.7电子证照下载服务 46电子印章对接 47网络要求 58安全防护技术要求 58.1授权认证 58.2数据安全管理 58.3安全审计与监控 58.4安全等级保护要求 59模板管理要求 59.1水利电子证照基本要素 59.2OFD电子模板管理要求 6附录A（资料性）电子证照服务对接示例 7附录B（资料性）电子证照特殊说明 16附录C（资料性）签名算法代码参考（JAVA） 17SL/T816.1-20251水利电子证照第1部分：基本技术要求1范围本标准规定了水利电子证照系统、水利电子证照服务、电子印章对接、网络要求、安全防护技术要求和模板管理要求。本标准适用于水利部（含部本级和流域管理机构）及省级水行政主管部门建设、维护和使用水利电子证照系统，发放和应用水利电子证照。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本标准必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本标准；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本标准。GB/T7408数据元和交换格式信息交换日期和时间表示法GB/T33190电子文件存储与交换格式版式文档GB/T33481党政机关电子印章应用规范GB/T36901电子证照总体技术架构GB/T36902电子证照目录信息规范GB/T36903电子证照元数据规范GB/T36904电子证照标识规范GB/T36905电子证照文件技术要求GB/T36906电子证照共享服务接口规范GB/T38540信息安全技术安全电子签章密码技术规范3术语和定义下列术语和定义适用于本标准。3.1水利电子证照electroniclicensesinwateradministration由各级水行政主管部门依据国家有关法律法规和标准规范，统一制作、核发的电子数据文件。4水利电子证照系统水利电子证照系统是水利部政务服务平台的支撑系统，实现了涉水政务服务事项的水利电子证照制发，通过接口对接形式，与全国一体化政务服务平台和国家电子证照系统对接，为水利部（含部本级和流域管理机构）和省级水行政主管部门提供对接核验、证照新办、证照延续、证照变更、证照注销、证照下载等服务，生成的涉水电子证照数据存储于全国水利电子证照库，水利电子证照系统架构图见图1。5水利电子证照服务5.1服务概述水利部（含部本级和流域管理机构）和省级政务服务平台应与水利电子证照系统进行对接，实现电子证照系统对接核验、证照新办、证照延续、证照变更、证照注销、证照下载等服务（见表1)，SL/T816.1-20252电子证照服务对接示例见附录A，返回状态码和问题描述见附录B，签名算法代码见附录C。图1水利电子证照系统架构图表1电子证照共享服务列表序号服务服务提供方服务使用方1电子证照对接核验服务水利电子证照系统审批系统2电子证照新办服务3电子证照延续服务4电子证照变更服务5电子证照注销服务6电子证照下载服务5.2电子证照对接核验服务电子证照对接核验服务用于获取token令牌，如果token过期应重新申请，电子证照对接核验服务参数见表2。表2电子证照对接核验服务参数参数类型参数名类型说明是否必填输人参数datajson系统对接核验密钥信息：appKey、appSecret是输出参数successbool状态true为token获取成功，状态false为token获取失败否dataobjecttoken宇符串msgstring提示信息statusint状态码timestampslong时间戳5.3电子证照新办服务电子证照新办服务用于首次生成电子证照，电子证照新办服务参数见表3。SL/T816.1-20253表3电子证照新办服务参数参数类型参数名类型说明是否必填输入参数datajson新办证照属性字段（证照名称、编号、发证机关、发证日期、单位名称或个人姓名、统一社会信用代码或身份证件号码、有效期限等字段）是输出参数successbool状态true为新办服务调用成功，状态false为新办服务调用失败否dataobject服务返回信息msgstring提示信息statusint状态码timestampslong时间戳5.4电子证照延续服务电子证照延续服务参数见表4。表4电子证照延续服务参数参数类型参数名类型说明是否必填输入参数datajson延续证照属性字段（证照名称、编号、发证机关、发证日期、单位名称或个人姓名、统一社会信用代码或身份证件号码、有效期限等字段）是输出参数successbool状态true为延续服务调用成功。状态false为延续服务调用失败否dataobject服务返回信息msgstring提示信息statusint状态码timestampslong时间戳5.5电子证照变更服务电子证照变更服务参数见表5。表5电子证照变更服务参数参数类型参数名类型说明是否必填输人参数datajson变更证照属性字段（证照名称、编号、发证机关、发证日期、单位名称或个人姓名、统一社会信用代码或身份证件号码、有效期限等字段）是SL/T816.1-20254表5电子证照变更服务参数（续）参数类型参数名类型说明是否必填输出参数successbool状态true为变更服务调用成功，状态false为变更服务调用失败否dataobject服务返回信息msgstring提示信息statusint状态码timestampslong时间戳5.6电子证照注销服务电子证照注销服务参数见表6。表6电子证照注销服务参数参数类型参数名类型说明是否必填输入参数datajson注销证照属性字段（证照唯一ID）是输出参数successbool状态true为注销服务调用成功。状态false为注销服务调用失败否dataobject服务返回信息msgstring提示信息statusint状态码timestampslong时间戳5.7电子证照下载服务电子证照下载服务参数见表7。表7电子证照下载服务参数参数类型参数名类型说明是否必填输入参数appTokenstring取登录服务返回值是appKeystring系统key是idstring文件ID，新办、延续、变更返回值中的id是输出参数fileDatafileOFD文件否6电子印章对接水利部（含部本级和流域管理机构）和省级水行政主管部门应使用本级政务服务平台电子印章系统，遵照本级电子印章管理办法使用电子印章，不具备使用条件的应按照GB/T33481、GB/T38540及全国一体化政务服务平台电子印章技术要求完成电子印章系统建设，实现与国家政务服务平台电子印章系统对接，同时应对本级政务服务平台电子印章系统进行兼容性测试，建立应急处理机制，确保系统稳定运行。提供电子印章CA支撑的机构应纳入国家密码管理局发布的《电子政务电子认证服务SL/T816.1--20255机构目录》，电子印章应在国家政务服务平台完成备案，在本级范围内提供电子印章申请、制作、备案、变更、注销等服务，实现数据互通共享。电子印章系统对接应满足下列要求：a）支持对OFD文件签章。b）电子证照元数据等信息在签章时不应被篡改。c）签章方式支持UKEY签章或云签章，UKEY签章应提供签章集成页面，云签章应提供签章服务。d）部署在国家电子政务外网，支持与水利电子证照系统双向访问。7网络要求应与国家电子政务外网互联互通，网络数据传输、接入控制等应遵照国家电子政务外网建设要求执行。8安全防护技术要求8.1授权认证与水利电子证照系统对接的系统，应通过对接核验服务获取授权后实现对接。8.2数据安全管理水利电子证照系统及与其对接的系统，应对电子证照数据信息建立可靠的存储、备份、恢复等机制，采用数据分类分级、加密等措施，对服务传输及存储过程中个人信息和重要数据进行安全防护，防止数据丢失或损坏，确保数据的安全性、完整性、保密性。8.3安全审计与监控水利电子证照系统及与其对接的系统，应建立安全审计机制，记录服务的访问日志和操作记录，以便进行安全审计和追溯，并对服务运行状态实时监控，及时发现、处理安全隐患。8.4安全等级保护要求水利电子证照系统及与其对接的系统，应具备完善的网络安全防护措施，符合计算机信息系统安全等级保护三级要求。9模板管理要求9.1水利电子证照基本要素水利电子证照包含但不限于下列基本要素信息：a）证照名称：依据国家或行业相关规定而确定的证照命名，宜与所属证照类型的类型名称相同。b）证照编码：电子证照唯一编号，应显示在照面上，取值应由发证机关级别代码、项目所在行政区划代码、发证年度号、首次发证年份、顺序号等组成。c）发证机关：颁发并管理水利电子证照的水行政主管部门，数据类型及格式为字符串，长度不大于100个字符。d）持证主体：持证主体为法人或其他组织的，单位名称应与注册登记的信息一致，持证主体为公民的，公民姓名应与有效身份证件的信息一致。e）所在地（行政区划）：取证工程（单位或个人）所在行政区划。f）地理信息：有地理位置的证照（如取水工程的地理位置），应包括坐标系、经纬度坐标或经纬SL/T816.1-20256度坐标范围，值域为2000国家大地坐标系、1985国家高程基准。g）证照有效期起始日期：数据类型为日期，格式为yyyy（年）mm（月）dd（日），按公元纪年精确至日；采用阿拉伯数字，将年、月、日标全，月、日不标虚位，应符合GB/T7408的要求。h）证照有效期终止日期：数据类型为日期，格式为yyyy（年）mm（月）dd（日），按公元纪年精确至日；采用阿拉伯数字，将年、月、日标全，月、日不标虚位，应符合GB/T7408的要求。9.2OFD电子模板管理要求水利部（含部本级和流域管理机构）及地方水行政主管部门批准的水利电子证照应使用水利部统一监制的OFD电子模板生成电子证照，OFD电子模板由水利电子证照系统的发证服务统一提供。水利电子证照许可登记的信息全部确定后，由申请制证部门的制证系统向部本级发证服务推送数据制证申请，经形式核验通过后实时生成包含电子证照编号的OFD电子模板。各申请制证部门取得证照模板后，将水利电子证照信息填充到模板中形成证照版式文件，同时加盖发证单位审批专用章。SL/T816.1-20257附录A（资料性）电子证照服务对接示例A.1服务使用说明A.1.1返回值统一格式返回值统一格式见表A.1。表A.1返回值统一格式参数名类型说明successbool状态true或falsedataobject{〕msgstring提示信息statusint状态码timestampslong时间戳A.1.2请求参数对于POST请求且contentType=application/json;charset=UTF-8的服务，系统通过使用ap-pKey/appSecret对称加密的方式来验证某个请求的发送者身份。appKey用于标识调用者身份（每个发证机关对应不同的appKey),appSecret是调用者用于加密请求BODY和电子证照系统用来验证签名字符串的密钥，其中appSecret必须保密。当项目需要向电子证照系统发送请求时，应以请求的byte流作为签名字符串，使用appSecret进行加密产生签名结果，并将请求byte流设置到HTTP-BODY中。A.1.3返回参数系统对返回值中的data对象进行整体加密处理，用appSecret作为密钥来解密后使用。A.1.4加密说明签名算法：国密SM4算法。密钥：项目的appSecret。签名方式：整体签名方式，对请求的HTTP-BODY进行整体签名。编码方式：UTF-8。适用服务类型：附录A中所有的服务。A.2对接核验服务A.2.1简要说明与水利电子证照系统对接的系统应先通过电子证照对接核验服务，获取token令牌。A.2.2请求URL/sys/token/signupSL/T816.1-20258A.2.3请求方式POSTcontentType:application/json;charssecA.2.4头部参数对接核验服务头部参数格式见表A.2。表A.2对接核验服务头部参数格式参数名类型说明是否必填appKeystring分配的appKey是A.2.5请求体对接核验服务请求体格式见表A.3。表A.3对接核验服务请求体格式参数名类型说明是否必填appKeystring注册时应用的key是appSecretstring密钥是A.2.6返回值对接核验服务返回值格式见表A.4。表A.4对接核验服务返回值格式参数名类型说明successbool状态true或falsedataobject(“token”:“"}msgstring提示信息statusint状态码timestampslong时间戳A.3新办服务A.3.1简要说明发证时调用此方法。A.3.2请求URL／jsec/interface/v25/newEC仅生成文件（前端UKEY盖章时调用）／jsec/interface/v25/newECSeal生成文件并调用签章系统盖章，未对接签章系统应先调用／jsec/interface/v25/newEC否则会报错SL/T816.1-20259A.3.3请求方式POSTcontentType:'application/json;charsSset=UTF-A.3.4头部参数新办服务头部参数格式见表A.5。表A.5新办服务头部参数格式参数名类型说明是否必填appTokenstring取登录服务返回值是appKeystring系统key是A.3.5请求体新办服务请求体格式见表A.6。表A.6新办服务请求体格式参数名类型说明datajson发证机关代码、办理机关名称、办理机关统一社会信用代码、代码类别、单位名称或个人姓名、住所（住址）注册地址、邮编、法定代表人、联系人、行业类别代码、用水管理部门、取水地址、取水地址行政编码、取水工程名称、水源类型代码等A.3.6返回值新办服务返回值格式见表A.7。表A.7新办服务返回值格式参数名类型说明successbool状态true或falsedataobject1“file”：“文件名”，”id”：“文件id"，“type”：“文件类型”，“fileExt”：“文件扩展名”，“certId”：“电子证照唯一标识”，“certNum”：“证照编号”，＂message”：＂提示信息”，“url”：“参数申”，＂engCodeInfoList”：[{/／取水工程信息“engld”：“取水工程ID，与提交的ID一致”，“engCode”：“系统生成的取水工程编码”}]}msgstring提示信息statusint状态码timestampslong时间截SL/T816.1-202510certId”:"005.2.1115555000001332XW002.11321123002624095J.20210015.100.0”,certId”:"005.2.1115555000001332XW002.11321123002624095J.20210015.100.0”,A.3.7返回示例示例：新办服务返回值json文件内容。イ"status”:200,"da"file":"1","id”:"a101ff12345640b7ad7f91ba0laaaaaa","type":"1","fileExt":"ofd",、"certNum”:"A110000S2019-0001”,＂message”：“生成ofd文件成功”，"url”:“type=1&.fileExt=pdf&-id=a101ffd5000000b7ad7f91ba01123456”,“engCodelnfoList”:[{“engld”:“abef56175515-47c987faeada5e123456”,“engCode”:“A199900S2021-0001-001”}]},＂msg"：”操作成功”，"success”:true,"timestamps";1566777574102}A.4变更服务A.4.1简要说明变更时调用此方法。A.4.2请求URL／jsec/interface/v25/changeEC仅生成文件（前端UKEY盖章）／jsec/interface/v25/changeECSeal生成文件并调用签章系统盖章（未对接签章系统调用此接口会报错，可先调用第一个接口）A.4.3请求方式POSTcontentType:'application/json;chars=et=UTF-A.4.4头部参数变更服务头部参数格式见表A.8。表A.8变更服务头部参数格式参数名类型说明是否必填appTokenstring取登录服务返回值是appKeystring系统key是SL/T816.1-202511A.4.5请求体变更服务请求体格式见表A.9。表A.9变更服务请求体格式参数名类型说明datajson原证照编码、取水权人名称、证明材料、发证机关代码、办理机关名称、办理机关统一社会信用代码、代码类别、单位名称或个人姓名、住所（住址）注册地址、邮编、法定代表人、联系人、行业类别代码、用水管理部门、取水地址、取水地址行政编码、取水工程名称、水源类型代码等A.4.6返回值变更服务返回值格式见表A.10。表A.10变更服务返回值格式参数名类型说明successbool状态true或falsedataobjectく“file”：“文件名”，“id”：“文件id”，＂type”；“文件类型”，＂fileExt”：“文件扩展名”，＂certld”：“电子证照唯一标识”.“certNum”：“证照编号”，＂message”；“提示信息”，“url”：“参数串”>msgstring提示信息statusint状态码timestampslong时间戳A.4.7返回示例变更服务返回示例同新办服务返回示例。A.5延续服务A.5.1简要说明延续时调用此方法。A.5.2请求URL／jsec/interface/v25/continueEC仅生成文件（前端UKEY盖章）／jsec/interface/v25/continueECSeal生成文件并调用签章系统盖章（未对接签章系统调用此接口会报错，可先调用第一个接口）SL/T816.1-202512A.5.3请求方式POSTcontentType:'application/json;charssecA.5.4头部参数延续服务头部参数格式见表A.11。表A.11延续服务头部参数格式参数名类型说明是否必填appTokenstring取登录服务返回值是appKeystring系统key是A.5.5请求体延续服务请求体格式见表A.12。表A.12延续服务请求体格式参数名类型说明datajson原证照编码、主要生产用水技术等变化情况、取水源等变化情况、证明文件、发证机关代码、办理机关名称、办理机关统一社会信用代码、代码类别、单位名称或个人姓名、住所（住址）注册地址、邮编、法定代表人、联系人、行业类别代码、用水管理部门、取水地址、取水地址行政编码、取水工程名称、水源类型代码等A.5.6返回值延续服务返回值格式见表A.13。表A.13延续服务返回值格式参数名类型说明successbool状态true或falsedataobject{“file”：“文件名”，“id”：“文件id”，“type”：“文件类型”，“fileExt”：“文件扩展名”，＂certId”：“电子证照唯一标识”，＂certNum”：＂证照编号”，＂message”：“提示信息”，＂url"：“参数申”msgstring提示信息statusint状态码timestampslong时间戳SL/T816.1-202513A.5.7返回示例延续服务返回示例同新办服务返回示例。A.6注销服务A.6.1简要说明需要注销证照时调用此方法。A.6.2请求URL/jsec/interface/v25/rmECA.6.3请求方式POSTcontentType:'application/json;char:A.6.4头部参数注销服务头部参数格式见表A.14。表A.14注销服务头部参数格式参数名类型说明是否必填appTokenstring取登录服务返回值是appKeystring系统key是A.6.5请求体注销服务请求体格式见表A.15表A.15注销服务请求体格式参数名类型说明是否必填certNumstring证照编码是reasonstring注销原因否A.6.6返回值注销服务返回值格式见表A.16。表A.16注销服务返回值格式参数名类型说明succcssbool状态true或falsedataobjectmsgstring提示信息statusint状态码timestampslong时间戳SL/T816.1-202514A.6.7返回示例示例：注销服务返回值json文件内容。("status":200,"data":{},＂msg"：“操作成功”，''"timestamps":1566444574102ーA.7下载服务A.7.1简要说明新办、延续、变更服务调用成功后，可调用下载证照文件方法，下载未盖章或已盖章（如果已经盖章成功）的文件。A.7.2请求URL/jsec/interface/v25/getBase64A.7.3请求方式POSTcontentType:'application/json;charset=UTF-A.7.4头部参数下载服务头部参数格式见表A.17。表A.17下载服务头部参数格式参数名类型说明是否必填appTokenstring取登录服务返回值是appKeystring系统key是A.7.5请求参数下载服务请求参数格式见表A.18。表A.18下载服务请求参数格式参数名类型说明是否必填idstring文件ID，新办、延续、变更返回值中的id是A.7.6返回示例示例：下载服务返回值json文件内容。SL/T816.1-202515ー"status":200,"data":fileData:”。0＂msg"：“操作成功”，"Suc"timestamps":1566444574102A.8获取UKEY签章页面A.8.1简要说明此服务供需要前端UKEY盖章方式调用（各地方案不同，没有对接签章无法调取）。A.8.2请求URL/jsec/zj/interface/sealPageA.8.3请求方式GETA.8.4请求参数请求参数格式见表A.19。表A.19请求参数格式参数名类型说明是否必填idstring取生成证照服务返回id值是typestring取生成证照服务返回type值是appTokenstring取登录服务返回值是appKeystring系统key是callBackUrlstring回调地址，仅限get类型的http服务，签章上传成功后会异步调用这个参数的地址（回调需要水利部先申请访问地方服务器权限）否A.8.5返回值直接跳转盖章页面。SL/T816.1-202516附录B（资料性）电子证照特殊说明B.1返回状态码表证照系统常见的返回值状态码及含义见表B.1，可结合状态字段判断请求结果。表B.1证照系统常见的返回值状态码及含义表状态码状态类型说明200true成功请求成功500false服务器异常服务器内部错误50001false业务参数不正确参数业务校验不通过，详细信息查看msg40001false参数不正确参数合法性有误，详细信息查看msg20202false缺少必要参数20201false参数类型不匹配20203false请求路径不存在请求url错误20204false服务器运行时异常20200false未指定的错误类型详细信息查看msg100001false业务逻辑错误详细信息查看msgB.2问题描述系统对接过程中常见问题见表B.2。表B.2系统对接过程中常见问题返回消息可能原因此持证人有未到期的证书此人名下已有有效的证书用户没有此发证机关权限发证机关代码与使用的appkey不对应没有找到此发证机关信息此发证机关信息没有注册或已失效没有找到此证照或此证照状态不正确没有找到原证件数据要操作的证照未盖章或者不存在SL/T816.1-202517附录C（资料性）签名算法代码参考（JAVA）示例：签名算法JAVA参考代码。importcn.hutool.crypto.SmUtil;importcn.hutool.crypto.symm