開啟 Tomcat 的 HTTPS 服務
在發布企業級應用的過程中會遇到一個硬性要求:自 iOS 7.1 之後,App 的下載網址必須是 https 開頭,這意味著伺服器一定要支援 HTTPS 協議(App Transport Security 進一步收緊了這項限制)。以下記錄在 Tomcat 上完成這件事的完整流程。
實驗環境:macOS 或 Windows 7、Tomcat 7.0、JDK 1.7
1. 安裝 Tomcat
下載頁面:https://tomcat.apache.org/download-70.cgi,選擇對應平台的版本。
2. 安裝 JDK
Tomcat 需要搭配對應的 JDK 才能運行,並設定好 JDK 路徑。
3. 驗證安裝
在瀏覽器輸入 https://localhost:8080,若出現 Tomcat 歡迎頁即代表設定正確;若畫面空白,請查看控制台的錯誤或警告訊息逐一修正。
4. 安裝 vcredist_x86
這是 OpenSSL 所需的執行環境,必須先裝好。
5. 安裝 OpenSSL
搜尋 Win32OpenSSL-1_0_1g.exe 下載安裝,一路下一步並指定安裝路徑(例如 D:\OpenSSL-Win32\)。
CA 憑證的製作分兩步。
1. 建立私鑰檔案
openssl genrsa -out myCA.key 2048
產出私鑰 myCA.key。
2. 建立根憑證
openssl req -x509 -new -key myCA.key -out myCA.cer -days 730 -subj /CN="My CustomCA"
產出根憑證 myCA.cer,機構名稱為 My Custom CA,有效期 730 天。
1. 建立私鑰
openssl genrsa -out server.key 2048
2. 建立 CSR(憑證簽署請求)
openssl req -new -out server.req -key server.key -subj /CN=127.0.0.1/CN=192.168.31.128/CN=localhost
這裡把伺服器可能的存取位址都放進 CN,實際部署時請替換為真實 IP 或網域名稱。輸出檔案為 server.req。
3. 用 CSR 簽發 SSL 憑證
openssl x509 -req -in server.req -out server.cer -CAkey myCA.key -CA myCA.cer -days 36500 -CAcreateserial -CAserial server.serial
此處把有效期設為 36500 天(約 100 年),輸出 server.cer,序號檔案為 server.serial(日後撤銷憑證時會用到)。
4. 將 .key 與 .cer 合併匯出為 .p12
openssl pkcs12 -export -in server.cer -inkey server.key -out server.p12 -name "server"
依提示輸入兩次憑證密碼,此處假設為 keypass,輸出 server.p12。
5. 將 .p12 匯入 Java keystore
keytool -importkeystore -v -srckeystore server.p12 -srcstoretype pkcs12 -srcstorepass keypass -destkeystore server.keystore -deststoretype jks -deststorepass keypass
keystore 檔名為 server.keystore,密碼同樣是 keypass。
把最終產出的 server.keystore 放到 Web 伺服器上,例如 Tomcat 的 conf 目錄,然後修改 server.xml:
<Connector port="8443" protocol="org.apache.coyote.http11.Http11Protocol" SSLEnabled="true"
maxThreads="150" scheme="https" secure="true"
keystoreFile="D:/CA/server.keystore" keystorePass="keypass"
clientAuth="false" sslProtocol="TLS" />
重啟 Tomcat,即可透過以下位址存取 HTTPS 服務:
https://localhost:8443/ 或 https://192.168.2.1:8443/
自簽憑證在瀏覽器與 iOS 系統中會被標記為不受信任。用於內部測試沒問題,但正式對外發布時,強烈建議向 CA 機構申請正式憑證——自簽憑證只能靠手動安裝根憑證信任,對一般使用者門檻過高。
另外,keystorePass 直接以明文寫在 server.xml 中並不安全。正式環境建議改用 Tomcat 的 tomcat-users.xml 或外部參數注入的方式管理密鑰庫口令,並限制 conf 目錄的檔案權限。
最後,若 App 端出現無法下載的情況,除了檢查伺服器憑證,也要確認 App 的 Info.plist 中 ATS 相關設定是否已放行對應網域,這兩邊是獨立的兩道關卡。