网络安全CLI后端【免费下载链接】certbotCertbot is EFFs tool to obtain certs from Lets Encrypt and (optionally) auto-enable HTTPS on your server. It can also act as a client for any other CA that uses the ACME protocol.项目地址https://gitcode.com/gh_mirrors/ce/certbot点击查看免费下载Certbot 是 EFF 出品的 ACME 客户端而certbot.crypto_util是其中负责所有本地密码学操作的底层模块从生成 RSA/ECDSA 私钥、构造带 SAN 与 OCSP Must-Staple 的 CSR到读取证书有效期、校验证书签名、拆分 fullchain、选择信任链等。本文以 certbot.crypto_util 模块 API 文档 为骨架结合 模块源码、ACME 层实现 与 CLI 参数定义系统讲解每个函数的行为、默认值、错误处理及其在 Certbot 主流程中的真实调用场景。读完本文你将能独立理解并复用这套密钥/CSR/证书工具链也能在排查certbot certificates、certbot renew、吊销等命令的密码学相关错误时快速定位根因。模块定位Certbot 密码学工具的“总装车间”certbot.crypto_util并不直接做底层密码运算它是一层“高层封装”自身依赖三个下层设施——cryptographycryptography.hazmat与cryptography.x509负责 RSA/ECDSA 密钥生成、X.509 解析、签名验证等真正的密码学原语pyOpenSSLOpenSSL.SSL用于私钥与证书匹配性检查acme.crypto_utilacme/src/acme/crypto_util.py负责 CSR 构造与域名提取等 ACME 协议相关工具。从源码 import 段crypto_util.py可以看到这一分层模块同时引入rsa、ec、mldsa、mlkem、dsa、ed25519/ed448等密钥类型说明其校验逻辑面向多种公钥算法开放。模块 docstring 中有一条 TODO 值得注意计划在服务器支持时从PKCS1_v1_5签名过渡到 PSS。模块的返回类型大量使用certbot.util中定义的具名元组util.Key(file: Optional[str], pem: bytes)私钥容器util.pyutil.CSR(file: Optional[str], data: bytes, form: str)CSR 容器form为pem或derutil.py。密钥生成make_key与generate_keymake_key内存中的底层密钥生成器make_key(bits2048, key_typersa, elliptic_curveNone)crypto_util.py负责真正生成密钥并以PEM 编码的 PKCS#8 无加密格式PrivateFormat.PKCS8NoEncryption返回字节流。其行为规则参数取值行为bits整数RSA 模式下密钥位数小于 2048 直接抛出errors.ErrorUnsupported RSA key lengthRSA 固定使用公钥指数65537key_typersa或ecdsa其他值抛errors.ErrorInvalid key_type specifiedelliptic_curvesecp256r1、secp384r1、secp521r1仅 ECDSA 模式需要缺失、不在白名单或底层不支持时抛errors.Error/UnsupportedAlgorithm注意曲线白名单是硬编码的(SECP256R1, SECP384R1, SECP521R1)与 CLI 侧--elliptic-curve的可选值完全一致见下文 CLI 对照这保证了命令行传入的值必然能被make_key接受。generate_key带落盘的高层入口generate_key(key_size, key_dir, key_typersa, elliptic_curvesecp256r1, keynamekey-certbot.pem, strict_permissionsTrue)crypto_util.py在make_key基础上增加文件系统行为若传入key_dir先调用util.make_or_verify_dir(key_dir, 0o700, strict_permissions)确保目录存在、权限为0700strict_permissionsTrue时目录权限非 0700 或属主非当前用户会直接抛异常这是 Certbot 保护私钥安全的核心机制通过util.unique_file(os.path.join(key_dir, keyname), 0o600, wb)以0600 权限写入且文件名可能因重名被自动改写——docstring 明确提示keyname is the attempted filename, it may be different if a file already existsmake_key抛出的ValueError会被捕获记录日志后重新抛出返回util.Key(key_path, key_pem)key_path在未传key_dir时为None密钥只存在于内存。测试见 crypto_util_test.pyGenerateKeyTest验证密钥文件确实写入工作目录且路径含key-certbot.pem并验证make_key抛ValueError时generate_key会向上传播。CSR 生成与管理generate_csr与底层acme.crypto_util.make_csrgenerate_csr(privkey, names, path, must_stapleFalse, strict_permissionsTrue, ipaddrsNone)crypto_util.py将私钥与域名列表交给 ACME 层的make_csr生成 CSR然后按需落盘CSR 文件名默认为csr-certbot.pem目录权限要求为0755make_or_verify_dir(path, 0o755, ...)文件权限0644——CSR 是公开信息权限比私钥宽松must_stapleTrue时在 CSR 中加入 TLS Feature 扩展RFC 7633即 OCSP Must-Stapleipaddrs参数接受ipaddress.IPv4Address/IPv6Address列表与域名一并写入 SAN返回util.CSR。底层的 acme/src/acme/crypto_util.pymake_csr实现细节决定了 CSR 的形态使用x509.CertificateSigningRequestBuildersubject 为空x509.Name([])所有标识符全部放在非 critical 的SubjectAlternativeName扩展中DNS 名 IP 地址校验私钥类型必须属于 DSA/RSA/EC/Ed25519/Ed448 集合否则抛ValueErrordomains与ipaddrs至少一个非空否则抛ValueErrormust_staple时追加x509.TLSFeature([x509.TLSFeatureType.status_request])扩展最终以SHA-256签名并输出 PEM。CSR 解析read_csr_file、valid_csr、csr_matches_pubkeyread_csr_file(csrfile, data)crypto_util.pyDER 优先、PEM 兜底的双格式解析器。先尝试load_der_x509_csr失败再尝试load_pem_x509_csr两者都失败则抛errors.Error(Failed to parse CSR file: ...)内部统一重编码为 PEM 返回util.CSR。这是当前推荐的入口旧import_csr_file已废弃。valid_csr(csr)crypto_util.py仅接受PEM调用load_pem_x509_csr后检查req.is_signature_valid自签名有效。解析失败ValueError/TypeError时返回False而非抛异常。测试ValidCSRTestcrypto_util_test.py覆盖了 PEM 有效、带 SAN 有效、DER 无效、空串、乱码五种情形。csr_matches_pubkey(csr, privkey)crypto_util.py解析 CSR 与无口令 PEM 私钥比较 CSR 签名有效且 CSR 公钥 私钥公钥。它被用于客户端签发前的一致性检查见下文调用链。证书校验体系verify_renewable_cert三件套verify_renewable_cert(renewable_cert)crypto_util.py是 Certbot 判断“磁盘上的证书是否完好”的总入口依次执行三项检查任一项失败抛errors.Errorverify_renewable_cert_sig加载 chain 与 cert取 chain 公钥对 cert 的tbs_certificate_bytes做签名验证verify_fullchain逐字节比较cert chain fullchain不一致时报 fullchain does not match cert chain for {lineagename}!verify_cert_matches_priv_key见下文。verify_signed_payload支持 RSA 与 ECDSA 的签名核验verify_signed_payload(public_key, signature, payload, signature_hash_algorithm)crypto_util.py按公钥类型分发RSAPublicKey→PKCS1v15()填充EllipticCurvePublicKey→ECDSA(hash_algorithm)其他类型包括 DSA、Ed25519、ML-DSA、ML-KEM 等抛errors.Error(Unsupported public key type.)。失败时抛InvalidSignature。类型注解显示其签名参数已声明支持 MLDSA44/65/87、MLKEM768/1024 等后量子算法密钥说明该函数面向未来算法演进做了预留。verify_cert_matches_priv_key基于 OpenSSL 的键值匹配verify_cert_matches_priv_key(cert_path, key_path)crypto_util.py利用SSL.Context(SSL.TLS_METHOD)加载证书与私钥文件并调用context.check_privatekey()任何OSError/SSL.Error都被包装为errors.Error。它在吊销流程中被复用certbot revoke使用证书对应私钥吊销时--key-path场景main.py 会先调用本函数确认私钥与待吊销证书匹配再加载 JWK 提交吊销。证书信息读取有效期、序列号与哈希notBefore(cert_path)crypto_util.py与notAfter(cert_path)crypto_util.py读取 PEM 证书的not_valid_before_utc/not_valid_after_utc返回时区感知的datetime.datetime。它们的调用面非常广renewal.py与renew_before_expiry配置比较决定是否提前续期续期时还用于向用户展示 expires on YYYY-MM-DDstorage.pyRenewableCert.target_expiry属性ocsp.py证书已过期则直接跳过 OCSP 检查main.py签发成功后的成功提示中显示过期日期。get_serial_from_cert(cert_path)crypto_util.py返回证书序列号整数。被 cert_manager.py 用于certbot certificates输出且以十六进制format(serial, x)展示。sha256sum(filename)crypto_util.py以文本模式读取文件并 UTF-8 编码后计算 SHA-256docstring 特别提示平台换行符会被转换为 Unicode 对应形式再哈希即不同平台的 CRLF/LF 归一化可能影响结果。用于 webroot.py 判断web.config是否为 Certbot 生成与预置哈希表比对后决定是否清理。证书链处理拆分 fullchain 与按签发者选链cert_and_chain_from_fullchaincert_and_chain_from_fullchain(fullchain_pem)crypto_util.py把“叶子证书 中间链”的拼接 PEM 拆成(cert_pem, chain_pem)。实现分两步用模块级正则CERT_PEM_REGEXcrypto_util.py按 RFC 7468 §3 匹配一个-----BEGIN CERTIFICATE-----块找出全部证书边界链中证书数 2即只有叶子、没有中间证书时抛errors.Error随后逐个用cryptography重新解析并标准化编码归一化 CRLF、空白等变体返回第一个为 cert、其余拼接为 chain。它在 client.py 的_get_cert_and_chain中被调用拿到 ACME 订单返回的fullchain_pem后拆分为 cert 与 chain 两段分别落盘为cert.pem与chain.pem。find_chain_with_issuerfind_chain_with_issuer(fullchains, issuer_cn, warn_on_no_matchFalse)crypto_util.py从多个 fullchain 候选中挑选“顶层中间证书的Issuer Common Name与issuer_cn精确匹配”的第一条链即能链到指定根 CA 的链全部不匹配时默认回退返回列表第一条若warn_on_no_matchTrue会记录 warning。该函数服务于--preferred-chain配置client.py实现方式是解析每条链最后一个证书顶层中间证书的issuer属性中的COMMON_NAME并比对。已废弃 API 清单迁移提醒以下函数在模块内已标记DeprecationWarning并计划在下个 major 版本移除新代码请勿使用废弃函数替代方案import_csr_file(csrfile, data)read_csr_file(csrfile, data)功能相同但不再返回废弃的Format枚举get_sans_from_cert(cert, typ)直接使用cryptography.x509解析后读取 SAN 扩展get_names_from_cert(cert, typ)同上或使用acme.crypto_util.get_names_from_subject_and_extensionsget_names_from_req(csr, typ)同上这些函数内部依赖已废弃的acme.crypto_util.Format枚举见 acme/src/acme/crypto_util.py因此调用时还带有warnings.catch_warnings()屏蔽逻辑。旧版解析行为仍可用参考get_names_from_cert/get_names_from_req会通过get_names_from_subject_and_extensions返回“首个 CN 全部 DNS SAN”CN 去重后置前见 acme/src/acme/crypto_util.py。CLI 参数与 crypto_util 的调用链对照理解命令行参数如何最终落到crypto_util函数是排查问题的关键。下表汇总 cli/init.py 中的相关参数CLI 参数取值/默认对应 crypto_util 行为--rsa-key-size N整数默认见flag_default(rsa_key_size)作为make_key的bitsRSA 下 2048直接报错--key-typersa/ecdsa作为make_key/generate_key的key_type--elliptic-curvesecp256r1/secp384r1/secp521r1作为elliptic_curve白名单与make_key硬编码一致--must-staplestore_true传入generate_csr/acme.make_csr的must_staple加入 TLS Feature 扩展--strict-permissionsstore_true作为generate_key/generate_csr的strict_permissions开启 0700/0755 目录与属主校验--csr PATH仅certonly子命令见 subparsers.py经read_file读取后由read_csr_file解析DER 或 PEM在证书签发主流程 client.py 中可以看到两条路径不传--csrgenerate_key(...)key_dirNone密钥仅存内存→generate_csr(key, domains, None, must_staple, strict_permissions, ipaddrs)→ 订单签发传--csr复用用户 CSR仅调用make_key生成内存密钥并用acme.make_csr按 CSR 中的 SAN 重新构造cli/helpful.py 先通过read_csr_file解析并抽出域名/IP 合并进config.domains。签发完成后client.py 会用csr_matches_pubkey验证“服务器返回的证书对应私钥与 CSR 公钥一致”否则报 The key and CSR do not match。证书落盘后cert_manager.py 在枚举续期配置时会调用verify_renewable_cert校验每条 lineage 的 cert/chain/fullchain/私钥完整性损坏的条目会被跳过并计入parse_failures。测试与验证路径模块的单元测试集中在 certbot/src/certbot/_internal/tests/crypto_util_test.py549 行覆盖GenerateKeyTest、GenerateCSRTest密钥/CSR 生成与落盘使用TempDirTestCase与 mockValidCSRTestPEM/DER/空串/乱码五种输入的valid_csr判定CSRMatchesPubkeyTest私钥与 CSR 公钥匹配判定含 RSA、EC 场景其余测试类覆盖verify_renewable_cert系列、cert_and_chain_from_fullchain、find_chain_with_issuer、read_csr_file等。测试向量rsa2048_key.pem、nistp256_key.pem、csr_512.pem、cert_leaf.pem、cert_intermediate_1.pem等 PEM 样本位于 certbot/src/certbot/tests/testdata其中cert_leaf/cert_intermediate_1/cert_intermediate_2组合专门用于验证证书链签发者匹配与 fullchain 拆分逻辑见 crypto_util_test.py 的注释。总结certbot.crypto_util用约 20 个函数完整覆盖了 Certbot 客户端在 ACME 流程之外的本地密码学需求密钥生成RSA ≥2048 / ECDSA 三曲线、CSR 构造与解析PEM/DER 双格式、Must-Staple、IP SAN、证书完整性三重校验签名、fullchain 拼接、私钥匹配、有效期/序列号读取以及信任链选择。理解这些函数的参数语义与调用链既能帮助你在集成 Certbot 能力时正确复用也能在renew、certificates、revoke等命令报出errors.Error时快速定位是密钥长度、曲线选择、目录权限、CSR 格式还是证书链不一致导致的问题。赞分享网络安全CLI后端【免费下载链接】certbotCertbot is EFFs tool to obtain certs from Lets Encrypt and (optionally) auto-enable HTTPS on your server. It can also act as a client for any other CA that uses the ACME protocol.项目地址https://gitcode.com/gh_mirrors/ce/certbot点击查看免费下载相关推荐Certbot ACME 库的 Crypto_util 加密工具模块深度解析CSR 生成、SAN 提取与证书序列化Certbot ACME 库的 Crypto_util 加密工具模块深度解析CSR 生成、SAN 提取与证书序列化 导读 本文以 acme/docs/api/网络安全CLI后端JDK keytool 完全指南密钥库、证书与 CSR 全流程实战手册JDK keytool 完全指南密钥库、证书与 CSR 全流程实战手册 导读 keytool 是 JDK 自带的密钥与证书管理命令行工具用于管理用户自身的公编程语言语言运行时标准库编译器JIT编译内存管理fhEVM 密钥管理服务KMS深度解析MPC 密钥生成、门限解密与密钥生命周期管理fhEVM 密钥管理服务KMS深度解析MPC 密钥生成、门限解密与密钥生命周期管理 导读 KMSKey Management Service是 Zam密码学隐私计算区块链后端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考