From a08bc5fd5112cae1a0a18d61e9497346f28ad351 Mon Sep 17 00:00:00 2001
From: "Yangkai.Shen" <237497819@qq.com>
Date: Sat, 20 Aug 2022 13:59:37 +0800
Subject: [PATCH] =?UTF-8?q?:sparkles:=20=E5=85=B6=E4=BB=96=E6=A8=A1?=
=?UTF-8?q?=E5=9D=97=E4=B9=8B=20https=20=E6=A1=88=E4=BE=8B=E5=AE=8C?=
=?UTF-8?q?=E6=88=90?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
demo-https/.gitignore | 31 -----
demo-https/README.md | 110 ---------------
demo-https/src/main/resources/application.yml | 11 --
demo-https/src/main/resources/server.keystore | Bin 2255 -> 0 bytes
demo-https/ssl.png | Bin 78633 -> 0 bytes
demo-others/demo-others-https/README.md | 148 +++++++++++++++++++++
.../demo-others-https}/pom.xml | 22 +--
.../java/com/xkcoding/https/HttpsApplication.java | 4 +-
.../com/xkcoding/https/config/HttpsConfig.java | 4 +-
.../src/main/resources/application.yml | 13 ++
.../src/main/resources/spring-boot-demo.key | Bin 0 -> 2812 bytes
.../src/main/resources/static/index.html | 4 +-
.../com/xkcoding/https/HttpsApplicationTests.java | 4 +-
demo-others/pom.xml | 4 +
pom.xml | 1 -
15 files changed, 184 insertions(+), 172 deletions(-)
delete mode 100644 demo-https/.gitignore
delete mode 100644 demo-https/README.md
delete mode 100644 demo-https/src/main/resources/application.yml
delete mode 100644 demo-https/src/main/resources/server.keystore
delete mode 100644 demo-https/ssl.png
create mode 100644 demo-others/demo-others-https/README.md
rename {demo-https => demo-others/demo-others-https}/pom.xml (78%)
rename demo-https/src/main/java/com/xkcoding/https/SpringBootDemoHttpsApplication.java => demo-others/demo-others-https/src/main/java/com/xkcoding/https/HttpsApplication.java (72%)
rename {demo-https => demo-others/demo-others-https}/src/main/java/com/xkcoding/https/config/HttpsConfig.java (95%)
create mode 100644 demo-others/demo-others-https/src/main/resources/application.yml
create mode 100644 demo-others/demo-others-https/src/main/resources/spring-boot-demo.key
rename {demo-https => demo-others/demo-others-https}/src/main/resources/static/index.html (61%)
rename demo-https/src/test/java/com/xkcoding/https/SpringBootDemoHttpsApplicationTests.java => demo-others/demo-others-https/src/test/java/com/xkcoding/https/HttpsApplicationTests.java (69%)
diff --git a/demo-https/.gitignore b/demo-https/.gitignore
deleted file mode 100644
index a2a3040..0000000
--- a/demo-https/.gitignore
+++ /dev/null
@@ -1,31 +0,0 @@
-HELP.md
-target/
-!.mvn/wrapper/maven-wrapper.jar
-!**/src/main/**
-!**/src/test/**
-
-### STS ###
-.apt_generated
-.classpath
-.factorypath
-.project
-.settings
-.springBeans
-.sts4-cache
-
-### IntelliJ IDEA ###
-.idea
-*.iws
-*.iml
-*.ipr
-
-### NetBeans ###
-/nbproject/private/
-/nbbuild/
-/dist/
-/nbdist/
-/.nb-gradle/
-build/
-
-### VS Code ###
-.vscode/
diff --git a/demo-https/README.md b/demo-https/README.md
deleted file mode 100644
index 042cb6f..0000000
--- a/demo-https/README.md
+++ /dev/null
@@ -1,110 +0,0 @@
-# spring-boot-demo-https
-
-> 此 demo 主要演示了 Spring Boot 如何集成 https
-
-## 1. 生成证书
-
-首先使用 jdk 自带的 keytool 命令生成证书复制到项目的 `resources` 目录下（生成的证书一般在用户目录下 C:\Users\Administrator\server.keystore）
-
-> 自己生成的证书浏览器会有危险提示,去ssl网站上使用金钱申请则不会
-
-
-
-## 2. 添加配置
-
-1. 在配置文件配置生成的证书
-
-```yaml
-server:
- ssl:
- # 证书路径
- key-store: classpath:server.keystore
- key-alias: tomcat
- enabled: true
- key-store-type: JKS
- #与申请时输入一致
- key-store-password: 123456
- # 浏览器默认端口 和 80 类似
- port: 443
-```
-
-2. 配置 Tomcat
-
-```java
-/**
- *
- * HTTPS 配置类
- *
- *
- * @author yangkai.shen
- * @date Created in 2020-01-19 10:31
- */
-@Configuration
-public class HttpsConfig {
- /**
- * 配置 http(80) -> 强制跳转到 https(443)
- */
- @Bean
- public Connector connector() {
- Connector connector = new Connector("org.apache.coyote.http11.Http11NioProtocol");
- connector.setScheme("http");
- connector.setPort(80);
- connector.setSecure(false);
- connector.setRedirectPort(443);
- return connector;
- }
-
- @Bean
- public TomcatServletWebServerFactory tomcatServletWebServerFactory(Connector connector) {
- 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;
- }
-}
-```
-
-## 3. 测试
-
-启动项目，浏览器访问 http://localhost 将自动跳转到 https://localhost
-
-## 4. 参考
-
-- `keytool`命令参考
-
-```bash
-$ keytool --help
-密钥和证书管理工具
-
-命令:
-
- -certreq 生成证书请求
- -changealias 更改条目的别名
- -delete 删除条目
- -exportcert 导出证书
- -genkeypair 生成密钥对
- -genseckey 生成密钥
- -gencert 根据证书请求生成证书
- -importcert 导入证书或证书链
- -importpass 导入口令
- -importkeystore 从其他密钥库导入一个或所有条目
- -keypasswd 更改条目的密钥口令
- -list 列出密钥库中的条目
- -printcert 打印证书内容
- -printcertreq 打印证书请求的内容
- -printcrl 打印 CRL 文件的内容
- -storepasswd 更改密钥库的存储口令
-
-使用 "keytool -command_name -help" 获取 command_name 的用法
-```
-
-- [Java Keytool工具简介](https://blog.csdn.net/liumiaocn/article/details/61921014)
diff --git a/demo-https/src/main/resources/application.yml b/demo-https/src/main/resources/application.yml
deleted file mode 100644
index 21ad6fc..0000000
--- a/demo-https/src/main/resources/application.yml
+++ /dev/null
@@ -1,11 +0,0 @@
-server:
- ssl:
- # 证书路径
- key-store: classpath:server.keystore
- key-alias: tomcat
- enabled: true
- key-store-type: JKS
- #与申请时输入一致
- key-store-password: 123456
- # 浏览器默认端口 和 80 类似
- port: 443
diff --git a/demo-https/src/main/resources/server.keystore b/demo-https/src/main/resources/server.keystore
deleted file mode 100644
index a6b59ffd9cdb35963cb3374ffdfd1e42fe3c151e..0000000000000000000000000000000000000000
GIT binary patch
literal 0
KcmV+b0RR6000031
literal 2255
zcmV;=2r&2l?f&fm00062000310003126S(2V_|dv00D28imiqK00jXsf&~3A4h9M<
z1_1;CDgqG!0R;dAf&}Swj_D63QR=C8oDOF!(Yjs*p;b7qyA_!{G!_V0^dC5mhhVw8
zH8pT}=yl4KZDXLNU{jz08X;^uDo;tcz)>}#6M#<6jJ}@EZ&smA4$nhlYZ!B^ns)4ugMPg8sL_v1^Y`z+!g1mq@Ur}y+hx&;Ht$@N-64(Iu%cAoo28;r
zmE)|KiUgTv9v!F??9Q%s3h?rME<<2qf30U96=ZXmbA=lVYuzA@oxj(YY2_$H0Li3N
z)LJz1ehBC6@53VR8?UayL$oc~#nVmnRwH0ZB@&WGLe>KCyn$3wLIQ@JZDgC2j$`gw
z?$w5)z??H6g$ZbgywiQQJnjo|694TH%ocomp7OWWPk>kp`3k|qxZ1Lsk-Pz3q6Pn=
zH`SET{aoWIYPq=pnubGTwqiN=C5(*s3dA+OJu{=Fc#lYXGOSMknPmpcAJ(lNXU8BfYnk7QvEXStre~kM!qj9jP_Ag-j
zEFl1z@K$Q>BB-oy>k>VT90kA%?e%3?Zg^n6fTZbIX1UgZbZHQ6mXYfU2W`fQ
z9KC9EK}I(e7T$jy7P|D8WP$4Rz
zuVAj%Wm2Uku*-lSP5e5R8Lz}WvqacnuO9f6ZmbX55=yN;5_=OC`VvFb+@Ncwm9Dy`
zkUxuKC8D2zFL0XjOJo6}SgWDH5l$fp0000100mesH842<00W0Gf&+svf&y!x0|Eg8
z0t5;_qKz;O1_>&LNQUvX>MUL5HJn~162eF69;N(
zVQy!5X)zHn4+aBO1P2ocZeea?Xkl(=F%vKm1_MvX>MUL5HJn~162eF69;N(VQy!5X)zHn
z4+aBO1P2ocZeea?Xkl(=F%vKm1_M7mhGqRC%b>cE8$)Yf!dLZj+N@3Qb+y?j>n@WJjsX5Z}*(+6*D>V=x&+>bG
z8ubDL0RRD`Aut~>9R>qc9S#H*1QY=ADRgxG4<&LNQUKck)H8xZck4Mj;k@$LF
zx_{zFOY7ydvyrYq{*W7W!(XX;lb^{mE0m~oZ6%HX7=}xWrQ>{jDYsrQaB}ptSMPu1
z`!+?rGfgmAZZ`G}jzPKe-<>yFyBZM!`dN!!4m)Wy`Mj1zD9?bf=^GsSwp$&zckd@-
z++QOXFhNEegpYS>mLG$BaDOx)GSijA8>T2`EM79r(@U{C3-6Q;bx|z;+(XgBOw-!n
ds{Wb@?)Uy9cwtgq9X1pzqFgNuy}i8Jdpc#5*qQ(U
diff --git a/demo-https/ssl.png b/demo-https/ssl.png
deleted file mode 100644
index 6961426c908a8ddd10c49bf394a8e7354b1a9b26..0000000000000000000000000000000000000000
GIT binary patch
literal 0
KcmV+b0RR6000031
literal 78633
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