Spring Boot配置SSL证书

目前越来越多的网站开始支持HTTPS连接，而想要支持HTTPS连接就必须要有SSL证书，下面将介绍如何在Spring Boot项目中配置SSL证书。

一、获取证书

1、生成证书

关于如何获取SSL证书，请阅读：SSL证书生成和配置

2、添加证书

将JKS格式的SSL放入项目根目录下src/main/resources文件夹中即可。

二、修改配置文件

1、application.properties

在application.properties文件中添加以下内容：

#证书位置
server.ssl.key-store=classpath:<filename>.jks
#密钥库密码
server.ssl.key-password=<password>
#证书类型
server.ssl.key-store-type=JKS
#证书别名
server.ssl.key-alias=<alias>
# 设置监听端口
tomcat.listen.port=80
# 设置重定向端口
tomcat.redirect.port=443

注意最后两项tomcat.listen.port和tomcat.redirect.port是自定义的配置项。

2、pom.xml

在pom.xml文件中添加以下配置，避免打包时过滤掉SSL证书文件。

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
        <!-- 打包时不过滤资源 -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-resources-plugin</artifactId>
            <configuration>
                <nonFilteredFileExtensions>
                    <!-- 不过滤SSL证书 -->
                    <nonFilteredFileExtension>jks</nonFilteredFileExtension>
                </nonFilteredFileExtensions>
            </configuration>
            <version>3.1.0</version>
        </plugin>
    </plugins>
</build>

三、添加配置类

在项目中添加一个TomcatConfig.java配置类：

package cn.frankfang.config;

import org.apache.catalina.Context;
import org.apache.catalina.connector.Connector;
import org.apache.tomcat.util.descriptor.web.SecurityCollection;
import org.apache.tomcat.util.descriptor.web.SecurityConstraint;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.web.embedded.tomcat.TomcatServletWebServerFactory;
import org.springframework.boot.web.servlet.server.ServletWebServerFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class TomcatConfig {

    @Value("${tomcat.listen.port}")
    private int port;

    @Value("${tomcat.redirect.port}")
    private int redirectPort;

    @Bean
    ServletWebServerFactory tomcatEmbeddedServletContainerFactory() {
        TomcatServletWebServerFactory tomcat = new TomcatServletWebServerFactory() {
            @Override
            protected void postProcessContext(Context context) {
                SecurityConstraint securityConstraint = new SecurityConstraint();
                securityConstraint.setUserConstraint("CONFIDENTIAL");
                SecurityCollection collection = new SecurityCollection();
                collection.addPattern("/*");
                securityConstraint.addCollection(collection);
                context.addConstraint(securityConstraint);
            }
        };
        tomcat.addAdditionalTomcatConnectors(httpConnector());
        return tomcat;
    }

    private Connector httpConnector() {
        Connector connector = new Connector("org.apache.coyote.http11.Http11NioProtocol");
        connector.setScheme("http");
        //Connector监听的http的端口号
        connector.setPort(port);
        connector.setSecure(false);
        //监听到http的端口号后转向到的https的端口号
        connector.setRedirectPort(redirectPort);
        return connector;
    }
}