關(guān)于Keytool配置?Tomcat的HTTPS雙向認(rèn)證的問題
證書生成
keytool 簡(jiǎn)介
Keytool是一個(gè)Java數(shù)據(jù)證書的管理工具, Keytool將密鑰(key)和證書(certificates)存在一個(gè)稱為keystore的文件中。
在keystore里,包含兩種數(shù)據(jù):
- 密鑰實(shí)體(Key entity)——密鑰(secret key)又或者是私鑰和配對(duì)公鑰(采用非對(duì)稱加密)
- 可信任的證書實(shí)體(trusted certificate entries)——只包含公鑰
我們常說的證書就是就是上面的公鑰,公鑰是公開給其它人使用的
- 證書后綴解釋
jks
是Java的keytool證書工具支持的證書私鑰格式;pfx
是微軟支持的私鑰格式(p12是pfx的新格式);cer
/crt
是證書的公鑰格式(cer是crt證書的微軟形式)csr
數(shù)字證書簽名請(qǐng)求文件(Cerificate Signing Request)
Tips:
.der
.cer
: 此證書文件是二進(jìn)制格式,只含有證書信息,不包含私鑰。.crt
: 此證書文件是二進(jìn)制格式或文本格式,一般為文本格式,功能與.der
及.cer
證書文件相同。.pem
: 此證書文件一般是文本格式,可以存放證書或私鑰,或者兩者都包含。.pem
文件如果只包含私鑰,一般用.key
文件代替。.pfx
.p12
: 此證書文件是二進(jìn)制格式,同時(shí)包含證書和私鑰,且一般有密碼保護(hù)。.keystore
.truststore
: 兩者本質(zhì)都是keystore,都是儲(chǔ)存密鑰的容器:- 不過兩者存放的密鑰所有者不同,keystore是存儲(chǔ)自己的公鑰和私鑰而,truststore是存儲(chǔ)自己信任對(duì)象的公鑰。約定通過文件名稱區(qū)分類型以及用途
truststore
是必須的,如果我們沒有顯式的指定,那么java會(huì)默認(rèn)指定為$JAVA_HOME/lib/security/cacerts
這個(gè)文件- java 在jdk 中已經(jīng)默認(rèn)在 $JAVA_HOME/lib/security/cacerts 這個(gè)文件中預(yù)置了常用的證書
- 不同語言需要的證書格式并不一致,比如說Java采用jks,.Net采用pfx和cer,Php則采用pem和cer;
- 區(qū)別證書的不是后綴名,而是文件的格式和內(nèi)容。
keytool 命令詳解
- 密鑰和證書管理工具
-certreq 生成證書請(qǐng)求 -changealias 更改條目的別名 -delete 刪除條目 -exportcert 導(dǎo)出證書(簡(jiǎn)寫 export) -genkeypair 生成密鑰對(duì)(簡(jiǎn)寫 genkey) -genseckey 生成密鑰 -gencert 根據(jù)證書請(qǐng)求生成證書 -importcert 導(dǎo)入證書或證書鏈(簡(jiǎn)寫 import) -importpass 導(dǎo)入口令 -importkeystore 從其他密鑰庫導(dǎo)入一個(gè)或所有條目 -keypasswd 更改條目的密鑰口令 -list 列出密鑰庫中的條目 -printcert 打印證書內(nèi)容 -printcertreq 打印證書請(qǐng)求的內(nèi)容 -printcrl 打印 CRL 文件的內(nèi)容 -storepasswd 更改密鑰庫的存儲(chǔ)口令
Tips:
- 使用
ketytool --help
獲取所有可用命令 - 使用
keytool -command_name -help
來獲取 command_name 的用法 - 常用參數(shù)
-genkey 產(chǎn)生密鑰對(duì)(genkeypair 簡(jiǎn)寫);表示要?jiǎng)?chuàng)建一個(gè)新的密鑰;alias和keystore缺省時(shí),在用戶主目錄中創(chuàng)建一個(gè)”.keystore”文件,且別名為mykey,包含用戶的公鑰、私鑰證書 -alias 產(chǎn)生證書別名,和keystore關(guān)聯(lián)的唯一別名,不區(qū)分大小寫(默認(rèn) `mykey`) -keystore 指定密鑰庫文件的名稱(默認(rèn)在用戶主目錄創(chuàng)建證書庫) -keyalg 指定密鑰的算法(可選擇密鑰算法:`RSA`、`DSA`、`EC`,默認(rèn)`DSA`) -keysize 指定密鑰長(zhǎng)度(與keyalg默認(rèn)對(duì)應(yīng)關(guān)系:`RSA=2048`、`DSA=2048`、`EC=256`) -sigalg 指定簽名算法(MD5和 SHA1的簽名算法已經(jīng)不安全) -validity 指定證書有效期天數(shù)(默認(rèn) `90`天) -storepass 指定密鑰庫口令,推薦與keypass一致(獲取keystore信息所需的密碼) -storetype 指定密鑰庫的類型,可用類型為:JKS、PKCS12等。(jdk9以前,默認(rèn)為JKS。自jdk9開始,默認(rèn)為PKCS12) -keypass 指定別名條目口令(私鑰的密碼) -dname 指定證書發(fā)行者信息(其中 CN 要和服務(wù)器的域名相同,本地測(cè)試則使用localhost,其他的可以不填) -list 顯示密鑰庫中的證書信息 -v 詳細(xì)輸出,顯示密鑰庫中的證書詳細(xì)信息 -file 指定導(dǎo)出或?qū)С龅奈募?-export 將別名指定的證書導(dǎo)出到文件(exportcert 簡(jiǎn)寫) -import 將已簽名數(shù)字證書導(dǎo)入密鑰庫(importcert 簡(jiǎn)寫) -printcert 查看導(dǎo)出的證書信息 -delete 刪除密鑰庫中某條目 -keypasswd 修改密鑰庫中指定條目口令 -storepasswd 修改keystore口令 -ext X.509 擴(kuò)展
- 所有密碼長(zhǎng)度必須大于或等于 6 位
- keyalg 指定加密算法;可以選擇的密鑰算法有:RSA、DSA(默認(rèn))、EC。
- sigalg 指定簽名算法(MD5和 SHA1的簽名算法已經(jīng)不安全):
- keyalg = RSA 時(shí),簽名算法有:MD5withRSA、SHA1withRSA、SHA256withRSA(默認(rèn))、SHA384withRSA、SHA512withRSA
- keyalg = DSA 時(shí),簽名算法有:SHA1withDSA、SHA256withDSA(默認(rèn))
- dname 表明了密鑰的發(fā)行者身份(Distinguished Names)
- CN = 域名或IP(Common Name) 注:生成服務(wù)器證書時(shí),CN要和服務(wù)器的域名相同,本地測(cè)試則使用localhost,其他的可以不填(客戶端證書無要求)
- OU = 組織單位名稱(Organization Unit)
- O = 組織名稱(Organization Name)
- L = 城市或區(qū)域名稱(Locality Name)
- ST = 州或省份名稱(State Name)
- C = 國(guó)家的簡(jiǎn)寫(Country,CN 代表中國(guó))
創(chuàng)建證書
創(chuàng)建秘鑰庫(keystore),秘鑰庫是存儲(chǔ)一個(gè)或多個(gè)密鑰條目的文件,每個(gè)密鑰條目應(yīng)該以一個(gè)別名標(biāo)識(shí),它包含密鑰和證書相關(guān)信息。
Usage:
keytool -genkey -alias <alias> -keyalg RSA [-sigalg SHA256withRSA] [-keysize 2048] -keypass <keypasswd> -keystore <keystore_file> -storetype JKS|PKCS12 -storepass <keystore_passwd> -validity 3650 -dname "CN=github.com,OU=github.com,Inc.,O=Github, Inc.,L=San Francisco,ST=California,C=US" -ext SAN=dns:github.com,dns:www.github.com,ip:127.0.0.1
Options:
-genkey 產(chǎn)生密鑰對(duì)(genkeypair 簡(jiǎn)寫) -alias 證書別名;和keystore關(guān)聯(lián)的唯一別名,這個(gè)alias通常不區(qū)分大小寫(默認(rèn)`mykey`) -keyalg 指定加密算法,RSA:非對(duì)稱加密(默認(rèn)`DSA`) -sigalg 指定簽名算法,可選; -keysize 指定密鑰長(zhǎng)度,可選; -keypass 指定別名條目口令(私鑰的密碼) -storetype 生成證書類型,可用的證書庫類型為:JKS、PKCS12等。 -keystore 指定產(chǎn)生的密鑰庫的位置; -storepass 指定密鑰庫的存取口令,推薦與keypass一致 -validity 證書有效期天數(shù);(默認(rèn)為 90天) -dname 表明了密鑰的發(fā)行者身份(Distinguished Names)生成證書時(shí),其中 CN 要和服務(wù)器的域名相同,本地測(cè)試則使用localhost,其他的可以不填 -ext X.509 擴(kuò)展
Tips:
- 此處需要注意:MD5和SHA1的簽名算法已經(jīng)不安全;
- 如果Tomcat所在服務(wù)器的域名不是“localhost”時(shí),瀏覽器會(huì)彈出警告窗口,提示用戶證書與所在域不匹配。
- 服務(wù)器證書 dname的 CN應(yīng)改為對(duì)應(yīng)的域名,如“www.github.com”;在本地做開發(fā)測(cè)試時(shí),CN應(yīng)填入“localhost”;
- 客戶端證書 dname的 CN可以是任意值,且不用使用 -ext擴(kuò)展。
創(chuàng)建證書栗子
生成服務(wù)器證書
keytool -genkey -alias server -keyalg RSA -keypass 123456 -keystore ~/ssl/tomcat.jks [-storetype JKS] -storepass 123456 -validity 3650 -dname "CN=localhost" -ext SAN=ip:127.0.0.1
生成客戶端證書,以便讓服務(wù)器來驗(yàn)證它。為了能將證書順利導(dǎo)入至IE和Firefox,證書格式應(yīng)該是PKCS12(客戶端的CN可以是任意值)
keytool -genkey -alias client -keyalg RSA -keypass 123456 -keystore ~/ssl/client.p12 -storetype PKCS12 -storepass 123456 -validity 3650 -dname "CN=client"
導(dǎo)出證書信息
此證書文件不包含私鑰;分為自簽名證書和認(rèn)證證書,下面分別介紹了兩中證書的生成方式
- 認(rèn)證證書與導(dǎo)出的服務(wù)器自簽名證書作用一致,使用時(shí)取其中一種證書即可。兩者主要區(qū)別為是否經(jīng)證書機(jī)構(gòu)認(rèn)證;
- 使用自簽名證書則無需生成證書簽名請(qǐng)求(CSR),使用認(rèn)證證書則無需導(dǎo)出服務(wù)器自簽名證書;
- 大部分認(rèn)證證書都是收費(fèi)的;
導(dǎo)出自簽名證書
自簽名證書沒有經(jīng)過證書認(rèn)證機(jī)構(gòu)進(jìn)行認(rèn)證,但并不影響使用,我們可以使用相應(yīng)的命令對(duì)證書進(jìn)行導(dǎo)出;
Usage:
keytool -export -alias <alias> -keystore <keystore_file> -storepass <keystore_passwd> -file <file_cer> [-rfc]
Options:
-export 執(zhí)行證書導(dǎo)出操作(exportcert 簡(jiǎn)寫) -alias 密鑰庫中的證書條目別名(jks里可以存儲(chǔ)多對(duì)公私鑰文件,通過別名指定導(dǎo)出的公鑰證書) -keystore 指定密鑰庫文件 -storepass 密鑰庫口令 -file 導(dǎo)出文件的輸出路徑 -rfc 使用Base64格式輸出(輸出pem編碼格式的證書,文本格式),不適用則導(dǎo)出的證書為DER編碼格式
導(dǎo)出證書栗子
導(dǎo)出服務(wù)器證書
此處為服務(wù)器的自簽名證書導(dǎo)出, 如果需要使用認(rèn)證證書,則生成證書簽名請(qǐng)求
keytool -export -alias server -keystore ~/ssl/tomcat.jks -storepass 123456 -file ~/ssl/server.cer
導(dǎo)出客戶端證書
雙向認(rèn)證: 服務(wù)端信任客戶端,由于不能直接將PKCS12格式的證書庫導(dǎo)入,所以必須先把客戶端證書導(dǎo)出為一個(gè)單獨(dú)的CER文件
keytool -export -alias client -keystore ~/ssl/client.p12 -storepass 123456 -file ~/ssl/client.cer -rfc
獲取認(rèn)證證書(生成證書簽名請(qǐng)求)
如果想得到證書認(rèn)證機(jī)構(gòu)的認(rèn)證,則不使用上述的自簽名證書,需要使用步驟導(dǎo)出數(shù)字證書并簽發(fā)申請(qǐng)(Cerificate Signing Request),經(jīng)證書認(rèn)證機(jī)構(gòu)認(rèn)證并頒發(fā)后,再將認(rèn)證后的證書導(dǎo)入本地密鑰庫與信任庫。
Usage:
keytool -certreq -alias <alias> -keystore <keystore_file> -storepass <keystore_passwd> -file <file_csr>
Options:
-certreq 執(zhí)行證書簽發(fā)申請(qǐng)導(dǎo)出操作 -alias 密鑰庫中的證書條目別名 -keystore 密鑰庫文件名稱 -storepass 密鑰庫口令 -file 輸出的csr文件路徑
生成證書簽名請(qǐng)求栗子
生成證書簽名請(qǐng)求(CSR)
keytool -certreq -alias server -keystore ~/ssl/tomcat.jks -storepass 123456 -file ~/ssl/certreq.csr
查看生成的CSR證書請(qǐng)求
keytool -printcertreq -file certreq.csr
導(dǎo)入證書庫
雙向認(rèn)證: 將各自的公鑰證書分別導(dǎo)入對(duì)方的信任庫,使客戶端和服務(wù)端相互信任。
Usage:
keytool -import [-trustcacerts] -alias <alias_cer> -keystore <keystore_file> -storepass <keystore_passwd> -file <file_cer>
Options:
-import 執(zhí)行證書導(dǎo)入操作(importcert 簡(jiǎn)寫) -alias 指定導(dǎo)入密鑰庫中的證書別名(指定的條目別名不能與密鑰庫中已存在的條目別名重復(fù)(導(dǎo)入簽發(fā)證書除外)) -trustcacerts 將證書導(dǎo)入信任庫(信任來自 cacerts 的證書) -keystore 密鑰庫名稱 -storepass 密鑰庫口令 -file 輸入文件名
導(dǎo)入證書栗子
1.安裝服務(wù)器證書(將服務(wù)器公鑰證書導(dǎo)入客戶端)
雙向認(rèn)證: 客戶端信任服務(wù)端: 在客戶機(jī)器上雙擊證書文件完成導(dǎo)入操作(window中導(dǎo)入)
- 將服務(wù)器公鑰證書 server.cer 發(fā)往客戶端機(jī)器 >> 雙擊該證書進(jìn)入“證書信息”頁 >> 點(diǎn)擊【安裝證書】進(jìn)入“證書導(dǎo)入向?qū)?rdquo;首頁 >> 點(diǎn)擊【下一步】>> 選中【將所有的證書都放入下列存儲(chǔ)】,然后單擊【瀏覽】 >> 選擇【受信任的根證書頒發(fā)機(jī)構(gòu)】b并點(diǎn)擊【確定】 >> 點(diǎn)擊【下一步】 >> 點(diǎn)擊【完成】。然后彈出提示【導(dǎo)入完成】。
- 將客戶端證書 client.p12 發(fā)往客戶端機(jī)器 >> 雙擊該證書進(jìn)入“證書導(dǎo)入向?qū)?rdquo;首頁 >> 點(diǎn)擊【下一步】>> 點(diǎn)擊【下一步】>> 輸入證書密碼(keystore密碼)并點(diǎn)擊【下一步】 >> 點(diǎn)擊【下一步】 >> 點(diǎn)擊【完成】。然后彈出提示【導(dǎo)入完成】。
2.證書導(dǎo)入信任庫(將客戶端公鑰證書導(dǎo)入信任庫)
雙向認(rèn)證: 服務(wù)端信任客戶端:
keytool -import -alias clientCert -keystore ~/ssl/truststore.jks -storepass 123456 -file ~/ssl/client.cer
此步驟會(huì)生成信任證書 truststore.jks文件, 文件存放需要信任的公鑰證書,如客戶端證書(也可以將 keystore值改為服務(wù)器密鑰庫,即tomcat.jks。此時(shí)的tomcat.jks 就同時(shí)是服務(wù)的密鑰庫和信任庫)
查看證書
Usage:
# 查看單個(gè)證書(cer | crt) keytool -printcert -file <cert_file> [-v|-rfc] # 查看密鑰庫中的證書條目 keytool -list [-alias <alias_name>] -keystore <keystore_file> -storepass <keystore_passwd> [-v|-rfc] # 查看生成的CSR證書請(qǐng)求 keytool -printcertreq -file <certreq_file>
Options:
-alias 密鑰庫中的證書條目別名; -keystore 指定密鑰庫文件; -storepass 密鑰庫口令; -printcert 執(zhí)行證書打印命令; -list 缺省情況下,命令打印證書的 MD5 指紋。 而如果指定了 -v 選項(xiàng),將以可讀格式打印證書, 如果指定了 -rfc 選項(xiàng),將以可打印的編碼格式輸出證書。
查看栗子證書
查看證書信息
keytool -printcert -file ~/ssl/client.cer [-v|-rfc]
查看密鑰庫
keytool -list -keystore ~/ssl/tomcat.jks -storepass 123456 -v
查看base64的內(nèi)容(即PEM編碼)
keytool -list -keystore ~/ssl/tomcat.jks -storepass 123456 -rfc
其他keytool命令
# 刪除keystore里面指定證書條目 keytool -delete -alias <alias> -keystore <keystore_file> -storepass <keystore_passwd> # 修改條目別名 keytool -changealias -keystore <keystore_file> -alias <old_alias> -destalias <new_alias> # 修改條目密碼 keytool -keypasswd -alias <alias> -keypass <old_keypasswd> -new <new_keypasswd> -keystore <keystore_file> -storepass <keystore_passwd> # 修改keysore密碼 keytool -storepasswd -new <new_storepasswd> -keystore <keystore_file> -storepass <old_storepasswd> # 列出信任的CA證書(查看 JVM的信任庫中的證書,storepass 默認(rèn)為changeit) ## 該證書文件存在于JAVA_HOME\jre\lib\security目錄下,是Java系統(tǒng)的CA證書倉庫,可以用 'alias' 來查看證書是否真的導(dǎo)入到JVM中 keytool -list -v [-alias clientCer] -keystore $JAVA_HOME/jre/lib/security/cacerts -storepass changeit # 導(dǎo)入新的CA到信任證書,導(dǎo)入到 JRE的信任證書庫 ## 常出現(xiàn)的異常:“未找到可信任的證書” -- 主要原因?yàn)樵诳蛻舳宋磳⒎?wù)器下發(fā)的證書導(dǎo)入到JVM中。 keytool -import -trustcacerts -alias clientCer -keystore $JAVA_HOME/jre/lib/security/cacerts -storepass changeit -file ~/ssl/client.cer
Tomcat服務(wù)認(rèn)證配置
打開Tomcat_HOME/conf/server.xml,找到如下原注釋內(nèi)容,并修改如下:
<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true" maxThreads="150" scheme="https" secure="true" clientAuth="true" sslProtocol="TLS" keystoreFile="~/ssl/tomcat.jks" keystorePass="123456" truststoreFile="~/ssl/truststore.jks" truststorePass="123456" />
Tips:
- 其中
clientAuth
指定是否需要驗(yàn)證客戶端證書 false
: 表示單向SSL驗(yàn)證,即服務(wù)端認(rèn)證;true
: 表示強(qiáng)制雙向SSL驗(yàn)證,必須驗(yàn)證客戶端證書;want
: 表示可以驗(yàn)證客戶端證書,但如果客戶端沒有有效證書,也不強(qiáng)制驗(yàn)證。- 如果設(shè)置了clientAuth="true",則需要強(qiáng)制驗(yàn)證客戶端證書。可通過雙擊
p12
文件將證書導(dǎo)入至瀏覽器; - 瀏覽器的HTTP缺省端口為
80
, HTTPS缺省端口為443
; keystoreFile
/keystorePass
: 服務(wù)器證書文件和密碼;truststoreFile
/truststorePass
: 信任證書文件和密碼;用來驗(yàn)證客戶端的。
SSL單向證書認(rèn)證配置
創(chuàng)建服務(wù)器證書導(dǎo)出服務(wù)器公鑰證書將服務(wù)器公鑰證書導(dǎo)入客戶端(客戶端信任服務(wù)器)配置 Tomcat
打開Tomcat_HOME/conf/server.xml,找到如下原注釋內(nèi)容,并修改如下:
<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true" maxThreads="150" scheme="https" secure="true" clientAuth="false" sslProtocol="TLS" keystoreFile="~/ssl/tomcat.jks" keystorePass="123456"() />
SSL雙向證書認(rèn)證配置
- 創(chuàng)建服務(wù)器證書,創(chuàng)建客戶端證書
- 導(dǎo)出服務(wù)器公鑰證書,導(dǎo)出客戶端公鑰證書
- 將服務(wù)器公鑰證書導(dǎo)入客戶端(客戶端信任服務(wù)器)
- 將客戶端公鑰證書導(dǎo)入信任庫(服務(wù)器信任客戶端)
- 配置 Tomcat,并開啟雙向認(rèn)證():
打開Tomcat_HOME/conf/server.xml,找到如下原注釋內(nèi)容,并修改如下:
<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true" maxThreads="150" scheme="https" secure="true" clientAuth="true" sslProtocol="TLS" keystoreFile="~/ssl/tomcat.jks" keystorePass="123456" truststoreFile="~/ssl/truststore.jks" truststorePass="123456" />
配置Tomcat服務(wù) HTTP自動(dòng)跳轉(zhuǎn)到 HTTPS(按需選配)
打開Tomcat_HOME/conf/web.xml,在 與 加入如下代碼:
<login-config> <!-- Authorization setting for SSL --> <auth-method>CLIENT-CERT</auth-method> <realm-name>Client Cert Users-only Area</realm-name> </login-config> <security-constraint> <!-- Authorization setting for SSL --> <web-resource-collection > <web-resource-name >SSL</web-resource-name> <url-pattern>/*</url-pattern> </web-resource-collection> <user-data-constraint> <transport-guarantee>CONFIDENTIAL</transport-guarantee> </user-data-constraint> </security-constraint>
測(cè)試
- 啟動(dòng) Tomcat項(xiàng)目
- 訪問 項(xiàng)目地址,本地配置如: https://localhost:8443/
- 如果遇到“不安全”的提示,可能是客戶端未安裝服務(wù)器證書
常見問題
瀏覽器訪問時(shí)提示:
- 此服務(wù)器無法證實(shí)它是“192.168..” - 您計(jì)算機(jī)的操作系統(tǒng)不信任其安全證書 。。。
- --客戶端未導(dǎo)入服務(wù)器證書
- 此服務(wù)器無法證實(shí)它就是“192.168..” - 它的安全證書沒有指定主題備用名稱 。。。
- --生成服務(wù)器證書庫未使用 -ext參數(shù)
- “192.168..”不接受您的登錄證書,或者您可能沒有提供登錄證書。。。
- --Tomcat配置未指定信任證書庫(truststore)
Reference
https://www.cnblogs.com/molao-doing/articles/9687445.html
https://yoloz.github.io/2020/04/17/security/keytool命令詳解/
https://blog.csdn.net/qq_26708427/article/details/68491201
到此這篇關(guān)于Keytool配置Tomcat的HTTPS雙向認(rèn)證的文章就介紹到這了,更多相關(guān)TomcatHTTPS雙向認(rèn)證內(nèi)容請(qǐng)搜索本站以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持本站!
版權(quán)聲明:本站文章來源標(biāo)注為YINGSOO的內(nèi)容版權(quán)均為本站所有,歡迎引用、轉(zhuǎn)載,請(qǐng)保持原文完整并注明來源及原文鏈接。禁止復(fù)制或仿造本網(wǎng)站,禁止在非www.sddonglingsh.com所屬的服務(wù)器上建立鏡像,否則將依法追究法律責(zé)任。本站部分內(nèi)容來源于網(wǎng)友推薦、互聯(lián)網(wǎng)收集整理而來,僅供學(xué)習(xí)參考,不代表本站立場(chǎng),如有內(nèi)容涉嫌侵權(quán),請(qǐng)聯(lián)系alex-e#qq.com處理。