certauth 1.3.0

证书颁发机构证书生成工具

这个包提供了一个小库，构建在pyOpenSSL之上，它允许创建自定义证书颁发机构证书， 并使用该ca证书生成按需动态主机证书。

它最适合与中间人https代理一起使用，例如，用于录制或重播web内容。

在受控制的设置中，应谨慎使用此工具创建的ca，以避免安全风险。

认证机构API

CertificateAuthority类提供一个接口来管理根ca并生成适合的动态主机证书 用于本机pythonssl库以及pyopensslSSL模块。

该类提供了几个用于存储根ca和生成的主机ca的选项。

ca=CertificateAuthority('My Custom CA','my-ca.pem',cert_cache='/tmp/certs')filename=ca.cert_for_host('example.com')

ca=CertificateAuthority('My Custom CA','my-ca.pem',cert_cache=50)cert,key=ca.load_cert('example.com')

context=SSl.Context(...)context.use_privatekey(key)context.use_certificate(cert)

ca=CertificateAuthority('My Custom CA','my-ca.pem',cert_cache=CustomCache())cert,key=ca.load_cert('example.com')classCustomCache:def__setitem__(self,host,cert_string):# store cert_string for hostdefget(self,host):# return cached cert_string, if availablecert_string=...returncert_string

cert,key=ca.load_cert('example.com',wildcard=True)

cert,key=ca.load_cert('test.example.com',wildcard=True,wildcard_for_parent=True)

cert,key=ca.load_cert('example.co.uk',wildcard=True,wildcard_for_parent=True)

cli用法示例

certauth还包括一个用于创建和管理证书的简单命令行api。

usage: certauth [-h] [-c CERTNAME] [-n HOSTNAME] [-d CERTS_DIR] [-f] [-w]
              root_ca_cert

positional arguments:
  root_ca_cert          Path to existing or new root CA file

optional arguments:
  -h, --help            show this help message and exit
  -c CERTNAME, --certname CERTNAME
                      Name for root certificate
  -n HOSTNAME, --hostname HOSTNAME
                      Hostname certificate to create
  -d CERTS_DIR, --certs-dir CERTS_DIR
                      Directory for host certificates
  -f, --force           Overwrite certificates if they already exist
  -w, --wildcard_cert   add wildcard SAN to host: *.<host>, <host>

创建新的根CA证书：

certauth myrootca.pem --certname "My Test CA"

在目录certs_dir：

certauth myrootca.pem --hostname "example.com" -d ./certs_dir

如果根证书不存在，它将自动创建。 如果^ {TT21}$不存在，它也会自动创建。

example.com的证书将创建为certs_dir/example.com.pem。 如果它已经存在，它将不会被覆盖（除非使用{TT26}$选项）。

-w选项可用于创建一个通配符证书，该证书具有example.com和*.example.com

历史记录

certificateauthority功能已经从nadeem douba最初在中间人代理pymiproxy中发现的证书管理演变而来。

它还被互联网档案馆的Noah Levitt扩展到warcprox。

ca功能也在pywb中重用，并最终分解到这个单独的模块化包中。

它现在也被wsgiprox用来为任何wsgi应用程序提供通用的https代理包装。