传统的为 Spring Boot 配置SSL/TLS证书一般都会把证书打包成 JKS
(Java KeyStore) 或 PKCS12
(Public Key Cryptographic Standards) 格式,然后为Spring Boot 增加以下类似配置:
shell
# 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
格式,比如:
shell
openssl pkcs12 -inkey ./private.key -in ./certificate.pem -export -out ./certificateWithKey.p12
重点是,从 Spring Boot 2.7.x 版本开始,已经增加了对 PEM
格式证书的支持,不需要再做额外的转换,这一点目前还鲜有文档或教程提到,所有这里记录一下
shell
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,这样的好处是能实现所有平台和软件的证书在格式上都保持一致。