AcmeN

AcmeN封装了常见的ACME操作的时序控制。通过调用AcmeNetIO，完成常见的ACME操作。

实例化

from acmen import AcmeN, SupportedCA
acme = AcmeN('/path/to/key_file.key', key_passphrase='', ca=SupportedCA.LETSENCRYPT, proxy=None)

key_file：执行签名时将使用的私钥文件。
key_passphrase：保护私钥文件的短语，若私钥未加密可留空。
ca：要使用的ACME服务器，可以是SupportedCA枚举的一个成员，也可以是其他有效ACME服务器的directory目录地址。
proxy：代理服务器的地址，例如：http://localhost:8080。

方法

register_account

使用实例化时指定的私钥注册ACME账户。

def register_account(contact: typing.List[str] = None, eab_key_identifier: str = None, eab_mac_key: str = None) -> str

contact：此账户的联系方式列表，例如['mailto:admin@example.com', 'mailto:admin2@example.com']，可选。
eab_key_identifier：外部密钥绑定(externalKeyBinding)使用的key identifier。
eab_mac_key：外部密钥绑定(externalKeyBinding)使用的mac key。

此方法返回账户的URL。

get_cert_by_domain

通过域名获取证书。

def get_cert_by_domain(common_name: str, subject_alternative_name: typing.List[str],
                   challenge_handler: ChallengeHandlerBase,
                   key_generation_method: KeyGenerationMethod = KeyGenerationMethod.CryptographyLib,
                   key_type: KeyType = KeyType.RSA3072, output_name: str = '') -> (bytes, bytes):

common_name：证书的commonName字段，通常是主域名。
subject_alternative_name：证书的subjectAlternativeName字段，可选的附加域名，不需要此扩展时可传入空列表[]。
challenge_handler：完成认证过程使用的Challenge Handler。
key_generation_method：生成私钥的方法，默认使用cryptography库生成，改为KeyGenerationMethod.OpenSSLCLI可使用openssl 命令行工具生成。
key_type：密钥类型，KeyType枚举的成员，默认是RSA3072。其中ECC384使用的是secp384r1曲线，ECC256使用的是secp256r1曲线。
output_name：输出的证书文件绝对或相对路径，当参数是空字符串''时，输出文件名是{commonName}.{timestamp}.key和{commonName}.{timestamp}.crt，当参数是None时，证书不会被写入文件。

此方法返回(私钥,证书)二元组，均是PEM字节序列(bytes)。

get_cert_by_csr

通过CSR文件获取证书。

def get_cert_by_csr(csr: typing.Union[str, bytes], challenge_handler: ChallengeHandlerBase, output_name: str = None) -> bytes:

csr：CSR文件的路径或文件内容，当传入文件内容时既可以是str也可以是bytes。
challenge_handler：完成认证过程使用的Challenge Handler。
output_name：输出的证书文件绝对或相对路径，当参数是空字符串''时，输出文件名是{commonName}.{timestamp}.crt，当参数是None时，证书不会被写入文件。

此方法返回服务器所签发的证书的bytes字节序列。

process_order

创建一个证书订单并完成其中的认证。

def process_order(domains: typing.Set[str], challenge_handler: ChallengeHandlerBase) -> AcmeResponse

domains：订单所包含的域名集合(Set)。
challenge_handler：完成认证过程使用的Challenge Handler。

此方法返回完成订单后从订单URL获取到的订单对象。

revoke_cert

吊销证书

def revoke_cert(self, cert_file, reason: RevocationReason = None, challenge_handler: ChallengeHandlerBase = None):

cert_file：需要吊销的证书。 reason：证书吊销原因，RevocationReason枚举中的一个成员，可以是None。 challenge_handler：完成认证过程使用的Challenge Handler(如果需要)。

有3种方式可以吊销证书：使用签发证书的账户签名吊销请求、签名吊销请求的账户对证书上的标识符(域名)有控制权、使用证书的私钥签名吊销请求
此方法会按照顺序尝试三种吊销方法，首先假定实例化AcmeN时传入的私钥是签发此证书的账户对应的私钥，并使用此密钥签名吊销请求(在jws protected header中使用kid)。
当发生错误时，若传入了challenge_handler参数，则尝试创建一个包含证书上所有标识符(域名)的订单，并完成订单中的认证(authorization)，然后签名吊销请求。
当发生错误或没有传入challenge_handler参数时，假定实例化AcmeN时传入的私钥是证书对应的私钥，使用此密钥签名吊销请求(在jws protected header中使用jwk)。

key_change

更换ACME账户的密钥。

def key_change(self, new_key_file, password: str = '') -> None:

new_key_file：新的账户密钥。
password：保护新密钥的密码。

此方法完成后，会更换AcmeN的签名密钥，后续基于此AcmeN对象的操作均由新密钥签名。

deactivate_account

注销此密钥所对应的账户。

def deactivate_account():

query_kid

获取密钥文件对应的Account URL。通过调用下层AcmeNetIO.query_kid实现。