新底层密钥体系详解2013412..docVIP

1 使用流程 以下写的都是针对新底层安全库部分的用法 2 使用注意事项 a.每次开机进入应用程序一定要做密码键盘初始化，初始化过程实现自动检测密码键盘类型和密码键盘bps。 b.第一次装载密钥建议初始化密钥区，如果是825-6初始化时间大约30秒左右 c.为显示上兼容，在密码键盘上显示时一行内容不要超过15个字节,显示完后请调用PubClrPinPad函数恢复默认显示。 d.由于zt579e18不支持显示汉字，zt579c47显示汉字方式和nl系列密码键盘不同，建议在程序中不要显示汉字，都用英文显示，否则程序要增加判断密码键盘类型。 e.nl825-6密码键盘支持0-167组密钥，由于考虑到x99 3des算法的兼容，在每装载一组密钥时库里面自动多装载一次，因此实际的密码组数是0~73，因新的密钥体系外接密码键盘部分支持Pin、Mac、Track、Data四组密钥，所以实际密码组数是0-36。 f.在调用PubGetPin取密码时，如果按确认键返回表示无密码，此时可以通过第一个输出参数pszPin是否有内容来判断是否有密码。 g.在中行IST版程序中如果是3DES密钥，由于主密钥不能参加MAC运算，因此需要将主密钥当作工作密钥再保存一次。 3 接口说明 3.1 PubInitSecrity 函数名称：int PubInitSecrity(int nMode,const STPINPADPARAM* pstPinpadParam); 函数介绍：初始化安全库 函数描述：完成密码键盘自适应、设置波特率、密码键盘类型的初始化工作，指定初始化内置还是外接密码键盘。 入口参数：nMode 详见：EM_SECRITY_MODE STPINPADPARAM：密码键盘参数 出口参数：无 返 回 值：APP_SUCC 成功 其它 失败 3.2 PubSetCurrentMainKeyIndex 函数名称：int PubSetCurrentMainKeyIndex(int nIndex) 函数介绍：设置当前主密钥索引号 函数描述：无 入口参数：nIndex 索引号 出口参数：无 返 回 值：APP_SUCC 成功 其它 失败 3.3 PubLoadMainKey 函数名称：int PubLoadMainKey(int nIndex,const char* psKey, int nKeyLen) 函数介绍：安装主密钥 函数描述：无 入口参数：nIndex 索引号 psKey 主密钥明文（BCD码） nKeyLen 主密钥长度 8字节或16字节 出口参数：无 返 回 值：APP_SUCC 成功 其它 失败 3.4 PubLoadWorkKey 函数名称：int PubLoadWorkKey(int nKeyType,const char* psKey, int nKeyLen,const char* psCheckValue) 函数介绍：安装工作密钥 函数描述：无 入口参数：nKeyType 安装的工作密钥类型（详见：EM_KEY_TYPE） psKey 工作密钥密文（BCD码） nKeyLen 工作密钥长度 8字节或16字节 出口参数：psCheckValue 校验值 返 回 值：APP_SUCC 成功 其它 失败 3.5 PubGetPin 函数名称：int PubGetPin(char *pszPin, int *pnPinLen, int nMode, const char *pszCardno,const char *pszAmount,int nMaxLen, int nMinLen); 函数介绍：获取Pin 函数描述：支持多种加密算法。实现密码最大最小长度的设置，显示无密码时，按确认键。密码输入提示在第二行、输入时以星号显示，密码输完，清除屏幕到默认状态； 入口参数：nMode 密码加密模式（详见：EM_PIN_TYPE） pszCardno 卡号 pszAmount 金额 nMaxLen 最大的密码长度 nMinLen 最小的密码长度 出口参数：pszPin 输入的Pin pnPinLen 输入Pin的长度 返 回 值：APP_SUCC 成功 其它 失败 3.6 PubGetPinExtern 函数名称：int PubGetPinExtern(char *pszPin, int *pnPinLen, int nMode, const char *pszCardno,int nMaxLen, int nMinLen,void (*ShowFunc)()); 函数介绍：获取Pin 函数描述：支持自定义POS界面显示函数 入口参数：nMode 密码加密模式（详见：EM_PIN_TYPE