Spring Boot：HTTP和HTTPS支援

如今，企業級應用程式的常見場景是同時支援HTTP和HTTPS兩種協議，這篇文章考慮如何讓Spring Boot應用程式同時支援HTTP和HTTPS兩種協議。

準備

為了使用HTTPS聯結器，需要生成一份Certificate keystore，用於加密和機密瀏覽器的SSL溝通。

如果你使用Unix或者Mac OS，可以透過下列命令： keytool-genkey-aliastomcat-keyalg RSA，在生成過程中可能需要你填入一些自己的資訊，例如我的機器上反饋如下：

可以看出，執行完上述命令後在home目錄下多了一個新的.keystore檔案。

How Do

• 首先在resources目錄下新建一個配置檔案tomcat.https.properties，用於存放HTTPS的配置資訊；

custom.tomcat.https.port=8443
custom.tomcat.https.secure=true
custom.tomcat.https.scheme=https
custom.tomcat.https.ssl=true
custom.tomcat.https.keystore=${user.home}/.keystore
custom.tomcat.https.keystore-password=changeit

• 然後在WebConfiguration類中建立一個靜態類TomcatSslConnectorProperties；

@ConfigurationProperties(prefix = "custom.tomcat.https")
public static class TomcatSslConnectorProperties {
    private Integer port;
    private Boolean ssl = true;
    private Boolean secure = true;
    private String scheme = "https";
    private File keystore;
    private String keystorePassword;
    //這裡為了節省空間，省略了getters和setters，讀者在實踐的時候要加上
    public void configureConnector(Connector connector) {
        if (port != null) {
            connector.setPort(port);
        }
        if (secure != null) {
            connector.setSecure(secure);
        }
        if (scheme != null) {
            connector.setScheme(scheme);
        }
        if (ssl != null) {
            connector.setProperty("SSLEnabled", ssl.toString());
        }
        if (keystore != null && keystore.exists()) {
            connector.setProperty("keystoreFile", keystore.getAbsolutePath());
            connector.setProperty("keystorePassword", keystorePassword);
        }
    }
}

@Configuration
@PropertySource("classpath:/tomcat.https.properties")
@EnableConfigurationProperties(WebConfiguration.TomcatSslConnectorProperties.class)
public class WebConfiguration extends WebMvcConfigurerAdapter {...}

@Bean
public EmbeddedServletContainerFactory servletContainer(TomcatSslConnectorProperties properties) {
    TomcatEmbeddedServletContainerFactory tomcat = new TomcatEmbeddedServletContainerFactory();
    tomcat.addAdditionalTomcatConnectors(createSslConnector(properties));
    return tomcat;
}
private Connector createSslConnector(TomcatSslConnectorProperties properties) {
    Connector connector = new Connector();
    properties.configureConnector(connector);
    return connector;
}