Spring Boot配置SSL实现https请求

Spring Boot配置SSL实现https请求

1. 生成SSL证书

• 专业的SSL证书较为昂贵，可以在腾讯云或者阿里云上申请免费的SSL证书。
• 如果只是做简单的demo，可以使用java自带的keytool工具生成SSL证书。

2. 使用keytool工具生成SSL证书

以windows系统为例（如果是linux系统，将keytool.exe替换为keytool即可），在终端输入

keytool.exe -genkey -alias test -storetype PKCS12 -keyalg RSA -keysize 2048 -keystore test.p12 -validity 3650

参数解释

-genkey: 生成SSL证书
-alias: 证书别名
-storetype: 秘钥仓库类型
-keyalg: 生成证书算法
-keysize: 证书大小
-keystore: 生成证书保存路径
-validity: 证书有效期

注意在终端输入生成SSL命令后，“您的名字和姓氏是什么？”这一项需要设置为你的域名，本地测试的话便是localhost，其余选项可以忽略。

3. Spring Boot项目配置SSL

在配置文件application.yml中添加如下内容

server:
#  配置端口号，https默认端口号为443，如果443端口被占用，将占用443端口的进程杀死
  port: 443
#  配置ssl证书
  ssl:
#    SSL证书test.p12与application.yml放在同级目录下
    key-store: classpath:test.p12
    key-store-password: 123456
    keyStoreType: PKCS12
    keyAlias: test

4. 测试SSL是否配置成功

创建HelloController

@RestController
@CrossOrigin(origins = "*")
public class HelloController {
    
    

    @GetMapping(value = "/hello")
    public String sayHello() {
    
    
        return "Hello World!";
    }

}

使用浏览器访问https://localhost/hello ，看是否正确响应
（第一次访问时，浏览器会警告，这是因为自己生成的SSL证书不被浏览器认可）。

如果出错：检查application.yml中端口号是否为443，检查443端口是否被其他进程占用。

5. http请求自动转换为https请求

修改入口类HttpsApplication，此配置方式需要SpringBoot2.0以上

package com.example.https;

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.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.web.embedded.tomcat.TomcatServletWebServerFactory;
import org.springframework.context.annotation.Bean;


@SpringBootApplication
public class HttpsApplication {
    
    

    public static void main(String[] args) {
    
    
        SpringApplication.run(HttpsApplication.class, args);
    }

    @Bean
    public Connector connector() {
    
    
        Connector connector = new Connector("org.apache.coyote.http11.Http11NioProtocol");
        // 捕获http请求，并将其重定向到443端口
        connector.setScheme("http");
        connector.setPort(80);
        connector.setSecure(false);
        connector.setRedirectPort(443);
        return connector;
    }

    @Bean
    public TomcatServletWebServerFactory servletContainer() {
    
    
        // 对http请求添加安全性约束，将其转换为https请求
        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(connector());
        return tomcat;
    }

}