YD_T 3207-2016多应用eID载体商用密码算法接口技术要求.pdf

ICS 35.240.15L 64YD中华人民共和国通信行业标准YD/T 3207—2016多应用eID载体商用密码算法接口技术要求Technical requirements for algorithm API ofmulti-application elDequipment2016-10-22发布2017-01-01实施中华人民共和国工业和信息化部发布 YD/T 3207—2016目次前言.II引言..范围2规范性引用文件。术语、定义和缩略语3.1术语和定义3.2缩略语..多应用eID载体总体框架，商用密码算法调用流程java技术多应用elD载体商用密码算法调用接口6.1简介....6.2包信息。6.3算法接口层次6.4类描述.附录A（规范性附录）Java技术多应用clID载体商用密码算法调用接口定义 YD/T3207—2016附录A（规范性附录）Java技术多应用eID载体商用密码算法调用接口定义A.1SM4KeyA.1.1SM4Key定义SM4Key定义见表A.1.表A1SM4Key返回做定义说明bytegetKey(byte keyData[], sbort kOm)获得密钥数据voidsetKey(byte keyData[], short koff)设置密数据A.1.2setKeyA.1.2.1声明public abstract void setKey(byte keyData],short kOff)throws CryptoException, NullPointerException, ArraylndexOutOfBoundsException;A.1.2.2描述本方法用于设置SM4密钥数据。输入的明文密钥数据长度为16字节。数据格式为大端并且右对齐，即景低有效位为最后那个字节的最低有效位。A.1.2.3参数keyData一此byte数组存放待设置的密钥数据。koff密钥数据在byte数组中的起始位置。A.1.2.4返回值无。A.1.2.5抛出异常CryptoException.ILLEGAL_VALUE一密码数据需要解密而且解密出错时范出该异带。NullPointerExceptionkeyData参数为null时抛出该异常。ArraylndexOutOfBoundsExceptionkOf参数为负数或者超过keyData数组时猎出该异常。 YD/T 3207—2016A.1.3getKeyA.1.3.1声明public abstract byte getKey(byte keyData[],short koff)throws CryptoException, NullPointerException, ArraylndexOutOfBoundsException;A.1.3.2描述本方法获得明文形式的SM4密钥数据。输出的明文密钥数据长度为16字节。数据格式为大端并且右对齐，即最低有效位为最后那个字节的最低有效位。A.1.3.3参数keyData-此byte数组存放返回的密钥数据。koff密钥数据在byte数组中的起始位置。A.1.3.4返回值以字节计的密钥数据的长度。A.1.3.5抛出异常CryptoException.UNINITIALIZED_KEY密钥对象没有正确初始化时。NullPointerExceptionkeyData参数为null时。ArraylndexOutOfBoundsException一kOf参数为负数或者超过keyData数组时。A.2SM2KeyA.2.1SM2Key定义SM2Key定义见表A.2.表A.2SM2Key返国值定文说明shortgetA(byte[] buffer, short offset)获得曲线参数人shortgetB(bytel] buffer, short offset)获得曲线参数BshortgetG(byte() buffer, short offset)获得曲线参数GA.2.2getAA.2.2.1声明public short getA(byte buffer[].short offset YD/T3207—2016)throws CryptoException;A.2.2.2描述本方法用于获取曲线参数A的数据。输出的明文数据长度为32字节。数据格式为大端并且右对齐，即最低有效位为最后那个字节的最低有效位。A.2.2.3参数buffer-此byte数组存放输出的数据。Offset-数据在byte数组中的起始位置。A.2.2.4返回值以字节计的曲线参数A的数据长度。A.2.2.5抛出异常CryptoException.UNINITIALIZED_KEY一密钥处于未初始化状态时抛出该异常。NullPointerExceptionkeyDa