Spring Boot 提供了配置 SSL 信任材料的能力，這些材料可以應用于多種類型的連接，以支持安全通信?？梢允褂靡?nbsp;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 實用程序創(chuàng)建的信任材料包，并將這些包存儲在 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，并使用它來創(chuàng)建用于在客戶端庫中配置 SSL 連接的對象。SslBundle 提供了一種分層的方法來獲取這些 SSL 對象：

• getStores() 可用于訪問密鑰庫和信任庫的 java.security.KeyStore 實例，以及任何所需的密鑰庫密碼。
• getManagers() 可用于訪問 java.net.ssl.KeyManagerFactory 和java.net.ssl.TrustManagerFactory 實例，以及它們創(chuàng)建的java.net.ssl.KeyManager 和java.net.ssl.TrustManager 數組。
• createSslContext() 提供了一種便捷的方式來獲取新的 java.net.ssl.SSLContext 實例。

此外，SslBundle 還提供了有關正在使用的密鑰、要使用的協(xié)議以及應應用于 SSL 引擎的任何選項的詳細信息。

以下示例演示了如何檢索 SslBundle 并使用它來創(chuàng)建 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）

當密鑰材料發(fā)生更改時，可以重新加載 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

然后，文件監(jiān)視器將監(jiān)視這些文件，如果文件發(fā)生更改，將重新加載 SSL 包。這反過來會觸發(fā)使用組件的重新加載，例如，Tomcat 將對啟用 SSL 的連接器中的證書進行輪換。

你可以使用 spring.ssl.bundle.watch.file.quiet-period 屬性來配置文件監(jiān)視器的靜默期（以確保沒有更多更改）。

到此這篇關于SpringBoot對SSL的支持實現的文章就介紹到這了,更多相關SpringBoot SSL內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

最新評論