/*************************************************************************** * 文件: DCSH_SAE_1.h * * 功能说明: 动联动态安全认证引擎1.0头文件 * * 版权所有：上海动联信息技术有限公司 * * 作者： 杨波 * 时间： 2008年5月13日 * 地点： 上海 动联 * ***************************************************************************/ /*------------------------------------------------------------------------- *修改记录* *修改时间* *修改内容* * ------------------------------------------------------------------------- *备注： * 此头文件内只允许申明，不可定义 * 此头文件内所有改动均需详细说明 * -------------------------------------------------------------------------*/ #ifndef _DCSH_SAE_1_H #define _DCSH_SAE_1_H #ifdef DCSHCOREAPI_EXPORTS #define DCSHCOREAPI_API __declspec(dllexport) #else #define DCSHCOREAPI_API __declspec(dllimport) #endif /* #define DCSHCOREAPI_API */ #ifdef __cplusplus extern "C" { #endif #define int8 char #define int16 short #define int32 long #define uint8 unsigned char #define uint16 unsigned short #define uint32 unsigned int #define uint unsigned int #define BYTE unsigned char #define WORD unsigned short #define DWORD unsigned long #define UCHAR unsigned char #define UINT unsigned int #define LONG long #define ULONG unsigned long #define VOID void #define PVOID void * #ifndef TRUE #define TRUE 1 #define FALSE 0 #endif //动态认证引擎的系统默认值 #define SYSTEMPIN "888888" /* 系统默认的PIN*/ #define TOTALSECONDS 0x47791200 /* 2008年1月1日00点00时00分，流失的秒*/ #define DCPVTLEN 232 /* 私有数据长度*/ #define SEEDLEN 16 /* 种子的长度，建议使用128位，经常用于密钥*/ #define EX_SEEDLEN 4 /* 种子的扩展，支持20字节*/ #define MAXSEEDLEN 20 /* 系统支持的最大种子长度，建议64，目前使用20*/ #define MAXOFFSETSECONDS 43200 /* (12*60*60)秒， 偏移量超过12小时，无论是否认证通过，应该永久禁用*/ #define ONEDAYSECONDS 86400 /* (24*60*60)秒， 一天的秒数，用于获得动态口令 */ #define TWOWEEKSECONDS 1209600 /* (14*24*60*60)秒，相距2周未登陆，则窗口自动扩展1，但最大不超过大窗口*/ #define ONEWEEKSECONDS 604800 /* (7*24*60*60)秒，相距1周未登陆，动联需要时间补偿*/ #define MAXRESYNCHTIMES 1000 //事件型令牌重新同步最大寻找次数 //事件型令牌在重新同不是分两种方式： //1、计数从1开始，到MAXRESYNCHTIMES 中寻找 //2、从当前最后一次有效计数，到MAXRESYNCHTIMES中寻找 #define SM3HASHSTRINGLENGTH 64 //SM3算法的令牌的明文组装空间，格式参考《时间同步一次性口令认证系统标准0702》 #define DATETIMESTRINGLEN 13 //SM3算法的日期转换，12字节，最末尾第13字节为间隔的商 #define THANDELTATIMES 3 //前一次使用的时间至少是此次时间差的3倍，用于时间补偿 #define GETTOKENCODESTRHEAD "%010u:%03u:%03u:%010u:" //"起始时间:令牌间隔:动态口令长度:动态口令个数:动态口令集合" /*定义算法*/ #define ALGORITHM_SHA1 0x01 /* 产生20字节摘要 */ #define ALGORITHM_RC6 0x02 /* 块加密，速度快*/ #define ALGORITHM_SM3 0x03 /* SM3，类似SHA1，复旦微电子 */ #define ALGORITHM_AES 0x04 /* 块加密，标准算法*/ #define ALGORITHM_ATM 0x00 /* 支持ATM机方式的挑战应答，带时间*/ #define ALGORITHM_ATM_MD5 0x05 /* 支持ATM机方式的挑战应答，带时间，用户口令使用MD5摘要*/ #define ALGORITHM_ATM_SHA1 0x06 /* 支持ATM机方式的挑战应答，带时间，用户口令使用SHA1摘要*/ #define ALGORITHM_HMAC 0x08 /* OTP，产生20字节摘要 */ #define ALGORITHM_YQ 0x10 /* AES，使用新的截取方式 */ #define ALGORITHM_COS 0x20 /* HMAC，cos的sim卡方式 */ #define ALGORITHM_ASP 0x30 /* 卓望SIM卡令牌，使用HMAC */ #define ALGORITHM_UNI 0x07 /* 联通SIM卡令牌，使用HMAC，但是截取规则不一样 */ #define ALGORITHM_TOTP 0x09 /* 工商银行使用的时间型OTP，OTP的时候等同ALGORITHM_HMAC，挑战则追加时间 */ #define ALGORITHM_SSM3 0x11 /* SM3算法，国密办刚公开，软算法，依然采用原先的规则 */ #define STRLENLOGID 48 /*LoginId的长度*/ #define STRLENAME 24 /*UserName的长度*/ #define GMTSTRLEN 24 /*时间字符的长度 GMT 2008-05-14 04:09:22*/ #define URGENCYPWLEN 20 /*紧急密码的最大长度*/ #define DCSH_MIN_PIN_LEN 4 /*Pin的最小长度*/ #define DCSH_MAX_PIN_LEN 8 /*Pin的最大长度*/ #define DCSH_PIN_LEN 12 /*Pin的长度空间，限制为4-8*/ #define DCSH_SN_LEN 12 /*序列号最大长度*/ #define DCSH_PRN_LEN 12 /*tokencode最大长度*/ #define DCSH_RESPONSE_LEN 16 /*用户响应码，可能包含PIN*/ #define DCSH_CHALLENGE_LEN 16 /*挑战码，建议8字节*/ #define UNLOCKCODELEN 8 /*解锁码的长度为8个数字*/ #define HMACQUESTIONLEN 8 /*挑战应答，HMAC算法的question长度一定为8*/ #define HOSTBYTELEN 12 /*取12个字节，使用最后4/6位*/ #define UNICOMMODLEN 1000 /*取摸，获得3个数字，不足则前端补零 */ #define UNICOMNUMBER 3 /*每个Short取模后最大数字为3个*/ #define OCRASUITE "OCRA-1:HOTP-SHA1-6:QN08" /* 挑战应答的规则 */ #define OCRASUITE_ICBC "OCRA-1:HOTP-SHA1-6:QA64-T" /* 工商银行挑战应答时间型令牌的规则 */ #define SM3OCRASUITE "OCRA-1:HOTP-SM3-8:QN08" /* SM3算法的挑战应答规则 */ //令牌类型 #define DCSH_TOKEN_TYPE_TIME 0 /*时间类型的令牌*/ #define DCSH_TOKEN_TYPE_EVENT 1 /*事件类型的令牌*/ #define DCSH_TOKEN_TYPE_MOBILE 2 /*手机类型的令牌, 动联专用*/ //令牌的应用类型 #define DCSH_HARDWARE_TOKEN_DC 1 /*动联生产的硬件令牌*/ //目前我们在做的，专门特指K5令牌 #define DCSH_HARDWARE_TOKEN_DC_EX 2 /*动联生产的令牌和 其他厂商的扩展*/ //主要使用了另一种传递参数方式 //支持杭州驭强的令牌 --AES //支持cos的SIM卡令牌 --COS //支持复旦微电子的SM3令牌，可能成为行业标准 --SM3 //动联自己的令牌 //卓望和联通的SIM卡令牌 #define DCSH_HARDWARE_TOKEN_CHR 3 /*异步类型的硬件令牌*/ //挑战应答，RSA有一款 #define DCSH_SOFTWARE_TOKEN_DC 4 /*动联生产的软件令牌*/ //标志位区分，等同于DCSH_HARDWARE_TOKEN_DC_EX #define DCSH_SOFTWARE_TOKEN_PHONE 5 /*手机令牌 */ //标志位区分，等同于DCSH_HARDWARE_TOKEN_DC_EX #define DCSH_SOFTWARE_TOKEN_CHR 6 /*异步类型的软件令牌*/ //用于手机异步令牌 #define DCSH_SOFTWARE_TOKEN_SMS 7 /*短信类型的软件令牌*/ //短信令牌 #define DCSH_HARDWARE_TOKEN_COVER 8 /*刮刮卡令牌*/ #define DCSH_HARDWARE_TOKEN_ATM 9 /*属于异步类型的令牌*/ //为银行ATM输入用户密码到令牌上 #define DCSH_SOFTWARE_TOKEN_ATM 10 /*属于异步软件令牌*/ //为银行ATM软件令牌，可用于手机和软件 #define DCSH_HARDWARE_TOKEN_SIM 11 /*卓望和联通的SIM卡令牌也单独列为应用类型，也可属于DC_EX*/ #define DCSH_HARDWARE_TOKEN_GETDC 12 /*K5 该令牌类型支持获取动态口令，建议该类型不用于认证*/ #define DCSH_HARDWARE_TOKEN_GETEX 13 /*K8 该令牌类型支持获取动态口令，建议该类型不用于认证*/ //认证类型 #define DCSH_PRN_TYPE 0 /*直接使用tokencode认证*/ #define DCSH_PASSCODE_TYPE 1 /*带PIN的tokencode认证 */ #define DCSH_CHALLENGE_RESPONSE_TYPE 2 /*挑战响应的认证方式 */ #define DCSH_PASSCODE_NEXT_TYPE 3 /*需要返回下一个tokencode的认证方式*/ #define DCSH_SMS_GETPRN_TYPE 4 /*短消息认证，获得tokencode*/ #define DCSH_SMS_PRN_TYPE 5 /*短消息认证，认证tokencode*/ #define DCSH_MSCHAP2_PASSCODE_TYPE 6 /*使用MS-Chap v2的认证方式，由引擎计算tokencode来验证*/ #define DCSH_MSCHAP2_CHANGE_PW_TYPE 7 /*修改令牌的PIN码*/ #define DCSH_SIGN_PRN_TYPE 8 /*数字签名的动态认证方式*/ #define DCSH_GET_SIGN_PRN_TYPE 9 /*获得签名口令，可用于短信数字签名方式*/ #define DCSH_COVER_GET_HOSTCODE_TYPE 10 /*获得刮刮卡的当前计数的主机码*/ #define DCSH_COVER_HOST_PRN_TYPE 11 /*刮刮卡码认证，包含主机字符 动态口令 PIN*/ #define DCSH_CHALLENGE_RESPONSE_ATM_TYPE 12 /*ATM用户密码的挑战应答认证模式，用户密码支持摘要算法 */ //认证状态，认证模式 #define DCSH_LOGON_STATE_FIRST_LOGIN 1 #define DCSH_LOGON_STATE_NORMAL 2 #define DCSH_LOGON_STATE_NEXT_TOKENCODE 3 #define DCSH_LOGON_STATE_NEXT_TOKENCODE_2 4 #define DCSH_MAX_PINTIMES 3 /*最大Pin输入错误次数*/ #define DCSH_MAX_THRESOLD 10 /*最大tokencode错误次数，超过进入next模式*/ #define DCSH_MAX_REPEATED 5 /*允许重放次数，超过则禁用*/ #define ICBC_ACTIVECHECKCODELEN 12 /* 工行令牌种子激活码的长度12，前6激活，后6校验 */ #define ICBC_ACTIVECODELEN 6 /* 工行令牌种子真正激活码6 */ #define ICBC_ACTIVECODECALCLEN 8 /* 工行令牌种子真正激活码6带入运算时的真实长度8 */ #define ICBC_CHECKCODELEN 6 /* 工行令牌种子真正校验码长度6 */ #define ICBC_PINLOCKCODELEN 8 /* 工行令牌PIN输入错误锁定后锁定码长度 */ #define ICBC_PINUNLOCKCODELEN 6 /* 工行令牌解锁码长度 */ #define DCSHEMSUCCESS 0 //验证通过，除了EMBADREC，所有的返回必须保存PDATA到数据库 #define DCSHEMFIRST 1 //第一次使用令牌登陆，成功，等同于EMSUCCESS #define DCSHEMBADARG 2 //参数错误，参数可能为空指针 #define DCSHEMBADREC 3 //严重错误！PDATA内部数据有问题，如签名等 #define DCSHEMPRNLEN 4 //Tokencode的长度错误 #define DCSHEMTIMRNG 5 //passcode时间错误，不在生命期限内 #define DCSHEMNOTASSIGNED 6 //令牌还没有分配 #define DCSHEMDISABLE 7 //令牌处于禁用状态 #define DCSHEMFOREVERDISABLE 8 //令牌被永久禁用，可能是时间偏移超过12小时 #define DCSHEMNOPIN 9 //没有输入pin码 #define DCSHEMPINLEN 10 //输入的PIN长度错误 #define DCSHEMBADPIN 11 //输入错误的PIN #define DCSHEMSTOLEN 12 //因为PIN错误次数到达极限，默认为丢失 #define DCSHEMOUTWIND 13 //在任何窗口内找不到tokencode，可能需要再同步 #define DCSHEMREPPRN 14 //这是重放，需要小心，应该立即记录，并提醒管理员 #define DCSHEMREPDISABLE 15 //重放到一定的次数则禁用 #define DCSHEMNEXTPRN 16 //进入Next的模式 #define DCSHEMTHRESHOLDNXT 17 //输入tokencode的错误次数到达极限，以后进入NEXT模式 #define DCSHEMBADNEX 18 //在Next模式下输入错了tokencode #define DCSHEMNEXTDISABLE 19 //在Next模式下输入错误次数到达极限，被禁用 #define DCSHEMSYN1OK 20 //重新同步模式下，第一次匹配tokencode已经找到 #define DCSHEMFIRSTDISABLE 21 //在First模式下，多次输入失败，则禁用 #define DCSHEMBADNEX2 22 //在Next2下输入错误的tokencode #define DCSHEMBADINPUT 23 //文件无法打开 #define DCSHEMNOMEM 24 //读取BIN文件，没有足够的内存空间 #define DCSHEMBADINPFIL 25 //BIN的文件内容错误，严重错误 #define DCSHEMBADSIG 26 //BIN文件签名错误，严重错误 #define DCSHEMEMPNAME 27 //文件名称错误 #define DCSHEMKEYPAIRERR 28 //密钥对创建失败 #define DCSHEMCERTERR 29 //根证书创建失败 #define DCSHEMSEEDERR 30 //创建种子失败 #define DCSHEMREADPUBKEYERR 31 //读取公钥失败 #define DCSHEMPUBKEYENCERR 32 //公钥加密失败 #define DCSHEMREADSEEDERR 33 //读根种子文件失败 #define DCSHEMREADPRIKEYERR 34 //读根私钥失败 #define DCSHEMPRIKEYDECERR 35 //根私钥解密失败 #define DCSHEMREADPKCS10ERR 36 //读取PKCS#10文件错误 #define DCSHEMTOKENTYPE 37 //错误的令牌应用类型 #define DCSHEMREADROOTCERTERR 38 //读取根证书失败 #define DCSHEMDECROOTCERTERR 39 //解析根证书失败 #define DCSHEMDECPKCS10ERR 40 //解析PKCS#10失败 #define DCSHEMUSERCERTERR 41 //创建用户证书失败 #define DCSHEMVERSIGDATAERR 42 //验证签名错误，严重错误 #define DCSHEMDECEVPDATAERR 43 //解密数字信封错误，严重错误 #define DCSHEMREADUSERCERTERR 44 //读取用户证书失败 #define DCSHEMDECUSERCERTERR 45 //解析用户证书失败 #define DCSHEMEVPDATAERR 46 //制作数字信封失败 #define DCSHEMSIGDATAERR 47 //制作数字签名失败 #define DCSHEMREADSEEDFILEERR 48 //读取种子文件失败 #define DCSHEMPKCS10ERR 49 //创建PKCS#10失败 #define DCSHEMBADFILETYPE 50 //错误的种子文件类型 #define DCSHEMRESPONSEERR 51 //挑战认证验证失败 #define DCSHEMBADTYPE 52 //错误的令牌类型 #define DCSHEMSNASSIGNED 53 //指定的序列号已经分配，且已经使用 #define DCSHEMBADURGENCYPW 54 //紧急密码错误 #define DCSHEMSMSBADPRN 55 //短消息认证，错误的动态口令 #define DCSHEMSMSTIMEOUT 56 //口令正确，但已经超时 #define DCSHEMBADGETURGENCYPW 57 //获取紧急密码失败 #define DCSHEMPKI128 58 //CryptoAPI在公钥加密时偶尔会丢失1字节 #define DCSHEMLICDEVSNERR 59 //授权，版权控制时设备序列号错误 #define DCSHEMLICDATEEND 60 //授权，授权文件设定的有效期结束 #define DCSHEMLICEKEYERR 61 //授权，eKey内部的版权信息错误，严重 #define DCSHEMLICUSBERROR 62 //授权，usb读eKey错误，设备原因，严重 #define DCSHEMMSCHAPV2ERROR 63 //ms chap v2 认证，客户端提交nt_response错误 #define DCSHEMMSCHAPV2ERRORPW 64 //ms chap v2 修改口令，口令存在异常 #define DCSHEMDEVSNERR 65 //授权，eKey序列号不匹配 #define DCSHEMDEVFILEERROR 66 //ekey内部文件不存在 #define DCSHEMFORCESYNTYPE 67 //强制同步的类型错误，应该是只能是事件型 #define DCSHEMNOTCOVERTYPE 68 //不是刮刮卡令牌类型，不能生成卡片 #define DCSHEMOVERCOVERNUM 69 //种子生成卡片口令的数量大于最大配置 #define DCSHEMLASTCOVERNUM 70 //最后一个覆盖区不用于认证，而是用于换卡 #define DCSHEMCOVERNOTUSED 71 //当前的覆盖区还没有用于认证 #define DCSHEMMUSTGETCOVER 72 //刮刮卡认证必须先获得主机字符 #define DCSHEMHOSTCODEERRO 73 //主机字符错误 #define DCSHEMCOVERCODEERR 74 //覆盖区域的动态口令错误 #define DCSHEMERRORTODISABLE 75 //多次认证错误，导致令牌被禁用 #define DCSHEMUPDATECODEERR 76 //刮刮卡更换码错误，即最后一个刮刮卡码错误 #define DCSHEMBASE64CODEERR 77 //base64编解码错误 #define DCSHEMURGPWDERR 78 //更改服务码失败 #define DCSHEMMODIFYSNERR 79 //修改序列号时，序列号输入错误 #define DCSHEMPCIOPENERR 80 //打开PCI SJK0817E加密卡失败 #define DCSHEMPCISESSIONERR 81 //创建会话失败，可能PCI中断，也可能达到最大会话数 #define DCSHEMPCISM3ERR 82 //SM3算法内部错误 #define DCSHEMNOSUPPORT 83 //该系统不支持该算法，目前SM3仅用于windows #define DCSHEMFORCECOUNTERLESS 84 //客户端强制同步服务端计数器时，计数器小于服务器已经使用的 #define DCSHEMSHECADLLERR 85 //加载sheca的开发接口失败 #define DCSHEMSHECAKEYERR 86 //驱动sheca的usb-eKey操作异常 #define DCSHEMPCIOPERERR 87 //加密卡运算操作失败 #define DCSHEMICBCVALUEERR 88 //工行进行种子异或的数据交验失败 #define DCSHEMICBCHAVEXOR 89 //工行的种子数据已经异或得到了新的种子数据 #define DCSHEMSEEDLENERR 90 //种子长度错误，可能是工行的种子有问题 #define DCSHEMACTIVELENERR 91 //激活码长度错误，6数字，运算长度为8，补0x00,0x00 #define DCSHEMCHECKLENERR 92 //校验码长度错误，6数字 #define DCSHEMACTIVCHECKERR 93 //激活校验码错误，12数字 #define DCSHEMBIGTIMELENERR 94 //运算的时间，大头自序，长度错误 #define DCSHEMCHANLENERR 95 //挑战的字符串长度错误，工行必须小于64 #define DCSHENUNLOCKPINERR 96 //令牌解锁码的字符串长度错误，8数字 #define DCSHENOUTONEDAY 97 //获取动态口令，时间型，超过了24小时 #define DCSHENOUTMAXCOUNTER 98 //获取动态口令，事件型，超过了1000个 typedef struct CARDREC { char ucSerialNumber[DCSH_SN_LEN]; /* Token序列号字符表示 */ char ucUrgencyPassWord[URGENCYPWLEN]; /* 紧急密码 */ char ucSeedNumber[32]; /* 种子转换的26个数字 */ } TOKENCARDRECORD, *PTTOKENCARDRECORD; typedef struct DCSHPDATA { unsigned int ulSerialNumber; /* Token序列号 */ char ucSerialNumber[DCSH_SN_LEN];/* Token序列号字符表示 */ unsigned int ulPRNLen; /* Tokencode的长度 */ unsigned int ulInterval; /* 时间间隔，产生tokencode */ unsigned int ulBirth; /* 出生日期，从 1/1/2008 */ unsigned int ulDeath; /* 有效期，秒，从 1/1/2008 */ char cTokenType; /* Token类型 */ char cIsHardwareToken; /* 是不是硬件 */ char cAlgorithmSData; /* 算法，私有数据的加密算法 */ char cAlgorithmToken; /* 算法，tokencode的产生算法*/ int iState; /* 状态值，这个非常重要的字段*/ char cEnabled; /* 是否可用，第一判断要素 */ char cAssigned; /* 是否分配，第一判断要素 */ char cNextPRNMode; /* NextToekn模式 */ char cPINDisabled; /* PIN是否使用 */ unsigned int ulLastlogin; /* 最近登陆时间,无论成功失败，秒，从 1/1/2008 */ char ucUserLoginID[STRLENLOGID]; /* */ char ucUserFirstName[STRLENAME]; /* */ char ucUserLastName[STRLENAME]; /* */ int iMaxBadPins; /* Pin优于tokencode认证，每次登陆成功前最大错误次数，超过则disable */ int iNextTokencodeModeThreshold; /* tokenode错误的极限值，超过该值，则进入Next Token模式 */ int iMaxRepeateds; /* 监测重放攻击极限值，反复提交先前的tokencode，或者同一时间提交tokencode则理解为重放，达到极限值则禁用 */ int iMaxBadNextTokencodes; /* 在Next模式下，允许最大错误次数 */ int iPrecision; /* 精度，离ulLastSuccessLogin每隔一个月累加精度秒 */ int iLargeWindowSeconds; /* 秒 */ int iMediumWindowSeconds; /* 秒 */ int iSmallWindowSeconds; /* 秒 */ char ucTokenTypeString[8]; /* 令牌的类型描述 */ int iSeedLen; /* 种子长度，如果是0，则默认为16 */ char ucReserved[4]; /* 保留字段 */ unsigned char ucPrivateData[DCPVTLEN]; /* 加密数据-种子 pin等 */ } TOKENRECORDDATA, *PTTOKENRECORDDATA; /* 424字节 Base64为568字节*/ typedef struct DCSHSAE_TOKENRECORD_INFO { unsigned int ulSerialNumber; /* Token序列号 */ char ucSerialNumber[DCSH_SN_LEN];/* Token序列号字符表示 */ unsigned int ulPRNLen; /* Tokencode的长度 */ unsigned int ulInterval; /* 时间间隔，产生tokencode */ unsigned int ulBirth; /* 出生日期，从 1/1/2008 */ unsigned int ulDeath; /* 有效期，秒，从 1/1/2008 */ char cTokenType; /* Token类型 */ char cIsHardwareToken; /* 是不是硬件 */ char cAlgorithmSData; /* 算法，私有数据的加密算法 */ char cAlgorithmToken; /* 算法，tokencode的产生算法*/ int iState; /* 状态值，这个非常重要的字段*/ char cEnabled; /* 是否可用，第一判断要素 */ char cAssigned; /* 是否分配，第一判断要素 */ char cNextPRNMode; /* NextToekn模式 */ char cPINDisabled; /* PIN是否使用 */ unsigned int ulLastlogin; /* 最近登陆时间,无论成功失败，秒，从 1/1/2008 */ char ucUserLoginID[STRLENLOGID]; /* */ char ucUserFirstName[STRLENAME]; /* */ char ucUserLastName[STRLENAME]; /* */ int iMaxBadPins; /* Pin优于tokencode认证，每次登陆成功前最大错误次数，超过则disable */ int iNextTokencodeModeThreshold; /* tokenode错误的极限值，超过该值，则进入Next Token模式 */ int iMaxRepeateds; /* 监测重放攻击极限值，反复提交先前的tokencode，或者同一时间提交tokencode则理解为重放，达到极限值则禁用 */ int iMaxBadNextTokencodes; /* 在Next模式下，允许最大错误次数 */ int iPrecision; /* 精度，离ulLastSuccessLogin每隔一个月累加精度秒 */ int iLargeWindowSeconds; /* 秒 */ int iMediumWindowSeconds; /* 秒 */ int iSmallWindowSeconds; /* 秒 */ char ucTokenTypeString[8]; /* 令牌的类型描述 */ int iSeedLen; /* 种子长度，如果是0，则默认为16 */ char ucReserved[4]; /* 保留字段 */ } TOKENPUBLICINFO, *PTTOKENPUBLICINFO; /* 192字节 */ typedef struct { LONG type; /* PASSCODE_TYPE/PASSCODE_NEXT_TYPE */ ULONG passc_time; /* passcodetime */ char prn[DCSH_PRN_LEN]; /* tokencode */ char pin[DCSH_PIN_LEN]; /* pin码 */ char nextPrn[DCSH_PRN_LEN]; /* PASSCODE_NEXT_TYPE输出，下一个tokencode */ } DCSHPASSCODE; typedef struct { LONG type; /* PRN_TYPE */ ULONG passc_time; /* passcodetime */ char prn[DCSH_PRN_LEN]; /* tokencode */ } DCSHPRN; typedef struct { LONG type; /* CHALLENGE_RESPONSE_TYPE */ ULONG passc_time; /* passcodetime */ char challenge[DCSH_CHALLENGE_LEN]; /* 挑战码 */ char response[DCSH_RESPONSE_LEN]; /* 响应码 */ } DCSHCHALLENGE_RESPONSE; typedef struct { LONG type; /* CHALLENGE_RESPONSE_ATM_TYPE */ ULONG passc_time; /* passcodetime */ int iPasswdAlg; /* 用户输入密码的摘要算法，0表示直接使用*/ char challenge[DCSH_CHALLENGE_LEN]; /* 挑战码 */ char response[DCSH_RESPONSE_LEN]; /* 响应码 */ } DCSHCHALLENGE_RESPONSE_ATM; typedef struct { LONG type; /* DCSH_SMS_GETPRN_TYPE/DCSH_SMS_PRN_TYPE */ ULONG valid_time; /* 有效时间，秒 */ char prn[DCSH_PRN_LEN]; /* tokencode，返回/验证 */ } DCSHSMSPRN; /* RFC 2548 MSCHAPV2 Response Vendor type = 25 */ /* RFC 2759 Section 8 Provides Pseudocode and details */ #define DCSH_CHALLENGE_LENGTH 16 #define DCSH_USERNAME_LENGTH 128 #define DCSH_RESPONSERECEIVED_LENGTH 24 #define DCSH_RESPONSE_LENGTH 42 #define DCSH_ENCRYPTED_NEWPW_LENGTH 516 #define DCSH_PASSWORD_LENGTH 256 #define DCSH_ENCRYPTED_OLDPWHASH_LENGTH 16 /* struct to be used with type set to DCSH_MSCHAP2_PASSCODE_TYPE */ /* allow to pass required parameters for mschapv2 auth */ typedef struct { LONG type; ULONG passc_time; /* IN::RFC 2759 Section 8.1 */ unsigned char authenticatorChallenge[DCSH_CHALLENGE_LENGTH]; unsigned char peerChallenge[DCSH_CHALLENGE_LENGTH]; /* IN::RFC 2759 Section 8.1 null terminated string of size less or equal to 128*/ char userName[DCSH_USERNAME_LENGTH]; /* IN::RFC 2759 Section 8.1 Result of*/ /* GenerateNTResponse(authenticatorChallenge, peerChallenge, userName, Passcode) */ /* note:: Passcode is used to generate this value */ unsigned char responseReceived[DCSH_RESPONSERECEIVED_LENGTH]; /* OUT::RFC 2759 Section 8.7 Output from*/ /* GenerateAuthenticatorResponse(Passcode, responseRecieved, peerChallenge, authenticatorChallenge, userName)*/ /* note::Passcode is used to generate this value */ char authenticatorResponse[DCSH_RESPONSE_LENGTH]; } DCSHMSCHAP2_PASSCODE; /* struct to be used with type set to DCSH_MSCHAP2_CHANGE_PW_TYPE */ /* allow to pass required parameters for to change password with mschapv2 auth */ typedef struct { LONG type; ULONG passc_time; /* IN::RFC 2759 Section 8.1 */ unsigned char authenticatorChallenge[DCSH_CHALLENGE_LENGTH]; unsigned char peerChallenge[DCSH_CHALLENGE_LENGTH]; /* IN::RFC 2759 Section 8.1 null terminated string of size less or equal to 128*/ char userName[DCSH_USERNAME_LENGTH]; /* IN::RFC 2759 Section 8.1 Result of */ /* GenerateNTResponse(authChallenge, peerChallenge, userName, NewPin) */ /* note:: NewPin is used to generate this value */ unsigned char responseReceived[DCSH_RESPONSERECEIVED_LENGTH]; /* OUT::RFC 2759 Section 8.7 Output from */ /* GenerateAuthenticatorResponse(NewPin, responseRecieved, peerChallenge, authenticatorChallenge, userName)*/ /* note:: NewPin is used to generate this value */ unsigned char authenticatorResponse[DCSH_RESPONSE_LENGTH]; /* IN::RFC 2759 Section 8.9 provides detail on how to calculate this value*/ unsigned char encryptedNewPasword[DCSH_ENCRYPTED_NEWPW_LENGTH]; /* IN::RFC 2759 Section 8.12 provides detail on how to calculate this value*/ unsigned char encryptedOldPasswordHashed[DCSH_ENCRYPTED_OLDPWHASH_LENGTH]; } DCSHMSCHAP2_CHANGE_PW; typedef struct { LONG type; /* DCSH_SIGN_PRN_TYPE / DCSH_GET_SIGN_PRN_TYPE */ ULONG passc_time; /* passcodetime */ char key1[20]; /* 第一个关键信息，建议6个数字 */ char key2[20]; /* 第二个关键信息，建议6个数字 */ char key3[20]; /* 第三个关键信息，建议6个数字 */ char prn[DCSH_PRN_LEN]; /* DCSH_SIGN_PRN_TYPE 为认证数字签名的动态口令*/ /* DCSH_GET_SIGN_PRN_TYPE 为获得签名动态口令*/ char pin[DCSH_PIN_LEN]; /* pin码 */ } DCSH_SIGN_PASSCODE; //数字签名的认证类型 typedef struct { LONG type; /*DCSH_COVER_GET_HOSTCODE_TYPE / DCSH_COVER_HOST_PRN_TYPE*/ ULONG passc_time; /*系统时间*/ char cHostCode[DCSH_PRN_LEN]; /*主机字符*/ //认证时提交，获得时返回 char cTokenCode[DCSH_PRN_LEN]; /*动态口令*/ //获得时实用 char pin[DCSH_PRN_LEN]; /*pin码*/ //认证时使用 int iCurrentCount; /*当前计数器*///获得时使用返回 } DCSH_COVER_PASSCODE; //刮刮卡认证类型 /*联合类型，用于上述类型的认证*/ typedef union { LONG type; DCSHPASSCODE passcode; DCSHCHALLENGE_RESPONSE challengeResponse; DCSHPRN prn; DCSHSMSPRN smsprn; DCSHMSCHAP2_PASSCODE mschap2; DCSHMSCHAP2_CHANGE_PW mschap2pw; DCSH_SIGN_PASSCODE sigprn; DCSH_COVER_PASSCODE coverprn; DCSHCHALLENGE_RESPONSE_ATM chapATM; } DCSHCODE2CHECK, *PT_DCSHCODE2CHECK; /****************************************************************************** ** **函数名称: DCSHSAGetPasscodeTime ** **功能描述: 根据系统时间取得当前令牌需要的时间UTC,相对于2008/1/1的秒数 ** **参数说明: void [] - ** **返回类型: LONG ** 返回整型，秒 ** ** **其他说明: 在进行引擎认证时，必须调用此函数提供的时间 ** **历史: 日期 作者 行为 2008-5-14 杨波 Created ******************************************************************************/ DCSHCOREAPI_API LONG DCSHSAGetPasscodeTime (void); /****************************************************************************** ** **函数名称: DCSHSAGetPasscodeTimeOTP ** **功能描述: 获取系统的秒，相对于1970/1/1 ** **参数说明: ULONG PasscodeTime [in / ] - DCSHSAGetPasscodeTime 获得的时间 ** **返回类型: LONG ** 返回整型，秒 ** ** **其他说明: 在进行OTP认证时，调用该接口获得时间：秒 ** **历史: 日期 作者 行为 2011-1-7 杨波 Created ******************************************************************************/ DCSHCOREAPI_API LONG DCSHSAGetPasscodeTimeOTP (ULONG PasscodeTime); /****************************************************************************** ** **函数名称: DCSHSAFmtTime ** **功能描述: 把认证引擎使用的时间转换为字符串 "GMT 2008-05-14 04:09:22" ** **参数说明: LONG tod [in / ] - 引擎时间，秒 char *outstr [in / out] - 输出字符串，外部分配空间，长度为 GMTSTRLEN ** **返回类型: int ** EMSUCCESS 成功转换 ** EMBADARG 参数错误，可能outstr为空指针 ** **其他说明: 时间为GMT时间，并不是UTC时间，注意时区 ** **历史: 日期 作者 行为 2008-5-14 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAFmtTime (LONG tod, char *outstr); /****************************************************************************** ** **函数名称: DCSHSASetUserLogin ** **功能描述: 分配令牌给用户,令牌的第一个操作应该是分配 ** 分配用户时将重置令牌PIN码，但是令牌自身的状态位和计数器不改变 ** 可以反复分配 ** **参数说明: PTTOKENDATA pdata [in / out] - 引擎数据包，不得修改 char *name [in / ] - 用户名称 ** **返回类型: int ** EMSUCCESS 成功 ** EMBADARG 参数错误，可能为空指针，也可能name的长度大于STRLENLOGID ** EMBADREC PDATA内部数据有问题，如签名等 ** EMFOREVERDISABLE 永久禁用 ** **其他说明: ** **历史: 日期 作者 行为 2008-5-14 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSASetUserLogin(PTTOKENRECORDDATA pdata ,char *name); /****************************************************************************** ** **函数名称: DCSHSASetTokenCodeLength ** **功能描述: 重新设置动态口令的长度，最大不超过DCSH_PRN_LEN，最小没有限制 ** 因为RFC取Long型，最大值以4字节表示，所以实际长度不可能超过10个数字 ** **参数说明: PTTOKENRECORDDATA pdata [in / out] - pdata int iLen [in / ] - 新的长度，应该不大于DCSH_PRN_LEN ** **返回类型: int ** EMSUCCESS 成功 ** EMBADARG 参数错误，可能为空指针，也可能iLen大于DCSH_PRN_LEN ** EMBADREC PDATA内部数据有问题，如签名等 ** EMFOREVERDISABLE 永久禁用 ** ** **其他说明: 建议在 4 - 8之间 ** **历史: 日期 作者 行为 2009-8-18 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSASetTokenCodeLength(PTTOKENRECORDDATA pdata , int iLen); /****************************************************************************** ** **函数名称: DCSHSAEnableToken ** **功能描述: 让已经分配的令牌启用，同时清除计数器和Next模式，必须在令牌分配之后才能启用 ** 启用操作将清除所有状态位和计数器，但是不清除重放和最后认证时间 ** **参数说明: PTTOKENDATA pdata [in / out] - 引擎数据包 char *pin [in / ] - pin，如果是NULL或者长度为0，则强制设置SYSTEMPIN ** **返回类型: int ** EMSUCCESS 设置可用成功 ** EMBADARG 参数错误，pdata可能为空指针，也可能pin长度大于MAX_PIN_LEN小于MIN_PIN_LEN ** EMBADREC PDATA内部数据有问题，如签名等 ** EMNOTASSIGNED 还没有分配用户 ** EMPINLEN pin的长度有问题，应该 4<=pinlen<=8 ** EMFOREVERDISABLE 永久禁用 ** **其他说明: 调用该函数前应该先调用DCSHSASetUserLogin ** **历史: 日期 作者 行为 2008-5-14 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAEnableToken (PTTOKENRECORDDATA pdata, char *pin); /****************************************************************************** ** **函数名称: DCSHSADisableToken ** **功能描述: 禁用一个令牌 ** **参数说明: PTTOKENDATA pdata [in / out] - 引擎数据包 ** **返回类型: int ** EMSUCCESS 设置禁用成功 ** EMBADARG 参数错误，pdata可能为空指针 ** EMBADREC PDATA内部数据有问题，如签名等 ** EMDISABLE 已经设置为禁用了 ** EMFOREVERDISABLE 永久禁用 ** ** **其他说明: 任何时候禁用令牌应该调用该函数，而不得胡乱修改 ** **历史: 日期 作者 行为 2008-5-14 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSADisableToken (PTTOKENRECORDDATA pdata); /****************************************************************************** ** **函数名称: DCSHSASetPinMaxErrors ** **功能描述: 设置或更改PIN错误的最大次数，设置时不考虑状态位 ** **参数说明: PTTOKENDATA pdata [in / out] - 引擎数据包 int iPinErrs [in / ] - 最大错误次数 ** **返回类型: int ** EMSUCCESS 设置pin成功 ** EMBADARG 参数错误，pdata可能为空指针 ** **其他说明: 在禁用之前修改最大值有作用，如果禁用后，也可以修改，但在启用后起作用 ** **历史: 日期 作者 行为 2008-5-14 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSASetPinMaxErrors (PTTOKENRECORDDATA pdata, int iPinErrs); /****************************************************************************** ** **函数名称: DCSHSASetPin ** **功能描述: 给一个已分配可用的令牌设置PIN，同时清除所有计数器和Next模式，不清除重放和时间 ** 注意，也不修改状态位，被禁用的将依然禁用 ** **参数说明: PTTOKENDATA pdata [in / out] - 引擎数据包 char *pin [in / ] - pin，如果是NULL或者长度为0，则强制设置SYSTEMPIN ** **返回类型: int ** EMSUCCESS 设置pin成功 ** EMBADARG 参数错误，pdata可能为空指针 ** EMBADREC PDATA内部数据有问题，如签名等 ** EMDISABLE 为禁用状态 ** EMPINLEN pin的长度有问题，应该 4<=pinlen<=8 ** EMFOREVERDISABLE 永久禁用 ** **其他说明: 在成功登陆后，应提供用户修改PIN的地方 ** **历史: 日期 作者 行为 2008-5-14 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSASetPin (PTTOKENRECORDDATA pdata, char *pin); /****************************************************************************** ** **函数名称: DCSHSASetPinDisabledFlag ** **功能描述: 设置是否使用PIN的标志位，1 禁用 0 启用 ** 未启用的令牌不能设置 ** **参数说明: PTTOKENDATA pdata [in / out] - 引擎数据包 int b [in / ] - 1 禁用PIN认证，0 使用PIN认证 ** **返回类型: int ** EMSUCCESS 设置Flag成功 ** EMBADARG 参数错误，pdata可能为空指针 ** EMBADREC PDATA内部数据有问题，如签名等 ** EMDISABLE 为禁用状态，不可设置 ** EMFOREVERDISABLE 永久禁用 ** ** **其他说明: 建议使用PIN认证 ** **历史: 日期 作者 行为 2008-5-14 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSASetPinDisabledFlag (PTTOKENRECORDDATA pdata,int b); /****************************************************************************** ** **函数名称: DCSHSASetNextTokencodeModeThreshold ** **功能描述: 设置tokencode错误最大值，达到这个数后，则进入next模式 ** 未启用的令牌不可设置 ** **参数说明: PTTOKENDATA pdata [in / out] - 引擎数据包 int index [in / ] - 最大tokencode错误极限值 ** **返回类型: int ** EMSUCCESS 设置Threshol成功 ** EMBADARG 参数错误，pdata可能为空指针，或者index错了(1-10之间) ** EMDISABLE 为禁用状态，不可设置 ** ** **其他说明: 现在放开了最大10的限制，可设置任意大 ** **历史: 日期 作者 行为 2008-5-14 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSASetNextTokencodeModeThreshold (PTTOKENRECORDDATA pdata, int index); /****************************************************************************** ** **函数名称: DCSHSAGetTokenInfo ** **功能描述: 获取令牌的详细信息 ** **参数说明: PTTOKENDATA pdata [in / ] - 引擎数据包 PTTOKENSECRETDATA tokenInfo [in / out] - 详细信息，外面分配空间 ** **返回类型: int ** EMSUCCESS 设置Threshol成功 ** EMBADARG 参数错误，pdata可能为空指针 ** EMBADREC PDATA内部数据有问题，如签名等 ** ** **其他说明: ** **历史: 日期 作者 行为 2008-5-14 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAGetTokenInfo (PTTOKENRECORDDATA pdata, PTTOKENPUBLICINFO tokenInfo); /****************************************************************************** ** **函数名称: DCSHSAUpdateTokenSeed ** **功能描述: 认证引擎内部创建种子，并更新pdata内的原有种子，注意，这将导致种子文件失效 更新种子后的令牌将作为全新的令牌，走Firt模式 ** **参数说明: PTTOKENRECORDDATA pdata [in / out] - pdata数据结构 int iBitLen [in / ] - 种子的位长，128或者160 char *cSeed [in / out] - 种子字符串，base64字符串，注意"==",真实长度为cSeedLen int *cSeedLen [in / out] - base64种子的字符串长度 ** **返回类型: int ** EMSUCCESS 设置种子成功 ** EMBADARG 参数错误，pdata可能为空指针 ** ** **其他说明: 动联的种子生成有严格的规则，涉及到算法和加密卡； 同时pdata结构和序列号/种子有密切关联，用于防伪； 更新种子将是的严格的规则和防伪校验失效； 另，使用者需要注意，一旦更新后，将导致种子文件BIN失效； ** **历史: 日期 作者 行为 2010-2-4 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAUpdateTokenSeed (PTTOKENRECORDDATA pdata, int iBitLen, char *cSeed, int *cSeedLen); /****************************************************************************** ** **函数名称: DCSHSACheckPasscode ** **功能描述: 动态口令认证 ** **参数说明: LONG passc_time [in / ] - DCSHSAGetPasscodeTime取得时间 PTTOKENDATA pdata [in / out] - 引擎数据包 char *prn [in / ] - tokencode char *pin [in / ] - pin ** **返回类型: int ** EMSUCCESS 验证通过，除了EMBADREC，所有的返回必须保存PDATA到数据库 ** EMBADARG 参数错误，参数可能为空指针 ** EMBADREC 严重错误！PDATA内部数据有问题，如签名等 ** EMFIRST 第一次使用令牌登陆，成功，等同于EMSUCCESS ** EMPRNLEN Tokencode的长度错误 ** EMTIMRNG passcode时间错误，不在生命期限内 ** EMNOTASSIGNED 令牌还没有分配 ** EMDISABLE 令牌处于禁用状态 ** EMFOREVERDISABLE 令牌被永久禁用，可能是时间偏移超过12小时 ** EMNOPIN 没有输入pin码 ** EMPINLEN 输入的PIN长度错误 ** EMBADPIN 输入错误的PIN ** EMSTOLEN 因为PIN错误次数到达极限，默认为丢失 ** EMOUTWIND 在任何窗口内找不到tokencode，可能需要再同步 ** EMREPPRN 这是重放，需要小心，应该立即记录，并提醒管理员 ** EMREPDISABLE 重放到一定的次数则禁用 ** EMNEXTPRN 进入Next的模式 ** EMTHRESHOLDNXT 输入tokencode的错误次数到达极限，以后进入NEXT模式 ** EMBADNEX 在Next模式下输入错了tokencode ** EMNEXTDISABLE 在Next模式下输入错误次数到达极限，被禁用 ** EMBADTYPE 错误的令牌类型 ** ** **其他说明: 最重要的认证接口，特别需要注意返回值 ** **历史: 日期 作者 行为 2008-5-15 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSACheckPasscode (ULONG passc_time, PTTOKENRECORDDATA pdata, char *prn, char *pin); /****************************************************************************** ** **函数名称: DCSHSACheckATMTokenCode ** **功能描述: ATM令牌的认证接口，需要注意用户密码的转换 ** **参数说明: ULONG passc_time [in / ] - 时间 PTTOKENRECORDDATA pdata [in / out] - pdata int iPasswdAlg [in / ] - 对用户口令的算法 char *atmpassword [in / ] - 用户口令，也可能是摘要数据 char *prn [in / ] - 动态口令 ** **返回类型: int ** EMSUCCESS 验证通过，除了EMBADREC，所有的返回必须保存PDATA到数据库 ** EMBADARG 参数错误，参数可能为空指针 ** EMBADREC 严重错误！PDATA内部数据有问题，如签名等 ** EMFIRST 第一次使用令牌登陆，成功，等同于EMSUCCESS ** EMPRNLEN Tokencode的长度错误 ** EMTIMRNG passcode时间错误，不在生命期限内 ** EMNOTASSIGNED 令牌还没有分配 ** EMDISABLE 令牌处于禁用状态 ** EMFOREVERDISABLE 令牌被永久禁用，可能是时间偏移超过12小时 ** EMNOPIN 没有输入pin码 ** EMPINLEN 输入的PIN长度错误 ** EMBADPIN 输入错误的PIN ** EMSTOLEN 因为PIN错误次数到达极限，默认为丢失 ** EMOUTWIND 在任何窗口内找不到tokencode，可能需要再同步 ** EMREPPRN 这是重放，需要小心，应该立即记录，并提醒管理员 ** EMREPDISABLE 重放到一定的次数则禁用 ** EMNEXTPRN 进入Next的模式 ** EMTHRESHOLDNXT 输入tokencode的错误次数到达极限，以后进入NEXT模式 ** EMBADNEX 在Next模式下输入错了tokencode ** EMNEXTDISABLE 在Next模式下输入错误次数到达极限，被禁用 ** EMBADTYPE 错误的令牌类型 ** ** **其他说明: ** **历史: 日期 作者 行为 2009-12-7 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSACheckATMTokenCode (ULONG passc_time, PTTOKENRECORDDATA pdata, int iPasswdAlg, char *atmpassword /*用户密码作为challenge*/, char *prn); /****************************************************************************** ** **函数名称: DCSHSACheckSIGPasscode ** **功能描述: 签名动态口令认证，外带三个关键信息，必须为数字 ** **参数说明: ULONG passc_time [in / ] - 当前系统时间 PTTOKENRECORDDATA pdata [in / out] - pdata char *key1 [in / ] - 关键信息1，建议6个数字 char *key2 [in / ] - 关键信息2，建议6个数字 char *key3 [in / ] - 关键信息3，建议6个数字 char *prn [in / ] - 动态口令 char *pin [in / ] - 令牌PIN码 ** ** **返回类型: int ** EMSUCCESS 验证通过，除了EMBADREC，所有的返回必须保存PDATA到数据库 ** EMBADARG 参数错误，参数可能为空指针 ** EMBADREC 严重错误！PDATA内部数据有问题，如签名等 ** EMFIRST 第一次使用令牌登陆，成功，等同于EMSUCCESS ** EMPRNLEN Tokencode的长度错误 ** EMTIMRNG passcode时间错误，不在生命期限内 ** EMNOTASSIGNED 令牌还没有分配 ** EMDISABLE 令牌处于禁用状态 ** EMFOREVERDISABLE 令牌被永久禁用，可能是时间偏移超过12小时 ** EMNOPIN 没有输入pin码 ** EMPINLEN 输入的PIN长度错误 ** EMBADPIN 输入错误的PIN ** EMSTOLEN 因为PIN错误次数到达极限，默认为丢失 ** EMOUTWIND 在任何窗口内找不到tokencode，可能需要再同步 ** EMREPPRN 这是重放，需要小心，应该立即记录，并提醒管理员 ** EMREPDISABLE 重放到一定的次数则禁用 ** EMNEXTPRN 进入Next的模式 ** EMTHRESHOLDNXT 输入tokencode的错误次数到达极限，以后进入NEXT模式 ** EMBADNEX 在Next模式下输入错了tokencode ** EMNEXTDISABLE 在Next模式下输入错误次数到达极限，被禁用 ** EMBADTYPE 错误的令牌类型 ** **其他说明: ** **历史: 日期 作者 行为 2009-2-12 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSACheckSIGPasscode (ULONG passc_time, PTTOKENRECORDDATA pdata, char *key1, char *key2, char *key3, char *prn, char *pin); /****************************************************************************** ** **函数名称: DCSHSAGetSIGPasscode ** **功能描述: 获取签名动态口令，内部使用 ** **参数说明: ULONG passc_time [in / ] - 系统时间 PTTOKENRECORDDATA pdata [in / ] - pdata char *key1 [in / ] - 关键信息1 char *key2 [in / ] - 关键信息2 char *key3 [in / ] - 关键信息3 char *prn [in / out] - 动态口令，外部分配空间，并初始化 ** **返回类型: int ** EMSUCCESS 验证通过，除了EMBADREC，所有的返回必须保存PDATA到数据库 ** EMBADARG 参数错误，参数可能为空指针 ** EMBADREC 严重错误！PDATA内部数据有问题，如签名等 ** EMPRNLEN Tokencode的长度错误 ** EMTIMRNG passcode时间错误，不在生命期限内 ** EMNOTASSIGNED 令牌还没有分配 ** EMDISABLE 令牌处于禁用状态 ** EMFOREVERDISABLE 令牌被永久禁用，可能是时间偏移超过12小时 ** ** **其他说明: ** **历史: 日期 作者 行为 2009-2-12 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAGetSIGPasscode (ULONG passc_time, PTTOKENRECORDDATA pdata, char *key1, char *key2, char *key3, char *prn); /****************************************************************************** ** **函数名称: DCSHSACheckUrgencyPassWord ** **功能描述: 检测紧急口令，跳过所有的状态位检测，区分大小写 ** 没有分配的令牌不允许使用紧急口令 ** **参数说明: PTTOKENDATA pdata [in / ] - PDATA char *ucUrgencyPassWord [in / ] - 紧急口令，16字符 ** **返回类型: int ** EMBADARG 参数错误 ** EMBADURGENCYPW 紧急口令认证失败 ** EMSUCCESS 紧急口令认证成功 ** **其他说明: ** **历史: 日期 作者 行为 2008-7-7 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSACheckUrgencyPassWord (PTTOKENRECORDDATA pdata, char *ucUrgencyPassWord); /****************************************************************************** ** **函数名称: DCSHSAGetUrgencyPassWord ** **功能描述: 获取紧急口令，跳过所有的状态位检测 ** **参数说明: PTTOKENDATA pdata [in / ] - PDATA char *ucUrgencyPassWord [in / out] - 紧急口令，16字符，外部分配空间 ** **返回类型: int ** EMBADARG 参数错误 ** EMBADGETURGENCYPW 紧急口令认证失败 ** EMSUCCESS 获取成功 ** **其他说明: 已经修改，在未分配的情况下也允许得到紧急口令 ** **历史: 日期 作者 行为 2008-7-7 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAGetUrgencyPassWord (PTTOKENRECORDDATA pdata, char *ucUrgencyPassWord); /****************************************************************************** ** **函数名称: DCSHSASetUrgencyPassWord ** **功能描述: 设置新的服务码，由引擎内部设置，设置成功后，返回新的服务码 ** **参数说明: PTTOKENRECORDDATA pdata [in / out] - pdata char *ucNewUrgencyPassWord [in / out] - 输出新的服务码，16个字节，建议外部分配20字节的空间 ** **返回类型: int ** DCSHEMURGPWDERR 更改服务码失败 ** DCSHEMSUCCESS 更改服务码成功 ** **其他说明: ** **历史: 日期 作者 行为 2009-10-27 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSASetUrgencyPassWord (PTTOKENRECORDDATA pdata, char *ucNewUrgencyPassWord); /****************************************************************************** ** **函数名称: DCSHSACheckTokenvalue ** **功能描述: 相当于FirstLogin,但是不修改任何数据，也不判断标志位 ** **参数说明: LONG passc_time [in / ] - 时间,DCSHSAGetPasscodeTime取得时间 PTTOKENDATA pdata [in / ] - 引擎数据包 char *prn [in / ] - tokencode ** **返回类型: int ** EMSUCCESS 检查通过 ** EMBADARG 参数错误，参数可能为空指针 ** EMBADREC 严重错误！PDATA内部数据有问题，如签名等 ** EMPRNLEN Tokencode的长度错误 ** EMTIMRNG passcode时间错误，不在生命期限内 ** EMOUTWIND 在任何窗口内找不到tokencode，可能需要再同步 ** EMBADTYPE 错误的令牌类型 ** **其他说明: ** **历史: 日期 作者 行为 2008-5-16 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSACheckTokenvalue (ULONG passc_time, PTTOKENRECORDDATA pdata, char *prn); /****************************************************************************** ** **函数名称: DCSHSAResynchTokenEx ** **功能描述: 重新同步，非常大的计算量，12小时内寻找 ** **参数说明: LONG passc_time [in / ] - 时间,DCSHSAGetPasscodeTime取得时间 PTTOKENDATA pdata [in / out] - 引擎数据包 char *prn [in / ] - tokencode ** **返回类型: int ** EMSUCCESS 重新同步 ** EMBADARG 参数错误，参数可能为空指针 ** EMBADREC 严重错误！PDATA内部数据有问题，如签名等 ** EMPRNLEN Tokencode的长度错误 ** EMTIMRNG passcode时间错误，不在生命期限内 ** EMOUTWIND 在任何窗口内找不到tokencode，可能需要再同步 ** EMSYN1OK 重新同步模式下，第一次匹配tokencode已经找到 ** EMBADTYPE 错误的令牌类型 ** **其他说明: 重新同步对“永久失效”有作用 ** **历史: 日期 作者 行为 2008-5-16 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAResynchTokenEx (ULONG passc_time, PTTOKENRECORDDATA pdata, char *prn); /****************************************************************************** ** **函数名称: DCSHSAInitBINRead ** **功能描述: 打开BIN文件，进行格式分解，返回空间和总记录数 ** **参数说明: const char *InputFile [in / ] - 文件名称 int **inpfil [in / out] - 解密的空间，使用DCSHSAExitBINRead释放 int *iRecoeds [in / out] - 总共的记录数 char *cType [in / out] - 种子文件的类型 ** **返回类型: int ** EMSUCCESS 成功 ** EMEMPNAME 文件名称错误 ** EMBADINPUT 文件无法打开 ** EMNOMEM 没有足够的内存空间 ** EMBADINPFIL BIN的文件内容错误，严重错误 ** EMBADSIG 文件签名错误，严重错误 ** EMBADFILETYPE 错误的种子文件类型 ** **其他说明: ** **历史: 日期 作者 行为 2008-5-16 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAInitBINRead (const char *InputFile, void **inpfil, unsigned int *iRecoeds, char *cType); /****************************************************************************** ** **函数名称: DCSHSAReadBINRec ** **功能描述: 从解密的数据中读取记录 ** **参数说明: char *userPriKeyPath[in / ] - 用户私要文件 void *inpfil [in / ] - 解密的数据块 PTTOKENDATA pdata [in / out] - 组装成PDATA int i [in / ] - 记录的索引号,从0开始 char cType [in / out] - 种子文件的类型 ** **返回类型: int ** EMSUCCESS 关闭成功 ** EMBADARG 错误的参数，可能是空指针 ** EMBADFILETYPE 种子文件的类型错误 ** **其他说明: ** **历史: 日期 作者 行为 2008-5-16 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAReadBINRec (char *userPriKeyPath, void *inpfil, PTTOKENRECORDDATA pdata, unsigned int i, char cType); /****************************************************************************** ** **函数名称: DCSHSAExitBINRead ** **功能描述: 清除BIN文件解密的内存空间 ** **参数说明: void *fc [in / ] - 空间地址 ** **返回类型: int ** EMSUCCESS 关闭成功 ** EMBADARG 参数错误，可能是空指针 ** ** **其他说明: 用于释放接口内部的内存空间，其他地方也可以使用 ** **历史: 日期 作者 行为 2008-5-16 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAExitBINRead (void *fc); /****************************************************************************** ** **函数名称: DCSHMakeTokenRecord -- 测试用 ** **功能描述: 手工制作一个PDATA,SDATA ** **参数说明: PTTOKENDATA pdata [in / out] - 初始化的数据 ** **返回类型: void ** [添加返回值说明] ** ** **其他说明: ** **历史: 日期 作者 行为 2008-5-17 杨波 Created ******************************************************************************/ DCSHCOREAPI_API void DCSHSAMakeTokenRecord(PTTOKENRECORDDATA pdata); /****************************************************************************** ** **函数名称: DCSHMakeTokenRecordEvent -- 测试用 ** **功能描述: 手工制作一个PDATA,SDATA ** **参数说明: PTTOKENDATA pdata [in / out] - 初始化的数据 ** **返回类型: void ** [添加返回值说明] ** ** **其他说明: ** **历史: 日期 作者 行为 2008-5-17 杨波 Created ******************************************************************************/ DCSHCOREAPI_API void DCSHSAMakeTokenRecordEvent(PTTOKENRECORDDATA pdata); /****************************************************************************** ** **函数名称: DCSHMakeTokenRecordMobile -- 测试用 ** **功能描述: 创建一个手机令牌，特指动联专用的 ** **参数说明: PTTOKENDATA pdata [in / out] - 初始化的数据 ** **返回类型: void ** [添加返回值说明] ** ** **其他说明: ** **历史: 日期 作者 行为 2011-1-11 杨波 Created ******************************************************************************/ DCSHCOREAPI_API void DCSHSAMakeTokenRecordMobile(PTTOKENRECORDDATA pdata); /****************************************************************************** ** **函数名称: DCSHSASplitBINFile ** **功能描述: 分割种子文件，支持加密格式，也支持数字信封格式 ** **参数说明: char *pSeedFile [in / ] - 种子文件路径 unsigned int iNumber [in / ] - 分割多少个出来 ** **返回类型: int ** EMREADSEEDFILEERR 读取种子文件失败 ** EMBADFILETYPE 种子文件类型错误 ** EMSUCCESS 成功 ** **其他说明: 源文件保留，创建拆分的两个文件 ** **历史: 日期 作者 行为 2008-6-12 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSASplitBINFile (char *pSeedFile, unsigned int iNumber); /****************************************************************************** ** **函数名称: DCSHSAGenerateUrgencyPassWord (16字节的紧急口令) ** **功能描述: 生成高质量的随机数，然后对该随机数进行Base64编码，截取16字节，作为紧急口令 ** **参数说明: char *ucUrgencyPassWord [in / out] - 外部分配空间，返回紧急口令字符，建议20个字节空间 ** **返回类型: int ** DCSHEMBADARG 参数错误 ** DCSHEMSEEDERR BBS计算随机数时错误，可重新尝试 ** DCSHEMSUCCESS 创建紧急口令成功 ** **其他说明: ** **历史: 日期 作者 行为 2008-7-7 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAGenerateUrgencyPassWord(char *ucUrgencyPassWord); /****************************************************************************** ** **函数名称: DCSHSAGetChallenge ** **功能描述: 产生一个指定长度的随机数作为挑战码 ** **参数说明: unsigned char *randomData [in / out] - 随机数，挑战码，外部分配空间 int iNumBytes [in / ] - 要求的随机数长度,最好是8 ** **返回类型: int ** EMBADARG 参数错误 ** EMSEEDERR 随机数产生错误 ** EMSUCCESS 成功 ** **其他说明: 增加了返回全0的判断，如果发现是0，则可以重新尝试 ** **历史: 日期 作者 行为 2008-6-23 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAGetChallenge(char *randomData, int iNumBytes); /****************************************************************************** ** **函数名称: DCSHSACheckCredential，兼容各种令牌的统一认证接口，比CheckPasscode更兼容 ** **功能描述: 兼容单一的tokencode认证 兼容PIN码+tokencode认证 兼容PIN码+tokencode认证，并且在成功后获取下一个正确的tokencode返回 兼容挑战响应模式认证 兼容SIM卡令牌 兼容COS等其他卡商的令牌 兼容ATM令牌认证 兼容刮挂卡令牌认证 兼容MS-Chap V2的认证方式 兼容短信令牌 兼容签名认证 ** **参数说明: PTTOKENDATA pdata [in / out] - 公用数据结构 PT_CODE2CHECK ptCode2Check [in / out] - 根据各种类型组装的数据结构 ** **返回类型: int ** EMSUCCESS 验证通过，除了EMBADREC，所有的返回必须保存PDATA到数据库 ** EMBADARG 参数错误，参数可能为空指针 ** EMBADREC 严重错误！PDATA内部数据有问题，如签名等 ** EMFIRST 第一次使用令牌登陆，成功，等同于EMSUCCESS ** EMPRNLEN Tokencode的长度错误 ** EMTIMRNG passcode时间错误，不在生命期限内 ** EMNOTASSIGNED 令牌还没有分配 ** EMDISABLE 令牌处于禁用状态 ** EMFOREVERDISABLE 令牌被永久禁用，可能是时间偏移超过12小时 ** EMNOPIN 没有输入pin码 ** EMPINLEN 输入的PIN长度错误 ** EMBADPIN 输入错误的PIN ** EMSTOLEN 因为PIN错误次数到达极限，默认为丢失 ** EMOUTWIND 在任何窗口内找不到tokencode，可能需要再同步 ** EMREPPRN 这是重放，需要小心，应该立即记录，并提醒管理员 ** EMREPDISABLE 重放到一定的次数则禁用 ** EMNEXTPRN 进入Next的模式 ** EMTHRESHOLDNXT 输入tokencode的错误次数到达极限，以后进入NEXT模式 ** EMBADNEX 在Next模式下输入错了tokencode ** EMNEXTDISABLE 在Next模式下输入错误次数到达极限，被禁用 ** EMBADTYPE 错误的令牌类型 ** EMRESPONSEERR 挑战认证方式认证失败 ** **其他说明: 请参考联合类型PT_DCSHCODE2CHECK详细说明 ** **历史: 日期 作者 行为 2008-6-23 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSACheckCredential (PTTOKENRECORDDATA pdata, PT_DCSHCODE2CHECK ptCode2Check); /****************************************************************************** ** **函数名称: ReadCardInfoFromFile ** **功能描述: 读取令牌刮卡信息的文件，请参考PTTOKENCARDRECORD结构体 ** **参数说明: char *CardFileName [in / ] - 文件名称 PTTOKENCARDRECORD *pTokenCardRecord [in / out] - 数据块，内部分配空间，DCSHSAExitBINRead释放 int *iCounter [in / out] - 总记录数 ** **返回类型: int ** EMSUCCESS 成功 ** EMBADARG 失败，可能参数传递错误 ** **其他说明: pTokenCardRecord的内存空间请使用DCSHSAExitBINRead释放 ** **历史: 日期 作者 行为 2008-8-5 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAReadCardInformation (char *CardFileName, PTTOKENCARDRECORD *pTokenCardRecord, int *iCounter); /****************************************************************************** ** **函数名称: DCSHSAGetSMSPasscode ** **功能描述: 获取短消息认证的动态口令，同时设置该口令的有效时间 ** **参数说明: LONG valid_time [in / ] - 有效时间，单位秒 PTTOKENDATA pdata [in / out] - 引擎数据包 char *prn [in / out] - 返回的tokencode，外部分配数组 ** **返回类型: int ** EMSUCCESS 验证通过，除了EMBADREC，所有的返回必须保存PDATA到数据库 ** EMBADARG 参数错误，参数可能为空指针 ** EMBADREC 严重错误！PDATA内部数据有问题，如签名等 ** EMTIMRNG passcode时间错误，不在生命期限内 ** EMNOTASSIGNED 令牌还没有分配 ** EMDISABLE 令牌处于禁用状态 ** EMFOREVERDISABLE 令牌被永久禁用，可能是时间偏移超过12小时 ** EMBADTYPE 错误的令牌类型 ** ** **其他说明: ** **历史: 日期 作者 行为 2008-8-15 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAGetSMSPasscode (ULONG valid_time, PTTOKENRECORDDATA pdata, char *prn); /****************************************************************************** ** **函数名称: DCSHSACheckSMSPasscode ** **功能描述: 认证短信动态口令，在有效时间内 ** **参数说明: PTTOKENDATA pdata [in / ] - 引擎数据包 char *prn [in / ] - 返回的tokencode，外部分配数组 ** **返回类型: int ** EMSUCCESS 验证通过，除了EMBADREC，所有的返回必须保存PDATA到数据库 ** EMBADARG 参数错误，参数可能为空指针 ** EMBADREC 严重错误！PDATA内部数据有问题，如签名等 ** EMTIMRNG passcode时间错误，不在生命期限内 ** EMNOTASSIGNED 令牌还没有分配 ** EMDISABLE 令牌处于禁用状态 ** EMFOREVERDISABLE 令牌被永久禁用，可能是时间偏移超过12小时 ** EMSMSTIMEOUT 超时，但口令正确 ** EMSMSBADPRN 口令错误 ** **其他说明: ** **历史: 日期 作者 行为 2008-8-15 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSACheckSMSPasscode (PTTOKENRECORDDATA pdata, char *prn); /****************************************************************************** ** **函数名称: DCSHSACheckPasscodeEx，建议使用DCSHSACheckCredential方法 ** **功能描述: 这是一个简便的认证接口，根据组合方式，也可以进行认证 扩展的、统一的认证接口 如果是 时间、事件、手机 认证，则 prn=tokencode,NULL,0 如果是 异步认证（如手机）， 则 prn=response,challenge=challenge,0 如果是短信认证，获得动态口令，则 prn=外部数组,NULL,valid_time=有效时间（秒） 认证动态口令，则 prn=tokencode,NULL,0 如果是ATM令牌，需要传递算法， 则 prn=动态口令,challenge=挑战码（用户口令，也可能使摘要）,valid_time=算法（ALGORITHM_ATM/MD5/SH1） 如果是刮刮卡令牌，只进行认证，则 prn=动态口令,challenge=主机码,valid_time=0） ** **参数说明: PTTOKENRECORDDATA pdata [in / out] - 引擎数据包 char *prn [in / out] - 根据要求存放tokencode，或者响应码，或者返回值，参考上访说明 char *challenge [in / ] - 异步模式，则为挑战码，参考上访说明 ULONG valid_time [in / ] - 获得短信口令，存放有效时间，秒，参考上访说明 ** **返回类型: int ** ** EMBADARG 参数错误，参数可能为空指针 ** EMTOKENTYPE 错误的令牌应用类型 ** ** **其他说明: 注意，本接口不支持带PIN的认证 ** **历史: 日期 作者 行为 2008-9-3 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSACheckPasscodeEx (PTTOKENRECORDDATA pdata, char *prn, char *challenge, ULONG valid_time); /****************************************************************************** ** **函数名称: DCSHSAMsChap2CheckAndMakeResponse ** **功能描述: MS CHAP V2，对客户端提交的nt_response进行认证 请查看DCSHMSCHAP2_PASSCODE结构，请查看RFC2759 引擎支持MS CHAP v2，但引擎内除了PIN和动态口令，没有用户名、服务端挑战码、客户端挑战码等 所以，要求调用该接口的时候必须送入 返回的AuthenticatorResponse是这样的格式“S=0123456789ABCDEF0123456789ABCDEF01234567” ** **参数说明: DCSHMSCHAP2_PASSCODE *pDCSHMSCHAP2Block [in / out] - 结构内包含了MS Chap V2的各个字段，AuthenticatorResponse由该函数生成 char *cMsChap2Password [in / ] - 口令，注意： 如果启用PIN，则口令应该为“动态口令+PIN码“ 如果不启用PIN，则口令就是”动态口令“ 注意，用户应用也应该如此编排 ** **返回类型: int ** DCSHEMBADARG 参数错误 ** DCSHEMMSCHAPV2ERROR mschapv2认证客户端提交的响应码错误 ** DCSHEMSUCCESS 成功 ** **其他说明: ** **历史: 日期 作者 行为 2009-2-5 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAMsChap2CheckAndMakeResponse(DCSHMSCHAP2_PASSCODE *pDCSHMSCHAP2Block, char *cMsChap2Password); /****************************************************************************** ** **函数名称: DCSHSACheckPasscodeMsChap2 ** **功能描述: ** **参数说明: LONG passc_time [in / ] - DCSHSAGetPasscodeTime取得时间 PTTOKENDATA pdata [in / out] - 引擎数据包 unsigned char *pMsChap2Block[in / out] - DCSHMSCHAP2_PASSCODE类型的block ** **返回类型: int ** EMSUCCESS 验证通过，除了EMBADREC，所有的返回必须保存PDATA到数据库 ** EMBADARG 参数错误，参数可能为空指针 ** EMBADREC 严重错误！PDATA内部数据有问题，如签名等 ** EMFIRST 第一次使用令牌登陆，成功，等同于EMSUCCESS ** EMPRNLEN Tokencode的长度错误 ** EMTIMRNG passcode时间错误，不在生命期限内 ** EMNOTASSIGNED 令牌还没有分配 ** EMDISABLE 令牌处于禁用状态 ** EMFOREVERDISABLE 令牌被永久禁用，可能是时间偏移超过12小时 ** EMNOPIN 没有输入pin码 ** EMPINLEN 输入的PIN长度错误 ** EMBADPIN 输入错误的PIN ** EMSTOLEN 因为PIN错误次数到达极限，默认为丢失 ** EMOUTWIND 在任何窗口内找不到tokencode，可能需要再同步 ** EMREPPRN 这是重放，需要小心，应该立即记录，并提醒管理员 ** EMREPDISABLE 重放到一定的次数则禁用 ** EMNEXTPRN 进入Next的模式 ** EMTHRESHOLDNXT 输入tokencode的错误次数到达极限，以后进入NEXT模式 ** EMBADNEX 在Next模式下输入错了tokencode ** EMNEXTDISABLE 在Next模式下输入错误次数到达极限，被禁用 ** EMBADTYPE 错误的令牌类型 ** ** **其他说明: ms-chap v2的认证方式是得不到用户的PIN码和动态口令的 于是，我们必须从引擎中得到这些，然后逆过程计算响应码，进行比较 此时，我们就会发现无法检测重放 对于这个问题，我们只能恰当的判断： 1、我们总是记住最后4次正确的tokencode 2、如果这次验证和历史的tokencode相同，则认为重放 3、如果在窗口内扫描，一旦发现与历史tokencode相同，则跳过 ** **历史: 日期 作者 行为 2008-5-15 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSACheckPasscodeMsChap2 (ULONG passc_time, PTTOKENRECORDDATA pdata, unsigned char *pMsChap2Block/*DCSHMSCHAP2_PASSCODE类型的block*/); /****************************************************************************** ** **函数名称: DCSHSAMsChap2ChangePassword ** **功能描述: MS CHAP V2，解密得到新口令，并验证新口令 请查看DCSHMSCHAP2_CHANGE_PW结构，请查看RFC2759 修改口令之前先要完成认证 认证通过后再解密新口令，并且验证新口令是否正确 返回的AuthenticatorResponse是这样的格式“S=0123456789ABCDEF0123456789ABCDEF01234567” ** **参数说明: DCSHMSCHAP2_CHANGE_PW *pDCSHMSCHAP2Blockpw[in / ] - 结构内包含了MS Chap V2的各个字段，AuthenticatorResponse由该函数生成 char *oldPinAndTokencode [in / ] - 口令，注意： 如果启用PIN，则口令应该为“动态口令+PIN码“ 如果不启用PIN，则口令就是”动态口令“ 注意，用户应用也应该如此编排 ** char *newpin [in / out] - 新口令 **返回类型: int ** DCSHEMBADARG 参数错误 ** DCSHEMMSCHAPV2ERRORPW mschapv2客户端提交的新口令校验异常 ** DCSHEMSUCCESS 成功 ** **其他说明: ** **历史: 日期 作者 行为 2009-2-5 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAMsChap2ChangePassword(DCSHMSCHAP2_CHANGE_PW *pMsChap2Blockpw, char *oldPinAndTokencode, char *newpin); /****************************************************************************** ** **函数名称: DCSHSAChangePINCodeMsChap2 ** **功能描述: ms chap v2 更改口令 ** **参数说明: ULONG passc_time [in / ] - DCSHSAGetPasscodeTime取得时间 PTTOKENRECORDDATA pdata [in / ] - 引擎数据包 unsigned char *pMsChap2Blockpw [in / out] - 参考DCSHMSCHAP2_CHANGE_PW结构，将返回authenticatorResponse ** **返回类型: int ** DCSHEMBADARG 参数错误 ** DCSHEMSUCCESS 成功 ** **其他说明: ** **历史: 日期 作者 行为 2009-2-5 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAChangePINCodeMsChap2 (ULONG passc_time, PTTOKENRECORDDATA pdata, unsigned char *pMsChap2Blockpw/*DCSHMSCHAP2_CHANGE_PW类型的block*/); /****************************************************************************** ** **函数名称: DCSHSAForceSynchronizeEventCounter ** **功能描述: 强制同步事件型令牌的计数器 ** 在某种情况下，需要获得服务端当前的计数器，然后累加一个常量，作为强制的同步的参数，要求客户端强制修改计数器等于这个参数 ** **参数说明: PTTOKENRECORDDATA pdata [in / out] - 引擎数据包 unsigned int CounterAdd [in / ] - 一个常量，建议大于100小于1000； unsigned int *SrvCounter [in / out] - 设置当前令牌的计数器的值，并且返回该值 ** **返回类型: int ** DCSHEMBADARG 参数错误 ** DCSHEMFORCESYNTYPE 强制同步令牌类型错误，不是事件型 ** DCSHEMSUCCESS 成功 ** **其他说明: ** **历史: 日期 作者 行为 2009-6-22 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAForceSynchronizeEventCounter(PTTOKENRECORDDATA pdata, unsigned int CounterAdd, unsigned int *SrvCounter ); /****************************************************************************** ** **函数名称: DCSHSAForceSynchronizeEventCounterReverse ** **功能描述: 根据客户端的计数器强制同步服务器中计数器 计数器更改的时候，不允许服务器的计数器往小修改，客户端提交的计数器必须大于服务器的计数器 ** **参数说明: PTTOKENRECORDDATA pdata [in / out] - 引擎数据包 unsigned int ClientCounter [in / ] - 客户端的计数器 ** **返回类型: int ** DCSHEMBADARG 参数错误 ** DCSHEMFORCESYNTYPE 强制同步令牌类型错误，不是事件型 ** DCSHEMFORCECOUNTERLESS 不允许使用客户端的小值修改服务端的大值 ** DCSHEMSUCCESS 成功 ** ** **其他说明: ** **历史: 日期 作者 行为 2010-1-27 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAForceSynchronizeEventCounterReverse(PTTOKENRECORDDATA pdata, unsigned int ClientCounter ); /****************************************************************************** ** **函数名称: DCSHSAUnlockPinpadToken ** **功能描述: 输出K8锁定的解锁码，带pad的令牌在多次输入pin失败后会锁定，此时提供屏幕的数字和序列号，可到服务端进行“获取解锁码” ** **参数说明: PTTOKENRECORDDATA pdata [in / ] - 引擎数据包 char *cChallenge [in / ] - 令牌锁定后，屏幕上的8位数字 char *cUnLockCode [in / out] - 解锁码，8位数字 ** **返回类型: int ** DCSHEMBADARG 参数错误 ** DCSHEMSUCCESS 成功 ** ** **其他说明: ** **历史: 日期 作者 行为 2009-7-29 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAUnlockPinpadToken(PTTOKENRECORDDATA pdata, char *cChallenge, char *cUnLockCode); /* 基本的两大类型：[时间型Time] [事件型Event（手机令牌是事件型）] 基本的两种介质：[硬件（SIM卡是硬件）] [软件（手机上的是软件）] 动联的令牌种类：[普通令牌K5旧 K3新] [短信令牌] [手机令牌] [软件令牌] 令牌的应用模式：[普通认证模式] [主机认证模式] [挑战应答模式] [数字签名模式] [MSChapV2模式] 每个模式都有自己的认证接口 上面的关系是层层叠加的，动联的K8令牌就是时间型的硬件K3令牌，同时支持了挑战应答和数字签名模式 举例：短信令牌可以是时间类型的，也可以是事件类型的 短信令牌传统意义上是软件介质，如果要认为硬件的，也可以 短信令牌的应用模式是获取再认证，这个就等同于普通认证模式 短信令牌也可以支持其他模式，只要调用接口就可以 就如同K5令牌完全可以支持数字签名模式，只不过K5没有键盘而已 这个举例说明四层结构都是层层叠加方式的，最终应用以接口调用和实际令牌决定 */ /****************************************************************************** ** **函数名称: DCSHSAGetCoverHostCode ** **功能描述: 获得当前的计数器对应的主机字符和动态口令，返回主机字符和当前使用的次数 ** **参数说明: ULONG passc_time [in / ] - 系统时间 PTTOKENRECORDDATA pdata [in / ] - pdata char *cHostCode [in / out] - 主机字符，外部分配空间 int *iCurrentUseCount [in / out] - 当前使用的次数 ** **返回类型: int ** DCSHEMBADARG 参数错误 ** DCSHEMNOTCOVERTYPE 不是刮刮卡类型的令牌 ** DCSHEMOVERCOVERNUM 达到最大值，刮刮卡可能是用到最后一个了 ** DCSHEMSUCCESS 成功 ** **其他说明: ** **历史: 日期 作者 行为 2009-8-14 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAGetCoverHostCode (ULONG passc_time, PTTOKENRECORDDATA pdata, char *cHostCode, int *iCurrentUseCount); /****************************************************************************** ** **函数名称: DCSHSACheckCoverTokenCode ** **功能描述: 认证覆盖区的动态口令，需要传递主机字符和动态口令，如果启用了PIN，还需要传递PIN ** **参数说明: ULONG passc_time [in / ] - 当前系统时间 PTTOKENRECORDDATA pdata [in / out] - pdata char *cHostCode [in / ] - 主机字符 char *cTokenCode [in / ] - 覆盖区动态口令 char *pin [in / ] - pin码 ** **返回类型: int ** DCSHEMBADARG 参数错误 ** DCSHEMNOTCOVERTYPE 不是刮刮卡类型 ** DCSHEMMUSTGETCOVER 认证之前应该获得主机字符 ** DCSHEMOVERCOVERNUM 不认证最大值和以后的 ** DCSHEMHOSTCODEERRO 主机字符错误 ** DCSHEMERRORTODISABLE 动态口令错误太多次，被禁用 ** DCSHEMCOVERCODEERR 覆盖区动态口令错误 ** DCSHEMSUCCESS 认证通过 ** **其他说明: ** **历史: 日期 作者 行为 2009-8-14 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSACheckCoverTokenCode (ULONG passc_time, PTTOKENRECORDDATA pdata, char *cHostCode, char *cTokenCode, char *pin); /****************************************************************************** ** **函数名称: DCSHSAUpdateNewCoverCard ** **功能描述: ** **参数说明: ULONG passc_time [in / ] - 系统时间 PTTOKENRECORDDATA pdataO [in / out] - 旧卡pdata char *cHostCodeO [in / ] - 主机字符 char *cTokenCodeO [in / ] - 动态口令 char *pinO [in / ] - pin PTTOKENRECORDDATA pdataN [in / out] - 新卡pdata char *cHostCodeN [in / ] - 主机字符 char *cTokenCodeN [in / ] - 动态口令 char *pinN [in / ] - pin ** **返回类型: int ** DCSHEMBADARG 参数错误 ** DCSHEMNOTCOVERTYPE 不是刮刮卡类型 ** DCSHEMMUSTGETCOVER 认证之前应该获得主机字符 ** DCSHEMOVERCOVERNUM 不认证最大值和以后的 ** DCSHEMHOSTCODEERRO 主机字符错误 ** DCSHEMERRORTODISABLE 动态口令错误太多次，被禁用 ** DCSHEMCOVERCODEERR 覆盖区动态口令错误 ** DCSHEMSUCCESS 认证通过，可以更新 ** ** **其他说明: ** **历史: 日期 作者 行为 2009-8-16 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAUpdateNewCoverCard (ULONG passc_time, PTTOKENRECORDDATA pdataO, char *cHostCodeO, char *cTokenCodeO, char *pinO, PTTOKENRECORDDATA pdataN, char *cHostCodeN, char *cTokenCodeN, char *pinN); /****************************************************************************** ** **函数名称: DCSHSAXORStringTo8Char ** **功能描述: 把字符串通过异或转化为8字节，原则是8字节分组，对应的位置异或 ** **参数说明: const char *cBuffer [in / ] - 原始字符串，长度不限 unsigned char *cDDWBUffer [in / out] - 输出的8字节，必须外部提供8字节空间，且初始化0 ** **返回类型: int ** EMBADARG 参数错误，参数可能是空指针，或者算法值不对 ** EMSUCCESS 成功 ** ** **其他说明: ** 小于等于8字节的字符串则直接copy ** **历史: 日期 作者 行为 2009-12-8 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAXORStringTo8Char (const char *cBuffer, unsigned char *cDDWBUffer); //---------------------------------客户订制的开发接口------------------------------------// /****************************************************************************** ** **函数名称: DCSHSACheckPasscode_for_hexin ** **功能描述: 专门为核心定制的认证接口 该接口中，返回值DCSHEMSUCCESS和DCSHEMFIRST是正确的，其他的统统的认为是错误 返回值同时返回偏移量的变化和update的建议，其中： DCSHEMFIRST返回值必须update； DCSHEMSUCCESS时，我们认为offset变化了就应该update,但决定权由核心控制；但是注意，当iAdjustStep接近小窗口最大值时，必须update; ** **参数说明: LONG passc_time [in / ] - DCSHSAGetPasscodeTime取得时间 PTTOKENDATA pdata [in / out] - 引擎数据包 char *prn [in / ] - tokencode char *pin [in / ] - pin int *iAdjustStep [in / out] - 此次认证调整的偏移量，可能是0，也可能是正数，也可能是负数 int *iAdviseUpdate [in / out] - 动联建议是否Update，0-表示不需要，1-表示需要 ** **返回类型: int ** EMSUCCESS 验证通过，除了EMBADREC，所有的返回必须保存PDATA到数据库 ** EMFIRST 第一次使用令牌登陆，成功，等同于EMSUCCESS ** 其他值统统认为失败 ** DCSHSACheckPasscode的返回值相同。 ** ** **其他说明: ** **历史: 日期 作者 行为 2010-1-4 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSACheckPasscode_for_hexin (ULONG passc_time, PTTOKENRECORDDATA pdata, char *prn, char *pin, int *iAdjustStep, int *iAdviseUpdate); /****************************************************************************** ** **函数名称: DCSHSAModifyTokenDataWindow ** **功能描述: 修改种子数据的认证窗口 ** 建议： 1、券商、游戏 设置成为 时间型（120，300，600），事件型（2，5，10） 2、银行、企业 设置成为 时间型（60，180，300），事件型（ 1，3，5） ** ** 该操作会清除所有状态位和认证模式 **参数说明: PTTOKENRECORDDATA pdata [in / out] - pdata，种子数据 int iSmallWindowSeconds [in / ] - 新的小窗口 int iMediumWindowSeconds [in / ] - 新的中窗口 int iLargeWindowSeconds [in / ] - 新的大窗口 ** **返回类型: int ** EMSUCCESS 修改成功，必须返回必须保存PDATA到数据库 ** 其他的返回值都是失败 ** **其他说明: 该接口属于逼迫得以使用，客户在订购令牌时，应该预先向厂商提出令牌的详细策略需求。 ** **历史: 日期 作者 行为 2010-8-4 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAModifyTokenDataWindow (PTTOKENRECORDDATA pdata, int iSmallWindowSeconds, int iMediumWindowSeconds, int iLargeWindowSeconds); /****************************************************************************** ** **函数名称: DCSHSACheckPasscode_for_City9 ** **功能描述: 专门为九城定制的认证接口 该接口中，返回值DCSHEMSUCCESS和DCSHEMFIRST是正确的，其他的统统的认为是错误 返回值同时返回偏移量的变化和update的建议，其中： DCSHEMFIRST返回值必须update； DCSHEMSUCCESS时，我们认为offset变化了就应该update,但决定权由九城控制；但是注意，当iAdjustStep接近小窗口最大值时，必须update; ** **参数说明: char *pdataBase64 [in / out] - 引擎数据包的base64字符串 char *prn [in / ] - tokencode char *pin [in / ] - pin int *iAdjustStep [in / out] - 此次认证调整的偏移量，可能是0，也可能是正数，也可能是负数 int *iAdviseUpdate [in / out] - 动联建议是否Update，0-表示不需要，1-表示需要 ** **返回类型: int ** EMSUCCESS 验证通过，除了EMBADREC，所有的返回必须保存PDATA到数据库 ** EMFIRST 第一次使用令牌登陆，成功，等同于EMSUCCESS ** 其他值统统认为失败 ** DCSHSACheckPasscode的返回值相同。 ** ** **其他说明: ** 内部调用了取系统UTC时间 ** 内部对状态位进行了重置操作 ** 为了降低客户应用的数据库操作，提供了Update数据库的建议 ** 如果外部用户有错误锁定操作，所有非正确返回值都可以不保存数据库 ** **历史: 日期 作者 行为 2010-1-24 杨波 Created 2010-6-24 杨波 对pdata的数据进行了Base64转换 ******************************************************************************/ DCSHCOREAPI_API int DCSHSACheckPasscode_for_City9 ( char *pdataBase64, char *prn, char *pin, int *iAdjustStep, int *iAdviseUpdate); /****************************************************************************** ** **函数名称: DCSHSAInitPdata_for_City9 ** **功能描述: 为9城定制的种子数据初始化的接口，其功能就是 分配/启用/禁用PIN ** **参数说明: char *pdataBase64 [in / out] - 引擎数据包的base64字符串 ** **返回类型: ** EMBADARG 参数错误，参数可能是空指针，或者算法值不对 ** EMSUCCESS 成功 ** ** **其他说明: ** **历史: 日期 作者 行为 2010-1-25 杨波 Created 2010-6-24 杨波 对pdata的数据进行了Base64转换 ******************************************************************************/ DCSHCOREAPI_API int DCSHSAInitPdata_for_City9 ( char *pdataBase64); /****************************************************************************** ** **函数名称: DCSHSAResynchTokenEx_for_City9 ** **功能描述: 为9城定制的重新同步接口 ** **参数说明: char *pdataBase64 [in / out] - 引擎数据包的base64字符串 char *prn1 [in / ] - 第一个动态口令 char *prn2 [in / ] - 连续的第二个动态口令 ** **返回类型: int ** DCSHEMBADARG 参数错误 ** DCSHEMSUCCESS 同步成功 ** 其它值参考返回信息列表 ** ** **其他说明: 只有当返回DCSHEMSUCCESS时，才需要Update数据库 ** **历史: 日期 作者 行为 2010-8-12 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAResynchTokenEx_for_City9(char *pdataBase64, char *prn1, char *prn2); /****************************************************************************** ** **函数名称: DCSHSAGetCustomTokenPasscode ** **功能描述: 获取定制类型令牌的认证的动态口令，用于DCSH_HARDWARE_TOKEN_GET类型的令牌 目前为恒生定制接口， 将来会增加策略控制，如时间不会回逆获取 注意，一旦获取动态口令后，该动态口令不可用于动联系统认证 First获取后，将设置为Normal，当作第一次已经被使用 Normal获取后依然是Normal Next/Next2获取后，还原成Normal ** **参数说明: LONG passc_time [in / ] - DCSHSAGetPasscodeTime取得时间 char *pdatabase64 [in / out] - 引擎数据包的base64字符串 char *prn [in / out] - 返回的tokencode，外部分配数组 ** **返回类型: int ** EMSUCCESS 验证通过，除了EMBADREC，所有的返回必须保存PDATA到数据库 ** EMBADARG 参数错误，参数可能为空指针 ** EMBADREC 严重错误！PDATA内部数据有问题，如签名等 ** EMTIMRNG passcode时间错误，不在生命期限内 ** EMNOTASSIGNED 令牌还没有分配 ** EMDISABLE 令牌处于禁用状态 ** EMFOREVERDISABLE 令牌被永久禁用，可能是时间偏移超过12小时 ** EMBADTYPE 错误的令牌类型 ** ** **其他说明: 建议每一次获得动态口令后都应该保存pdatabase64，如果对性能有要求，也可以不保存 ** **历史: 日期 作者 行为 2010-3-28 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAGetCustomTokenPasscode (ULONG passc_time, char *pdataBase64, char *prn); /****************************************************************************** ** **函数名称: DCSHSABase64Encode ** **功能描述: 对二进制流进行编码，形成可见字符 ** **参数说明: unsigned char * binaryDataPtr [in / ] - 二进制流 int binaryDataLength [in / ] - 二进制流长度 char * stringData [in / out] - 可见字符串，外部分配空间 int *stringDataLength [in / out] - 可见字符串长度 ** **返回类型: int ** DCSHEMSUCCESS 成功 ** DCSHEMBASE64CODEERR 失败 ** **其他说明: ** **历史: 日期 作者 行为 2009-8-19 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSABase64Encode( unsigned char * binaryDataPtr, int binaryDataLength, char * stringData ,int *stringDataLength ); /****************************************************************************** ** **函数名称: DCSHSABase64Decode ** **功能描述: 对base64编码进行解码，获得二进制流 ** **参数说明: char * stringData [in / ] - 可见字符串 int stringDataLen [in / ] - 可见字符串长度 unsigned char * binaryDataPtr [in / out] - 二进制流，外部分配空间 int * binaryDataLength [in / out] - 二进制流的长度 ** **返回类型: int ** DCSHEMSUCCESS 成功 ** DCSHEMBASE64CODEERR 失败 ** ** ** **其他说明: ** **历史: 日期 作者 行为 2009-8-19 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSABase64Decode( char * stringData, int stringDataLen, unsigned char * binaryDataPtr, int * binaryDataLength ); /****************************************************************************** ** **函数名称: DCSHSAUpdateNewSeedForICBC ** **功能描述: 更新种子数据，工行使用了身份证码的数字与种子重新异或后，得到新的种子 ** **参数说明: PTTOKENRECORDDATA pdata [in / out] - 种子数据 char *cID [in / ] - 异或的数字，应该是9byte ** **返回类型: int ** DCSHEMBADARG 参数错误 ** DCSHEMICBCHAVEXOR 已经异或过了 ** DCSHEMSUCCESS 成功 **其他说明: ** **历史: 日期 作者 行为 2010-11-19 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAUpdateNewSeedForICBC(PTTOKENRECORDDATA pdata, char *cID ); /****************************************************************************** ** **函数名称: DCSHSAICBCActiveUnlockAlg ** **功能描述: 工行令牌的种子二次变形算法和令牌解锁算法 ** **参数说明: BYTE *bSeed [in / ] - 种子，变形之前为老种子，变形之后为新种子，20字节 int iSeedLen [in / ] - 种子长度，工行固定为20字节，固定为20 char *cChallengeCode [in / ] - 挑战码，变形时为激活码6数字，后补0x00,0x00，解锁时为解锁码8数字 int iChallengeCodeLen [in / ] - 挑战码的长度，固定为8 char *cResponseCode [in / out] - 响应码，即校验码或者解锁码，外部分配空间 int iResponseCodeLen [in / ] - 响应码长度，固定为6 ** **返回类型: int ** DCSHEMBADARG 参数送入了空指针 ** DCSHEMSEEDLENERR 种子长度错误 ** DCSHEMCHECKLENERR 指定的响应码长度错误 ** DCSHEMACTIVELENERR 挑战码的长度错误 ** DCSHEMSUCCESS 成功 ** **其他说明: 建议对Msg的数据长度补齐8Byte ** **历史: 日期 作者 行为 2010-12-22 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAICBCActiveUnlockAlg( BYTE *bSeed, int iSeedLen, char *cChallengeCode, int iChallengeCodeLen, char *cResponseCode, int iResponseCodeLen ); /****************************************************************************** ** **函数名称: DCSHSAICBCGenerateNewSeedAlg ** **功能描述: 工行令牌变形得到新种子算法，需要输入激活码和校验码 ** **参数说明: BYTE *bSeed [in / ] - 种子数据，20字节 int iSeedLen [in / ] - 种子长度，20 char *cChallengeCode [in / ] - 激活码，激活码为6个数字，输入时后补0x00,0x00 int iChallengeCodeLen [in / ] - 激活码的长度，8 char *cResponseCode [in / ] - 校验码，6数字字符 int iResponseCodeLen [in / ] - 校验码的长度6 BYTE *bNewSeed [in / out] - 新的种子，外部分配空间，至少20字节 int *iNewSeedLen [in / out] - 新种子长度，20 ** **返回类型: int ** DCSHEMBADARG 参数送入了空指针 ** DCSHEMSEEDLENERR 种子长度错误 ** DCSHEMCHECKLENERR 指定的响应码长度错误 ** DCSHEMACTIVELENERR 挑战码的长度错误 ** DCSHEMACTIVCHECKERR 激活码校验失败，不进行变形 ** DCSHEMSUCCESS 成功 ** **其他说明: ** **历史: 日期 作者 行为 2010-12-22 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAICBCGenerateNewSeedAlg( BYTE *bSeed, int iSeedLen, char *cChallengeCode, int iChallengeCodeLen, char *cResponseCode, int iResponseCodeLen , BYTE *bNewSeed, int *iNewSeedLen); /****************************************************************************** ** **函数名称: DCSHSAICBCTimeTokeAlg ** **功能描述: 工行的时间型动态口令算法 ** **参数说明: BYTE *bSeed [in / ] - 种子，20字节 int iSeedLen [in / ] - 种子长度，20 BYTE *bTokenTime [in / ] - 时间数据，注意大头字序，8字节 int iTokenTimeLen [in / ] - 时间数据长度，固定为8 char *cTokenCode [in / out] - 动态口令，6数字字符，外部分配空间 int iTokenCodeLen [in / ] - 动态口令长度，固定为6 ** **返回类型: int ** DCSHEMBADARG 参数送入了空指针 ** DCSHEMSEEDLENERR 种子长度错误 ** DCSHEMPRNLEN 动态口令长度错误 ** DCSHEMBIGTIMELENERR 大头字序的时间长度错误 ** DCSHEMSUCCESS 成功 ** **其他说明: ** **历史: 日期 作者 行为 2010-12-22 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAICBCTimeTokeAlg( BYTE *bSeed, int iSeedLen, BYTE *bTokenTime, int iTokenTimeLen, char *cTokenCode, int iTokenCodeLen ); /****************************************************************************** ** **函数名称: DCSHSAICBCChallengeResponseAlg ** **功能描述: 工行的时间挑战应答型动态口令算法 ** **参数说明: BYTE *bSeed [in / ] - 种子，20字节 int iSeedLen [in / ] - 种子长度，20 BYTE *bTokenTime [in / ] - 时间数据，大头字序，8字节 int iTokenTimeLen [in / ] - 时间长度，固定为8 char *cResponse [in / ] - 挑战问题，字符串 unsigned int iResponseLen [in / ] - 最大长度64 char *cTokenCode [in / out] - 动态口令，6数字字符，外部分配空间 int iTokenCodeLen [in / ] - 动态口令长度，固定为6 ** **返回类型: int ** DCSHEMBADARG 参数送入了空指针 ** DCSHEMSEEDLENERR 种子长度错误 ** DCSHEMPRNLEN 动态口令长度错误 ** DCSHEMBIGTIMELENERR 大头字序的时间长度错误 ** DCSHEMCHANLENERR 挑战问题的的长度大于64，错误 ** DCSHEMSUCCESS 成功 ** **其他说明: ** **历史: 日期 作者 行为 2010-12-22 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAICBCChallengeResponseAlg( BYTE *bSeed, int iSeedLen, BYTE *bTokenTime, int iTokenTimeLen, char *cResponse, unsigned int iResponseLen, char *cTokenCode, int iTokenCodeLen ); /****************************************************************************** ** **函数名称: DCSHSAICBCPinLockedAlg ** **功能描述: 工行令牌的PIN输入错误的锁定码产生算法 ** **参数说明: BYTE *bSeed [in / ] - 种子数据，20字节 int iSeedLen [in / ] - 种子长度，20 BYTE *bTokenTime [in / ] - 时间数据，大头字序，8字节 int iTokenTimeLen [in / ] - 时间数据长度，8 char *cPin [in / ] - 令牌的PIN码，6数字字符,后补0x00,0x00 unsigned int iPinLen [in / ] - PIN码长度，8 char *cPinLockedCode [in / out] - 令牌的锁定码，8数字字符 int iPinLockedCodeLen [in / ] - 锁定码长度，8 ** **返回类型: int ** DCSHEMBADARG 参数送入了空指针 ** DCSHEMSEEDLENERR 种子长度错误 ** DCSHEMPRNLEN 动态口令长度错误 ** DCSHEMBIGTIMELENERR 大头字序的时间长度错误 ** DCSHEMCHANLENERR 挑战问题的的长度大于64，错误 ** DCSHEMPINLEN Pin码长度错误 ** DCSHENUNLOCKPINERR 令牌解锁码的字符串长度错误，8数字 ** DCSHEMSUCCESS 成功 ** ** **其他说明: ** **历史: 日期 作者 行为 2010-12-22 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAICBCPinLockedAlg( BYTE *bSeed, int iSeedLen, BYTE *bTokenTime, int iTokenTimeLen, char *cPin, unsigned int iPinLen, char *cPinLockedCode, int iPinLockedCodeLen ); /****************************************************************************** ** **函数名称: DCSHSAConvertICBCTokenSeed ** **功能描述: 第一次使用时转换原始的种子数据 ** **参数说明: PTTOKENRECORDDATA pdata [in / out] - pdata数据 char *cActiveCode [in / ] - 激活码，12个数字 ** **返回类型: int ** DCSHEMBADARG 参数送入了空指针 ** DCSHEMSEEDLENERR 种子长度错误 ** DCSHEMPRNLEN 动态口令长度错误 ** DCSHEMBIGTIMELENERR 大头字序的时间长度错误 ** DCSHEMCHANLENERR 挑战问题的的长度大于64，错误 ** DCSHEMPINLEN Pin码长度错误 ** DCSHENUNLOCKPINERR 令牌解锁码的字符串长度错误，8数字 ** DCSHEMSUCCESS 成功** ** **其他说明: 激活码被保存在ucUserLastName中 原始种子被保存在ucUserFirstName种 ** **历史: 日期 作者 行为 2011-1-11 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAConvertICBCTokenSeed(PTTOKENRECORDDATA pdata, char *cActiveCode ); /****************************************************************************** ** **函数名称: DCSHSAGetICBCActiveCode ** **功能描述: 转换之前获得激活码，12个数字 ** **参数说明: PTTOKENRECORDDATA pdata [in / ] - pdata char *cActiveCode [in / out] - 令牌激活码，12个数字，外部应送入12以上的空间 ** **返回类型: int ** DCSHEMBADARG 参数送入了空指针 ** DCSHEMSEEDLENERR 种子长度错误 ** DCSHEMPRNLEN 动态口令长度错误 ** DCSHEMBIGTIMELENERR 大头字序的时间长度错误 ** DCSHEMCHANLENERR 挑战问题的的长度大于64，错误 ** DCSHEMPINLEN Pin码长度错误 ** DCSHENUNLOCKPINERR 令牌解锁码的字符串长度错误，8数字 ** DCSHEMSUCCESS 成功 ** ** **其他说明: ** **历史: 日期 作者 行为 2011-1-11 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAGetICBCActiveCode(PTTOKENRECORDDATA pdata, char *cActiveCode ); /****************************************************************************** ** **函数名称: SM3 ** **功能描述: 国密刚公开的SM3算法 ** **参数说明: unsigned char *Block [in / ] - SM3的单个块运算 unsigned int ulBlock [in / ] - 单个块长度，固定为64 unsigned char *bSM3HashValue [in / out] - SM3摘要 ** **返回类型: int ** ** ** **其他说明: ** **历史: 日期 作者 行为 2011-1-10 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSASM3(unsigned char *Block, unsigned int ulBlock, unsigned char *bSM3HashValue); /****************************************************************************** ** **函数名称: TestCreateTimeTokencodeRange -- 测试专用 ** **功能描述: 创建一段时间范围内的动态口令 ** **参数说明: PTTOKENRECORDDATA pdata [in / out] - ** **返回类型: void ** [添加返回值说明] ** ** **其他说明: ** **历史: 日期 作者 行为 2011-1-11 杨波 Created ******************************************************************************/ DCSHCOREAPI_API void TestCreateTimeTokencodeRange(PTTOKENRECORDDATA pdata); /****************************************************************************** ** **函数名称: TestCreateTimeTokencode -- 测试专用 ** **功能描述: ** **参数说明: void [in / out] - ** **返回类型: void ** [添加返回值说明] ** ** **其他说明: ** **历史: 日期 作者 行为 2011-1-11 杨波 Created ******************************************************************************/ DCSHCOREAPI_API void TestCreateTimeTokencode(void); /****************************************************************************** ** **函数名称: TestCreateTimeTokencode_Host -- 测试专用 ** **功能描述: ** **参数说明: void [in / out] - ** **返回类型: void ** [添加返回值说明] ** ** **其他说明: ** **历史: 日期 作者 行为 2011-1-11 杨波 Created ******************************************************************************/ DCSHCOREAPI_API void TestCreateTimeTokencode_Host(void); /****************************************************************************** ** **函数名称: TestCreateEventTokencode -- 测试专用 ** **功能描述: ** **参数说明: void [in / out] - ** **返回类型: void ** [添加返回值说明] ** ** **其他说明: ** **历史: 日期 作者 行为 2011-1-11 杨波 Created ******************************************************************************/ DCSHCOREAPI_API void TestCreateEventTokencode(void); /****************************************************************************** ** **函数名称: TestCreateChallengeResponsecode -- 测试专用 ** **功能描述: ** **参数说明: void [in / out] - ** **返回类型: void ** [添加返回值说明] ** ** **其他说明: ** **历史: 日期 作者 行为 2011-1-11 杨波 Created ******************************************************************************/ DCSHCOREAPI_API void TestCreateChallengeResponsecode(void); /****************************************************************************** ** **函数名称: TestCreateTimeTokencodeSig -- 测试专用 ** **功能描述: ** **参数说明: void [in / out] - ** **返回类型: void ** [添加返回值说明] ** ** **其他说明: ** **历史: 日期 作者 行为 2011-1-11 杨波 Created ******************************************************************************/ DCSHCOREAPI_API void TestCreateTimeTokencodeSig(void); /****************************************************************************** ** **函数名称: TestCreateTimeTokencodeATM -- 测试专用 ** **功能描述: ** **参数说明: void [in / out] - ** **返回类型: void ** [添加返回值说明] ** ** **其他说明: ** **历史: 日期 作者 行为 2011-1-11 杨波 Created ******************************************************************************/ DCSHCOREAPI_API void TestCreateTimeTokencodeATM(void); /****************************************************************************** ** **函数名称: TestCreateEventTokencodeATM -- 测试专用 ** **功能描述: ** **参数说明: void [in / out] - ** **返回类型: void ** [添加返回值说明] ** ** **其他说明: ** **历史: 日期 作者 行为 2011-1-11 杨波 Created ******************************************************************************/ DCSHCOREAPI_API void TestCreateEventTokencodeATM(void); /****************************************************************************** ** **函数名称: TestPrintCardInfo -- 测试专用 ** **功能描述: ** **参数说明: char *CardFileName [in / out] - ** **返回类型: void ** [添加返回值说明] ** ** **其他说明: ** **历史: 日期 作者 行为 2011-1-11 杨波 Created ******************************************************************************/ DCSHCOREAPI_API void TestPrintCardInfo(char *CardFileName); /****************************************************************************** ** **函数名称: DCSHChangeTokenSeed -- 测试专用 ** **功能描述: ** **参数说明: PTTOKENRECORDDATA pdata [in / out] - ** **返回类型: int ** [添加返回值说明] ** ** **其他说明: ** **历史: 日期 作者 行为 2011-1-11 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAChangeTokenSeed(PTTOKENRECORDDATA pdata); #if OS_SELECT_WINDOWS /****************************************************************************** ** **函数名称: DCSHSACheckShecaCert ** **功能描述: 接入上海CA的开发包，此接口初始化eKey，并读取证书信息，以用来检测eKey的正常 ** **参数说明: char *cPrikeyPassword [in / ] - 私钥的密钥 char* pCertInfoFile [in / out] - 证书的一些信息，保存到文件 ** **返回类型: int ** DCSHEMSHECADLLERR 上海CA的接口不存在，请按装上海CA的证书管理器 ** DCSHEMSHECAKEYERR eKey操作失败，请检查eKey是否正常 ** DCSHEMSUCCESS 成功，可以打印证书信息 ** **其他说明: ** **历史: 日期 作者 行为 2010-9-2 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSACheckShecaCert (char *cPrikeyPassword, char* pCertInfoFile); /****************************************************************************** ** **函数名称: DCSHSACheckSJK0817E ** **功能描述: 检测华正天网的加密卡是否正常，并且进行了加解密运算，SM1 ** **参数说明: [in / out] - ** **返回类型: int ** DCSHEMPCIOPENERR 加密卡初始化失败 ** DCSHEMPCISESSIONERR 创建连接失败 ** DCSHEMPCIOPERERR 加密卡运算失败 ** DCSHEMSUCCESS 成功 **其他说明: ** **历史: 日期 作者 行为 2010-9-2 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSACheckSJK0817E (); /****************************************************************************** ** **函数名称: DCSHSAMakePubkeyEncRecord ** **功能描述: 用户的公钥加密会话密钥数据 ** **参数说明: char *userCertPath [in / ] - 用户证书的路径 unsigned char *pRecordData [in / ] - 会话密钥，16字节 unsigned int RecordDataLen [in / ] - 数据长度，16 unsigned char *pEvpSigData [in / out] - 加密的数据，128字节，外部分配空间 unsigned int EvpSigDataLen [in / out] - 加密的数据长度，应该是128 ** **返回类型: int ** EMREADUSERCERTERR 读取用户证书失败 ** EMDECUSERCERTERR 解析用户证书失败 ** EMSUCCESS 成功 **其他说明: ** **历史: 日期 作者 行为 2008-6-12 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int DCSHSAMakePubkeyEncRecord (char *userCertPath, unsigned char *pRecordData, unsigned int RecordDataLen, unsigned char *pEvpSigData, unsigned int *EvpSigDataLen); /****************************************************************************** ** **函数名称: TestRandom ** **功能描述: 真随机数测试 ** **参数说明: int iNumber [in / ] - 次数 ** **返回类型: DCSHCOREAPI_API int ** [添加返回值说明] ** ** **其他说明: ** **历史: 日期 作者 行为 2010-9-7 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int TestRandom(int iNumber); /****************************************************************************** ** **函数名称: TestSM1 ** **功能描述: SM1算法测试 ** **参数说明: int iNumber [in / ] - 次数 ** **返回类型: DCSHCOREAPI_API int ** [添加返回值说明] ** ** **其他说明: ** **历史: 日期 作者 行为 2010-9-7 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int TestSM1(int iNumber); /****************************************************************************** ** **函数名称: TestSM3 ** **功能描述: SM3算法测试 ** **参数说明: int iNumber [in / ] - 次数 ** **返回类型: DCSHCOREAPI_API int ** [添加返回值说明] ** ** **其他说明: ** **历史: 日期 作者 行为 2010-9-7 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int TestSM3(int iNumber); #endif /****************************************************************************** ** **函数名称: TestTokenCodeNumberIndex ** **功能描述: 使用10个不同的种子，每个种子从tokentime=i*60计算10000个tokencode， 对10000个tokencode进行数字统计，计算0-9数字出现的频率 ** **参数说明: int iAlgID [in / ] - 算法 ** **返回类型: int ** [添加返回值说明] ** ** **其他说明: ** **历史: 日期 作者 行为 2009-1-16 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int TestTokenCodeNumberIndex(int iAlgID); /****************************************************************************** ** **函数名称: TestTokenCodeDoubleIdx ** **功能描述: 设定5个时间点，在每个点随机创建若干个种子，并且在这时间点上计算tokencode 对若干个tokencode进行逐个比对，进行重复计数 “若干个”为传递参数，可指定 ** **参数说明: int seedCount [in / ] - 每个时间点，创建seedCount个种子，计算seedCount个动态口令 ** int iAlgID [in / ] - 算法 **返回类型: int ** [添加返回值说明] ** ** **其他说明: ** **历史: 日期 作者 行为 2009-1-16 杨波 Created ******************************************************************************/ DCSHCOREAPI_API int TestTokenCodeDoubleIdx(int seedCount, int iAlgID); /****************************************************************************** ** **函数名称: TestTokenCodePrefect ** **功能描述: 测试验证动态口令的性能，1000000次验证 直接命中，计算1次 偏移1，计算2次 偏移3，计算6次 偏移5，计算10次 ** **参数说明: [in / out] - ** **返回类型: void ** [添加返回值说明] ** ** **其他说明: ** **历史: 日期 作者 行为 2009-1-16 杨波 Created ******************************************************************************/ DCSHCOREAPI_API void TestTokenCodePrefect(int MAXCYCLETEST, int iAlgID); #ifdef __cplusplus } #endif #endif