我們在【商戶平臺(tái)】->【自助服務(wù)】中設(shè)立了API證書及密鑰 專區(qū),包括了商戶證書如何升級,申請,下載等問題的解答。下面是商戶技術(shù)人員可能關(guān)心的一些問題。
數(shù)字簽名通常定義了兩種運(yùn)算: 簽名和驗(yàn)簽。發(fā)送者用自己的私鑰對消息的哈希值進(jìn)行簽名,接收者用對方的公鑰進(jìn)行驗(yàn)簽。因此,在使用數(shù)字簽名時(shí),需要通信的雙方都要事先生成公鑰、私鑰,并且完成雙方的公鑰交換。其中,私鑰是只能由擁有者使用的不公開密鑰,公鑰是可以公開的密鑰。
由于公鑰本身并不含有擁有者的身份信息,使用時(shí)無法確認(rèn)它是真實(shí)有效的。所以需要證書認(rèn)證機(jī)構(gòu)(簡稱 CA)在核實(shí)公鑰擁有者的信息后,將公鑰擁有者的身份信息(如商戶號、公司名稱等),公鑰、簽發(fā)者信息、有效期以及擴(kuò)展信息等進(jìn)行簽名,制作成“證書”。
? “商戶證書”是指由商戶申請的,包含商戶的商戶號、公司名稱、公鑰信息的證書。
? “平臺(tái)證書”是指由微信支付負(fù)責(zé)申請的,包含微信支付平臺(tái)標(biāo)識(shí)、公鑰信息的證書。
商戶在調(diào)用 API 時(shí)用自身的私鑰簽名,微信支付使用商戶證書中的公鑰來驗(yàn)簽。微信支付在響應(yīng)的報(bào)文中使用自身的私鑰簽名,商戶使用平臺(tái)證書中的公鑰來驗(yàn)簽。
主要是為了符合監(jiān)管的要求,保證更高的安全級別。《中華人民共和國電子簽名法》、《金融電子認(rèn)證規(guī)范》及《非銀行支付機(jī)構(gòu)網(wǎng)絡(luò)支付業(yè)務(wù)管理辦法》中規(guī)定 “電子簽名需要第三方認(rèn)證的,由依法設(shè)立的電子認(rèn)證服務(wù)提供者提供認(rèn)證服務(wù)。”,所以需使用第三方 CA 來確保數(shù)字證書的唯一性、完整性及交易的不可抵賴性。
每個(gè)證書都有一個(gè)由CA頒發(fā)的唯一編號,即證書序列號。
登錄商戶平臺(tái)【API安全】->【API證書】->【查看證書】,可查看商戶API證書序列號。
商戶API證書和微信支付平臺(tái)證書均可以使用第三方的證書解析工具,查看證書內(nèi)容。或者使用openssl命令行工具查看證書序列號。
$ openssl x509 -in 1900009191_20180326_cert.pem -noout -serial
serial=1DDE55AD98ED71D6EDD4A4A16996DE7B47773A8C
推薦使用微信支付提供的SDK。你也可以查看下列編程語言的示例代碼。
/**
* 獲取證書。
*
* @param filename 證書文件路徑 (required)
* @return X509證書
*/
public static X509Certificate getCertificate(String filename) throws IOException {
InputStream fis = new FileInputStream(filename);
BufferedInputStream bis = new BufferedInputStream(fis);
try {
CertificateFactory cf = CertificateFactory.getInstance("X509");
X509Certificate cert = (X509Certificate) cf.generateCertificate(bis);
cert.checkValidity();
return cert;
} catch (CertificateExpiredException e) {
throw new RuntimeException("證書已過期", e);
} catch (CertificateNotYetValidException e) {
throw new RuntimeException("證書尚未生效", e);
} catch (CertificateException e) {
throw new RuntimeException("無效的證書文件", e);
} finally {
bis.close();
}
}
主要是為了確保在更換平臺(tái)證書時(shí),不影響商戶使用微信支付的各種功能。以下場景中,微信支付會(huì)更換平臺(tái)證書:
? 證書到期后,必須更換。(目前是五年)
? 證書到期前,例行更換。(每年一次)
主要是為了防御“中間人攻擊”。
由于驗(yàn)證應(yīng)答報(bào)文的簽名和加密敏感信息時(shí),必須使用到平臺(tái)證書。平臺(tái)證書是商戶認(rèn)證微信支付身份時(shí)最關(guān)鍵的要素。因此,要通過簽名和加密等多重機(jī)制來保障商戶獲取到的平臺(tái)證書沒有被“中間人”篡改。
商戶在調(diào)用下載接口獲取平臺(tái)證書時(shí),應(yīng)進(jìn)行以下四步操作,以保證證書的真實(shí)性:
? 使用與平臺(tái)共享的對稱密鑰,解密報(bào)文中的證書(必須)
? 通過解密得到的證書,來驗(yàn)證報(bào)文的簽名(必須)
? 使用證書查看工具,核對證書的頒發(fā)者為Tenpay.com Root CA。詳見如何區(qū)分API證書的類型?(強(qiáng)烈推薦)
? 通過證書信任鏈驗(yàn)證平臺(tái)證書(強(qiáng)烈推薦)
下面介紹如何使用openssl工具,通過證書信任鏈驗(yàn)證平臺(tái)證書。
首先,從微信支付商戶平臺(tái)下載平臺(tái)證書信任鏈 CertTrustChain.p7b ,并將它轉(zhuǎn)換為pem證書格式。
openssl pkcs7 -print_certs -in CertTrustChain.p7b -inform der -out CertTrustChain.pem
然后,-CAfile file指定受信任的證書,驗(yàn)證下載的平臺(tái)證書
openssl verify -verbose -CAfile ./CertTrustChain.pem ./WeChatPayPlatform.pem
商戶上送敏感信息時(shí)使用了微信支付平臺(tái)公鑰加密。為了能使用正確的密鑰解密,微信支付要求商戶在請求的HTTP頭部中包括證書序列號 ,以聲明加密所用的密鑰對和平臺(tái)證書。詳見這里的說明。
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP證