Server : Apache/2.4.62 (Unix) OpenSSL/1.0.2k-fips System : Linux server1.richineiserver.com 3.10.0-1160.119.1.el7.x86_64 #1 SMP Tue Jun 4 14:43:51 UTC 2024 x86_64 User : fdshops ( 1003) PHP Version : 8.2.21 Disable Function : NONE Directory : /lib/python2.7/site-packages/certbot/_internal/ |
�
���_c @ s\ d Z d d l Z d d l Z d d l Z d d l m Z d d l m Z d d l Z d d l
Z
d d l Z d d l
m Z d d l
m Z d d l
m Z d d l
m Z d d l m Z d d
l m Z d d l Z d d l m Z d d l m Z d d l m Z d d l m Z d d
l m Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m! Z! d d l m" Z" d d l# m$ Z% d d l& m' Z' d d l( m) Z* e j+ e, � Z- e. d � Z/ d � Z0 d � Z1 d e2 f d � � YZ3 d � Z4 e. d � Z5 d � Z6 d e2 f d � � YZ7 e. d! � Z8 d" � Z9 d# � Z: d$ � Z; d S(% s Certbot client API.i����N( t default_backend( t generate_private_key( t client( t crypto_util( t errors( t messages( t List( t Optional( t
interfaces( t util( t account( t auth_handler( t cli( t constants( t eff( t
error_handler( t storage( t selection( t os( t opsc C sA t j | d | d | j d t | � �} t j | | | j � S( s Wrangle ACME client constructionR
t
verify_sslt
user_agent( t acme_clientt
ClientNetworkt
no_verify_sslt determine_user_agentt BackwardsCompatibleClientV2t server( t configt keyt regrt net( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyt acme_from_config_key& s c C s� | j d k r� d } t j j d � d k rB d } d } d } n! t j } t j � } t j
� } | j t j
| | | j | j | j t | � | | j r� d | j n d � } n | j } | S(
s�
Set a user_agent string in the config based on the choice of plugins.
(this wasn't knowable at construction time)
:returns: the client's User-Agent string
:rtype: `str`
s\ CertbotACMEClient/{0} ({1}; {2}{8}) Authenticator/{3} Installer/{4} ({5}; flags: {6}) Py/{7}t CERTBOT_DOCSt 1s certbot(-auto)s OS_NAME OS_VERSIONs major.minor.patchlevels ; t N( R t NoneR t environt getR t cli_commandR t get_os_info_uat platformt python_versiont formatt certbott __version__t
authenticatort installert verbt ua_flagst user_agent_comment( R t uaR' t os_infoR* ( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyR . s " c C s� t | t � r d Sg } | j r2 | j d � n | j rK | j d � n | j rd | j d � n | j r} | j d � n d } g | D] } t | | d � ^ q� } t | � r� | j d � n d
j | � S( s@ Turn some very important CLI flags into clues in the user agent.t FLAGSt dupt frnt asnt nt pret postt renewt manual_autht manual_cleanupt _hookt hookt ( R: R; R< R= R> (
t
isinstancet DummyConfigt duplicatet appendt renew_by_defaultt allow_subset_of_namest noninteractive_modet getattrt anyt join( R t flagst
hook_namest ht hooks( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyR1 M s & RC c B s e Z d Z d � Z d � Z RS( s' Shim for computing a sample user agent.c C s( d | _ d | _ d | _ d | _ d S( Nt XXXt YYYt
SUBCOMMAND( R. R/ R$ R R0 ( t self( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyt __init__b s c C s d S( s- Any config properties we might have are None.N( R$ ( RS t name( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyt __getattr__h s ( t __name__t
__module__t __doc__RT RV ( ( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyRC ` s c C s
t t � � S( s< Document what this Certbot's user agent string will be like.( R RC ( ( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyt sample_user_agentl s c C s) | j � r" t j d | j � n | j d k r{ | j s_ d } t j | � t j | � � n | j
s{ t j d � q{ n | j
r� d | _ n t d d d | j
d t � � } t j d t j | � � } t | | � } t | | | � } t j | | � } | j | | � t j | | � | | f S(
s� Register new account with an ACME CA.
This function takes care of generating fresh private key,
registering the account, optionally accepting CA Terms of Service
and finally saving the account. It should be called prior to
initialization of `Client`, unless account has already been created.
:param .IConfig config: Client configuration.
:param .AccountStorage account_storage: Account storage where newly
registered account will be saved to. Save happens only after TOS
acceptance step, so any account private keys or
`.RegistrationResource` will not be persisted if `tos_cb`
returns ``False``.
:param tos_cb: If ACME CA requires the user to accept a Terms of
Service before registering account, client action is
necessary. For example, a CLI tool would prompt the user
acceptance. `tos_cb` must be a callable that should accept
`.RegistrationResource` and return a `bool`: ``True`` iff the
Terms of Service present in the contained
`.Registration.terms_of_service` is accepted by the client, and
``False`` otherwise. ``tos_cb`` will be called only if the
client action is necessary, i.e. when ``terms_of_service is not
None``. This argument is optional, if not supplied it will
default to automatic acceptance!
:raises certbot.errors.Error: In case of any client problems, in
particular registration failure, or unaccepted Terms of Service.
:raises acme.errors.Error: In case of any protocol problems.
:returns: Newly registered and saved account, as well as protocol
API handle (should be used in `Client` initialization).
:rtype: `tuple` of `.Account` and `acme.client.Client`
s* There are already existing accounts for %ssL No email was provided and --register-unsafely-without-email was not present.s Registering without email!t public_exponenti t key_sizet backendR N( t find_allt loggert infoR t emailR$ t register_unsafely_without_emailt warningR t Errort dry_runt debugR t rsa_key_sizeR t joset JWKRSAt ComparableRSAKeyR t perform_registrationR
t Accountt saveR t prepare_subscription( R t account_storaget tos_cbt msgt rsa_keyR t acmeR t acc( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyt registerr s, &
c
C sS | j o | j } | rc | j j j j � } t j j d | d | j d | j d | j j � } n d } | j � r� | s� d } t j
| � � q� n y2 t j j d | j d | � } | j | | � SWn� t j
k
rN} | j d k s� | j d k rH| j r#d
| j } t j
| � � n t j d t � | _ t | | | � S� n Xd S(
sj
Actually register new account, trying repeatedly if there are email
problems
:param acme.client.Client client: ACME client object.
:param .IConfig config: Client configuration.
:param Callable tos_cb: a callback to handle Term of Service agreement.
:returns: Registration Resource.
:rtype: `acme.messages.RegistrationResource`
t account_public_keyt kidt hmac_keyt directorysR Server requires external account binding. Please use --eab-kid and --eab-hmac-key.Ra t external_account_bindingt invalidEmailt invalidContactsz The ACME server believes %s is an invalid email address. Please ensure it is a valid email and attempt registration again.t invalidN( t eab_kidt eab_hmac_keyR R R t
public_keyR t ExternalAccountBindingt from_dataRy R$ t external_account_requiredR Rd t NewRegistrationRa t new_account_and_tost codeRH t display_opst get_emailt TrueRk ( Rs R Rp t eab_credentials_suppliedRv t eabRq t newregt e( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyRk � s2
t Clientc B s� e Z d Z d
d � Z d
d � Z d
d � Z d � Z d � Z d � Z d � Z
d � Z e d � Z
d
d
� Z d � Z d � Z RS( sq Certbot's client.
:ivar .IConfig config: Client configuration.
:ivar .Account account: Account registered with `register`.
:ivar .AuthHandler auth_handler: Authorizations handler that will
dispatch DV challenges to appropriate authenticators
(providing `.IAuthenticator` interface).
:ivar .IAuthenticator auth: Prepared (`.IAuthenticator.prepare`)
authenticator that can solve ACME challenges.
:ivar .IInstaller installer: Installer.
:ivar acme.client.BackwardsCompatibleClientV2 acme: Optional ACME
client API handle. You might already have one from `register`.
c C s� | | _ | | _ | | _ | | _ | d k r` | j d k r` t | | j j | j j � } n | | _ | d k r� t j
| | j | j | j j � | _ n d | _ d S( s Initialize a client.N( R R
t authR/ R$ R R R Rs R t AuthHandlert pref_challs( RS R t account_R� R/ Rs ( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyRT � s ! $c C sM | j d k r4 d } t j | � t j | � � n | j j d k rX t j d � � n t j d | � | d k r� | j | j
d t �} n t j j
� t j d d � } | j j d k } | j j | | d | �} | j } | r"| j r"t j | g | j | j j | j j � } n t j | � \ } } | j � | j � f S( sW Obtain certificate.
:param .util.CSR csr: PEM-encoded Certificate Signing
Request. The key used to generate this CSR can be different
than `authkey`.
:param acme.messages.OrderResource orderr: contains authzrs
:returns: certificate and chain as PEM byte strings
:rtype: tuple
s> Unable to obtain certificate because authenticator is not set.s+ Please register with the ACME server first.s CSR: %st best_effortt secondsiZ t fetch_alternative_chainsN( R R$ R_ Rc R Rd R
R Rf t _get_order_and_authorizationst datat Falset datetimet nowt timedeltaR t preferred_chainRs t finalize_ordert
fullchain_pemt alternative_fullchains_pemR t find_chain_with_issuerRe t cert_and_chain_from_fullchaint encode( RS t csrt orderrRq t deadlinet get_alt_chainst fullchaint certt chain( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyt obtain_certificate_from_csr s*
c C s� | d k ra t | d � � } | } | j � } Wd QXt j d | d | � } t j d | � n d } | j j } d } t | j j
t � r� | j j
d | j _
n | j j r� | j j
d k r� | j j } d | j _
d | j _ d
| j _ n3 | j j r+| j j
j � d k r+| j j } n | j j r�| ppt j d d d t j d | d
| d | j j
� � } t j d d d d d t j | j | | j j � � } nQ | p�t j d | d | j j d | j j
d
| � } t j | | | j j � } | j | j | j j � }
|
j } t! d � | D� � } g | D] }
|
| k r>|
^ q>} | j j r�| | k r�| j j s�t" j# | j$ � t" j# | j$ � n | j% | � S| j& | |
� \ } } | | | | f Sd S( s� Obtains a certificate from the ACME server.
`.register` must be called before `.obtain_certificate`
:param list domains: domains to get a certificate
:returns: certificate as PEM string, chain as PEM string,
newly generated private key (`.util.Key`), and DER-encoded
Certificate Signing Request (`.util.CSR`).
:rtype: tuple
t rbNt filet pems% Reusing existing private key from %s.i t ecdsas ./chain-ecdsa.pems ./cert-ecdsa.pems ./key-ecdsa.pemt rsat bitst elliptic_curvet key_typet formR� R\ t key_dirc s s | ] } | j j j Vq d S( N( t bodyt
identifiert value( t .0t a( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pys <genexpr>x s (' R$ t opent readR t KeyR_ R` R Rg RB R� t listR� t auth_chain_patht auth_cert_patht key_patht lowerRe R t make_keyt CSRt acme_crypto_utilt make_csrR� t must_staplet
init_save_keyR� t
init_save_csrt csr_dirR� R� RG t authorizationst setR t removeR� t obtain_certificateR� ( RS t domainst old_keypatht ft keypatht keypemR R\ R� R� R� t authzrt auth_domainst dt successful_domainsR� R� ( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyR� . sZ $ %
c C s� y | j j | � } Wn# t j k
r; t j d � � n X| r� | j j r� | j j | � \ } } | r� t
j d � | j j | � } n | r� t
j d � q� n | j j
| | � } | j d | � S( s` Request a new order and complete its authorizations.
:param str csr_pem: A CSR in PEM format.
:param bool best_effort: True if failing to complete all
authorizations should not raise an exception
:returns: order resource containing its completed authorizations
:rtype: acme.messages.OrderResource
sW The currently selected ACME CA endpoint does not support issuing wildcard certificates.s* Recreating order after authz deactivationss Certbot was unable to obtain fresh authorizations for every domain. The dry run will continue, but results may not be accurate.R� ( Rs t new_ordert acme_errorst WildcardUnsupportedErrorR Rd R Re R t deactivate_valid_authorizationsR_ Rf Rc t handle_authorizationst update( RS t csr_pemR� R� t deactivatedt failedR� ( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyR� � s
c C s� | j | � \ } } } } | j j t j d k sM | j j t j d k r] t j d � n | j | | � } | j j r� t j
d | � d St j
j | | | j | | j � S( s{ Obtain and enroll certificate.
Get a new certificate for the specified domains using the specified
authenticator and installer, and then create a new renewable lineage
containing it.
:param domains: domains to request a certificate for
:type domains: `list` of `str`
:param certname: requested name of lineage
:type certname: `str` or `None`
:returns: A new :class:`certbot._internal.storage.RenewableCert` instance
referred to the enrolled cert lineage, False if the cert could not
be obtained, or None if doing a successful dry run.
t
config_dirt work_dirsd Non-standard path(s), might not work with crontab installed by your operating system package managers- Dry run: Skipping creating new lineage for %sN( R� R R� R
t CLI_DEFAULTSR� R_ R` t _choose_lineagenameRe Rf R$ R t
RenewableCertt new_lineageR� ( RS R� t certnameR� R� R t _t new_name( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyt obtain_and_enroll_certificate� s
c C s1 | r
| St j | d � r) | d d S| d S( s/ Chooses a name for the new lineage.
:param domains: domains in certificate request
:type domains: `list` of `str`
:param certname: requested name of lineage
:type certname: `str` or `None`
:returns: lineage name that should be used
:rtype: str
i i ( R t is_wildcard_domain( RS R� R� ( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyR� � s
c
C s� x< | | | f D]+ } t j t j j | � d | j j � q Wt d | � \ } } z | j | � Wd | j � Xt
j d | � t d | � \ } }
t d | � \ } } t | | � t | | | � | |
| f S( s Saves the certificate received from the ACME server.
:param str cert_pem:
:param str chain_pem:
:param str cert_path: Candidate path to a certificate.
:param str chain_path: Candidate path to a certificate chain.
:param str fullchain_path: Candidate path to a full cert chain.
:returns: cert_path, chain_path, and fullchain_path as absolute
paths to the actual files
:rtype: `tuple` of `str`
:raises IOError: If unable to find room to write the cert files
i� t cert_pathNs4 Server issued certificate; certificate written to %st
chain_patht fullchain_path(
R t make_or_verify_dirR t patht dirnameR t strict_permissionst _open_pem_filet writet closeR_ R` t _save_chain(
RS t cert_pemt chain_pemR� R� R� R� t cert_filet
abs_cert_patht
chain_filet abs_chain_patht fullchain_filet abs_fullchain_path( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyt save_certificate� s )
c C s | j d
k r. t j d � t j d � � n | d
k r@ d
n t j j | � } d } t j
| j | � �v x^ | D]V } | j j d | d t j j | � d t j j | � d | d | � | j j
� qu W| j j
d � Wd
QXd } t j
| j | � � | j j � Wd
QXd
S( s Install certificate
:param list domains: list of domains to install the certificate
:param str privkey_path: path to certificate private key
:param str cert_path: certificate file path (optional)
:param str chain_path: chain file path
sA No installer specified, client is unable to deploythe certificates No installer availables! Unable to install the certificatet domainR� R� R� R� s Deployed ACME CertificateNsu We were unable to install your certificate, however, we successfully restored your server to its prior configuration.( R/ R$ R_ Rc R Rd R R� t abspathR t ErrorHandlert _recovery_routine_with_msgt deploy_certRm t _rollback_and_restartt restart( RS R� t privkey_pathR� R� R� Rq t dom( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyt deploy_certificate s"
$
c C s1 | j d
k r. t j d � t j d � � n t } d d d d | f d f } | j j � } x� | D]� \ } } } t | j | � }
| | k r� | d k r� |
d
k r� | }
n |
r� | j
| | | � t } q� qe |
re t j d | � qe qe Wd } | r-t j
| j | � � | j j � Wd
QXn d
S( sf Enhance the configuration.
:param list domains: list of domains to configure
:param chain_path: chain file path
:type chain_path: `str` or `None`
:param redirect_default: boolean value that the "redirect" flag should default to
:raises .errors.Error: if no installer is specified in the
client.
sD No installer is specified, there isn't any configuration to enhance.s No installer availablet hstss ensure-http-headers Strict-Transport-Securityt redirectt staples staple-ocspt uirs Upgrade-Insecure-RequestssK Option %s is not supported by the selected installer. Skipping enhancement.s$ We were unable to restart web serverN( R s ensure-http-headers Strict-Transport-Security( R
R
N( R s ensure-http-headers Upgrade-Insecure-Requests( R/ R$ R_ Rc R Rd R� t supported_enhancementsRI R t apply_enhancementR� R R R R ( RS R� R� t redirect_defaultt enhancedt enhancement_infot supportedt config_namet enhancement_namet optiont config_valueRq ( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyt enhance_config+ s2
c
C s� d | } t j | j | � �� x� | D]� } y | j j | | | � Wq' t j k
r� | d k ry t j d | � q� t j d | � q' t j k
r� t j d | | � � q' Xq' W| j j
d | � Wd QXd S( s� Applies an enhancement on all domains.
:param list domains: list of ssl_vhosts (as strings)
:param str enhancement: name of enhancement, e.g. ensure-http-header
:param str options: options to enhancement, e.g. Strict-Transport-Security
.. note:: When more `options` are needed, make options a list.
:raises .errors.PluginError: If Enhancement is not supported, or if
there is any other problem with the enhancement.
sm We were unable to set up enhancement %s for your server, however, we successfully installed your certificate.s ensure-http-headers Enhancement %s was already set.s# Unable to set enhancement %s for %ss Add enhancement %sN( R R R R/ t enhanceR t PluginEnhancementAlreadyPresentR_ Rc t PluginErrorRm ( RS R� t enhancementt optionsRq R ( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyR V s"
c C s9 | j j � t j j t j � } | j | | j � d S( s� Calls the installer's recovery routine and prints success_msg
:param str success_msg: message to show on successful recovery
N( R/ t recovery_routinet zopet componentt
getUtilityR t IReportert add_messaget
HIGH_PRIORITY( RS t success_msgt reporter( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyR y s
c C sw t j d � t j j t j � } y | j j � | j j � Wn | j
d | j � � n X| j
| | j � d S( s� Rollback the most recent checkpoint and restart the webserver
:param str success_msg: message to show on successful rollback
s0 Rolling back to previous server configuration...s� An error occurred and we failed to restore your config and restart your server. Please post to https://community.letsencrypt.org/c/help with details about your configuration and this error you received.N( R_ t criticalR R R R R! R/ t rollback_checkpointsR R" R# ( RS R$ R% ( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyR � s
N( RW RX RY R$ RT R� R� R� R� R� R� R R� R R R R ( ( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyR� � s & [ $ ( $ + #
c C s | j r. t j | j � r. t j d � � n | r| j d k r� t j j t j j | j
� } t j j t j j | � } t
j | j | d � } n | j
r� t j | j
� r� t j d � � n | j
r| j rt j | j
| j � st j d � � qqn d S( s� Validate Key and CSR files.
Verifies that the client key and csr arguments are valid and correspond to
one another. This does not currently check the names in the CSR due to
the inability to read SANs from CSRs in python crypto libraries.
If csr is left as None, only the key will be validated.
:param privkey: Key associated with CSR
:type privkey: :class:`certbot.util.Key`
:param .util.CSR csr: CSR
:raises .errors.Error: when validation fails
s# The provided key is not a valid keyt derR� s# The provided CSR is not a valid CSRs The key and CSR do not matchN( R� R t
valid_privkeyR Rd R� t OpenSSLt cryptot load_certificate_requestt
FILETYPE_ASN1R� t dump_certificate_requestt FILETYPE_PEMR R� R� t valid_csrt csr_matches_pubkey( t privkeyR� t csr_objt cert_buffer( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyt validate_key_csr� s c C sE t j | | | d d �} | d k rA | j | � | j � n d S( s� Revert configuration the specified number of checkpoints.
:param int checkpoints: Number of checkpoints to revert.
:param config: Configuration.
:type config: :class:`certbot.interfaces.IConfig`
t questions, Which installer should be used for rollback?N( t plugin_selectiont pick_installerR$ R' R ( t default_installert checkpointsR t pluginsR/ ( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyt rollback� s
c C sm t j | � r: t j | d d d d �t j j | � f St j | d d � } | d t j j | d � f S( s' Open a pem file.
If cli_arg_path was set by the client, open that.
Otherwise, uniquify the file path.
:param str cli_arg_path: the cli arg name, e.g. cert_path
:param str pem_path: the pem file path to open
:returns: a tuple of file object and its absolute file path
t chmodi� t modet wbi i ( R t
set_by_cliR t safe_openR R� R t unique_file( t cli_arg_patht pem_patht uniq( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyR� � s
c C s6 z | j | � Wd | j � Xt j d | j � d S( s� Saves chain_pem at a unique path based on chain_path.
:param str chain_pem: certificate chain in PEM format
:param str chain_file: chain file object
Ns Cert chain written to %s( R� R� R_ R` RU ( R� R� ( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyR� � s (< RY R� t loggingR) t cryptography.hazmat.backendsR t- cryptography.hazmat.primitives.asymmetric.rsaR t josepyRh R* t zope.componentR Rs R R R R� R R� R t acme.magic_typingR R R, R R t certbot._internalR
R R R
R R R t certbot._internal.pluginsR R7 t certbot.compatR t certbot.displayR R� t getLoggerRW R_ R$ R R R1 t objectRC RZ Ru Rk R� R5 R< R� R� ( ( ( s< /usr/lib/python2.7/site-packages/certbot/_internal/client.pyt <module> sV G -� � .