swift-certificates

一个用于处理 X.509 证书的库。

概述

X.509 证书是一种常用的身份格式,用于以密码学方式证明系统中参与者的身份。它们是 ITU-T 创建的 X.509 标准的一部分,该标准定义了公钥基础设施 (PKI)。 X.509 风格的 PKI 通常用于需要将证明参与者身份的权限委托给少量受信任方(称为证书颁发机构)的情况。

如今,X.509 证书最常见的用途是作为 WebPKI 的一部分,用于保护与网站的 TLS 连接。 X.509 证书也广泛用于其他基于 TLS 的通信中,以及代码签名基础设施中。

此模块可以序列化、反序列化、创建和与 X.509 证书交互。 这是各种 PKI 应用的重要组成部分。 它能够构建验证器,与证书颁发机构交互,验证对等方等等。 它还附带一个默认验证器和许多内置的验证器策略。

支持的 Swift 版本

此库将支持最新的稳定 Swift 版本以及之前的两个版本。

入门

要使用 swift-certificates,请将以下依赖项添加到您的 Package.swift

dependencies: [
    .package(url: "https://github.com/apple/swift-certificates.git", .upToNextMajor(from: "1.0.0"))
]

然后,您可以将特定的产品依赖项添加到您的目标

dependencies: [
    .product(name: "X509", package: "swift-certificates"),
]

有关详细用法和 API 文档,请查看文档

基准测试

swift-certificates 的基准测试位于此存储库的 Benchmarks 子文件夹中的一个单独的 Swift 包中。 它们使用 package-benchmark 插件。 基准测试依赖于 jemalloc 内存分配库,package-benchmark 使用该库来捕获内存分配统计信息。 安装指南可以在 package-benchmark入门文章中找到。 之后,您可以通过转到 Benchmarks 子文件夹(例如 cd Benchmarks)并调用以下命令,从 CLI 运行基准测试

swift package benchmark

有关更多信息,请参考 swift package benchmark --helppackage-benchmark 的文档