当前位置: 代码网 > it编程>编程语言>Java > SpringBoot对SSL的支持实现

SpringBoot对SSL的支持实现

2024年08月22日 Java 我要评论
spring boot 提供了配置 ssl 信任材料的能力,这些材料可以应用于多种类型的连接,以支持安全通信。可以使用以spring.ssl.bundle为前缀的配置属性来指定命名的信任材料集和相关信

spring boot 提供了配置 ssl 信任材料的能力,这些材料可以应用于多种类型的连接,以支持安全通信。可以使用以 spring.ssl.bundle 为前缀的配置属性来指定命名的信任材料集和相关信息。

https://docs.spring.io/spring-boot/docs/3.2.0/reference/htmlsingle/#features.ssl

使用 java keystore 文件配置 ssl

可以使用以 spring.ssl.bundle.jks 为前缀的配置属性来配置使用 java keytool 实用程序创建的信任材料包,并将这些包存储在 jks 或 pkcs12 格式的 java keystore 文件中。每个包都有一个用户提供的名称,可用于引用该包。

当用于保护嵌入式 web 服务器时,通常会将keystore 配置为包含证书和私钥的 java keystore,如下所示:

spring.ssl.bundle.jks.mybundle.key.alias=application
spring.ssl.bundle.jks.mybundle.keystore.location=classpath:application.p12
spring.ssl.bundle.jks.mybundle.keystore.password=secret
spring.ssl.bundle.jks.mybundle.keystore.type=pkcs12

当用于保护客户端连接时,通常会将truststore 配置为包含服务器证书的 java keystore,如下所示:

spring.ssl.bundle.jks.mybundle.truststore.location=classpath:server.p12
spring.ssl.bundle.jks.mybundle.truststore.password=secret

使用 pem 编码的证书配置 ssl

可以使用以 spring.ssl.bundle.pem 为前缀的配置属性来配置以 pem 编码文本形式存在的信任材料包。每个包都有一个用户提供的名称,可用于引用该包。

当用于保护嵌入式 web 服务器时,通常会将keystore 配置为包含证书和私钥,如下所示:

spring.ssl.bundle.pem.mybundle.keystore.certificate=classpath:application.crt
spring.ssl.bundle.pem.mybundle.keystore.private-key=classpath:application.key

当用于保护客户端连接时,通常会将truststore 配置为包含服务器证书,如下所示:

spring.ssl.bundle.pem.mybundle.truststore.certificate=classpath:server.crt

提示certificate 和private-key属性可以直接使用 pem 内容。如果属性值包含 begin 和 end 标记,则它们将被视为 pem 内容,而不是资源位置。

以下示例演示了如何定义信任库证书:

spring.ssl.bundle.pem.mybundle.truststore.certificate=\
-----begin certificate-----\n\
miid1zccar+gawibagiunm5qqv8izvqsgsmmdpqnaqyzws4wdqyjkozihvcnaqel\n\
bqawezelmakga1uebhmcwfgxejaqbgnvbagmcvn0yxrltmftzterma8ga1uebwwi\n\
...\n\
v0ijjcmyjezbtvpjfkznvafiouv+8l7jhq1/yf+9c3c8gsjdufv88m17pqyxd+ds\n\
hemfmnnjht130uyjncitmlvxyy5p35vwmdf95u3uebjsnnvtxh8qrmn9ok9mupdb\n\
ngx6jbji7fw7txoqwslhnibodm88fulqsho8\n\
-----end certificate-----\n

应用 ssl 包(applying ssl bundles)

一旦使用属性进行配置,就可以在由 spring boot 自动配置的各种类型连接的配置属性中通过名称引用 ssl 包。

使用 ssl 包(using ssl bundles)

spring boot 会自动配置一个 sslbundles 类型的 bean,该 bean 可提供对使用 spring.ssl.bundle 属性配置的每个命名包的访问。

可以从自动配置的 sslbundles bean 中检索 sslbundle,并使用它来创建用于在客户端库中配置 ssl 连接的对象。sslbundle 提供了一种分层的方法来获取这些 ssl 对象:

  • getstores() 可用于访问密钥库和信任库的 java.security.keystore 实例,以及任何所需的密钥库密码。
  • getmanagers() 可用于访问 java.net.ssl.keymanagerfactory 和java.net.ssl.trustmanagerfactory 实例,以及它们创建的java.net.ssl.keymanager 和java.net.ssl.trustmanager 数组。
  • createsslcontext() 提供了一种便捷的方式来获取新的 java.net.ssl.sslcontext 实例。

此外,sslbundle 还提供了有关正在使用的密钥、要使用的协议以及应应用于 ssl 引擎的任何选项的详细信息。

以下示例演示了如何检索 sslbundle 并使用它来创建 sslcontext

import javax.net.ssl.sslcontext;

import org.springframework.boot.ssl.sslbundle;
import org.springframework.boot.ssl.sslbundles;
import org.springframework.stereotype.component;

@component
public class mycomponent {

    public mycomponent(sslbundles sslbundles) {
        sslbundle sslbundle = sslbundles.getbundle("mybundle");
        sslcontext sslcontext = sslbundle.createsslcontext();
        // do something with the created sslcontext
    }

}

重新加载 ssl 包(reloading ssl bundles)

当密钥材料发生更改时,可以重新加载 ssl 包。使用包的组件必须与可重新加载的 ssl 包兼容。目前,以下组件与此兼容:

  • tomcat web 服务器
  • netty web 服务器

要启用重新加载,你需要通过以下示例中的配置属性进行选择:

spring.ssl.bundle.pem.mybundle.reload-on-update=true
spring.ssl.bundle.pem.mybundle.keystore.certificate=file:/some/directory/application.crt
spring.ssl.bundle.pem.mybundle.keystore.private-key=file:/some/directory/application.key

然后,文件监视器将监视这些文件,如果文件发生更改,将重新加载 ssl 包。这反过来会触发使用组件的重新加载,例如,tomcat 将对启用 ssl 的连接器中的证书进行轮换。

你可以使用 spring.ssl.bundle.watch.file.quiet-period 属性来配置文件监视器的静默期(以确保没有更多更改)。

到此这篇关于springboot对ssl的支持实现的文章就介绍到这了,更多相关springboot ssl内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!

(0)

相关文章:

版权声明:本文内容由互联网用户贡献,该文观点仅代表作者本人。本站仅提供信息存储服务,不拥有所有权,不承担相关法律责任。 如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 2386932994@qq.com 举报,一经查实将立刻删除。

发表评论

验证码:
Copyright © 2017-2025  代码网 保留所有权利. 粤ICP备2024248653号
站长QQ:2386932994 | 联系邮箱:2386932994@qq.com