当前位置:   article > 正文

Java实现7种常见密码算法_java pkcs1

java pkcs1

简介

前面在密码学入门一文中讲解了各种常见的密码学概念、算法与运用场景,但没有介绍过代码,因此,为作补充,这一篇将会介绍使用Java语言如何实现使用这些算法,并介绍一下使用过程中可能遇到的坑。

Java加密体系JCA

Java抽象了一套密码算法框架JCA(Java Cryptography Architecture),在此框架中定义了一套接口与类,以规范Java平台密码算法的实现,而Sun,SunRsaSign,SunJCE这些则是一个个JCA的实现Provider,以实现具体的密码算法,这有点像List与ArrayList、LinkedList的关系一样,Java开发者只需要使用JCA即可,而不用管具体是怎么实现的。

JCA里定义了一系列类,如Cipher、MessageDigest、MAC、Signature等,分别用于实现加密、密码学哈希、认证码、数字签名等算法,一起来看看吧!

对称加密

对称加密算法,使用Cipher类即可,以广泛使用的AES为例,如下:

  1. public byte[] encrypt(byte[] data, Key key) {
  2. try {
  3. Cipher cipher = Cipher.getInstance("AES/CBC/PKCS5Padding");
  4. byte[] iv = SecureRandoms.randBytes(cipher.getBlockSize());
  5. //初始化密钥与加密参数iv
  6. cipher.init(Cipher.ENCRYPT_MODE, key, new IvParameterSpec(iv));
  7. //加密
  8. byte[] encryptBytes = cipher.doFinal(data);
  9. //将iv与密文拼在一起
  10. ByteArrayOutputStream baos = new ByteArrayOutputStream(iv.length + encryptBytes.length);
  11. baos.write(iv);
  12. baos.write(encryptBytes);
  13. return baos.toByteArray();
  14. } catch (Exception e) {
  15. return ExceptionUtils.rethrow(e);
  16. }
  17. }
  18. public byte[] decrypt(byte[] data, Key key) {
  19. try {
  20. Cipher cipher = Cipher.getInstance("AES/CBC/PKCS5Padding");
  21. //获取密文前面的iv
  22. IvParameterSpec ivSpec = new IvParameterSpec(data, 0, cipher.getBlockSize());
  23. cipher.init(Cipher.DECRYPT_MODE, key, ivSpec);
  24. //解密iv后面的密文
  25. return cipher.doFinal(data, cipher.getBlockSize(), data.length - cipher.getBlockSize());
  26. } catch (Exception e) {
  27. return ExceptionUtils.rethrow(e);
  28. }
  29. }
  30. 复制代码

如上,对称加密主要使用Cipher,不管是AES还是DES,Cipher.getInstance()传入不同的算法名称即可,这里的Key参数就是加密时使用的密钥,稍后会介绍它是怎么来的,暂时先忽略它。
另外,为了使得每次加密出来的密文不同,我使用了随机的iv向量,并将iv向量拼接在了密文前面。

注:如果某个算法名称,如上面的AES/CBC/PKCS5Padding,你不知道它在JCA中的标准名称是什么,可以到 docs.oracle.com/en/java/jav… 中查询即可。

非对称加密

非对称加密同样是使用Cipher类,只是传入的密钥对象不同,以RSA算法为例,如下:

  1. public byte[] encryptByPublicKey(byte[] data, PublicKey publicKey){
  2. try{
  3. Cipher cipher = Cipher.getInstance("RSA");
  4. cipher.init(Cipher.ENCRYPT_MODE, publicKey);
  5. return cipher.doFinal(data);
  6. }catch (Exception e) {
  7. throw Errors.toRuntimeException(e);
  8. }
  9. }
  10. public byte[] decryptByPrivateKey(byte[] data, PrivateKey privateKey){
  11. try{
  12. Cipher cipher = Cipher.getInstance("RSA");
  13. cipher.init(Cipher.DECRYPT_MODE, privateKey);
  14. return cipher.doFinal(data);
  15. }catch (Exception e) {
  16. throw Errors.toRuntimeException(e);
  17. }
  18. }
  19. 复制代码

一般来说应使用公钥加密,私钥解密,但其实反过来也是可以的,这里的PublicKey与PrivateKey也先忽略,后面会介绍它怎么来的。

密码学哈希

密码学哈希算法包括MD5、SHA1、SHA256等,在JCA中都使用MessageDigest类即可,如下:

  1. public static String sha256(byte[] bytes) throws NoSuchAlgorithmException {
  2. MessageDigest digest = MessageDigest.getInstance("SHA-256");
  3. digest.update(bytes);
  4. return Hex.encodeHexString(digest.digest());
  5. }
  6. 复制代码

消息认证码

消息认证码使用Mac类实现,以常见的HMAC搭配SHA256为例,如下:

  1. public byte[] digest(byte[] data, Key key) throws InvalidKeyException, NoSuchAlgorithmException{
  2. Mac mac = Mac.getInstance("HmacSHA256");
  3. mac.init(key);
  4. return mac.doFinal(data);
  5. }
  6. 复制代码

数字签名

数字签名使用Signature类实现,以RSA搭配SHA256为例,如下:

  1. public byte[] sign(byte[] data, PrivateKey privateKey) {
  2. try {
  3. Signature signature = Signature.getInstance("SHA256withRSA");
  4. signature.initSign(privateKey);
  5. signature.update(data);
  6. return signature.sign();
  7. } catch (Exception e) {
  8. return ExceptionUtils.rethrow(e);
  9. }
  10. }
  11. public boolean verify(byte[] data, PublicKey publicKey, byte[] sign) {
  12. try {
  13. Signature signature = Signature.getInstance("SHA256withRSA");
  14. signature.initVerify(publicKey);
  15. signature.update(data);
  16. return signature.verify(sign);
  17. } catch (Exception e) {
  18. return ExceptionUtils.rethrow(e);
  19. }
  20. }
  21. 复制代码

密钥协商算法

在JCA中,使用KeyAgreement来调用密钥协商算法,以ECDH协商算法为例,如下:

  1. public static void testEcdh() {
  2. KeyPairGenerator keyGen = KeyPairGenerator.getInstance("EC");
  3. ECGenParameterSpec ecSpec = new ECGenParameterSpec("secp256r1");
  4. keyGen.initialize(ecSpec);
  5. // A生成自己的私密信息
  6. KeyPair keyPairA = keyGen.generateKeyPair();
  7. KeyAgreement kaA = KeyAgreement.getInstance("ECDH");
  8. kaA.init(keyPairA.getPrivate());
  9. // B生成自己的私密信息
  10. KeyPair keyPairB = keyGen.generateKeyPair();
  11. KeyAgreement kaB = KeyAgreement.getInstance("ECDH");
  12. kaB.init(keyPairB.getPrivate());
  13. // B收到A发送过来的公用信息,计算出对称密钥
  14. kaB.doPhase(keyPairA.getPublic(), true);
  15. byte[] kBA = kaB.generateSecret();
  16. // A收到B发送过来的公开信息,计算对对称密钥
  17. kaA.doPhase(keyPairB.getPublic(), true);
  18. byte[] kAB = kaA.generateSecret();
  19. Assert.isTrue(Arrays.equals(kBA, kAB), "协商的对称密钥不一致");
  20. }
  21. 复制代码

基于口令加密PBE

通常,对称加密算法需要使用128位字节的密钥,但这么长的密钥用户是记不住的,用户容易记住的是口令,也即password,但与密钥相比,口令有如下弱点:

  1. 口令通常较短,这使得直接使用口令加密的强度较差。
  2. 口令随机性较差,因为用户一般使用较容易记住的东西来生成口令。

为了使得用户能直接使用口令加密,又能最大程度避免口令的弱点,于是PBE(Password Based Encryption)算法诞生,思路如下:

  1. 既然密码算法需要密钥,那在加解密前,先使用口令生成密钥,然后再使用此密钥去加解密。
  2. 为了弥补口令随机性较差的问题,生成密钥时使用随机盐来混淆口令来产生准密钥,再使用散列函数对准密钥进行多次散列迭代,以生成最终的密钥。

因此,使用PBE算法进行加解密时,除了要提供口令外,还需要提供随机盐(salt)与迭代次数(iteratorCount),如下:

  1. public static byte[] encrypt(byte[] plainBytes, String password, byte[] salt, int iteratorCount) {
  2. try {
  3. PBEKeySpec keySpec = new PBEKeySpec(password.toCharArray());
  4. SecretKey key = SecretKeyFactory.getInstance("PBEWithMD5AndTripleDES").generateSecret(keySpec);
  5. Cipher cipher = Cipher.getInstance("PBEWithMD5AndTripleDES");
  6. cipher.init(Cipher.ENCRYPT_MODE, key, new PBEParameterSpec(salt, iteratorCount));
  7. byte[] encryptBytes = cipher.doFinal(plainBytes);
  8. byte[] iv = cipher.getIV();
  9. ByteArrayOutputStream baos = new ByteArrayOutputStream(iv.length + encryptBytes.length);
  10. baos.write(iv);
  11. baos.write(encryptBytes);
  12. return baos.toByteArray();
  13. } catch (Exception e) {
  14. throw Errors.toRuntimeException(e);
  15. }
  16. }
  17. public static byte[] decrypt(byte[] secretBytes, String password, byte[] salt, int iteratorCount) {
  18. try {
  19. PBEKeySpec keySpec = new PBEKeySpec(password.toCharArray());
  20. SecretKey key = SecretKeyFactory.getInstance("PBEWithMD5AndTripleDES").generateSecret(keySpec);
  21. Cipher cipher = Cipher.getInstance("PBEWithMD5AndTripleDES");
  22. IvParameterSpec ivParameterSpec = new IvParameterSpec(secretBytes, 0, cipher.getBlockSize());
  23. cipher.init(Cipher.DECRYPT_MODE, key, new PBEParameterSpec(salt, iteratorCount, ivParameterSpec));
  24. return cipher.doFinal(secretBytes, cipher.getBlockSize(), secretBytes.length - cipher.getBlockSize());
  25. } catch (Exception e) {
  26. throw Errors.toRuntimeException(e);
  27. }
  28. }
  29. public static void main(String[] args) throws Exception {
  30. byte[] content = "hello".getBytes(StandardCharsets.UTF_8);
  31. byte[] salt = Base64.decode("QBadPOP6/JM=");
  32. String password = "password";
  33. byte[] encoded = encrypt(content, password, salt, 1000);
  34. System.out.println("密文:" + Base64.encode(encoded));
  35. byte[] plainBytes = decrypt(encoded, password, salt, 1000);
  36. System.out.println("明文:" + new String(plainBytes, StandardCharsets.UTF_8));
  37. }
  38. 复制代码

注意,虽然使用PBE加解密数据,都需要使用相同的password、salt、iteratorCount,但这里面只有password是需要保密的,salt与iteratorCount不需要,可以保存在数据库中,比如每个用户注册时给他生成一个随机盐。

到此,JCA密码算法就介绍完了,来回顾一下:

整体来说,JCA对密码算法相关的类设计与封装还是非常清晰简单的!

但使用密码算法时,依赖SecretKey、PublicKey、PrivateKey对象提供密钥信息,那这些密钥对象是怎么来的呢?

密钥生成与读取

密码学随机数

密码学随机数算法在安全场景中使用广泛,如:生成对称密钥、盐、iv等,因此相比普通的随机数算法(如线性同余),它需要更高强度的不可预测性,在Java中,使用SecureRandom来生成更安全的随机数,如下:

  1. public class SecureRandoms {
  2. public static byte[] randBytes(int len) throws NoSuchAlgorithmException {
  3. byte[] bytes = new byte[len];
  4. SecureRandom secureRandom = SecureRandom.getInstance("SHA1PRNG");
  5. secureRandom.nextBytes(bytes);
  6. return bytes;
  7. }
  8. }
  9. 复制代码

SecureRandom使用了更高强度的随机算法,同时会读取机器本身的随机熵值,如/dev/urandom,因此相比普通的Random,它具有更强的随机性,因此,对于需要生成密钥的场景,该用哪个要拧得清。

对称密钥

在JCA中对称密钥使用SecretKey表示,若要生成一个新的SecretKey,可使用KeyGenerator,如下:

  1. //生成新的密钥
  2. public static SecretKey genSecretKey() {
  3. KeyGenerator keyGenerator = KeyGenerator.getInstance("AES");
  4. keyGenerator.init(SecureRandom.getInstance("SHA1PRNG"));
  5. SecretKey secretKey = keyGenerator.generateKey();
  6. }
  7. 复制代码

而如果是从文件中读取密钥的话,则可以借助SecretKeyFactory将其转换为SecretKey,如下:

  1. //读取密钥
  2. public static SecretKey getSecretKey() {
  3. byte[] keyBytes = readKeyBytes();
  4. String alg = "AES";
  5. SecretKey secretKey = SecretKeyFactory.getInstance(alg).generateSecret(new SecretKeySpec(keyBytes, alg));
  6. }
  7. 复制代码

非对称密钥

在JCA中,对于非对称密钥,公钥使用PublicKey表示,私钥使用PrivateKey表示,若要生成一个新的公私钥对,可使用KeyPairGenerator,如下:

  1. //生成新的公私钥对
  2. public static void genKeyPair() {
  3. KeyPairGenerator keyPairGen = KeyPairGenerator.getInstance("RSA");
  4. keyPairGen.initialize(2048);
  5. KeyPair keyPair = keyPairGen.generateKeyPair();
  6. PublicKey publicKey = keyPair.getPublic();
  7. PrivateKey privateKey = keyPair.getPrivate();
  8. }
  9. 复制代码

而如果是从文件中读取公私钥的话,一般公钥是X509格式,而私钥是PKCS8格式,分别对应JCA中的X509EncodedKeySpec与PKCS8EncodedKeySpec,如下:

  1. //读取私钥
  2. public static PrivateKey getPrivateKey() {
  3. byte[] privateKeyBytes = readPrivateKeyBytes();
  4. PKCS8EncodedKeySpec pkcs8EncodedKeySpec = new PKCS8EncodedKeySpec(privateKeyBytes);
  5. PrivateKey privateKey = KeyFactory.getInstance("RSA").generatePrivate(pkcs8EncodedKeySpec);
  6. }
  7. //读取公钥
  8. public static PublicKey getPublicKey() {
  9. byte[] publicKeyBytes = readPublicKeyBytes();
  10. X509EncodedKeySpec x509EncodedKeySpec = new X509EncodedKeySpec(publicKeyBytes);
  11. PublicKey publicKey = KeyFactory.getInstance("RSA").generatePublic(x509EncodedKeySpec);
  12. }
  13. 复制代码

注意,KeyGenerator、KeyPairGenerator与KeyFactory从命名上看起来有点相似,但它们实现的功能是完全不同的,KeyGenerator、KeyPairGenerator用于生成新的密钥,而KeyFactory则用于将KeySpec转换为对应的Key密钥对象。

JCA密钥相关类关系一览,如下:
 

常见问题

密文无法解密问题

有时,在使用密码算法时,会发现别人提供的密文使用正确的密钥却无法解密出来,特别容易发生在跨语言的情况下,如加密方使用的C#语言,而解密方却使用的Java。

遇到这种情况,你需要和对方认真确认加密时使用的加密模式、填充模式以及IV等密码参数是否完全一致。

如AES算法加密模式有ECBCBCCFBCTRGCM等,填充模式有PKCS#5, ISO 10126, ANSI X9.23等,以及对方是使用了固定的IV向量还是将IV向量拼在了密文中,这些都需要确认清楚并与对方保持一致才能正确解密。

签名失败问题

签名失败也是使用密码算法时常见的情况,比如对方生成的MD5值与你生成的MD5不一致,常见有2种原因,如下:
1. 使用的字符编码不一致导致
密码算法为了通用性,操作对象都是字节数组,而你要签名的对象一般是字符串,因此你需要将字符串转为字节数组之后再做md5运算,如下:

  • 调用方:md5(str.getBytes())
  • 服务方:md5(str.getBytes())

看起来两边的代码一模一样,但问题就在getBytes()函数中,getBytes()函数默认会使用操作系统的字符编码将字符串转为字节数组,而中文Windows默认字符编码是GBK,而Linux默认是UTF-8,这就导致当str中有中文时,调用方与服务方获取到的字节数组是不一样的,那生成的MD5值当然也不一样了。

因此,强烈推荐在使用getBytes()函数时,传入统一的字符编码,如下:

  • 调用方:md5(str.getBytes("UTF-8"))
  • 服务方:md5(str.getBytes("UTF-8"))
    这样就能有效地避过这个非常隐晦的坑了。

2. json的escape功能导致
有些json框架,做json序列化时会默认做一些转义操作,如把&字符转义为\u0026,但如果服务端做json反序列化时没有做反转义,这会导致两边计算的签名值不一样,如下:

  • 调用方:md5("&")
  • 服务方:md5("\\u0026")
    这也是一个非常隐晦的坑,如Gson默认就会有这种行为,可使用new GsonBuilder().disableHtmlEscaping()禁用。

生成与读取证书

概念

随着对密码学了解的深入,会发现有特别多奇怪的名词出现,让人迷惑不已,如PKCS8X.509ASN.1DERPEM等,接下来就来澄清下这些名词是什么,以及它们之间的关系。

首先,了解3个概念,如下:

  • 密钥:包括对称密钥与非对称密钥等。
  • 证书:包含用户或网站的身份信息、公钥,以及CA的签名。
  • 密钥库:用于存储密钥与证书的仓库。

ASN.1语法

ASN.1抽象语法标记(Abstract Syntax Notation One),和XML、JSON类似,用于描述对象结构,可以把它看成一种描述语言,简单的示例如下:

  1. Report ::= SEQUENCE {
  2. author OCTET STRING,
  3. title OCTET STRING,
  4. body OCTET STRING,
  5. }
  6. 复制代码

这个语法描述了一个结构体,它包含3个属性author、title、body,且都是字符串类型。

DER与PEM

DER是ASN.1的一种序列化编码方案,也就是说ASN.1用来描述对象结构,而DER用于将此对象结构编码为可存储的字节数组。

PEM(Privacy Enhanced Mail)是一种将二进制数据,以文本形式进行存储或传输的方案,早期主要用于邮件中交换证书,它的文本内容常以-----BEGIN XXX-----开头,并以-----END XXX-----结尾,而中间 Body 部分则为 Base64 编码后的数据,如下是一个证书的PEM样例。

以上面证书为例,PEM与DER的关系大概如下:

  1. PEM = "-----BEGIN CERTIFICATE-----" + base64(DER) + "-----END CERTIFICATE-----"
  2. 复制代码

X.509、PKCS8、PKCS12等

X.509、PKCS8、PKCS12等都是公钥密码学标准(PKCS)组织制定的各种密码学规范,该组织使用ASN.1语法为密钥、证书、密钥库等定义了标准的对象结构,常见的如下:

  • X.509规范:用于描述证书与公钥的标准格式。
  • PKCS7规范:可描述的对象很多,不过一般也是用于描述证书的。
  • PKCS8规范:用于描述私钥的标准格式。
  • PKCS12规范:用于描述密钥库的标准格式。
  • PKCS1规范:用于描述RSA算法及其公私钥的标准格式。

这些规范都有相应的RFC文档,感兴趣的可以前往查看:

  1. PEM:https://www.rfc-editor.org/rfc/rfc7468
  2. X.509:https://datatracker.ietf.org/doc/html/rfc5280
  3. PKCS7:https://datatracker.ietf.org/doc/html/rfc2315
  4. PKCS8:https://datatracker.ietf.org/doc/html/rfc8351
  5. PKCS12:https://datatracker.ietf.org/doc/html/rfc7292
  6. PKCS1:https://datatracker.ietf.org/doc/html/rfc8017#appendix-A
  7. 复制代码

类比一下,如果把ASN.1比作Java,那X.509就是使用Java定义的一个名叫X509的类,这个类里面包含身份信息、公钥信息等相关字段,而DER就是一种Java对象序列化方案,用于将X509这个类的对象序列化为字节数组,字节数组保存为文件后,这个文件就是我们常说的证书或密钥文件。

常见证书文件

由于PKCS组织并未给证书文件定下标准的文件名后缀,所以证书文件有非常多的后缀名,如下:

  • .der: DER编码的证书,一般是X.509规范的,无法用文本编辑器直接打开
  • .pem: PEM编码的证书,一般是X.509规范的
  • .crt: 常见于unix类系统,一般是X.509规范的,可能是DER编码或PEM编码
  • .cer: 常见于windows系统,一般是X.509规范的,可能是DER编码或PEM编码
  • .p7b: 常见于windows系统,PKCS7规范证书,可能是DER编码或PEM编码
  • .pfx:PKCS12规范的密钥库文件,也有取名为.p12的
  • .jks:java专用的密钥库文件格式,在java技术栈内使用较多,非java一般使用.pfx

证书概念小结

生成证书与密钥库

openssl命令提供了大量的工具,用以生成密钥、证书与密钥库文件,如下,是一个典型的生成密钥与证书的过程:

  1. # 生成pkcs1 rsa私钥
  2. openssl genrsa -out rsa_private_key_pkcs1.key 2048
  3. # 生成pkcs1 rsa公钥
  4. openssl rsa -in rsa_private_key_pkcs1.key -RSAPublicKey_out -out rsa_public_key_pkcs1.key
  5. # 生成证书申请文件cert.csr
  6. openssl req -new -key rsa_private_key_pkcs1.key -out cert.csr
  7. # 自签名(演示时使用,生产环境一般不用自签证书)
  8. openssl x509 -req -days 365 -in cert.csr -signkey rsa_private_key_pkcs1.key -out cert.crt
  9. # ca签名(将证书申请文件提交给ca机构签名)
  10. openssl x509 -req -days 365 -in cert.csr -CA ca_cert.crt -CAkey ca_private_key.pem -CAcreateserial -out cert.crt
  11. # 生成p12密钥库文件
  12. openssl pkcs12 -export -in cert.crt -inkey rsa_private_key_pkcs1.key -name demo -out keystore.p12
  13. 复制代码

有时别人发来的密钥或证书文件无法读取,也可使用openssl确认一下,如果openssl能读出来,那大概率是自己程序有问题,如果openssl读不出来,那大概率是别人发的文件有问题,如下:

  1. # 查看pkcs1 rsa私钥
  2. openssl rsa -in rsa_private_key_pkcs1.key -text -noout
  3. # 查看pkcs1 rsa公钥
  4. openssl rsa -RSAPublicKey_in -in rsa_public_key_pkcs1.key -text -noout
  5. # 查看x.509证书
  6. openssl x509 -in cert.crt -text -nocert
  7. # 查看pkcs12密钥库文件
  8. openssl pkcs12 -in keystore.p12
  9. keytool -v -list -storetype pkcs12 -keystore keystore.p12
  10. 复制代码

由于密钥、证书、密钥库文件,其实都是使用ASN.1语法描述的,所以它们都能按ASN.1语法解析出来,如下:

  1. openssl asn1parse -i -inform pem -in cert.crt
  2. 复制代码

证书格式转换

某些情况下,我们需要在不同格式的密钥或证书文件之间转换,也可使用openssl命令来完成。
密钥格式转换,如下:

  1. # rsa公钥转换为X509公钥
  2. openssl rsa -RSAPublicKey_in -in rsa_public_key_pkcs1.key -pubout -out public_key_x509.key
  3. # rsa私钥转换为PKCS8格式
  4. openssl pkcs8 -topk8 -inform PEM -in rsa_private_key_pkcs1.key -outform PEM -nocrypt -out private_key_pkcs8.key
  5. # pkcs8转rsa私钥
  6. openssl pkcs8 -inform PEM -nocrypt -in private_key_pkcs8.key -traditional -out rsa_private_key_pkcs1.key
  7. 复制代码

证书格式转换,如下:

  1. # 证书DER转PEM
  2. openssl x509 -inform der -in cert.der -outform pem -out cert.pem -noout
  3. # x509证书转pkcs7证书
  4. openssl crl2pkcs7 -nocrl -certfile cert.crt -out cert.p7b
  5. # 查看pkcs7证书
  6. openssl pkcs7 -print_certs -in cert.p7b -noout
  7. 复制代码

由于密钥库中包含证书与私钥,故可以从密钥库文件中提取出证书与私钥,如下:

  1. # 从pkcs12密钥库中提取证书
  2. openssl pkcs12 -in keystore.p12 -clcerts -nokeys -out cert.crt
  3. # 从pkcs12密钥库中提取私钥
  4. openssl pkcs12 -in keystore.p12 -nocerts -nodes -out private_key.key
  5. # pkcs12转jks
  6. keytool -importkeystore -srckeystore keystore.p12 -srcstoretype pkcs12 -srcalias demo -destkeystore keystore.jks -deststoretype jks -deststorepass 123456 -destalias demo
  7. # 从jks中提取证书
  8. keytool -export -alias demo -keystore keystore.jks -file cert.crt
  9. 复制代码

读取密钥或证书文件

使用JCA来读取密钥或证书文件,也是非常方便的。

PEM转DER

若要将PEM格式文件转换为DER,只需要把---BEGIN XXX------END XXX---去掉,然后使用Base64解码即可,如下:

  1. private static byte[] pemFileToDerBytes(String pemFilePath) throws IOException {
  2. InputStream is = ClassLoader.getSystemClassLoader().getResourceAsStream(pemFilePath);
  3. String pemStr = StreamUtils.copyToString(is, StandardCharsets.UTF_8);
  4. //去掉---BEGIN XXX---与---END XXX---
  5. pemStr = pemStr.replaceAll("---+[^-]+---+", "")
  6. .replaceAll("\\s+", "");
  7. //base64解码为DER二进制内容
  8. return Base64.getDecoder().decode(pemStr);
  9. }
  10. 复制代码

读取PKCS8私钥

在JCA中,使用PKCS8EncodedKeySpec解析PKCS8私钥文件,如下:

  1. public static void testPkcs8PrivateKeyFile() {
  2. byte[] derBytes = pemFileToDerBytes("cert/private_key_pkcs8.key");
  3. PKCS8EncodedKeySpec pkcs8EncodedKeySpec = new PKCS8EncodedKeySpec(derBytes);
  4. RSAPrivateCrtKey rsaPrivateCrtKey = (RSAPrivateCrtKey)KeyFactory.getInstance("RSA").generatePrivate(pkcs8EncodedKeySpec);
  5. BigInteger n = rsaPrivateCrtKey.getModulus();
  6. BigInteger e = rsaPrivateCrtKey.getPublicExponent();
  7. BigInteger d = rsaPrivateCrtKey.getPrivateExponent();
  8. System.out.printf(" n: %X \n e: %X \n d: %X \n", n, e, d);
  9. BigInteger plain = BigInteger.valueOf(new Random().nextInt(1000000000));
  10. // RSA加密
  11. long t1 = System.nanoTime();
  12. BigInteger secret = plain.modPow(e, n);
  13. long t2 = System.nanoTime();
  14. // RSA解密
  15. BigInteger plain2 = secret.modPow(d, n);
  16. long t3 = System.nanoTime();
  17. System.out.printf(" plain: %d \n plain2: %d \n", plain, plain2);
  18. System.out.printf("enc time: %d \n", (t2 - t1));
  19. System.out.printf("dec time: %d \n", (t3 - t2));
  20. }
  21. 复制代码

读取X.509公钥

在JCA中,使用X509EncodedKeySpec解析X.509公钥文件,如下:

  1. public static void testX509PublicKeyFile() {
  2. byte[] derBytes = pemFileToDerBytes("cert/public_key_x509.key");
  3. X509EncodedKeySpec x509EncodedKeySpec = new X509EncodedKeySpec(derBytes);
  4. RSAPublicKey rsaPublicKey = (RSAPublicKey)KeyFactory.getInstance("RSA").generatePublic(x509EncodedKeySpec);
  5. BigInteger e = rsaPublicKey.getPublicExponent();
  6. BigInteger n = rsaPublicKey.getModulus();
  7. System.out.printf(" e: %X \n n: %X \n", e, n);
  8. }
  9. 复制代码

读取X.509证书

读取X.509证书文件,可使用CertificateFactory类,如下:

  1. public static void testX509CertFile() {
  2. byte[] derBytes = pemFileToDerBytes("cert/cert.crt");
  3. Collection<? extends Certificate> certificates = CertificateFactory.getInstance("X.509")
  4. .generateCertificates(new ByteArrayInputStream(derBytes));
  5. for(Certificate certificate : certificates){
  6. X509Certificate x509Certificate = (X509Certificate)certificate;
  7. System.out.printf("SubjectDN: %s \n", x509Certificate.getSubjectDN());
  8. System.out.printf("IssuerDN: %s \n", x509Certificate.getIssuerDN());
  9. System.out.printf("SigAlgName: %s \n", x509Certificate.getSigAlgName());
  10. System.out.printf("Signature: %s \n", Hex.encodeHexString(x509Certificate.getSignature()));
  11. System.out.printf("PublicKey: %s \n", x509Certificate.getPublicKey());
  12. }
  13. }
  14. 复制代码

读取PKCS12密钥库文件

读取PKCS12规范的密钥库文件,可使用KeyStore类,如下:

  1. public static void testPkcs12File() {
  2. KeyStore keyStore = KeyStore.getInstance("PKCS12");
  3. InputStream is = ClassLoader.getSystemClassLoader().getResourceAsStream("cert/keystore.p12");
  4. char[] password = "123456".toCharArray();
  5. keyStore.load(is, password);
  6. //获取证书
  7. X509Certificate x509Certificate = (X509Certificate)keyStore.getCertificate("demo");
  8. System.out.println("X509Certificate: ");
  9. System.out.printf("SubjectDN: %s \n", x509Certificate.getSubjectDN());
  10. System.out.printf("IssuerDN: %s \n", x509Certificate.getIssuerDN());
  11. System.out.printf("SigAlgName: %s \n", x509Certificate.getSigAlgName());
  12. System.out.printf("Signature: %s \n", Hex.encodeHexString(x509Certificate.getSignature()));
  13. System.out.printf("PublicKey: %s \n", x509Certificate.getPublicKey());
  14. //获取私钥
  15. Key key = keyStore.getKey("demo", password);
  16. System.out.printf("PrivateKey: %s \n", key);
  17. }
  18. 复制代码

如果要读取.jks文件,只需要将KeyStore.getInstance("PKCS12")中的PKCS12更换为JKS即可,其它部分保持不变,不过由于JKS是java专有格式,目前java也不推荐使用了,所以能不用的话,就尽量不要用了。

常见问题

证书信任问题

证书的绝大多数应用场景是Https协议,但在访问https接口时,有时会由于证书信任问题导致https握手失败,主要有以下2点原因:

  1. 有些公司会自建CA,使用自签证书,如早期的12306,而jdk只信任它预置的根证书,所以https握手时这种证书会认证失败。
  2. 新成立的根CA机构证书,没预置在旧的jdk里面,导致这些CA机构签发的证书不被信任。

要解决这种证书信任问题,有两种方法,如下:
1. 将证书导致到jdk的预置证书库中

  1. # 将cert.crt导入jdk预置密钥库文件,密钥库文件密码默认是changeit
  2. sudo keytool -importcert -file cert.crt -alias demo -keystore $JAVA_HOME/jre/lib/security/cacerts -storepass changeit
  3. # 查看密钥库文件,检查是否导入成功
  4. keytool -list -v -alias demo -keystore $JAVA_HOME/jre/lib/security/cacerts -storepass changeit
  5. 复制代码

2. 以编码的方式信任证书
以jdk自带的https sdk为例,可在代码中手动将问题证书添加到信任列表中,如下:

  1. public String testReqHttpsTrustCert() throws Exception {
  2. // 读取jdk预置证书
  3. KeyStore keyStore = KeyStore.getInstance(KeyStore.getDefaultType());
  4. try(InputStream ksIs = new FileInputStream(System.getProperty("java.home") + "/lib/security/cacerts")) {
  5. keyStore.load(ksIs, "changeit".toCharArray());
  6. }
  7. // 读取证书文件
  8. CertificateFactory cf = CertificateFactory.getInstance("X.509");
  9. try(InputStream certIs = this.getClass().getResourceAsStream("/cert/cert.crt")) {
  10. Certificate c = cf.generateCertificate(certIs);
  11. keyStore.setCertificateEntry("demo", c);
  12. }
  13. // 生成信任管理器
  14. TrustManagerFactory tmFact = TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm());
  15. tmFact.init(keyStore);
  16. // 生成SSLSocketFactory
  17. SSLContext sslContext = SSLContext.getInstance("TLSv1.2");
  18. sslContext.init(null, tmFact.getTrustManagers(), new SecureRandom());
  19. SSLSocketFactory ssf = sslContext.getSocketFactory();
  20. // 发送https请求
  21. URL url = new URL("https://www.demo.com/user/list");
  22. HttpsURLConnection connection = (HttpsURLConnection) url.openConnection();
  23. connection.setHostnameVerifier((hostname, session) -> hostname.endsWith("demo.com"));
  24. connection.setSSLSocketFactory(ssf);
  25. String result;
  26. try(InputStream inputStream = connection.getInputStream()){
  27. result = IOUtils.toString(inputStream, StandardCharsets.UTF_8);
  28. }
  29. connection.disconnect();
  30. return result;
  31. }
  32. 复制代码

注:虽然2种方法都可以解决问题,但第1种方法使得java程序对环境形成了依赖,一旦部署环境发生变化,java程序可能就报错了,因此更推荐使用第2种方法。

总结

到这里,JCA相关类的使用就介绍完了,如下表格中总结了JCA的常用类:

本篇花了近一周时间整理,内容较多,对这块不太熟悉的同学,可以先关注收藏起来当示例手册,待需要时再参阅即可。

作者:扣钉日记
链接:https://juejin.cn/post/7157174018531917861
来源:稀土掘金
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/我家小花儿/article/detail/838581
推荐阅读
相关标签
  

闽ICP备14008679号