ossl_store-file
名稱
ossl_store-file - 儲存體「檔案」配置載入器
語法
#include <openssl/store.h>
說明
對「檔案」配置的支持已內建於 libcrypto
中。由於檔案有各種不同的格式和內容類型,「檔案」配置有自己的功能層,稱為「檔案處理常式」,用於嘗試解碼各種類型的檔案內容。
如果檔案格式為 PEM,每個稱為檔案處理常式的程式都會收到 PEM 名稱(任何「-----BEGIN
」之後的所有內容)以及可能的 PEM 標頭,連同已解碼的 PEM 主體。由於 PEM 格式的檔案可以包含多個物件,因此會針對每個此類物件呼叫檔案處理常式。
如果檔案未確定為 PEM 格式,則內容會以原始形式全部載入,並原樣傳遞給可用的檔案處理常式,沒有 PEM 名稱或標頭。
預期每個檔案處理常式都能適當地處理 PEM 和非 PEM 內容。有些可能會拒絕非 PEM 內容,以確保確定性(例如,實際上有一些金鑰以 ASN.1 OCTET STRING 表示。以原始形式,很難將這些金鑰與以 ASN.1 OCTET STRING 形式傳送的任何其他資料區分開來,因此此類金鑰自然只能被接受為 PEM 檔案)。
備註
需要時,「檔案」配置載入器會使用透過 OSSL_STORE_open() 傳遞的 UI_METHOD 要求輸入字串。預期此輸入字串以 UTF-8 編碼,其他任何編碼都會產生未定義的結果。預期透過此載入器存取的檔案在輸入字串編碼方面符合標準。不符合標準的檔案應重新產生,並使用正確編碼的輸入字串。如需更多資訊,請參閱 passphrase-encoding(7)。
另請參閱
ossl_store(7)、passphrase-encoding(7)
版權
版權所有 2018 The OpenSSL Project Authors。保留所有權利。
根據 Apache 授權條款 2.0(「授權條款」)授權。您不得在不遵守授權條款的情況下使用此檔案。您可以在原始程式碼散發中的 LICENSE 檔案中取得一份副本,或至 https://www.openssl.org/source/license.html 取得。