SpringBoot2.x配置HTTPS访问,总体上可以分为两大步:
- 生成SSL证书
- 配置HTTPS访问
一.生成SSL证书
取得SSL证书的方法有:
(1)阿里云购买免费的ssl证书
(2)用命令生成ssl证书
因为在阿里云购买后需要填写域名,所以这里选择第(2)种方式:用命令生成ssl证书
1.新建一个证书目录,例如D:\sslca
打开cmd命令窗口,切换到D:\sslca
- C:\Users\Administrator>d:
- D:\>cd D:\sslca
- D:\sslca>
2.命令生成证书
keytool -genkey -alias tomcat -keypass 12345678 -keyalg RSA -keysize 2048 -validity 365 -keystore ./tomcat.keystore -storepass 12345678
过程如下:提示问题的回答可以任意填写
D:\sslca>keytool -genkey -alias tomcat -keypass 12345678 -keyalg RSA -keysize 2048 -validity 365 -keystore ./tomcat.keystore -storepass 12345678
您的名字与姓氏是什么?
[Unknown]: liang
您的组织单位名称是什么?
[Unknown]: aa
您的组织名称是什么?
[Unknown]: bb
您所在的城市或区域名称是什么?
[Unknown]: cc
您所在的省/市/自治区名称是什么?
[Unknown]: dd
该单位的双字母国家/地区代码是什么?
[Unknown]: Ch
CN=liang, OU=aa, O=bb, L=cc, ST=dd, C=Ch是否正确?
[否]: y
Warning:
JKS 密钥库使用专用格式。建议使用 "keytool -importkeystore -srckeystore ./tomcat.keystore -destkeystore ./tomcat.keystore -deststoretype pkcs12" 迁移到行业标准格式 PKCS12。
D:\sslca>
在D:\sslca生成了tomcat.keystore文件:
3.生成客户端证书
keytool -genkey -alias client -keypass 12345678 -keyalg RSA -keysize 2048 -validity 365 -storetype PKCS12 -keystore ./client.p12 -storepass 12345678
过程如下:提示信息的回答可以任意填写
您的名字与姓氏是什么?
[Unknown]: aa
您的组织单位名称是什么?
[Unknown]: bb
您的组织名称是什么?
[Unknown]: cc
您所在的城市或区域名称是什么?
[Unknown]: dd
您所在的省/市/自治区名称是什么?
[Unknown]: Ch
该单位的双字母国家/地区代码是什么?
[Unknown]: Ch
CN=aa, OU=bb, O=cc, L=dd, ST=Ch, C=Ch是否正确?
[否]: y
在D:\sslca生成了client.p12文件:
二.配置HTTPS访问
1.打开已有的SpringBoot工程
2.将证书文件:client.p12复制到resources目录下
3.修改application.yml
server:
port: 8443 #注意,这里是https访问的的端口号
ssl:
key-store: file:F:\Study\mywebsite\websiteback\src\main\resources\client.p12
key-store-password: 12345678
key-store-type: PKCS12
key-alias: client
注意:key-store:值的路径要注意按实际修改
4.修改启动类
添加servletContainer()和initiateHttpConnector()两个方法,完整代码如下:
package com.jipson.websiteback;
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.mybatis.spring.annotation.MapperScan;
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
@MapperScan({"com.jipson.websiteback.dao"})
public class WebsitebackApplication {
public static void main(String[] args) {
SpringApplication.run(WebsitebackApplication.class, args);
}
@Bean
public TomcatServletWebServerFactory servletContainer() { //springboot2 新变化
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(initiateHttpConnector());
return tomcat;
}
private Connector initiateHttpConnector() {
Connector connector = new Connector("org.apache.coyote.http11.Http11NioProtocol");
connector.setScheme("http");
connector.setPort(8080);
connector.setSecure(false);
connector.setRedirectPort(8443);
return connector;
}
}
5.启动Springboot项目
6.浏览器访问 https://localhost:8443/getAllUser
可以看到用https访问成功了!
问题:此方式只支持https访问,访问http端口会自动转到https方式访问。如果项目只需要https访问这样配置已经够用,如果需要http和https方式同时访问的话,继续看如下配置。
配置既能支持https又能支持http的方式如下:
1.修改application.yml,添加http port配置
server:
port: 8443 #注意,这里是https访问的的端口号
http:
port: 8081
ssl:
key-store: file:F:\Study\mywebsite\websiteback\src\main\resources\client.p12
key-store-password: 12345678
key-store-type: PKCS12
key-alias: client
2.还原启动类(WebsitebackApplication.java):删除或注释掉servletContainer和initiateHttpConnector方法
3.添加配置类TomcatConfig.java
import org.apache.catalina.connector.Connector;
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("${server.http.port}")
private int httpPort;
@Bean
public ServletWebServerFactory servletContainer() {
TomcatServletWebServerFactory tomcat = new TomcatServletWebServerFactory();
tomcat.addAdditionalTomcatConnectors(createStandardConnector()); // 添加http
return tomcat;
}
private Connector createStandardConnector() {
Connector connector = new Connector("org.apache.coyote.http11.Http11NioProtocol");
connector.setPort(httpPort);
return connector;
}
}
这样配置就可以用http和https都能访问了
以上为个人经验,希望能给大家一个参考,也希望大家多多支持编程网。