Spring Boot 配置使用 PEM 格式SSL/TLS证书和私钥

原创已于 2024-05-21 19:02:05 修改 · 3.3k 阅读

CC 4.0 BY-SA版权

文章标签：

#spring boot #ssl #TLS #https #JKS #PKCS12

于 2024-05-21 17:55:26 首次发布

传统的为 Spring Boot 配置SSL/TLS证书一般都会把证书打包成 JKS(Java KeyStore) 或 PKCS12 (Public Key Cryptographic Standards) 格式，然后为Spring Boot 增加以下类似配置：

# The format used for the keystore. It could be set to JKS in case it is a JKS file
server.ssl.key-store-type=PKCS12
# The path to the keystore containing the certificate
server.ssl.key-store=classpath:keystore/baeldung.p12
# The password used to generate the certificate
server.ssl.key-store-password=xxxxxxx
# The alias mapped to the certificate
server.ssl.key-alias=example_com

但很多时候我们拿到的是 PEM （Privacy Enhanced Mail）格式的证书和私钥，比如Nginx配置证书时就是使用的该格式，传统上要把它们应用到 Spring Boot 里需要转换成前述的 JKS 或者 PKCS12 格式，比如：

openssl pkcs12 -inkey ./private.key -in ./certificate.pem -export -out ./certificateWithKey.p12

重点是，从 Spring Boot 2.7.x 版本开始，已经增加了对 PEM 格式证书的支持，不需要再做额外的转换，这一点目前还鲜有文档或教程提到，所有这里记录一下

server.ssl.certificate=classpath:my-cert.crt
server.ssl.certificate-private-key=classpath:my-cert.key
server.ssl.trust-certificate=classpath:ca-cert.crt

具体文档可以查看这里 https://docs.spring.io/spring-boot/docs/current/reference/html/howto.html#howto.webserver.configure-ssl.pem-files，这样的好处是能实现所有平台和软件的证书在格式上都保持一致。