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 包那樣解碼,並且用指定口令解密 |