Springboot以Tomcat为容器实现http重定向到https的两种方式！

谁践踏了优雅 2022-12-17 07:10 209阅读 0赞

## 1、 简介 ##

本文将介绍在Springboot中如何通过代码实现Http到Https的重定向，本文仅讲解Tomcat作为容器的情况，其它容器将在以后一一道来。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzQ1MjcwNjY3_size_1_color_FFFFFF_t_70_pic_center]

## 2 、相关概念 ##

**2.1 什么叫重定向**

所谓重定向，就是本来你想浏览地址A的，但是到达服务端后，服务端认为地址A的界面不在了或者你没权限访问等原因，不想你访问地址A；就告诉你另一个地址B，然后你再去访问地址B。

对于重定向一般有两个返回码：

*  301：永久性重定向；
 *  302：暂时性重定向。

通过Chrome查看网络详情，记录了几个网站的重定向情况：

<table> 
 <thead> 
  <tr> 
   <th align="center">网站</th> 
   <th align="center">域名</th> 
   <th align="center">重定向代码</th> 
   <th align="center">重定向后的网址</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="center">南瓜慢说</td> 
   <td align="center">www.pkslow.com</td> 
   <td align="center">301</td> 
   <td align="center">https://www.pkslow.com</td> 
  </tr> 
  <tr> 
   <td align="center">Google</td> 
   <td align="center">www.google.com</td> 
   <td align="center">307</td> 
   <td align="center">https://www.google.com</td> 
  </tr> 
  <tr> 
   <td align="center">Apple</td> 
   <td align="center">www.apple.com</td> 
   <td align="center">307</td> 
   <td align="center">https://www.apple.com</td> 
  </tr> 
  <tr> 
   <td align="center">支付宝</td> 
   <td align="center">www.alipay.com</td> 
   <td align="center">301</td> 
   <td align="center">https://www.alipay.com</td> 
  </tr> 
  <tr> 
   <td align="center">QQ</td> 
   <td align="center">www.qq.com</td> 
   <td align="center">302</td> 
   <td align="center">https://www.qq.com</td> 
  </tr> 
  <tr> 
   <td align="center">百度</td> 
   <td align="center">www.baidu.com</td> 
   <td align="center">307</td> 
   <td align="center">https://www.baidu.com</td> 
  </tr> 
 </tbody> 
</table>

> 注：307也是重定向的一种，是新的状态码。

**2.2 为什么要重定向**

结合我上面特意列的表格，是不是大概想到了为何要做这种重定向？不难发现上面的重定向都在做一件事，就是把http重定向为https。原因如下：

（1）http是不安全的，应该使用安全的https网址；

（2）但不能要求用户每次输入网站都输入https:// 吧，这也太麻烦了，所以大家都是习惯于只输入域名，甚至连www. 都不愿意输入。因此，用户的输入其实都是访问http的网页，就需要重定向到https以达到安全访问的要求。

**2.3 如何做到重定向**

首先，服务器必须要同时支持http和https，不然也就没有重定向一说了。因为https是必须提供支持的，那为何还要提供http的服务呢？直接访问https不就行了，不是多此一举吗？原因之前已经讲过了，大家是习惯于只输入简单域名访问的，这时到达的就是http，如果不提供http的支持，用户还以为你的网站已经挂了呢。

两种协议都提供支持，所以是需要打开两个Socket端口的，一般http为80，而https为443。然后就需要把所有访问http的请求，重定向到https即可。不同的服务器有不同的实现，现在介绍Springboot+Tomcat的实现。

## 3 、Springboot Tomcat实现重定向 ##

Springboot以Tomcat作为Servlet容器时，有两种方式可以实现重定向，一种是没有使用Spring Security的，另一种是使用了Spring Security的。代码结构如下：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzQ1MjcwNjY3_size_1_color_FFFFFF_t_70_pic_center 1]  
主类的代码如下：

package com.pkslow.ssl;
    
    import com.pkslow.ssl.config.containerfactory.HttpToHttpsContainerFactoryConfig;
    import com.pkslow.ssl.config.security.EnableHttpWithHttpsConfig;
    import com.pkslow.ssl.config.security.HttpToHttpsWebSecurityConfig;
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    import org.springframework.context.annotation.ComponentScan;
    import org.springframework.context.annotation.Import;
    
    @SpringBootApplication
    @Import({ EnableHttpWithHttpsConfig.class, HttpToHttpsWebSecurityConfig.class})
    //@Import(HttpToHttpsContainerFactoryConfig.class)
    @ComponentScan(basePackages = "com.pkslow.ssl.controller")
    public class SpringbootSslApplication { 
    
    	public static void main(String[] args) { 
    		SpringApplication.run(SpringbootSslApplication.class, args);
    	}
    	
    }

@ComponentScan(basePackages = “com.pkslow.ssl.controller”)：没有把config包扫描进来，是因为想通过@Import来控制使用哪种方式来进行重定向。当然还可以使用其它方式来控制，如@ConditionalOnProperty，这里就不展开讲了。

*  当没有使用Spring Security时，使用@Import(HttpToHttpsContainerFactoryConfig.class)；
 *  当使用Spring Security时，使用@Import(\{EnableHttpWithHttpsConfig.class,  
    HttpToHttpsWebSecurityConfig.class\})。

配置文件application.properties内容如下：

server.port=443
    http.port=80
    
    server.ssl.enabled=true
    server.ssl.key-store-type=jks
    server.ssl.key-store=classpath:localhost.jks
    server.ssl.key-store-password=changeit
    server.ssl.key-alias=localhost

需要指定两个端口，server.port为https端口；http.port为http端口。注意在没有https的情况下，server.port指的是http端口。

**3.1 配置Container Factory实现重定向**

配置的类为HttpToHttpsContainerFactoryConfig，代码如下：

package com.pkslow.ssl.config.containerfactory;
    
    import org.apache.catalina.Context;
    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.apache.catalina.connector.Connector;
    import org.springframework.beans.factory.annotation.Value;
    import org.springframework.context.annotation.Configuration;
    
    @Configuration
    public class HttpToHttpsContainerFactoryConfig { 
        @Value("${server.port}")
        private int httpsPort;
    
        @Value("${http.port}")
        private int httpPort;
    
        @Bean
        public TomcatServletWebServerFactory servletContainer() { 
            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(createHttpConnector());
            return tomcat;
        }
    
        private Connector createHttpConnector() { 
            Connector connector =
                    new Connector(TomcatServletWebServerFactory.DEFAULT_PROTOCOL);
            connector.setScheme("http");
            connector.setSecure(false);
            connector.setPort(httpPort);
            connector.setRedirectPort(httpsPort);
            return connector;
        }
    }

createHttpConnector()：这个方法主要是实现了在有https前提下，打开http的功能，并配置重定向的https的端口。

**3.2 配置Spring security实现重定向**

有两个配置类，一个为打开http服务，一个为实现重定向。

EnableHttpWithHttpsConfig主要作用是在已经有https的前提下，还要打开http服务。

package com.pkslow.ssl.config.security;
    
    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.server.WebServerFactoryCustomizer;
    import org.springframework.context.annotation.Configuration;
    import org.springframework.stereotype.Component;
    
    @Configuration
    public class EnableHttpWithHttpsConfig { 
        @Value("${http.port}")
        private int httpPort;
    
        @Component
        public class CustomContainer implements WebServerFactoryCustomizer<TomcatServletWebServerFactory> { 
    
            @Override
            public void customize(TomcatServletWebServerFactory factory) { 
                Connector connector = new Connector(TomcatServletWebServerFactory.DEFAULT_PROTOCOL);
                connector.setPort(httpPort);
                connector.setScheme("http");
                connector.setSecure(false);
                factory.addAdditionalTomcatConnectors(connector);
            }
        }
    }

HttpToHttpsWebSecurityConfig主要是针对Spring Security的配置，众所周知，Spring Security是功能十分强大，但又很复杂的。代码中已经写了关键的注释：

package com.pkslow.ssl.config.security;
    
    import org.springframework.beans.factory.annotation.Value;
    import org.springframework.context.annotation.Configuration;
    import org.springframework.security.config.annotation.web.builders.HttpSecurity;
    import org.springframework.security.config.annotation.web.builders.WebSecurity;
    import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;
    
    @Configuration
    public class HttpToHttpsWebSecurityConfig extends WebSecurityConfigurerAdapter { 
        @Value("${server.port}")
        private int httpsPort;
    
        @Value("${http.port}")
        private int httpPort;
    
        @Override
        protected void configure(HttpSecurity http) throws Exception { 
            //redirect to https - 用spring security实现
            http.portMapper().http(httpPort).mapsTo(httpsPort);
            http.requiresChannel(
                    channel -> channel.anyRequest().requiresSecure()
            );
    
            //访问路径/hello不用登陆获得权限
            http.authorizeRequests()
                    .antMatchers("/hello").permitAll()
                    .anyRequest().authenticated().and();
        }
    
        @Override
        public void configure(WebSecurity web) throws Exception { 
            //过滤了actuator后，不会重定向，也不用权限校验，这个功能非常有用
            web.ignoring()
                    .antMatchers("/actuator")
                    .antMatchers("/actuator/**");
        }
    }

## 结语： ##

有需要学习资料的小伙伴可以[点击进入，暗号：cspp][cspp] ，免费领取！  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzQ1MjcwNjY3_size_16_color_FFFFFF_t_70_pic_center]

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzQ1MjcwNjY3_size_16_color_FFFFFF_t_70_pic_center 1]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzQ1MjcwNjY3_size_1_color_FFFFFF_t_70_pic_center]: /images/20221123/eac61c71a1124b369956366ec65d1895.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzQ1MjcwNjY3_size_1_color_FFFFFF_t_70_pic_center 1]: /images/20221123/908b921e2ebe423fa8ec79c42c1ce48d.png
[cspp]: https://jq.qq.com/?_wv=1027&k=wZR4Xaft
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzQ1MjcwNjY3_size_16_color_FFFFFF_t_70_pic_center]: /images/20221123/3ba4f5a0849946309102418d962f05fa.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzQ1MjcwNjY3_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20221123/ce8586125e9146348618cb73cecebf19.png