springboot tomcat HTTPS配置


Tomcat配置

常規配置在Spring Boot項目中,可以內置Tomcat、Jetty、Undertow、Netty等容器。當開發者添加了spring-boot-starter-web依賴之后,默認會使用Tomcat作為Web容器。如果需要對Tomcat做進一步的配置,可以在application.properties中進行配置,代碼如下:

server:
  port: 8081
  error:
    path: /error
  servlet:
    session:
      timeout: 1m
#    context-path: /xc
  tomcat:
    uri-encoding: UTF-8
    max-threads: 1

• server.port配置了Web容器的端口號。

• error.path配置了當項目出錯時跳轉去的頁面。

• session.timeout配置了session失效時間,30m表示30分鍾,如果不寫單位,默認單位是秒。由於Tomcat中配置session過期時間以分鍾為單位,因此這里單位如果是秒的話,該時間會被轉換為一個不超過所配置秒數的最大分鍾數,例如這里配置了119,默認單位為秒,則實際session過期時間為1分鍾。

• context-path表示項目名稱,不配置時默認為/。如果配置了,就要在訪問路徑中加上配置的路徑。

• uri-encoding表示配置Tomcat請求編碼。

• max-threads表示Tomcat最大線程數。

• basedir是一個存放Tomcat運行日志和臨時文件的目錄,若不配置,則默認使用系統的臨時目錄。

當然,Web容器相關的配置不止這些,這里只列出了一些常用的配置,完整的配置可以參考官方文檔Appendix A. Common application properties一節。

 

HTTPS配置

由於HTTPS具有良好的安全性,在開發中得到了越來越廣泛的應用,像微信公眾號、小程序等的開發都要使用HTTPS來完成。對於個人開發者而言,一個HTTPS證書的價格還是有點貴,國內有一些雲服務器廠商提供免費的HTTPS證書,一個賬號可以申請數個。不過在jdk中提供了一個Java數字證書管理工具keytool,在\jdk\bin目錄下,通過這個工具可以自己生成一個數字證書,生成命令如下:

keytool -genkey -alias tomcathttps -keyalg RSA -keysize 2048 -keystore xc.p12 -validity 365

• -genkey表示要創建一個新的密鑰。

• -alias表示keystore的別名。

• -keyalg表示使用的加密算法是RSA,一種非對稱加密算法。

• -keysize表示密鑰的長度。

• -keystore表示生成的密鑰存放位置。

• -validity表示密鑰的有效時間,單位為天。

在cmd窗口中直接執行如上命令,在執行的過程中需要輸入密鑰口令等信息,根據提示輸入即可。命令執行完成后,會在當前用戶目錄下生成一個名為xc.p12的文件,將這個文件復制到項目的根目錄下,然后在application.properties中做如下配置:

server:
  ssl:
    key-store: sang.p12
    key-alias: tomcathttps
    key-store-password: 123456

• key-store表示密鑰文件名。

• key-alias表示密鑰別名。

• key-store-password就是在cmd命令執行過程中輸入的密碼。

配置成功后,啟動項目,在瀏覽器中輸入“https://localhost:8081/”來查看結果。注意,證書是自己生成的,不被瀏覽器認可,此時添加信任或者繼續前進即可

此時,如果以HTTP的方式訪問接口,就會訪問失敗

 這是因為Spring Boot不支持同時在配置中啟動HTTP和HTTPS。這個時候可以配置請求重定向,將HTTP請求重定向為HTTPS請求。配置方式如下:

@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(8080);
        connector.setSecure(false);
        connector.setRedirectPort(8081);
        return connector;
    }
}

這里首先配置一個TomcatServletWebServerFactory,然后添加一個Tomcat中的Connector(監聽8080端口),並將請求轉發到8081上去。配置完成后,在瀏覽器中輸入“http://localhost:8080/”,就會自動重定向到https://localhost:8081/上。

 

文章來源: Spring Boot+Vue全棧開發實戰 2.4 Web容器配置


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM