1、基本加密函數
基本加密函數為開發加密應用程序提供了足夠靈活的空間。所有CSP 的通訊都是通過這些函數。
一個CSP 是實現所有加密操作的獨立模塊。在每一個應用程序中至少需要提供一個CSP來完成所需的加密操作。
如果使用多於一個以上的CSP,在加密函數調用中就要指定所需的CSP。微軟基本加密提供者(Microsoft Base Cryptographic Provider),是缺省綁定到CryptoAPI 里的。如果沒有指定其他CSP 時,這個CSP 就是卻省的。
每一個CSP 對CryptoAPI 提供了一套不同的實現。一些提供了更加強大的加密算法,而其他一些CSP 包含了對硬件的支持,比如智能卡。另外,一些CSP 偶爾和使用者直接通訊,比如數字簽名就使用了用戶的簽名私鑰。
基本加密函數包含了以下幾種:
服務提供者函數:
應用程序使用服務提供者函數來連接和斷開一個CSP。下面就是主要的API:
| CryptAcquireContext |
獲得指定CSP 的密鑰容器的句柄 |
| CryptContextAddRef |
對HCRYPTPROV 句柄增加一個應用計數 |
| CryptEnumProviders |
枚舉當前計算機中的CSP |
| CryptEnumProviderTypes |
枚舉CSP 的類型 |
| CryptGetDefaultProvider |
對於指定CSP 類型的卻省CSP |
| CryptGetProvParam |
得到一個CSP 的屬性 |
| CryptInstallDefaultContext |
安裝先前得到的HCRYPTPROV 上下文作為當前卻省的上下文 |
| CryptReleaseContext |
釋放由CryptAcquireContext 得到的句柄 |
| CryptSetProvider 和 CryptSetProviderEx |
為指定CSP 類型指定一個卻省的CSP |
| CryptSetProvParam |
指定一個CSP 的屬性 |
| CryptUninstallDefaultContext |
刪除先前由CryptInstallDefaultContext 安裝的卻省上下文 |
密鑰的產生和交換函數:
密鑰產生函數創建、配置和銷毀加密密鑰。他們也用於和其他用戶進行交換密鑰。下面就是主要的一些函數:
| CryptAcquireCertificatePrivateKey |
對於指定證書上下文得到一個HCRYPTPROV 句柄和dwKeySpec |
| CryptDeriveKey |
從一個密碼中派生一個密鑰 |
| CryptDestoryKey |
銷毀密鑰 |
| CryptDuplicateKey |
制作一個密鑰和密鑰狀態的精確復制 |
| CryptExportKey |
把CSP 的密鑰做成BLOB 傳送到應用程序的內存空間中 |
| CryptGenKey |
創建一個隨機密鑰 |
| CryptGenRandom |
產生一個隨機數 |
| CryptGetKeyParam |
得到密鑰的參數 |
| CryptGetUserKey |
得到一個密鑰交換或簽名密鑰的句柄 |
| CryptImportKey |
把一個密鑰BLOB 傳送到CSP中 |
| CryptSetKeyParam |
指定一個密鑰的參數 |
編碼/解碼函數:
有一些編碼/解碼函數,他們可以用來對證書、證書撤銷列表、證書請求和證書擴展進行編碼和解碼。以下就是這幾個函數:
| CryptDecodeObject |
對lpszStructType 結構進行解碼 |
| CryptDecodeObjectEx |
對lpszStructType 結構進行解碼,此函數支持內存分配選項 |
| CryptEncodeObject |
對lpszStructType 結構進行編碼 |
| CyptEncodeObjectEx |
對lpszStructType 結構進行編碼,此函數支持內存分配選項 |
數據加密/解密函數:
這些函數支持數據的加密/解密操作。CryptEncrypt 和CryptDecrypt 要求在被調用前指定一個密鑰。這個密鑰可以由CryptGenKey、CryptDeriveKey 或CryptImportKey 產生。創建密鑰時要指定加密算法。CryptSetKeyParam 函數可以指定額外的加密參數。
| CryptDecrypt |
使用指定加密密鑰來解密一段密文 |
| CryptEncrypt |
使用指定加密密鑰來加密一段明文 |
| CryptProtectData |
執行對DATA_BLOB 結構的加密 |
| CryptUnprotectData |
執行對DATA_BLOB 結構的完整性驗證和解密 |
哈希和數字簽名函數:
這些函數在應用程序中完成計算哈希、創建和校驗數字簽名。
| CryptCreateHash |
創建一個空哈希對象 |
| CryptDestoryHash |
銷毀一個哈希對象 |
| CryptDuplicateHash |
復制一個哈希對象 |
| CryptGetHashParam |
得到一個哈希對象參數 |
| CryptHashData |
對一塊數據進行哈希,把它加到指定的哈希對象中 |
| CryptHashSessionKey |
對一個會話密鑰進行哈希,把它加到指定的哈希對象中 |
| CryptSetHashParam |
設置一個哈希對象的參數 |
| CryptSignHash |
對一個哈希對象進行簽名 |
| CryptVerifySignature |
校驗一個數字簽名 |
2、證書和證書庫函數
這組函數管理、使用和取得證書、證書撤銷列表和證書信任列表。這些函數可以分成一下幾組:
證書庫函數:
一個用戶站點可以收集許多證書。這些證書是為這個站點的用戶所使用的,證書描述了這個用戶的具體身份。對於每個人,可能有一個以上的證書。證書庫和其相關的函數提供了對庫獲得、枚舉、驗證和使用證書庫里的信息。
以下就是這些函數:
| CertAddStoreToCollection |
在證書庫中增加一個證書 |
| CertCloseStore |
關閉一個證書庫句柄 |
| CertControlStore |
如果證書緩沖區和證書本身內容不相符時,允許給應用程序發一個通知 |
| CertDuplicateStore |
通過增加引用計數來復制證書庫句柄 |
| CertEnumPhysicalStore |
對於指定系統庫枚舉物理庫 |
| CertEnumSystemStore |
枚舉所有可用的系統庫 |
| CertEnumSystemStoreLocation |
枚舉可用系統庫的所有位置 |
| CertGetStoreProperty |
得到一個庫的屬性 |
| CertOpenStore |
使用指定庫類型來打開證書庫 |
| CertOpenSystemStore |
打開一個系統證書庫 |
| CertRegisterPhysicalStore |
在一個注冊系統庫里增加一個物理庫 |
| CertRegisterSystemStore |
注冊一個系統庫 |
| CertRemoveStoreFromCollection |
從一個庫集合里刪除證書庫 |
| CertSaveStore |
保存證書庫 |
| CertSetStoreProperty |
設置證書屬性 |
| CertUnregisterPhysicalStore |
從系統庫中刪除一個物理庫 |
| CertUnregisterSystemStore |
反注冊一個指定系統庫 |
維護函數:
CryptoAPI 提供了證書和證書庫函數如下:
| CertAddSerializeElementToStore |
在庫中增加一系列證書或CRL |
| CertCreateContext |
從編碼字節中創建指定上下文 |
| CertEnumSubjectInSortedCTL |
在CTL 庫中枚舉信任主題 |
| CertFindSubjectInCTL |
在CTL 中尋找指定主題 |
| CertFindSubjectInSortedCTL |
在分類CTL 中尋找指定主題 |
證書函數:
下列函數是針對於證書的。大多數函數都是處理CRL 和CTL 的。
| CertAddCertificateContextToStore |
在證書庫里增加一個證書上下文 |
| CertAddCertificateLinkToStore |
在證書庫里增加一個對不同庫里的證書上下文的鏈接 |
| CertAddEncodedCertificateToStore |
把編碼證書轉換成證書上下文並且把它加到證書庫里 |
| CertCreateCertificateContext |
從編碼證書中創建一個證書上下文。但這個上下文並不放到證書庫里 |
| CertCreateSelfSignCertificate |
創建一個自簽名證書 |
| CertDeleteCertificateFromStore |
從證書庫里刪除一個證書 |
| CertDuplicateCertificate |
通過增加引用計數來復制證書上下文 |
| CertEnumCertificateInStore |
在證書庫里枚舉證書上下文 |
| CertFindCertificateInStore |
在證書庫里尋找證書上下文 |
| CertFreeCertificateContext |
釋放一個證書上下文 |
| CertGetIssuerCertificateFromStore |
在證書庫里得到指定主題證書的發行者 |
| CertGetSubjectCertificateFromStore |
獲得主題證書的上下文 |
| CertGetValidUsages |
返回所有證書的用法 |
| CertSerializeCertificateStoreElement |
串行化編碼證書的證書上下文 |
| CertVerifySubjectCertificateContext |
使用發行者來驗證主題證書 |
| CryptUIDlgViewContext |
顯示證書、CRL 或CTL |
| CryptUIDlgSelectCertificateFromStore |
從指定庫中顯示對話框,可以從中選擇證書 |
證書撤銷列表函數:
| CertAddCRLContextToStore |
在證書庫里增加一個CRL 上下文 |
| CertAddCRLLinkToStore |
在不同的庫里增加一個CRL 上下文鏈接 |
| CertAddEncodedCRLToStore |
把編碼CRL 轉化成CRL 上下文然后把它加入到證書庫中 |
| CertCreateCRLContext |
從編碼CRL 中創建CRL 句柄,但不把它加到庫中 |
| CertDeleteCRLFromStore |
從證書庫里刪除一個CRL |
| CertDuplicateCRLContext |
通過增加引用計數來復制CRL 上下文 |
| CertEnumCRLsInStore |
枚舉庫里的CRL 句柄 |
| CertFindCertificateInCRL |
從指定證書里尋找CRL 列表 |
| CertFindCRLInStore |
在庫里尋找CRL 上下文 |
| CertFreeCRLContext |
釋放CRL 上下文 |
| CertGetCRLFromStore |
從庫里得到CRL 上下文句柄 |
| CertSerializeCRLStoreElement |
串行化CRL 上下文的編碼CRL 和它的屬性 |
證書信任列表函數:
| CertAddCTLContextToStore |
把一個CTL 上下文加入到證書庫里 |
| CertAddCTLLinkToStore |
給不同庫里的CRL 上下文添加鏈接 |
| CertAddEncodedCTLToStore |
把編碼CTL 轉化成CTL 上下文並且把它加到證書庫里 |
| CertCreateCTLContext |
從編碼CTL 中創建CTL 上下文 |
| CertDeleteCTLFromStore |
從證書庫里刪除CTL |
| CertDuplicateCTLContext |
通過增加引用計數來復制CTL 上下文 |
| CertEnumCTLsInStore |
在證書庫里枚舉CTL 上下文 |
| CertFindCTLInStore |
在證書庫里查找CTL 上下文 |
| CertFreeCTLContext |
釋放CTL 上下文 |
| CertSerializeCTLStoreElement |
串行化CTL 上下文的編碼CTL 和屬性 |
擴展屬性函數:
| CertEnumCertificateContextProperties |
枚舉指定證書上下文的屬性 |
| CertEnumCRLContextProperties |
枚舉指定CRL 上下文的屬性 |
| CertEnumCTLContextProperties |
枚舉指定CTL 上下文的屬性 |
| CertGetCertificateContextProperty |
得到證書屬性 |
| CertGetCRLContextProperty |
得到CRL 屬性 |
| CertGetCTLContextProperty |
得到CTL 屬性 |
| CertSetCertificateContextProperty |
設置證書屬性 |
| CertSetCRLContextProperty |
設置CRL 屬性 |
| CertSetCTLContextProperty |
設置CTL 屬性 |
3、證書驗證函數
證書驗證是通過CTL 和證書列表進行的。
使用CTL 的函數:
| CertVerifyCTLUsage |
驗證CTL 用法 |
| CryptMsgEncodeAndSignCTL |
編碼和驗證CTL |
| CryptMsgGetAndVerifySigner |
從一個消息中獲得和驗證CTL |
| CryptMsgSignCTL |
對包含CTL 的消息進行簽名 |
證書鏈驗證函數:
| CertCreateCertificateChainEngine |
為應用程序創建一個新的非卻省的鏈引擎 |
| CertCreateCTLEntryFromCertificateContextProperties |
創建一個CTL 入口 |
| CertDuplicateCertificateChain |
通過增加引用計數來復制證書鏈 |
| CertFindChainInStore |
在證書庫里查找證書鏈 |
| CertFreeCertificateChain |
釋放證書鏈 |
| CertFreeCertificateChainEngine |
釋放證書鏈引擎 |
| CertGetCertificateChain |
從最后一個證書建立一個上下文鏈表 |
| CertSetCertificateContextPropertiesFromCTLEntry |
通過CTL 入口屬性來設置證書上下文的屬性 |
| CertIsValidCRLForCertificate |
通過檢查CRL 來確定CRL 是否包括指定被撤銷的證書 |
| CertVerifyCertificateChainPolicy |
通過檢查證書鏈來確定它的完整性 |
4、消息函數
CryptoAPI 消息函數包括兩組:低級消息函數和簡化消息函數。
低級消息函數直接和PKCS#7 消息工作。這些函數對傳輸的PKCS#7 數據進行編碼,對接收到的PKCS#7 數據進行解碼,並且對接收到的消息進行解密和驗證。
簡化消息函數是比較高級的函數,是對幾個低級消息函數和證書函數的封裝,用來執行指定任務。這些函數在完成一個任務時,減少了函數調用的數量,因此簡化了CryptoAPI的使用。
低級消息函數:
| CryptMsgCalculateEncodedLength |
計算加密消息的長度 |
| CryptMsgClose |
關閉加密消息的句柄 |
| CryptMsgControl |
執行指定的控制函數 |
| CryptMsgCountersign |
標記消息中已存在的簽名 |
| CryptMsgCountersignEncoded |
標記已存在的簽名 |
| CryptMsgDuplicate |
通過增加引用計數來復制加密消息句柄 |
| CryptMsgGetParam |
對加密消息進行編碼或者解碼后得到的參數 |
| CryptMsgOpenToDecode |
打開加密消息進行解碼 |
| CryptMsgOpenToEncode |
打開加密消息進行編碼 |
| CryptMsgUpdate |
更新加密消息的內容 |
| CryptMsgVerifyCountersignatureEncoded |
驗證SignerInfo 結構中標記時間 |
| CryptMsgVerifyCountersignatureEncodedEx |
驗證SignerInfo 結構中標記時間簽名者可以是CERT_PUBLIC_KEY_INFO 結構 |
簡化消息函數:
| CryptDecodeMessage |
對加密消息進行解碼 |
| CryptDecryptAndVerifyMessageSignature |
對指定消息進行解密並且驗證簽名者 |
| CryptDecryptMessage |
解密指定消息 |
| CryptEncryptMessage |
加密指定消息 |
| CryptGetMessageCertificates |
返回包含消息的證書和CRL 的證書庫 |
| CryptGetMessageSignatureCount |
返回簽名消息的簽名者數量 |
| CryptHashMessage |
創建消息的哈希 |
| CryptSignAndEncryptMessage |
對消息進行簽名並且加密 |
| CryptSignMessage |
對消息進行簽名 |
| CryptVerifyDetachedMessageHash |
驗證包含已解邦定哈希的哈希消息 |
| CryptVerifyDetachedMessageSignature |
驗證包含已解邦定簽名的簽名消息 |
| CryptVerifyMessageHash |
驗證一個哈希消息 |
| CryptVerifyMessageSignature |
驗證一個簽名消息 |
5、輔助函數
數據管理函數
| CertCompareCertificate |
比較兩個證書是否相同 |
| CertCompareCertificateName |
通過比較兩個證書名稱來決定他們是否相同 |
| CertCompareIntegerBlob |
比較兩個整數BLOB |
| CertComparePublicKeyInfo |
通過比較兩個證書公鑰來決定他們是否相同 |
| CertFindAttribute |
通過OID 來查找屬性 |
| CertFindExtension |
通過OID 來查找擴展 |
| CertFindRDNAttr |
通過OID 來查找RDN 屬性 |
| CertGetIntendedKeyUsage |
從證書中取得相關密鑰用法 |
| CertGetPublicKeyLength |
從公鑰BLOB 中取得公鑰/私鑰長度 |
| CertIsRDNAttrsInCertificateName |
通過指定RDN 數組屬性比較證書名稱屬性來決定證書是否已包含了所有屬性 |
| CertVerifyCRLRevocation |
驗證主題證書是否在CRL 中 |
| CertVerifyCRLTimeValidity |
驗證CRL 的有效時間 |
| CertVerifyRevocation |
驗證主題證書是否在CRL 中 |
| CertVerifyTimeValidity |
驗證CRL 的有效時間 |
| CertVerifyValidityNesting |
驗證主題時間的有效性是否在發行者有效時間內 |
| CryptExportPublicKeyInfo |
導出公鑰信息 |
| CryptExportPublicKeyInfoEx |
導出公鑰信息(用戶可以指定算法) |
| CryptFindCertificateKeyProvInfo |
枚舉CSP 和它的密鑰容器來查找對應於公鑰的相應私鑰 |
| CryptFindLocalizedName |
查找指定名字的局部化名稱 |
| CryptHashCertificate |
哈希證書內容 |
| CryptHashPublicKeyInfo |
計算公鑰信息的哈希 |
| CryptHashToBeSigned |
計算簽名內容的信息哈希值 |
| CryptImportPublicKeyInfo |
把公鑰信息導入CSP 並且返回它的句柄 |
| CryptImportPublicKeyInfoEx |
把公鑰信息導入CSP 並且返回它的句柄 |
| CryptMemAlloc |
分配內存 |
| CryptMemFree |
釋放內存 |
| CryptMemRealloc |
重新分配內存 |
| CryptQueryObject |
得到BLOB 或文件的內容信息 |
| CryptSignAndEncodeCertificate |
對信息進行簽名並且編碼 |
| CryptSignCertificate |
對證書進行簽名 |
| CryptVerifyCertificateSignature |
使用公鑰信息對主題證書或CRL 的簽名進行驗證 |
| CryptVerifyCertificateSignatureEx |
使用公鑰信息對主題證書或CRL 的簽名進行驗證 |
數據轉換函數
| CertAlgIdToOID |
把CSP 算法標示符轉換成OID |
| CertGetNameString |
得到證書的主題或頒發者名稱並且把它轉換成字符串 |
| CertNameToStr |
把證書名稱BLOB 轉換成字符串 |
| CertOIDToAlgId |
把OID 轉換成CSP 算法表示符 |
| CertRDNValueToStr |
把名稱值轉換成字符串
|
| CertStrToName |
把字符串轉換成編碼證書名稱 |
| CryptBinaryToString |
把二進制序列轉換成字符串 |
| CryptFormatObject |
格式化編碼數據,返回Unicode 字符串 |
| CryptStringToBinary |
把格式化的字符串轉換成二進制序列 |
增強密鑰用法函數
| CertAddEnhancedKeyUsageIdentifier |
在證書EKU 屬性中增加一個用法標示符 |
| CertGetEnhancedKeyUsage |
獲得證書的EKU 擴展或屬性信息 |
| CertRemoveEnhancedKeyUsageIdentifier |
從證書EKU 擴展屬性中刪除用法標示符OID |
| CertSetEnhancedKeyUsage |
設置證書的EKU 屬性 |
密鑰標示函數
| CryptCreateKeyIdentifierFromCSP |
創建CSP 公鑰的密鑰標示符 |
| CryptEnumKeyIdentifierProperties |
枚舉標示符和其屬性 |
| CryptGetKeyIdentifierProperty |
從指定密鑰標示符中獲得指定屬性 |
| CryptSetKeyIdentifierProperty |
設置指定密鑰標示符的屬性 |
證書庫回調函數
| CertDllOpenStoreProv |
定義庫提供者打開函數 |
| CertStoreProvCloseCallback |
決定當證書庫引用計數為0 時將發生的動作 |
| CertStoreProvDeleteCertCallback |
決定當從證書庫中刪除一個證書之前的動作 |
| CertStoreProvDeleteCRLCallback |
決定當從證書庫中刪除一個CRL 之前的動作 |
| CertStoreProvReadCertCallback |
保留 |
| CertStoreProvReadCRLCallback |
保留 |
| CertStoreProvSetCertPropertyCallback |
決定在CertSetCertificateContextProperty 和CertGetCertificateContext 調用之前的動作 |
| CertStoreProvSetCRLPropertyCallback |
決定在CertSetCRLContextProperty 和CertGetCRLContextProperty 調用之前的動作 |
| CertStoreProvWriteCertCallback |
決定在證書庫中加入一個證書前的動作 |
| CertStoreProvWriteCRLCallback |
決定在證書庫中加入一個CRL 前的動作 |
| CertStoreProvReadCTL |
讀CSP 的CTL 上下文 |
| CertStoreProvWriteCTL |
決定CTL 是否可被加入到證書庫中 |
| CertStoreProvDeleteCTL |
決定CTL 是否可被刪除 |
| CertStoreProvSetCTLProperty |
決定是否可以設置CTL 的屬性 |
| CertStoreProvControl |
當緩沖庫和存儲庫不同時,通知應用程序 |
| CertStoreProvFindCert |
在證書庫中查找下一個證書 |
| CertStoreProvFreeFindCert |
釋放前一個找到的證書上下文 |
| CertStoreProvGetCertProperty |
得到指定的證書屬性 |
| CertStoreProvFindCRL |
查找第一個或下一個匹配的CRL |
| CertStoreProvFreeFindCRL |
釋放前一個找到的CRL 上下文 |
| CertStoreProvGetCRLProperty |
得到指定CRL 屬性 |
| CertStoreProvFindCTL |
查找第一個或下一個匹配的CTL |
| CertStoreProvFreeFindCTL |
釋放前一個找到的CTL 上下文 |
| CertStoreProvGetCTLProperty |
得到指定CTL 屬性 |
OID 支持函數
| CryptEnumOIDFuction |
枚舉由編碼類型、函數名和OID 指定注冊的OID 函數 |
| CryptEnumOIDInfo |
枚舉注冊的OID 信息 |
| CryptEnumOIDInfo |
使用指定的密鑰和組查找OID 信息 |
| CryptFreeOIDFuctionAddress |
釋放OID 函數地址句柄 |
| CryptGetDefaultOIDDllList |
對於指定的函數結合和類型獲得卻省注冊的DLL 入口 |
| CryptGetDefaultOIDFuctionAddress |
獲得已安裝的第一次或下一個卻省函數或者加載包含卻省函數的DLL |
| CryptGetOIDFuctionAddress |
搜索匹配指定編碼類型和OID 函數列表,如果沒有找到,就查找注冊表 |
| CryptGetOIDFuctionValue |
獲得指定編碼類型、函數名稱和OID 的值 |
| CryptInitOIDFuctionSet |
初始化OID 函數集合的句柄 |
| CryptInstallOIDFuctionAddress |
安裝可調用的OID 函數地址集合 |
| CryptRegisterDefaultOIDFuction |
注冊包含卻省函數的DLL |
| CryptRegisterOIDFuction |
注冊包含指定函數的DLL |
| CryptRegisterOIDInfo |
注冊由CRYPT_OID_INFO 指定的OID 信息 |
| CryptSetOIDFuctionValue |
設置編碼類型、函數名稱等的值 |
| CryptUnregisterDefaultOIDFunction |
卸載包含卻省函數的DLL |
| CryptUnregisterOIDFuction |
卸載包含函數的DLL |
| CryptUnregisterOIDInfo |
卸載指定OID 的信息 |
遠程對象恢復函數
| CryptGetObjectUrl |
從證書、CTL 或CRL 中取得遠程對象的URL |
| CryptRetrieveObjectByUrl |
由URL 指定位置恢復PKI 對象 |
PFX 函數
| PFXExportCertStore |
從證書庫中導出證書或證書和私鑰 |
| PFXExportCertStoreEx |
從證書庫中導出證書或證書和私鑰 |
| PFXImportCertStore |
從PFX BLOB 導入到指定證書庫 |
| PFXIsPFXBlob |
把外層BLOB 像pfx 包那樣解碼 |
| PFXVerifyPassword |
把外層BLOB 像pfx 包那樣解碼,並且用指定口令解密 |
