居民健康卡应用接口技术规范XXXX-12-0117841.docx
《居民健康卡应用接口技术规范XXXX-12-0117841.docx》由会员分享,可在线阅读,更多相关《居民健康卡应用接口技术规范XXXX-12-0117841.docx(99页珍藏版)》请在淘文阁 - 分享文档赚钱的网站上搜索。
1、居民健康康卡应用接口口技术规范范北京冠新新医卫软软件科技技有限公公司20155年12月目录目录2前言41适用范范围52规范性性引用文文件53术语和和定义553.1居居民健康康卡 Ressideentss Heealtth CCardd53.2CCPU卡卡53.3卡卡片操作作系统(COS) Card Operating System53.4加加密算法法 CCrypptoggrapphicc Allgorrithhm53.5对对称加密密算法 Syymmeetriic CCrypptoggrapphicc Allgorrithhm63.6非非对称加加密算法法 AAsymmmettricc Crryp
2、ttogrraphhic Alggoriithmm63.7密密钥 Keyy63.8对对称密钥钥 SSymmmetrric Keyy63.9非非对称密密钥 Asyymmeetriic KKey663.100公钥 Pubblicc Keey63.111私钥 Priivatte KKey663.122数字签签名 Diggitaal SSignnatuure663.133SM22算法73.144SM33算法74缩略语语85应用模模型96接口函函数1006.1设设备管理理126.2用用户卡读读写1336.3卡卡算法服服务2776.4错错误码定定义299附录A VC程程序用例例301设备管管理3112用户
3、卡卡读写3323卡算法法服务553附录B555前言本规范涉涉及的数数据项定定义、命命令数据据符合卫卫生部定定义的居居民健康康卡系列列规范。本规范涉涉及的密密码算法法按照国国家密码码管理部部门的要要求使用用。本规范依依据居居民健康康卡技术术规范,居民健康卡应用规范,居民健康卡安全存取模块(SAM)卡规范,居民健康卡安全存取模块(SAM)卡命令集,居民健康卡用户卡命令集,结合医疗服务和用户管理业务流程,描述定义居民健康卡中数据存取访问接口。1 适用范围围本文确定定居民健健康卡中中数据存存取的应应用编程程接口。基于符合规范的设备如(读写机具、SAM卡、用户卡)以及居民健康卡应用规范的用户卡中的定义的
4、特定数据项,依据居民健康卡在医疗业务,用户管理等流程中的应用,描述定义所需接口函数、参数数据类型、以及接口的调用方式。2 规范性引引用文件件下列文件件中的条条款通过过本规范范的引用用而成为为本规范范的条款款居民健健康卡技技术规范范居民健健康卡应应用规范范居民健健康卡安安全存取取模块(SAMM)卡规规范居民健健康卡安安全存取取模块(SAMM)卡命命令集居民健健康卡用用户卡命命令集以下术语语和定义义适用于于本规范范。3 术语和定定义3.1 居民健康康卡 Ressideentss Heealtth CCardd居民健康康卡是中中华人民民共和国国居民拥拥有的,在在医疗卫卫生服务务活动中中用于身身份识别
5、别,满足足健康信信息存储储,实现现跨地区区和跨机机构就医医、数据据交换和和费用结结算的基基础载体体,是计计算机可可识别的的CPUU卡。3.2 CPU卡卡带有中央央处理器器(CPPU)、存存储单元元以及卡卡片操作作系统的的集成电电路卡。3.3 卡片操作作系统(COS) Card Operating SystemCPU卡卡芯片中中存储和和运行的的,以保保护应用用数据和和程序的的机密性性和完整整性,控控制CPPU卡芯芯片与外外界信息息交换为为目的的的嵌入式式软件。3.4 加密算法法 CCrypptoggrapphicc Allgorrithhm为了隐藏藏或显现现数据信信息内容容的变换换算法。3.5
6、对称加密密算法 Syymmeetriic CCrypptoggrapphicc Allgorrithhm加密密钥钥可以从从解密密密钥中推推算出来来,反过过来也成成立,在在大多数数算法中中加/解密密密钥是相相同的。3.6 非对称加加密算法法 AAsymmmettricc Crrypttogrraphhic Alggoriithmm加密算法法的加密密密钥和和解密密密钥是不不一样的的,不能能由一个个密钥推推导出另另一个密密钥。3.7 密钥 Keyy加密转换换中控制制操作的的符号序序列。3.8 对称密钥钥 SSymmmetrric Keyy在对称加加密算法法中使用用的密钥钥。3.9 非对称密密钥 As
7、yymmeetriic KKey在非对称称加密算算法中使使用的密密钥,包包括公钥钥和私钥钥。3.10 公钥 Pubblicc Keey在一个实实体使用用的非对对称密钥钥对中可可以被公公众使用用的密钥钥。在数数字签名名方案中中,公钥钥用于验验证。3.11 私钥 Priivatte KKey在一个实实体使用用的非对对称密钥钥对中仅仅被该实实体使用用的密钥钥。在数数字签名名方案中中,私钥钥用于签签名。3.12 数字签名名 DDigiitall Siignaaturre对数据的的一种非非对称加加密变换换。该变变换可以以使数据据接收方方确认数数据的来来源和完完整性,保保护数据据发送方方发出和和接收方方收
8、到的的数据不不被第三三方篡改改,也保保护数据据发送方方发出的的数据不不被接收收方篡改改。3.13 SM2算算法SM2 alggoriithmm ,一一种国家家商用密密码非对对称密码码算法,密密钥长度度为2556比特特。3.14 SM3算算法SM3 alggoriithmm ,一一种国家家商用密密码密码码杂凑算算法,输输出长度度为2556比特特。4 缩略语下列缩略略语适用用于本规规范: 缩略语中文名英文名0-9 AA-F十六进制制数字API应用编程程接口Appllicaatioon PProggrammminng IInteerfaaceAPDUU应用协议议数据单单元Appllicaatioon
9、 PProttocool DDataa UnnitPKI公钥基础础设施Publlic Keyy InnfraastrructtureePIN个人身份份识别码码Perssonaal IIdenntifficaatioon NNumbberan字母数字字型Alphhanuumerricans特殊字母母数字型型Alphhanuumerric Speeciaalb二进制BinaaryBER基本编码码规则Basiic EEncoodinng RRuleescn压缩数字字Comppresssedd NuumerricDDF目录定义义文件Direectoory Deffiniitioon FFileeDF专
10、用文件件Dediicatted FilleEF基本文件件Elemmenttaryy FiileFCI文件控制制信息Filee Coontrrol InfformmatiionFID文件标识识符Filee IddenttifiierIC集成电路路Inteegraatedd CiircuuitISO 国际标准准化组织织Inteernaatioonall Orrgannizaatioon ffor StaandaardiizattionnMAC报文鉴别别代码Messsagee Auutheentiicattionn CoodeMF 主控文件件Mastter FilleSAM安全存取取模块Secuur
11、e Acccesss MoodulleTLV标签、长长度、值值Tag Lenngthh VValuue5 应用模型型根据居民民健康卡卡应用规规范,卡卡中存放放了卡片片基本信信息,用用户个人人基本信信息,联联系人信信息、医医学警示示生物标标识信息息,住院院信息、门门诊记录录信息以以及相应应的证书书签名信信息。总总共记录录的数据据项有3380多多个类别别,这些些数据项项分布在在卡中不不同目录录下不同同的文件件中。卡卡中不同同的数据据文件,根根据其存存放数据据的不同同,具有有不同的的读写权权限。具具体请参参见居居民健康康卡安全全存取模模块(SAMM)卡技术术规范附附录表A4 密钥配配置表。要读写居居
12、民健康康卡,需需要使用用符合卫卫生部颁颁布的相相关规范范的读写写机具和和SAMM卡,完完成读写写数据所所需要的的权限控控制,在在读取特特定数据据前,需需要根据据其所在在文件不不同,依依据密钥钥配置表表去获取取外部认认证所需需要的密密钥标识识用途,密密钥版本本等信息息。然后后通过发发送指令令到SAAM卡进进行密钥钥分散,使使用SMM1算法法加密数数据取得得SAMM卡计算算外部认认证需要要的认证证数据,再发送给用户卡完成外部认证以取得相应的权限,此后再根据所读取的字段所在文件、记录号等信息进行数据读写。为了简化化上层应应用的开开发,读读写接口口将这一一过程进进行了封封装,应应用开发发者只需需要通过
13、过接口规规范提供供的读写写函数,设设置所需需读写居居民健康康卡中的的单个或或多个数数据项,就就可以完完成数据据的读写写操作。这样应用用层就可以不不需要关关心读写写机具、用用户卡、SSAM卡卡之间的的交互,只只需要针针对所需需要数据据完成业业务流程程的设计计开发。6 接口函数数接口函数数列表如如下:函数名功能备注iDOppenPPortt打开设备备返回设备备操作句句柄iDClloseePorrt关闭设备备PoweerOnn设备复位位返回复位位信息SenddAPDDU发送指令令iVerrifyyPINN验证PIIN校验SAAM卡PPINiChaangee_Piin修改PIIN修改SAAM卡PPIN
14、iReaaderr_SAAM_PPubllic读取SAAM卡公公共信息息该函数取取得SAAM卡片片公共信信息文件件iReaaderr_SAAM_TTermminaal读取SAAM卡片片终端信信息该函数取取得SAAM卡片片的终端端信息文文件iReaaderr_SAAM_PPubllicAApp读取SAAM公共共应用信信息该函数取取得SAAM卡片片的居民民健康卡卡应用的的公共信信息文件件iReaaderr_SAAM_OOrgCCerttifiicatte读取SAAM卡上上的健康康卡发卡卡机构证证书该函数取取得SAAM卡片片的居民民健康卡卡发卡机机构证书书文件iReaaderr_SAAM_CCert
15、tifiicatte读取SAAM卡的的机构证证书该函数取取得SAAM卡片片的SAAM卡机机构证书书iR_DDDF11EF005Innfo读取卡中中DDFF1EFF05中中的数据据根据函数数各参数数读取卡卡中数据据(发卡卡机构基基本数据据文件)iR_DDDF11EF006Innfo读取卡中中DDFF1EFF06中中的数据据根据函数数各参数数读取卡卡中数据据(持卡卡人基本本信息数数据文件件)iR_DDDF11EF007Innfo读取卡中中DDFF1EFF07中中的数据据根据函数数各参数数读取卡卡中数据据(照片片)iR_DDDF11EF008Innfo读取卡中中DDFF1EFF08中中的数据据根据函
16、数数各参数数读取卡卡中数据据(有效效期等)iW_DDDF11EF008Innfo写入卡中中DDFF1EFF08中中的数据据根据函数数各参数数写入卡卡中数据据(有效效期等)iR_DDF011EF005Innfo读取卡中中DF01EEF055中的数数据根据函数数各参数数读取卡卡中数据据(地址址信息文文件)iW_DDF011EF005Innfo写入卡中中DDFF1EFF05中中的数据据根据函数数各参数数写入卡卡中数据据(地址址信息文文件)iR_DDF011EF006Innfo读取卡中中DF001EFF06中中的数据据根据函数数各参数数读取卡卡中数据据(联系系人信息息文件)iW_DDF011EF006
17、Innfo写入卡中中DF001EFF06中中的数据据根据函数数各参数数写入卡卡中数据据(联系系人信息息文件)iR_DDF011EF007Innfo读取卡中中DF001EFF07中中的数据据根据函数数各参数数读取卡卡中数据据(职业业婚姻信信息文件件)iW_DDF011EF007Innfo写入卡中中DF001EFF07中中的数据据根据函数数各参数数写入卡卡中数据据(职业业婚姻信信息文件件)iR_DDF011EF008Innfo读取卡中中DF001EFF08中中的数据据根据函数数各参数数读取卡卡中数据据(证件件记录信信息文件件)iW_DDF011EF008Innfo写入卡中中DF001EFF08中中
18、的数据据根据函数数各参数数写入卡卡中数据据(证件件记录信信息文件件)iR_DDF022EF005Innfo读取卡中中DF002EFF05中中的数据据根据函数数各参数数读取卡卡中数据据(临床床基本数数据文件件)iW_DDF022EF005Innfo写入卡中中DF002EFF05中中的数据据根据函数数各参数数写入卡卡中数据据(临床床基本数数据文件件)iR_DDF022EF006Innfo读取卡中中DF002EFF06中中的数据据根据函数数各参数数读取卡卡中数据据(特殊殊信息数数据文件件)iW_DDF022EF006Innfo写入卡中中DF002EFF06中中的数据据根据函数数各参数数写入卡卡中数据
19、据(特殊殊信息数数据文件件)iR_DDF022EF007Innfo读取卡中中DF002EFF07中中的数据据根据函数数各参数数读取卡卡中数据据(过敏敏基本数数据文件件)iW_DDF022EF007Innfo写入卡中中DF002EFF07中中的数据据根据函数数各参数数写入卡卡中数据据(过敏敏基本数数据文件件)iR_DDF022EF008Innfo读取卡中中DF002EFF08中中的数据据根据函数数各参数数读取卡卡中数据据(免疫疫基本数数据文件件)iW_DDF022EF008Innfo写入卡中中DF002EFF08中中的数据据根据函数数各参数数写入卡卡中数据据(免疫疫基本数数据文件件)iR_DDF
20、033EF005Innfo读取卡中中DF003EFF05中中的数据据根据函数数各参数数读取卡卡中数据据(住院院信息索索引文件件)iW_DDF033EF005Innfo写入卡中中DF003EFF05中中的数据据根据函数数各参数数写入卡卡中数据据(住院院信息索索引文件件,将住住院有效效标识更更改为00x000)iEraase_DF003EFF05IInfoo擦出卡中中DF003EFF05中中的数据据住院信息息索引文文件,将将住院有有效标识识更改为为0xFFFiR_DDF033EF006Innfo读取卡中中DF003EFF06中中的数据据根据函数数各参数数读取卡卡中数据据(门诊诊信息索索引文件件)i
21、W_DDF033EF006Innfo写入卡中中DF003EFF06中中的数据据根据函数数各参数数写入卡卡中数据据(门诊诊信息索索引文件件,将门门诊有效效标识更更改为00x000)iEraase_DF003EFF06IInfoo擦出卡中中DF003EFF06中中的数据据门诊信息息索引文文件,将将门诊有有效标识识更改为为0xFFFiR_DDF03EEEInnfo读取卡中中DF03EEE中的的数据根据函数数各参数数读取卡卡中数据据(住院院信息文文件)iW_DDF03EEEInnfo写入卡中中DF03EEE中的的数据根据函数数各参数数写入卡卡中数据据(住院院信息文文件)iR_DDF03EEDInnfo
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 居民 健康 应用 接口 技术规范 XXXX 12 0117841
限制150内