Certifi 项目技术文档

1. 安装指南

Certifi 是一个提供 Mozilla 精心整理的根证书集合的 Python 库，用于验证 SSL 证书的可信度以及 TLS 主机的身份。它从 Requests 项目中提取出来，旨在为 Python 部署提供一个可靠且高度可移植的信任根。

安装步骤

Certifi 可以通过 PyPI 进行安装。只需使用 pip 命令即可完成安装：

$ pip install certifi

安装完成后，Certifi 将会在你的 Python 环境中提供一个 CA 证书包，用于 SSL 证书的验证。

2. 项目的使用说明

引用 CA 证书包

安装 Certifi 后，你可以通过以下方式引用安装的证书颁发机构（CA）证书包：

在 Python 代码中引用

import certifi

print(certifi.where())

运行上述代码后，你将获得 CA 证书包的路径，例如：

/usr/local/lib/python3.7/site-packages/certifi/cacert.pem

在命令行中引用

你也可以直接在命令行中使用 Certifi 模块来获取 CA 证书包的路径：

$ python -m certifi

运行上述命令后，你将获得类似的路径输出。

3. 项目 API 使用文档

Certifi 提供了一个简单的 API，用于获取 CA 证书包的路径。

certifi.where()

• 功能: 返回当前安装的 CA 证书包的路径。
• 返回值: 字符串，表示 CA 证书包的文件路径。

示例:

import certifi

ca_bundle_path = certifi.where()
print(f"CA Bundle Path: {ca_bundle_path}")

命令行接口

Certifi 还提供了一个命令行接口，用于直接输出 CA 证书包的路径：

$ python -m certifi

4. 项目安装方式

Certifi 的安装非常简单，只需使用 pip 命令即可完成：

$ pip install certifi

安装完成后，Certifi 将会在你的 Python 环境中提供一个 CA 证书包，用于 SSL 证书的验证。

总结

Certifi 是一个轻量级的 Python 库，旨在为 Python 部署提供一个可靠且高度可移植的信任根。通过简单的安装和使用，你可以轻松地在项目中引用 Mozilla 的根证书集合，确保 SSL 证书的可信度。