SpringBoot启用Https(二十六)

https 协议:

超文本传输安全协议(HyperText Transfer Protocol Secure),缩写:HTTPS;

常称为 HTTP over TLS、HTTP over SSL 或 HTTP Secure)

是一种通过计算机网络进行安全通信的传输协议。HTTPS 经由 HTTP 进行通信,但利用 SSL/TLS 来加密数据包。

HTTPS 开发的主要目的,是提供对网站服务器的身份认证,保护交换数据的隐私与完整性。

这个协议由网景公司(Netscape)在 1994 年首次提出,随后扩展到互联网上。

HTTPS 连接经常用于网络上的交易支付和企业信息系统中敏感信息的传输。


在 2000 年代末至 2010 年代初,HTTPS 开始广泛使用,以确保各类型的网页真实,

保护账户和保持用户通信,身份和网络浏览的私密性。


一. 通过 JDK自带的工具生成 https 证书

进入到 %JAVA_HOME%\bin 目录下, 使用 keytool.exe 命令

SpringBoot启用Https(二十六)



生成证书


在这个 bin 目录,打开 cmd 窗口

keytool -genkey -alias myhttps -keyalg RSA -keysize 1024  -keystore D:\yjl.p12 -validity 365

SpringBoot启用Https(二十六)

命令含义:


genkey 表示要创建一个新的密钥。


alias 表示 keystore 的别名。


keyalg 表示使用的加密算法是 RSA ,一种非对称加密算法。


keysize 表示密钥的长度。


keystore 表示生成的密钥存放位置。


validity 表示密钥的有效时间,单位为天。


注意,我们使用的密码是 123456, 在 D 盘下生成了 yjl.p12 文件.

SpringBoot启用Https(二十六)


二. 构建 SpringBoot 的 Thymeleaf 项目环境

创建 Maven 项目,构建 Thymeleaf 环境


可以参考老蝴蝶以前写的系列文章: SpringBoot整合Thymeleaf(十三)

SpringBoot启用Https(二十六)



实现一个 index.html 页面 和对应的接口实现


UserController

@Controller
public class UserController {
    //跳转到页面
    @RequestMapping("/")
    public String index(){
        return "index";
    }
    @RequestMapping("/hello")
    @ResponseBody
    //实现接口
    public String hello(){
        return "你好啊,我是岳泽霖";
    }
}


启动项目,页面可以正常的跳转,接口可以正常的访问.


三. SpringBoot 启用 https

三.一 放置文件

将keytools 生成的秘钥文件 放置在 resources 目录下

SpringBoot启用Https(二十六)

三.二 application.yml 配置 https

server:
  port: 8043
  servlet:
    context-path: /Https
  # 配置https
  ssl:
    key-store: classpath:yjl.p12   #路径
    key-alias: myhttps # 别名,与创建时一致
    key-store-password: 123456  # 密码,与创建时一致
spring:
  # 配置thymeleaf的相关信息
  thymeleaf:
    # 开启视图解析
    enabled: true
    #编码格式
    encoding: UTF-8
    #前缀配置
    prefix: classpath:/templates/
    # 后缀配置
    suffix: .html
    #是否使用缓存 开发环境时不设置缓存
    cache: false
    # 格式为 HTML 格式
    mode: HTML5
    # 配置类型
    servlet:
      content-type: text/html


三.三 启动连接

启动项目, 注意观察控制台

SpringBoot启用Https(二十六)



使用的是 8043(https) 以前是 8043(http)


访问页面跳转


输入网址: http://localhost:8043/Https

SpringBoot启用Https(二十六)



输入接口: http://localhost:8043/Https/hello


SpringBoot启用Https(二十六)


这个时候,传统的 http 协议就无法访问了, 只能使用 https 协议


https://localhost:8043/Https/

SpringBoot启用Https(二十六)



仔细看:


SpringBoot启用Https(二十六)


写着不安全.


https://localhost:8043/Https/hello

SpringBoot启用Https(二十六)

https 是生效的.

三.四 https 配置时配置信息错误

application.yml

ssl:
    key-store: classpath:yjl.p12
    key-alias: myhttps
    key-store-password: 123456


配置时,


如果配置密码写错误时, 如 key-store-password 配置成 abc123

Caused by: java.security.UnrecoverableKeyException: Password verification failed

SpringBoot启用Https(二十六)

如果密码写对,但是 别名 key-alias 配置错了,如写成 hhhhttps

Caused by: java.io.IOException: jsse.alias_no_key_entry


配置的https 文件的别名和密码不能写错.


三.五 启动 http 配置

考虑到 Spring Boot 不支持同时启动 HTTP 和 HTTPS ,为了解决这个问题,我们这里可以配置一个请求转发,当用户发起 HTTP 调用时,自动转发到 HTTPS 上。


在 config 包下 创建 TomcatConfig 配置

package top.yueshushu.learn.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.boot.web.embedded.tomcat.TomcatServletWebServerFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
/**
 * @ClassName:TomcatConfig
 * @Description 配置Tomcat,同时支持 https 和http
 * @Author zk_yjl
 * @Date 2021/11/1 18:42
 * @Version 1.0
 * @Since 1.0
 **/
@Configuration
public class TomcatConfig {
    @Bean
    TomcatServletWebServerFactory tomcatServletWebServerFactory() {
        TomcatServletWebServerFactory factory = new TomcatServletWebServerFactory(){
            @Override
            protected void postProcessContext(Context context) {
                SecurityConstraint constraint = new SecurityConstraint();
                constraint.setUserConstraint("CONFIDENTIAL");
                SecurityCollection collection = new SecurityCollection();
                collection.addPattern("/*");
                constraint.addCollection(collection);
                context.addConstraint(constraint);
            }
        };
        factory.addAdditionalTomcatConnectors(createTomcatConnector());
        return factory;
    }
    private Connector createTomcatConnector() {
        Connector connector = new
                Connector("org.apache.coyote.http11.Http11NioProtocol");
        connector.setScheme("http");
        connector.setPort(8081);  //接口跳转  访问用的是  http: 80
        connector.setSecure(false);
        connector.setRedirectPort(8043);  //会跳转到  https: 8043
        return connector;
    }
}


启动,查看控制台信息

SpringBoot启用Https(二十六)


8081(http) 8043(https) 都是可以访问的.


当我们输入网址: http://localhost:8081/Https/ 访问 http 请求时


会自动跳转到: https://localhost:8043/Https/


配置生效


上一篇:itext poi 学习之旅 (1)创建pdf


下一篇:spring 配置文件XSD地址