问题现象
加解密常用于数据存储或传输场景,在使用对称密钥加解密算法RSA进行数据加解密操作时产生错误,常见执行加解密时抛出错误码17630001、密钥转换失败、执行加解密时闪退等现象。
问题定位
RSA常见报错与错误码有:
- 错误码“-1”,这通常表示“ERR_UNEXPECTED”,即遇到了一个未被预期或未被特定处理的问题,需要进一步根据报错信息判断具体的错误原因。
- 错误码401,提示参数错误,通常需要排查密钥格式、密钥长度、入参是否正确、密钥处理不当等问题。
- 分段加解密数据损坏,分段加解密后数据乱码或不完整。通常是在Uint8Array与字符串转换过程中出现错误,从这方面进行排查。
- 报错init cipher fail,需要排查初始化时的入参是否正确。
- 加解密闪退,doFinal方法是加解密操作关键节点,执行加解密操作时通过DEBUG单步调试观察是否为此处导致应用闪退。
- 17630001、错误码401等报错问题:此类问题原因通常是由于API入参使用错误、加密和解密方法不匹配、明文长度与算法不匹配、数据格式与算法不匹配等问题造成,因此可按照以下步骤进行排查:
- 将明文数据转换为Uint8Array格式,根据不同的填充模式检查长度是否满足要求。
- 检查入参是否格式正确,例如RSA2048|PKCS1是否输入为RSA2048/PKCS1。
- 根据选择的填充模式,检查算法入参是否与密钥长度匹配,例如NoPadding的填充模式下,数据长度必须等于密钥长度(如RSA2048需256字节)。
- 检查明文或密文转换编码格式方法是否正确,入参为Uint8Array格式,实际应用中需要将Base64等数据编码格式转换,检查转码方法是否正确。
- 检查加密参数与解密参数是否一致,包含加密算法密钥长度、填充模式、密钥、PKCS1_OAEP模式对应的填充模式的参数等。
分析结论
- 错误码“-1”,可根据具体的报错信息来分析原因,例如“The input string contains unsupported characters”,表示输入参数格式错误(如公钥含非法字符),或者是密钥或明文数据未正确转换为Uint8Array。
- 加解密执行doFinal方法时出现闪退通常是以下原因:
- Cipher实例的init方法为异步函数,还未完成初始化时程序已经执行加解密doFinal操作导致发生闪退。
- 分段加解密过程中,分段方式错误,导致加密报错。
- 17630001、401等报错问题:
- 采用NoPadding的填充方式,输入的数据必须与RSA密钥字节长度一样长;输出数据长度与RSA密钥字节长度一样长。
- 入参格式未与API入参要求保持一致,传入错误格式。
- 所采用的密钥为其他平台已有密钥,为满足算法要求对密钥长度做截取或补位操作,但在ArkTS侧未做同样处理,导致密钥长度与算法要求不一致。
- 明文或密钥数据做转码时操作错误,如将16进制字符串采用Base64的转码方式处理。
- 加密方法的入参未与解密方法入参保持一致,如PKCS1_OAEP模式加密时pSource设置为[1,2,3],解密时设置为不同的字节流[4,5,6],会因为OAEP填充验证不通过,从而导致解密失败或乱码。
修改建议
- 加解密方法同时提供异步方法和同步方法,在使用异步方法时可通过await方式保障Cipher实例先初始化再加解密,可参考使用RSA非对称密钥(PKCS1模式)加解密(ArkTS)。
- 加解密操作仅用于ArkTS侧时可结合以上示例正确选择算法入参和调用方式,若涉及与服务端等交互,可参考服务端加密的密文填充方式、数据编码格式等进行调整,保障加密模式与服务端一致。
- RSA的分段加密是指当明文大于单次加密支持的数据长度时(具体长度请查非对称密钥加解密算法规格),需要将待加密数据分为合适长度的数据段,并对每个数据段执行加密操作,可以参考使用RSA非对称密钥分段加解密(ArkTS)。
密钥长度 | 填充模式 | 单段明文上限 | 单段密文长度 |
1024位 | PKCS1 | 117字节 | 128字节 |
3072位 | PKCS1 | 373字节 | 284字节 |