springboot項目配置ssl連接的實現(xiàn)示例
更新時間：2025年05月12日 09:21:04 作者：緣友一世
本文主要介紹了springboot項目配置ssl連接的實現(xiàn)示例,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧
說明
- 本文經(jīng)過本人實踐，具有實際可操作性。
- 本文重點說明如何快速完成初創(chuàng)springboot項目的ssl配置方式，如果需要深入學習ssl內(nèi)容，請移步
申請jks文件
在終端中切換到j(luò)dk/bin目錄下，然后輸入生成文件的命令
cd C:\Program Files\Java\jdk-21\bin keytool -genkeypair -alias AiDoctor -keyalg RSA -keysize 4096 -storetype JKS -keystore keystore.jks -validity 365
參數(shù)說明：
alias AiDoctor : 密鑰別名
keyalg RSA: 使用RSA算法
keysize 4096: 密鑰長度2048位
storetype JKS: 存儲類型為JKS
keystore keystore.jks: 生成的密鑰庫文件名
validity 365: 有效期365天(1年)
按照提示輸入相關(guān)信息：密鑰庫密碼、名字與姓氏(通常輸入域名)、組織單位名稱、組織名稱、城市或地區(qū)名稱、州或省份名稱、國家代碼(如CN)、確認信息是否正確、密鑰密碼(可以直接回車使用與密鑰庫相同的密碼)
完整的代碼和執(zhí)行過程
C:\Users\kongyue>cd C:\Program Files\Java\jdk-21\bin
C:\Program Files\Java\jdk-21\bin>keytool -genkeypair -alias AiDoctor -keyalg RSA -keysize 4096 -storetype JKS -keystore keystore.jks -validity 365
輸入密鑰庫口令:
再次輸入新口令:
輸入唯一判別名。提供單個點 (.) 以將子組件留空，或按 ENTER 以使用大括號中的默認值。
您的名字與姓氏是什么?
[Unknown]: yang
您的組織單位名稱是什么?
[Unknown]: henu
您的組織名稱是什么?
[Unknown]: henu
您所在的城市或區(qū)域名稱是什么?
[Unknown]: kaifeng
您所在的省/市/自治區(qū)名稱是什么?
[Unknown]: henu
該單位的雙字母國家/地區(qū)代碼是什么?
[Unknown]: Zh_CN
CN=yang, OU=henu, O=henu, L=kaifeng, ST=henu, C=Zh_CN是否正確?
[否]: y
正在為以下對象生成 4,096 位RSA密鑰對和自簽名證書 (SHA384withRSA) (有效期為 365 天):
CN=yang, OU=henu, O=henu, L=kaifeng, ST=henu, C=Zh_CN
輸入 <AiDoctor> 的密鑰口令
(如果和密鑰庫口令相同, 按回車):
Warning:
JKS 密鑰庫使用專用格式。建議使用 "keytool -importkeystore -srckeystore keystore.jks -destkeystore keystore.jks -deststoretype pkcs12" 遷移到行業(yè)標準格式 PKCS12。
JKS轉(zhuǎn)PKCS12
keytool -importkeystore -srckeystore keystore.jks -destkeystore keystore.jks -deststoretype pkcs12
C:\Program Files\Java\jdk-21\bin>keytool -importkeystore -srckeystore keystore.jks -destkeystore keystore.jks -deststoretype pkcs12 輸入源密鑰庫口令: 已成功導入別名 aidoctor 的條目。 已完成導入命令: 1 個條目成功導入, 0 個條目失敗或取消 Warning: 已將 "keystore.jks" 遷移到 PKCS12。將 JKS 密鑰庫作為 "keystore.jks.old" 進行了備份。
導出證書(用于客戶端信任)
如果需要讓客戶端信任此證書，可以導出公鑰證書：
keytool -exportcert -alias mydomain -keystore keystore.jks -file mydomain.crt -rfc
C:\Program Files\Java\jdk-21\bin>keytool -exportcert -alias AiDoctor -keystore keystore.jks -file AiDoctor.crt -rfc 輸入密鑰庫口令: 存儲在文件 <AiDoctor.crt> 中的證書
spring 配置ssl證書
將生成的keystore.jks文件復制到Spring Boot項目的src/main/resources目錄下
配置Spring Boot的application.yml
server:
ssl:
enabled: true
key-store: classpath:keystore.jks
key-store-password: yourpassword # 替換為你的密鑰庫密碼
key-password: yourpassword # 替換為你的密鑰密碼(如果不同)
key-alias: yourdomain
port: 8443
測試接口
@RestController
@RequestMapping("/test")
public class TestController {
@RequestMapping("/hello")
public String HController() {
return "Hello Controller";
}
}
測試HTTPS連接：啟動Spring Boot應(yīng)用，訪問https://localhost:8443
由于是自簽名證書，瀏覽器會顯示安全警告，可以添加例外繼續(xù)訪問。
補充：JKS轉(zhuǎn)PKCS12兩種方式的區(qū)別
keytool -importkeystore -srckeystore keystore.jks -destkeystore keystore.jks -deststoretype pkcs12 keytool -importkeystore -srckeystore keystore.jks -destkeystore keystore.pfx -deststoretype PKCS12
第一條命令（原地轉(zhuǎn)換）
keytool -importkeystore -srckeystore keystore.jks -destkeystore keystore.jks -deststoretype pkcs12
- 作用：將現(xiàn)有的
keystore.jks文件原地轉(zhuǎn)換為 PKCS12 格式 - 結(jié)果：
- 文件擴展名保持
.jks不變 - 但實際內(nèi)容已經(jīng)是 PKCS12 格式
- 原始 JKS 格式被備份成jks.old
- 文件擴展名保持
- 使用場景：當你希望保留原文件名但改用 PKCS12 格式時
第二條命令（新建文件）
keytool -importkeystore -srckeystore keystore.jks -destkeystore keystore.pfx -deststoretype PKCS12
- 作用：創(chuàng)建一個新的
keystore.pfx文件（PKCS12 格式） - 結(jié)果：
- 生成新文件
keystore.pfx - 原
keystore.jks文件保持不變 - 文件擴展名使用
.pfx（PKCS12 的常用擴展名）
- 生成新文件
- 使用場景：當你需要同時保留 JKS 和 PKCS12 兩個版本時
兩種格式的使用
兩種方式生成的文件都可以在 Spring Boot 中使用，但配置方式稍有不同：
- 對于原地轉(zhuǎn)換的
.jks文件（實際是 PKCS12 格式）
server:
ssl:
key-store: classpath:keystore.jks
key-store-type: PKCS12 # 必須明確指定
key-store-password: yourpassword
- 對于新建的
.pfx文件
server:
ssl:
key-store: classpath:keystore.pfx
key-store-type: PKCS12 # 可以省略，因為.pfx擴展名默認關(guān)聯(lián)PKCS12
key-store-password: yourpassword
實踐建議
推薦使用第二條命令（生成
.pfx文件）：- 保留原始 JKS 文件作為備份
.pfx擴展名更明確地表示文件格式- 是行業(yè)更通用的標準
如果你選擇原地轉(zhuǎn)換：
- 確保備份原始 JKS 文件
- 在配置中必須明確指定
key-store-type: PKCS12 - 注意文件擴展名與實際格式不符可能造成混淆
驗證文件格式：
keytool -list -v -keystore keystore.jks # 或 keytool -list -v -keystore keystore.pfx -storetype PKCS12
到此這篇關(guān)于springboot項目配置ssl連接的實現(xiàn)示例的文章就介紹到這了,更多相關(guān)springboot配置ssl連接內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
這篇文章介紹的是Java中的引用類型和使用場景，主要內(nèi)容展開Java中的引用類型，有強引用、軟引用 、弱引用、虛引用,需要的朋友可以參考一下2021-10-10
這篇文章主要介紹了學習Java內(nèi)存模型JMM的心得以及對其原理做了深入的介紹，有興趣的朋友學習下吧。2017-12-12
Java套接字(Socket)網(wǎng)絡(luò)編程入門
這篇文章主要介紹了Java套接字(Socket)網(wǎng)絡(luò)編程入門,Socket可以理解為是對TCP/IP協(xié)議的抽象,需要的朋友可以參考下2015-10-10
注解和反射應(yīng)該說是后期JAVA開發(fā)里面比較重要的技術(shù)了,通過注解和反射可以簡化許許多多的操作和步驟,最重要的是為JAVA的運行提供了更多的靈活性,這篇文章主要介紹了Java反射與注解的詳細講解,需要的朋友可以參考下2026-06-06
SpringBoot集成P6spy實現(xiàn)自定義SQL日志打印
本文主要介紹了SpringBoot集成P6spy實現(xiàn)自定義SQL日志打印，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2023-07-07
這篇文章主要為大家詳細介紹了Java實現(xiàn)動態(tài)日歷效果，文中示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下2021-07-07
這篇文章主要介紹了java操作elasticsearch的案例解析,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2019-10-10
JavaWeb中請求轉(zhuǎn)發(fā)和請求重定向的區(qū)別以及使用
今天帶大家學習JavaWeb的相關(guān)知識,文章圍繞著JavaWeb中請求轉(zhuǎn)發(fā)和請求重定向的區(qū)別以及使用展開,文中有非常詳細的介紹,需要的朋友可以參考下2021-06-06
IDEA 中 maven 的 Lifecycle 和Plugins&n
IDEA 主界面右側(cè) Maven 標簽欄有同樣的命令，比如 install，既在 Plugins 中存在，也在 Lifecycle中存在，到底選哪個？二者又有什么區(qū)別呢?下面小編給大家介紹下IDEA 中 maven 的 Lifecycle 和Plugins 的區(qū)別，感興趣的朋友一起看看吧2023-03-03
這篇文章主要介紹了Java實現(xiàn)的DES加密解密工具類,結(jié)合具體實例形式分析了Java實現(xiàn)的DES加密解密工具類定義與使用方法,需要的朋友可以參考下2017-09-09