MH∕T 3032-2023 民航统一认证接口规范.pdf

ICS 35.240.60 CCS L 67 MH 中 华 人 民 共 和 国 民 用 航 空 行 业 标 准 MH/T 30322023 民航统一认证接口规范 Specification of civil aviation unified authentication interface 2023-07-21 发布 2023-08-01 实施 中国民用航空局 发 布 学兔兔 标准下载MH/T 30322023 I 目次 前言.II 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 缩略语.1 5 概述.1 统一认证平台（4A）接口.2 统一身份认证系统（2A）接口.2 6 统一认证平台（4A）对接要求.2 总体要求.2 接入流程.2 数据接口方式.3 接口服务说明.3 7 统一身份认证系统（2A）对接要求.9 总体要求.9 接入流程.9 实名核验服务.12 认证服务接口 SDK.18 用户中心 SDK.22 散列函数服务.24 附录 A（规范性）统一认证平台（4A）代码集.27 A.1 验证票据返回码.27 A.2 统一认证平台（4A）返回码.27 附录 B（规范性）统一身份认证系统（2A）代码集.29 B.1 统一身份认证系统（2A）返回码.29 B.2 统一身份认证系统（2A）实名核验等级.33 B.3 统一身份认证系统（2A）证件类型.34 B.4 统一身份认证系统（2A）自然人数据结构.34 B.5 统一身份认证系统（2A）企业法人数据结构.34 B.6 统一身份认证系统（2A）法人类型.35 B.7 统一身份认证系统（2A）法人账号信息.35 B.8 统一身份认证系统（2A）TOKEN 数据结构.36 B.9 统一身份认证系统（2A）身份识别码类型.36 B.10 统一身份认证系统（2A）AuthResult 类数据格式.37 学兔兔 标准下载MH/T 30322023 II 前言 本文件按照GB/T 1.12020标准化工作导则 第1部分：标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由中国民用航空局综合司提出。本文件由中国民航科学技术研究院归口。本文件起草单位：中国民用航空局信息中心。本文件主要起草人：孙立华、曾曦、朱伯宇、曹媛、汤琰、裴勇、刘建、李欣莹、邢伟、庞湃、马晓晨、闫帅。学兔兔 标准下载MH/T 30322023 1 民航统一认证接口规范 1 范围 本文件规定了中国民用航空局（以下简称“民航局”）各政务信息系统对接民航局信息中心统一认证平台（包括认证Authentication、授权Authorization、账号Accounting、审计Audit，简称4A）和面向社会公众（自然人或法人）的统一身份认证系统（包括认证Authentication、账号Accounting，简称2A）的接入模式、接入流程和接口定义。本文件适用于民航各政务信息系统之间，以及民航各政务信息系统与国家政务服务平台间统一认证的应用过程。2 规范性引用文件 本文件没有规范性引用文件。3 术语和定义 下列术语和定义适用于本文件。自然人 natural person 自然人是基于出生而取得民事主体资格的人，其外延包括本国公民、港澳台居民、外国公民和无国籍人等。法人 legal person 具有民事权利能力和民事行为能力，依法独立享有民事权利和承担民事义务的组织。信任传递 trust transitivity 实现用户、业务系统的强身份鉴别，跨域条件下的信任传递。本标准中特指在统一身份认证系统（2A）中，将某个政务系统的已登录身份传递到另一个系统完成登录的过程。单点登录 single sign on 当用户访问多个政务信息系统时，只需提交一次认证信息就可访问多个政务信息系统。令牌 token 认证子系统产生的，用于标识用户的登录身份信息。注：在统一身份认证体系中，用户登录会话与令牌相绑定。票据 ticket 基于随机数的一次性会话验证凭据，用于验证通讯请求的合法性。4 缩略语 下列缩略语适用于本文件。HTTP 超文本传输协议（Hyper Text Transfer Protocol）URL 统一资源定位器（Uniform Resource Locator）SDK 软件开发工具包（Software Development Kit）5 概述 学兔兔 标准下载MH/T 30322023 2 统一认证平台（4A）接口 统一认证平台（4A）接口面向民航局各政务信息系统的业务人员，采用认证、授权、账号、审计的“4A”管理，融合集中认证管理、集中权限管理、集中帐号管理、集中审计管理四要素，实现统一认证平台与民航局各政务信息系统间的单点登录。该接口适用于民航局统一认证平台门户网站单点登录到民航局各政务信息系统的使用场景。统一认证平台到民航局各政务信息系统的数据同步方向为正向，反之为逆向。民航局各政务信息系统采用票据的方式接入统一认证平台（4A），实现从统一认证门户跳转至民航局各政务信息系统、并有选择地实现机构和账号的正向和逆向数据同步。统一身份认证系统（2A）接口 统一身份认证系统（2A）接口面向社会公众，采用账号和认证的“2A”管理，实现社会公众登录民航局各政务信息系统办理相关服务事项。该接口基于国家政务服务平台标准建设，适用于民航局各政务信息系统与面向社会公众提供在线办理服务系统对接的场景，和民航局各政务信息系统与自然人、法人注册系统对接的场景，为民航局各政务信息系统对接以上系统提供用户管理、用户实名核验、用户数据汇聚、单点登录等能力。该接口支持自然人或企业法人通过统一身份认证系统登录到民航局各政务信息系统，并支持自然人或企业法人与国家政务服务平台身份信息互信互认。统一身份认证系统有统一模式和协同模式两种对接方式，民航局各政务信息系统对接时需选择其中一种对接模式。6 统一认证平台（4A）对接要求 总体要求 统一认证平台（4A）对接的总体要求如下：a)统一认证平台（4A）采用票据方式单点登录到民航局各政务信息系统；b)政务信息系统集成统一认证平台（4A）提供的 SDK 开发包；c)政务信息系统拦截统一认证平台（4A）到该系统的票据登录请求，解密票据字段定义为 pname；d)解密票据的方法：public static String com.linkage.util.EncodeUtil.decodeURL(String pname)；e)解密后的票据参数分项见表 1；f)政务信息系统将统一认证平台的 pname 解析完成后得到票据 ticket，并将该票据发送至统一认证平台票据服务进行验证。表1 解密后的票据信息 参数名称 类型和长度 必填 说明 描述 MAIN_ID String(64)是 当前登录统一认证平台的帐号 此帐号为统一认证平台的登录账号区别于政务信息系统的账号 op String(64)是 表示经统一认证平台单点登录 此参数可没有，根据应用实际情况设置 loginName String(64)是 登录政务信息系统的帐号 此帐号为政务信息系统的账号区别于登录统一认证平台的账号 ticket String(200)是 当前票据 政务信息系统需要将此票据发回单点登录服务器进行验证 接入流程 学兔兔 标准下载MH/T 30322023 3 6.2.1 流程图 统一认证平台（4A）接口接入流程见图1。统一认证门户统一认证门户浏览器浏览器应用系统应用系统票据中心+统一认证中心票据中心+统一认证中心a)登录统一认证门户b)返回成功登录e)页面链接民航局各政务信息系统，提交帐号和票据f)验证帐号和票据c)申请票据d)返回票据g)返回验证结果 图1 统一认证平台（4A）接口接入流程 6.2.2 流程说明 接入统一认证平台（4A）接口应符合如下流程。a)用户通过浏览器登录统一认证平台（4A）门户。b)统一认证平台（4A）门户向用户返回统一认证平台（4A）门户登录结果。c)如登录成功，统一认证平台（4A）门户向票据中心申请票据。d)票据中心向统一认证平台（4A）门户返回票据。e)统一认证平台（4A）门户使用政务信息系统的链接地址，并附带用户账号和票据登录到政务信息系统。访问地址示例如下：示例：http:/政务信息系统 URL/login.do?pname=c3RhZmZOYW1lPUFBNjAwMDAzJk1BSU5fSUQ9UzBfcWlhbmdlJnRpY2tldD0yYzExZDQyYy00NTA5LTAwMTYzNTd5STZ0NjRIVTVqcGlZbFk4dkQ1dFE9PQ%3D%3Dz%26%26%26cf4。f)政务信息系统收到票据后，对票据进行解密，并向票据中心验证票据真实性；同时，政务信息系统对收到的用户账号有效性进行验证。解密后的票据信息见表 1。g)票据中心向政务信息系统返回验证结果，如结果正确，则用户登录成功；如结果错误，则用户登录失败。验证票据的返回码应符合附录 A 中表 A.1 的规定。数据接口方式 民航局各政务信息系统与统一认证平台（4A）数据接口采用轻量级的rest api+JSON POST方式实现数据的传输。接口服务说明 6.4.1 政务信息系统验证票据服务 民航局各政务信息系统向票据中心验证用户登录请求时携带票据。具体接口调用方式如下：a)调用地址：http:/统一认证平台 URL/pname；b)接口参数说明见表 2；表2 验证票据参数说明 类别 参数 必填 数据类型 说明 入参 pracct 是 字符串 主账号 学兔兔 标准下载MH/T 30322023 4 表2 验证票据参数说明（续）类别 参数 必填 数据类型 说明 入参 slacct 是 字符串 从账号 ticket 是 字符串 票据，ticket由政务信息系统通过解密pname获得，解密方法在统一认证平台提供的SDK包里：public static String com.linkage.util.EncodeUtil.decodeURL(String pname)clientIp 是 字符串 登录资源地址：在统一认证平台（4A）管理台中配置的政务信息系统单点登录地址 clientPort 是 字符串 登录资源端口号：在统一认证平台（4A）管理台中配置的政务信息系统服务端口号 userIp 是 字符串 用户地址：在统一认证平台（4A）管理台中配置的政务信息系统服务器地址 出参 resultCode 是 字符串 结果代码，应符合附录A中表A.1的规定 resultMsg 是 字符串 结果提示信息 userName 是 字符串 登录系统帐号名 c)验证票据返回码应符合附录 A 中表 A.1 的规定。示例：pname 解密方法 decodeURL public static String decodeURL(String enCode)if(enCode!=null)String splitStr=enCode.split(z&);if(splitStr!=null&splitStr.length 1)try String encodeUrl=splitStr0;if(encodeUrl!=null&getMd5(encodeUrl).equals(splitStr1)return new String(BaseEncode.decode(encodeUrl),UTF-8);return;catch(UnsupportedEncodingException var3)LOGGER.error(var3.getMessage(),var3);return;return;6.4.2 统一认证平台（4A）到政务信息系统用户名密码登录认证服务 统一认证平台（4A）向政务信息系统发起用户名密码登录认证请求，该接口为统一认证平台（4A）到政务信息系统验证登录用户名密码的合法性提供验证服务。具体接口调用方式如下：a)调用地址：http:/政务信息系统 URL/doSSO；b)接口参数说明见表 3。学兔兔 标准下载MH/T 30322023 5 表3 统一认证平台（4A）到政务信息系统用户名密码登录认证参数说明 类别 参数 必填 数据类型 说明 入参 pracct 是 字符串 统一认证平台（4A）主帐号名称 slacct 是 字符串 政务信息系统从帐号名称 ticket 是 字符串 验证票据 clientIp 是 字符串 登录资源地址，该地址为统一认证平台（4A）管理台维护，作为政务信息系统白名单判断使用 clientPort 是 字符串 登录资源端口号，该地址为统一认证平台（4A）管理台维护，作为政务信息系统判断使用 userIp 是 字符串 用户地址，用户终端地址 出参 resultCode 是 字符串 结果代码，应符合附录A中表A.1的规定 resultMsg 是 字符串 返回信息 userName 是 字符串 登录政务信息系统帐号名 示例：调用方法 Client client=Client.getInstance(“文件路径”);CResult result=client.doSSO(pracct,slacct,ticket,clientIp,clientPort,userIp);if(result.getResultCode()=0)String username=result.getUsername();System.out.println(“用户”+username+result.getResultMsg();else if(result.getResultCode()=-1)System.out.println(result.getResultMsg();else System.out.println(“认证不通过！原因：”+result.getResultMsg();6.4.3 政务信息系统到统一认证平台用户名密码登录认证服务 政务信息系统向统一认证平台（4A）发起用户名密码登录认证请求，该接口为政务信息系统到统一认证平台（4A）验证登录用户名密码的合法性提供验证服务。具体接口调用方式如下：a)调用地址：http:/统一认证平台 URL/loginAuthenByPassWd；b)接口参数说明见表 4。表4 政务信息系统到统一认证平台（4A）用户名密码登录认证参数说明 类别 参数 必填 数据类型 说明 入参 clientIp 是 字符串 客户端IP，政务信息系统服务器IP，该IP为统一认证平台（4A）白名单配置项 学兔兔 标准下载MH/T 30322023 6 表4 政务信息系统到统一认证平台（4A）用户名密码登录认证参数说明（续）类别 参数 必填 数据类型 说明 入参 userIp 是 字符串 用户终端IP operatorName 是 字符串 政务信息系统登录帐号，与验证的用户名相同 appSysNum 是 字符串 政务信息系统编码，该编码由统一认证平台（4A）统一分配 userName 是 字符串 用户名 passWd 是 字符串 用户密码，加密方法在统一认证平台（4A）提供的SDK包里：com.linkage.fa.service.util.AESUtil.AES_Encrypt(String plainText)出参 errCode 是 字符串 返回码，应符合附录A中表A.2的规定 errDes 是 字符串 返回信息 示例：AES_Encrypt 加密方法 public static String AES_Encrypt(String plainText)return AES_Encrypt(asiainfoSecurity,plainText);public static String AES_Encrypt(String keyStr,String plainText)if(keyStr!=null&plainText!=null&!.equals(keyStr)&!.equals(plainText)StringBuffer _key=new StringBuffer();if(keyStr.length()16)for(int i=0;i 16)keyStr=keyStr.substring(0,16);byte encrypt=(byte)null;try Key key=generateKey(keyStr);Cipher cipher=Cipher.getInstance(AES/ECB/PKCS5Padding);cipher.init(1,key);encrypt=cipher.doFinal(plainText.getBytes();catch(Exception var6)学兔兔 标准下载MH/T 30322023 7 LOGGER.error(var6.getMessage(),var6);return new String(Base64.encodeBase64(encrypt);else return;6.4.4 政务信息系统获取短信验证码服务 政务信息系统向统一认证平台（4A）发起获取短信验证码请求。具体接口调用方式如下：a)调用地址：http:/统一认证平台 URL/sendShortMessage；b)接口参数说明见表 5；表5 政务信息系统获取短信验证码参数说明 类别 参数 必填 数据类型 说明 入参 clientIp 是 字符串 客户端IP，政务信息系统服务器IP，该IP为统一认证平台（4A）白名单配置项 userIp 是 字符串 用户IP，即用户终端的IP operatorName 是 字符串 政务信息系统登录帐号，与验证的用户名相同 appSysNum 是 字符串 政务信息系统编码，该编码由统一认证平台（4A）统一分配 telephone 是 字符串 手机号码 出参 errCode 是 字符串 返回码，应符合附录A中表A.2的规定 errDes 是 字符串 返回信息 c)该功能可通过发送 JSON 报文实现，无需调用统一认证平台（4A）SDK。示例：报文示例 输入报文：clientIp:客户端 IP（调用端服务器 IP）,operatorName:操作人帐号,userIp:用户 IP（用户机器 IP）,appSysNum:123,telephone:手机号 输出报文：errCode:错误代码,学兔兔 标准下载MH/T 30322023 8 errDes:错误描述 6.4.5 政务信息系统短信验证码登录认证服务 政务信息系统向统一认证平台（4A）发起逆向短信验证码登录请求，该服务为民航局各政务信息系统到统一认证平台（4A）验证短信验证码是否有效，政务信息系统根据返回的结果获得短信码的合法性。具体接口调用方式如下：a)调用地址：http:/统一认证平台 URL/loginAuthenBySMS；b)接口参数说明见表 6；表6 政务信息系统短信验证码登录认证参数说明 类别 参数 必填 数据类型 说明 入参 clientIp 是 字符串 客户端IP，政务信息系统服务器IP，该IP为统一认证平台（4A）白名单配置项 userIp 是 字符串 用户IP，即用户终端的IP operatorName 是 字符串 政务信息系统登录帐号，与验证的用户名相同 appSysNum 是 字符串 政务信息系统编码，该编码由统一认证平台（4A）统一分配 telephone 是 字符串 手机号码 verifyCode 是 字符串 验证码，该验证码为获取短信验证码接口中获取到的值 出参 errCode 是 字符串 返回码，应符合附录A中表A.2的规定 errDes 是 字符串 返回信息 c)该功能可通过发送 JSON 报文实现，无需调用统一认证平台（4A）SDK。示例：报文示例 输入报文：clientIp:客户端 IP（调用端服务器 IP）,operatorName:操作人帐号,userIp:用户 IP（用户机器 IP）,appSysNum:123,sessionUuid:会话 id,signedToken:token,telephone:手机号,verifyCode:短信验证码 输出报文：errCode:错误代码,errDes:错误描述 学兔兔 标准下载MH/T 30322023 9 7 统一身份认证系统（2A）对接要求 总体要求 7.1.1 统一模式要求 统一模式要求是以统一身份认证系统（2A）为中心的认证方式，民航局各政务信息系统需采用统一身份认证系统（2A）的数据模型、登录和注册界面。政务信息系统无存量用户且不维护用户身份信息，所有自然人、法人信息由统一身份认证系统（2A）统一存储和管理。总体要求如下：a)民航局各政务信息系统集成统一身份认证系统（2A）SDK，并对接信任传递流程（具体流程见7.2.1）；b)用户登录政务信息系统时，需在浏览器端跳转至统一身份认证系统（2A）登录界面，并在统一身份认证系统（2A）登录地址中附带 backUrl 参数，参数值为政务信息系统信任传递回调页面地址；c)用户通过统一身份认证系统（2A）的登录界面输入账号密码登录成功后，浏览器端自动跳转回政务信息系统 backUrl 的参数地址，同时附带 ticket（一次性票据）参数；d)政务信息系统接收 ticket（一次性票据）参数后，通过信任传递流程获取已登录的当前用户身份信息。7.1.2 协同模式要求 协同模式要求民航局各政务信息系统本身存在用户模型及存量用户，利用统一身份认证系统（2A）的实名核验能力和数据汇聚能力完成认证。各政务信息系统保留自己的数据模型、登录和注册方式，其中，数据模型应符合附录B中表B.4和表B.5的规定。总体要求如下：a)民航局各政务信息系统需集成统一身份认证系统（2A）SDK，按照隐性登录流程（具体流程见7.2.2）与统一身份认证系统（2A）同步用户身份信息；b)政务信息系统通过隐性登录接口向统一身份认证系统（2A）同步当前登录的用户信息，此时政务信息系统和统一身份认证系统（2A）均标记同一用户为已登录状态；c)政务信息系统向统一身份认证系统（2A）传递已登录的用户身份信息，已登录的用户身份信息由统一身份认证系统（2A）入库并统一管理。接入流程 7.2.1 信任传递流程 学兔兔 标准下载MH/T 30322023 10 图2 信任传递流程 信任传递流程见图2，流程说明如下。a)用户通过浏览器访问民航局各政务信息系统并使用登录功能。b)政务信息系统通过浏览器重定向到统一身份认证系统（2A）登录页面，同时 URL 中传入回调地址 backUrl。c)用户在统一身份认证系统（2A）登录页面输入账号、密码认证。d)统一身份认证系统（2A）经过业务处理后，重定向回政务信息系统，重定向地址为 backUrl 参数。同时统一身份认证系统（2A）下发一次性票据 ticket。e)政务信息系统根据一次性票据 ticket 调用统一身份认证系统（2A）获取令牌接口（getTokenWithTicket 接口）。f)统一身份认证系统（2A）经过逻辑处理后返回 token 令牌，政务信息系统接收返回值 token 令牌。g)政务信息系统根据 token 令牌调用统一身份认证系统（2A）获取用户信息接口 getNautralUser（自然人）、getCorpUser（法人），获得用户身份信息。h)统一身份认证系统（2A）经过业务处理后根据政务信息系统传入的 token 值，返回用户身份信息。i)政务信息系统根据获得的用户身份信息，在系统中标记业务系统账号已登录状态。j)用户成功登录政务信息系统。7.2.2 隐性登录流程 学兔兔 标准下载MH/T 30322023 11 图3 隐性登录流程 隐性登录流程见图 3，流程说明如下。a)用户通过浏览器访问民航局各政务信息系统并使用登录功能。b)用户在政务信息系统输入账号、密码认证。用户登录成功后，系统判断本地是否保存该用户的哈希值。c)政务信息系统如未保存用户的哈希值，则调用 getHash 散列方法生成用户的哈希值；如已保存用户的哈希值，则直接获取用户的哈希值。d)政务信息系统调用统一身份认证系统（2A）用户信息实时同步接口，将用户身份信息同步到统一身份认证系统（2A）。e)统一身份认证系统（2A）保存政务信息系统同步的用户信息。f)统一身份认证系统（2A）返回数据同步结果给政务信息系统。g)政务信息系统调用隐性登录接口（见 7.5），通知统一身份认证系统（2A）该用户已登录。h)统一身份认证系统（2A）内部实现用户隐性登录流程，该流程将用户在国家政务服务平台的登录状态置为已登录状态。i)统一身份认证系统（2A）返回用户令牌信息（token）至政务信息系统。j)政务信息系统保存该用户的哈希值。k)用户成功登录政务信息系统。7.2.3 登出流程 登出流程具体说明如下。a)用户登出政务信息系统时，政务信息系统调用统一身份认证系统（2A）平台登出接口（见 7.5.3），同时登出统一身份系统（2A）以及国家政务服务平台。b)用户登出国家政务服务平台时，同时登出统一身份认证系统（2A）以及所有政务信息系统。c)用户登出统一身份认证系统（2A）时，同时登出国家政务服务平台以及所有政务信息系统。学兔兔 标准下载MH/T 30322023 12 实名核验服务 7.3.1 社团法人实名核验服务 实现社团法人的社会组织名称、登记号、法定代表人的实名验证。具体接口调用方式如下：a)调用 SDK 方法：EnterpriseResult verifyAssociation(EnterpriseRequest request)；b)请求参数说明见表 7；c)返回值应符合附录 B 中表 B.1 的规定。表7 社团法人实名核验参数说明 类别 参数 必填 数据类型 说明 入参 userName 是 字符串 社会组织名称 uniscId 是 字符串 登记号 name 是 字符串 法定代表人姓名 出参 code 是 字符串 响应码，应符合附录B中表B.1的规定 msg 是 字符串 响应信息 示例：调用方法 package com.asiainfo.test;import com.alibaba.fastjson.JSON;import gov.zwfw.iam.client.TacsHttpClient;import gov.zwfw.iam.exception.TacsException;import gov.zwfw.iam.real.client.RealClient;import gov.zwfw.iam.real.request.NaturalRequest;import gov.zwfw.iam.real.response.RealResult;public class TestSimpleSt public static void main(String args)/读取配置文件 tacs.cer TacsHttpClient.init(证书路径，环境地址);EnterpriseRequest request=new EnterpriseRequest();request.setEntName(*);request.setUniscId(5082);request.setName(*);RealClient realClient=null;try realClient=TacsRealClient.getInstance();EnterpriseResult result=realClient.verifyAssociation(request);catch(TacsException e1)/TODO Auto-generated catch block e1.printStackTrace();7.3.2 企业法人实名核验接口 实现企业法人信息实名验证，传入企业名称、或统一社会信用代码等，返回企业照面信息(企业照面信息指企业营业执照上面的信息，是企业的主体信息，包括企业营业执照的统一社会信用代码、企业名称、企业经营地址、企业的注册资本、法定代表人、注册登记机关及日期等信息)比对结果。具体接口调用方式如下：a)调用 SDK 方法：EnterpriseResult verifyEnterpriseInfo(EnterpriseRequest request)；学兔兔 标准下载MH/T 30322023 13 b)接口参数说明见表 8；表8 企业法人实名核验参数说明 类别 参数 必填 数据类型 说明 入参 entName 是 字符串 主体名称 uniscId 是 字符串 统一社会信用代码 regno 否 字符串 注册号 enttypeCn 否 字符串 企业类型 regcap 否 字符串 注册资本 regcapcurCn 否 字符串 注册资本币种 estdate 否 字符串 成立日期 apprdate 否 字符串 核准日期 regstateCn 否 字符串 登记状态（中文）regorgCn 否 字符串 登记机关（中文）opfrom 否 字符串 经营期限自 opto 否 字符串 经营期限至 dom 否 字符串 住所 name 否 字符串 法定代表人 opscope 否 字符串 经营范围 出参 code 是 字符串 响应码，应符合附录B中表B.1的规定 msg 是 字符串 响应信息 c)接口返回值应符合附录 B 中表 B.1 的规定。示例：调用方法 import gov.zwfw.iam.client.TacsHttpClient;import gov.zwfw.iam.data.request.EnterpriseRequest;import gov.zwfw.iam.exception.TacsException;import gov.zwfw.iam.real.client.RealClient;import gov.zwfw.iam.real.client.TacsRealClient;import gov.zwfw.iam.real.response.EnterpriseResult;public class Demo public void main(String args)TacsHttpClient.init(证书路径,环境地址);EnterpriseRequest request=new EnterpriseRequest();request.setEntName(*);RealClient realClient=null;try realClient=TacsRealClient.getInstance();学兔兔 标准下载MH/T 30322023 14 EnterpriseResult result=realClient.verifyEnterpriseInfo(request);catch(TacsException e)e.printStackTrace();7.3.3 事业单位法人实名核验服务 实现事业单位法人的社会组织名称、登记号、法定代表人的实名验证，传入事业单位法人的社会组织名称、登记号、法定代表人返回该法人的实名验证信息。具体接口调用方式如下：a)调用 SDK 方法：EnterpriseResult verifyCause(EnterpriseRequest request)；b)接口参数说明见表 9；表9 事业单位法人实名核验参数说明 类别 参数 必填 数据类型 说明 入参 username 是 字符串 事业单位名称 uniscId 是 字符串 统一社会信用代码 name 否 字符串 法定代表人姓名 出参 code 是 字符串 响应码，应符合附录B中表B.1的规定 msg 是 字符串 响应信息 c)接口返回值应符合附录 B 中表 B.1 的规定。示例：调用方法 package com.asiainfo.test;import com.alibaba.fastjson.JSON;import gov.zwfw.iam.client.TacsHttpClient;import gov.zwfw.iam.exception.TacsException;import gov.zwfw.iam.real.client.RealClient;import gov.zwfw.iam.real.request.NaturalRequest;import gov.zwfw.iam.real.response.RealResult;public class TestSimpleSt public static void main(String args)/读取配置文件 tacs.cer TacsHttpClient.init(证书路径，环境地址);EnterpriseRequest request=new EnterpriseRequest();request.setEntName(*);request.setUniscId(5082);request.setName(*);RealClient realClient=null;try realClient=TacsRealClient.getInstance();EnterpriseResult result=realClient.verifyCause(request);catch(TacsException e1)e1.printStackTrace();7.3.4 个体工商户实名核验服务 学兔兔 标准下载MH/T 30322023 15 实现个体工商户法人的身份证号、姓名、工商注册号的实名验证。传入个体工商户法人的身份证号、姓名、工商注册号返回该法人的实名验证信息。具体调用方式如下：a)调用 SDK 方法：EnterpriseResult verifyIndividual(EnterpriseRequest request)；b)接口参数说明见表 10；表10 个体工商户实名核验参数说明 类别 参数 必填 数据类型 说明 入参 certNo 是 字符串 身份证号 name 是 字符串 姓名 uniscId 否 字符串 工商注册号 出参 code 是 字符串 响应码，应符合附录B中表B.1的规定 msg 是 字符串 响应信息 c)接口返回值应符合附录 B 中表 B.1 的规定。示例：调用方法 package com.asiainfo.test;import com.alibaba.fastjson.JSON;import gov.zwfw.iam.client.TacsHttpClient;import gov.zwfw.iam.exception.TacsException;import gov.zwfw.iam.real.client.RealClient;import gov.zwfw.iam.real.request.NaturalRequest;import gov.zwfw.iam.real.response.RealResult;public class TestSimpleSt public static void main(String args)/读取配置文件 tacs.cer TacsHttpClient.init(证书路径，环境地址);EnterpriseRequest request=new EnterpriseRequest();request.setCertNo(*);request.setUniscId(565456518919);request.setName(*);RealClient realClient=null;try realClient=TacsRealClient.getInstance();EnterpriseResult result=realClient.verifyIndividual(request);catch(TacsException e1)e1.printStackTrace();7.3.5 自然人初级实名