打开SSL

加密和 SSL/TLS 工具包

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 OpenSSL 项目作者。保留所有权利。

根据 Apache 许可证 2.0(“许可证”)获得许可。除非符合许可证,否则您不得使用此文件。您可以在源代码分发中的 LICENSE 文件或https://www.openssl.org/source/license.html中获取副本。