GM_T 0056-2018多应用载体密码应用接口规范.pdf

ICS 35.040L 80GM备案号：62991—2018中华人民共和国密码行业标准GM/T 0056—2018多应用载体密码应用接口规范Specification of cryptography application interface withmulti-applications equipment2018-05-02发布2018-05-02实施国家密码管理局发布 GM/T 0056—2018目次前言引言范围规范性引用文件术语和定义缩略语多应用载体系统板架多应用载体密码应用接口调用流程6.1密码应用接口调用流程6.2密码算法能力标识6.3密码应用接口规格Java技术方案密码应用接口7.1简介7.2密码算法能力标识7,3密码应用包定义7.4密码应用接口定义7,5密码应用类信息附录A（资料性附录)多应用安全管理的密码应用要求28附录B（资料性附录)多应用安全管理的证书格式33参考文献35 GM/T 0056—2018NullPointerExceptionkeyData参数为null时。ArraylndexOutOfBoundsExceptionkOff参数为负数或者超过keyData数组时，或者kOf加上密钥数据长度超出keyData数据长度时，抛出该异常。setKey.1声明public abstract void setKey(byte keyData[],short kOff)throws CryptoException, NullPointerException, ArrayIndexOutOfBoundsException;.2本方法用于设置SM4密钥数据，输人的密钥数据长度为16字节。数据格式为大端并且右对齐，即最低有效位为最后那个字节的最低有效位，.3参数keyData此byte数组存放待设置的密钥数据。koff密钥数据在byte数组中的起始位置，7,抛出异常CryptoException,ILLEGAL_VALUE密码数据需要解密面且解密出错时抛出该异常，NullPointerExceptionkeyData参数为null时瑰出该异常，ArrayIndexOutOfBoundsExceptionkOff参数为负数或者超过keyData数组时，或者kOff加上密钥数据长度超出keyData数据长度时，抛出该异常，7.5.2SM2Key7,5.2.1概述SM2Key是非对称密钥的一种，分为公钥和私钥，用于SM2算法的运算，SM2Key接口定义见表4，表 4SM2Key接口定义返国值定义说明shortgetA(byte[J buffer, short offset)获得曲线参数AshortgetB(byte[J buffer, short offset)获得曲线参数BshortgetG(byte[J buffer, short offset)获得曲线参数G7,5.2.2getA7,声明public short getA( GM/T 0056—2018byte buffer[],short offset)throws CryptoException, NullPointerException, ArraylndexOutOfBoundsException.2描述本方法用于获取曲线参数A的数据，输出的数据长度为32字节。数据格式为大端并且右对齐，即最低有效位为最后那个字节的最低有效位，.3参数buffer此byte数组存放输出的数据，offset数据在byte数组中的起始位置，.4返回值以字节计的曲线参数A的数据长度，.5CryptoException.UNINITIALIZED_KEY密钥处于未初始化状态时抛出该异常，NullPointerExceptionkeyData多参数为null时抛出该异常。ArrayIndexOutOfBoundsException-offset参数为负数或者超过buffer数组时，或者offset加上曲线参数A长度超出buffer数据长度时，抛出该异常。 getB.1声明publie short getB(byte buffer[J.short offset)throws CryptoException, NullPointerException, ArrayIndexOutOfBoundsException;.22描述本方法用于获取曲线参数B的数据，输出的数据长度为32字节。数据格式为大端并且右对齐，即最低有效位为最后那个字节的最低有效位，.33参数Jajjnq此byte数组存放输出的数据。offset数据在byte数组中的起始位置。.4返回值以字节计的曲线参数B的数据长度，.5抛出异常CryptoException,UNINITIALIZED_KEY一密钥处于末初始化状态时