Resin 配置 SSL 完整指南：基於 Sun JSSE 與 Keytool 的 Windows 實作

Resin 配置 SSL 完整指南：基於 Sun JSSE 與 Keytool 的 Windows 實作

Resin 啟用 HTTPS 需配置 <http-server> 節點下的 SSL 相關元素。本文採用 JDK 1.4 內建 **Sun JSSE** 方案，在 Windows 2000 上以 keytool 生成伺服器證書並修改 resin.conf，完成端到端 SSL 啟用與驗證。

環境準備

• OS: Windows 2000 Server
• JDK: 1.4.x (含 JSSE)
• Resin: 2.1.x
• 工具: keytool (JDK bin 目錄)

步驟 1：生成伺服器證書 (Keystore)

keytool -genkey -alias mykey -keyalg RSA -keystore keys/server.keystore

• 依提示輸入：Keystore 密碼、主密碼（**建議設為相同**）、CN（Common Name）**必須填寫伺服器 DNS 名稱**（如 localhost 或實際域名），否則瀏覽器會彈出憑證不匹配警告。
• 生成檔案：keys/server.keystore（相對 Resin 根目錄）。

步驟 2：修改 resin.conf 啟用 SSL

在 <http-server> 下擴展：

<caucho.com>
  <security-provider id="com.sun.net.ssl.internal.ssl.Provider"/>
</caucho.com>

<http-server>
  <doc>doc</doc>
  <http port="80"/>
  <srun port="6802" host="localhost"/>

  <!-- HTTPS 配置 -->
  <http port="443">
    <ssl>true</ssl>
    <key-store-file>keys/server.keystore</key-store-file>
    <key-store-password>YourPassWordHere</key-store-password>
  </http>
</http-server>

關鍵屬性：key-store-file 相對路徑、key-store-password 與生成時一致。

步驟 3：啟動驗證

1. 執行 bin/httpd.exe 啟動 Resin。
2. 瀏覽器訪問 https://localhost/，接受安全警告（自簽證書）。
3. 建立測試 JSP isSecure.jsp：

Secure? <%= request.isSecure() %>

訪問 https://localhost/isSecure.jsp，顯示 Secure? true 即成功。

消除瀏覽器安全警告（生產環境必做）

1. 將生成的證書匯入客戶端瀏覽器「受信任的根憑證授權機構」。
2. **生成證書時 CN 必須等於伺服器 DNS 名稱**（非 IP），否則瀏覽器仍報「名稱不匹配」。
3. 正式環境請向 CA (VeriSign, Thawte, Let's Encrypt 等) 申請受信任證書。

參考資源

• Resin 官方 SSL 快速入門：本地文檔
• Resin 3.0 SSL 詳細文檔：Caucho 官網
• Keytool 使用詳解：中文教程

「SSL 配置核心在於：真隨機金鑰生成、CN 匹配域名、私鑰保護、證書鏈完整。Resin 配置極簡，難點在 PKI 基礎設施而非伺服器本身。」