SpringBoot2.x配置HTTPS訪問的過程

更新時間：2022年07月07日 08:47:28 作者：Hadoop_Liang

這篇文章主要介紹了SpringBoot2.x配置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
 
您所在的城市或區(qū)域名稱是什么?
 
  [Unknown]:  cc
 
您所在的省/市/自治區(qū)名稱是什么?
 
  [Unknown]:  dd
 
該單位的雙字母國家/地區(qū)代碼是什么?
 
  [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" 遷移到行業(yè)標準格式 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
您所在的城市或區(qū)域名稱是什么?
  [Unknown]:  dd
您所在的省/市/自治區(qū)名稱是什么?
  [Unknown]:  Ch
該單位的雙字母國家/地區(qū)代碼是什么?
  [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訪問這樣配置已經(jīng)夠用，如果需要http和https方式同時訪問的話，繼續(xù)看如下配置。

配置既能支持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都能訪問了

以上為個人經(jīng)驗，希望能給大家一個參考，也希望大家多多支持腳本之家。

您可能感興趣的文章: