File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/namecheap_ssl.cpython-310.pyc
Back
o ;j�f � @ s� d Z ddlZddlZddlZzddlZdZW n ey! dZY nw e�e �Z dd� Z ddd�Z dd d �Z d d � Zdd d�Zddd�Zddd�Zdd� Zddd�ZdS ) af Namecheap SSL Certificate Management .. versionadded:: 2017.7.0 Prerequisites ------------- This module uses the ``requests`` Python module to communicate to the namecheap API. Configuration ------------- The Namecheap username, API key and URL should be set in the minion configuration file, or in the Pillar data. .. code-block:: yaml namecheap.name: companyname namecheap.key: a1b2c3d4e5f67a8b9c0d1e2f3 namecheap.client_ip: 162.155.30.172 #Real url namecheap.url: https://api.namecheap.com/xml.response #Sandbox url #namecheap.url: https://api.sandbox.namecheap.xml.response � NTFc C s t rdS dS )zH Check to make sure requests and xml are installed and requests Z namecheap_sslF)�CAN_USE_NAMECHEAP� r r �N/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/namecheap_ssl.py� __virtual__- s r c K � t dd| |||||�S )a� Reissues a purchased SSL certificate. Returns a dictionary of result values. csr_file Path to Certificate Signing Request file certificate_id Unique ID of the SSL certificate you wish to activate web_server_type The type of certificate format to return. Possible values include: - apache2 - apacheapachessl - apacheopenssl - apacheraven - apachessl - apachessleay - c2net - cobaltseries - cpanel - domino - dominogo4625 - dominogo4626 - ensim - hsphere - ibmhttp - iis - iis4 - iis5 - iplanet - ipswitch - netscape - other - plesk - tomcat - weblogic - website - webstar - zeusv3 approver_email The email ID which is on the approver email list. .. note:: ``http_dc_validation`` must be set to ``False`` if this option is used. http_dc_validation : False Whether or not to activate using HTTP-based validation. .. note:: For other parameters which may be required, see here__. .. __: https://www.namecheap.com/support/api/methods/ssl/reissue.aspx CLI Example: .. code-block:: bash salt 'my-minion' namecheap_ssl.reissue my-csr-file my-cert-id apachessl znamecheap.ssl.reissueZSSLReissueResult��__get_certificates��csr_file�certificate_id�web_server_type�approver_email�http_dc_validation�kwargsr r r �reissue6 � G�r c K r )a� Activates a newly-purchased SSL certificate. Returns a dictionary of result values. csr_file Path to Certificate Signing Request file certificate_id Unique ID of the SSL certificate you wish to activate web_server_type The type of certificate format to return. Possible values include: - apache2 - apacheapachessl - apacheopenssl - apacheraven - apachessl - apachessleay - c2net - cobaltseries - cpanel - domino - dominogo4625 - dominogo4626 - ensim - hsphere - ibmhttp - iis - iis4 - iis5 - iplanet - ipswitch - netscape - other - plesk - tomcat - weblogic - website - webstar - zeusv3 approver_email The email ID which is on the approver email list. .. note:: ``http_dc_validation`` must be set to ``False`` if this option is used. http_dc_validation : False Whether or not to activate using HTTP-based validation. .. note:: For other parameters which may be required, see here__. .. __: https://www.namecheap.com/support/api/methods/ssl/activate.aspx CLI Example: .. code-block:: bash salt 'my-minion' namecheap_ssl.activate my-csr-file my-cert-id apachessl znamecheap.ssl.activateZSSLActivateResultr r r r r �activate� r r c C s� d}||vrt �d|� td| ��|d ur!|r!t �d� td��|d u r0|s0t �d� td��tjj�| �} tjj�|d��} tjj � | � � �| d< W d � n1 sUw Y || d< || d < |d urj|| d < |rpd | d < |� � D ]\} } | | | < qttjj� | �} | d u r�i S | �|�d }tjj�|�}|r�|�d�}|r�|d }|�d��� dkr�|�d�d jd j|�d�d jd jd�}||d< |S )N) Z apacheopensslZ apachesslZ apacheravenZ apachessleayZc2netZibmhttpZiplanetZdominoZ dominogo4625Z dominogo4626ZnetscapeZzeusv3Zapache2ZapacheapachesslZ cobaltseriesZcpanelZensimZhsphereZipswitchZpleskZtomcatZweblogicZwebsiteZwebstarZiis�otherZiis4Ziis5z%Invalid option for web_server_type=%sz#Invalid option for web_server_type=z=approver_email and http_dc_validation cannot both have valuesz6approver_email or http_dc_validation must have a value�rb�csr� CertificateIDZ WebServerTypeZ ApproverEmail�True�HTTPDCValidationr ZHttpDCValidationZValueAvailable�trueZFileNameZ FileContent)�filenameZ filecontentZhttpdcvalidation)�log�error� Exception�salt�utils� namecheap�get_opts�files�fopen� stringutils� to_unicode�read�items� post_request�getElementsByTagName� atts_to_dictZ getAttribute�lowerZ childNodes�data)ZcommandZresult_tag_namer r r r r r Zweb_server_types�opts� csr_handle�key�value� response_xmlZ sslresult�resultZvalidation_tagZvalidation_dictr r r r � sV � � ��r c C s� d}||vrt �d|� td| ��| dk s| dkr*t �dt| �� tdt| � ��tjj�d�}t| �|d < t|�|d < ||d < |d urI||d < tjj�|�}|d u rVi S |� d�d }tjj� |�S )a� Renews an SSL certificate if it is ACTIVE and Expires <= 30 days. Returns the following information: - The certificate ID - The order ID - The transaction ID - The amount charged for the order years : 1 Number of years to register certificate_id Unique ID of the SSL certificate you wish to renew certificate_type Type of SSL Certificate. Possible values include: - EV Multi Domain SSL - EV SSL - EV SSL SGC - EssentialSSL - EssentialSSL Wildcard - InstantSSL - InstantSSL Pro - Multi Domain SSL - PositiveSSL - PositiveSSL Multi Domain - PositiveSSL Wildcard - PremiumSSL - PremiumSSL Wildcard - QuickSSL Premium - RapidSSL - RapidSSL Wildcard - SGC Supercert - SSL Web Server - SSL Webserver EV - SSL123 - Secure Site - Secure Site Pro - Secure Site Pro with EV - Secure Site with EV - True BusinessID - True BusinessID Multi Domain - True BusinessID Wildcard - True BusinessID with EV - True BusinessID with EV Multi Domain - Unified Communications promotional_code An optional promo code to use when renewing the certificate CLI Example: .. code-block:: bash salt 'my-minion' namecheap_ssl.renew 1 my-cert-id RapidSSL � zQuickSSL PremiumZRapidSSLzRapidSSL WildcardZ PremiumSSLZ InstantSSLZ PositiveSSLzPositiveSSL WildcardzTrue BusinessID with EVzTrue BusinessIDzTrue BusinessID Wildcardz True BusinessID Multi Domainz$True BusinessID with EV Multi Domainz Secure SitezSecure Site ProzSecure Site with EVzSecure Site Pro with EVZ EssentialSSLzEssentialSSL WildcardzInstantSSL ProzPremiumSSL WildcardzEV SSLz EV SSL SGCZSSL123zSSL Web Serverz SGC SupercertzSSL Webserver EVzEV Multi Domain SSLzMulti Domain SSLzPositiveSSL Multi DomainzUnified Communications�&Invalid option for certificate_type=%s�$Invalid option for certificate_type=� � �Invalid option for years=%s�Invalid option for years=znamecheap.ssl.renew�Yearsr ZSSLTypeN� PromotionCodeZSSLRenewResultr ) r r r �strr r r r! r( r) r* )�yearsr �certificate_type�promotion_code� valid_certsr- r1 Zsslrenewresultr r r �renew= s$ <! rA c C s� d}||vrt �d|� td| ��| dk s| dkr*t �dt| �� tdt| � ��tjj�d�}| |d < ||d < |d urA||d < |d urI||d < tjj�|�}|d u rVi S |� d�d }|� d�d }tjj� |�} | � tjj� |�� | S )a� Creates a new SSL certificate. Returns the following information: - Whether or not the SSL order was successful - The certificate ID - The order ID - The transaction ID - The amount charged for the order - The date on which the certificate was created - The date on which the certificate will expire - The type of SSL certificate - The number of years for which the certificate was purchased - The current status of the SSL certificate years : 1 Number of years to register certificate_type Type of SSL Certificate. Possible values include: - EV Multi Domain SSL - EV SSL - EV SSL SGC - EssentialSSL - EssentialSSL Wildcard - InstantSSL - InstantSSL Pro - Multi Domain SSL - PositiveSSL - PositiveSSL Multi Domain - PositiveSSL Wildcard - PremiumSSL - PremiumSSL Wildcard - QuickSSL Premium - RapidSSL - RapidSSL Wildcard - SGC Supercert - SSL Web Server - SSL Webserver EV - SSL123 - Secure Site - Secure Site Pro - Secure Site Pro with EV - Secure Site with EV - True BusinessID - True BusinessID Multi Domain - True BusinessID Wildcard - True BusinessID with EV - True BusinessID with EV Multi Domain - Unified Communications promotional_code An optional promo code to use when creating the certificate sans_to_add : 0 This parameter defines the number of add-on domains to be purchased in addition to the default number of domains included with a multi-domain certificate. Each certificate that supports SANs has the default number of domains included. You may check the default number of domains included and the maximum number of domains that can be added to it in the table below. +----------+----------------+----------------------+-------------------+----------------+ | Provider | Product name | Default number of | Maximum number of | Maximum number | | | | domains (domain from | total domains | of domains | | | | CSR is counted here) | | that can be | | | | | | passed in | | | | | | sans_to_add | | | | | | parameter | +----------+----------------+----------------------+-------------------+----------------+ | Comodo | PositiveSSL | 3 | 100 | 97 | | | Multi-Domain | | | | +----------+----------------+----------------------+-------------------+----------------+ | Comodo | Multi-Domain | 3 | 100 | 97 | | | SSL | | | | +----------+----------------+----------------------+-------------------+----------------+ | Comodo | EV Multi- | 3 | 100 | 97 | | | Domain SSL | | | | +----------+----------------+----------------------+-------------------+----------------+ | Comodo | Unified | 3 | 100 | 97 | | | Communications | | | | +----------+----------------+----------------------+-------------------+----------------+ | GeoTrust | QuickSSL | 1 | 1 domain + | The only | | | Premium | | 4 subdomains | supported | | | | | | value is 4 | +----------+----------------+----------------------+-------------------+----------------+ | GeoTrust | True | 5 | 25 | 20 | | | BusinessID | | | | | | with EV | | | | | | Multi-Domain | | | | +----------+----------------+----------------------+-------------------+----------------+ | GeoTrust | True Business | 5 | 25 | 20 | | | ID Multi- | | | | | | Domain | | | | +----------+----------------+----------------------+-------------------+----------------+ | Thawte | SSL Web | 1 | 25 | 24 | | | Server | | | | +----------+----------------+----------------------+-------------------+----------------+ | Thawte | SSL Web | 1 | 25 | 24 | | | Server with | | | | | | EV | | | | +----------+----------------+----------------------+-------------------+----------------+ | Thawte | SGC Supercerts | 1 | 25 | 24 | +----------+----------------+----------------------+-------------------+----------------+ | Symantec | Secure Site | 1 | 25 | 24 | | | Pro with EV | | | | +----------+----------------+----------------------+-------------------+----------------+ | Symantec | Secure Site | 1 | 25 | 24 | | | with EV | | | | +----------+----------------+----------------------+-------------------+----------------+ | Symantec | Secure Site | 1 | 25 | 24 | +----------+----------------+----------------------+-------------------+----------------+ | Symantec | Secure Site | 1 | 25 | 24 | | | Pro | | | | +----------+----------------+----------------------+-------------------+----------------+ CLI Example: .. code-block:: bash salt 'my-minion' namecheap_ssl.create 2 RapidSSL r3 r4 r5 r6 r7 r8 r9 znamecheap.ssl.creater: �TypeNr; Z SANStoADDZSSLCreateResultr ZSSLCertificate) r r r r< r r r r! r( r) r* �update) r= r> r? Z sans_to_addr@ r- r1 ZsslcreateresultZ sslcertinfor2 r r r �create� s, {! rD c C s� d}||vrt �d|� td| ��tjj�d�}tjj�| d��}tjj � |� � �|d< W d � n1 s7w Y ||d< |rFd |d < tjj� |�}|� d �d }tjj�|�S ) a4 Parses the CSR. Returns a dictionary of result values. csr_file Path to Certificate Signing Request file certificate_type Type of SSL Certificate. Possible values include: - EV Multi Domain SSL - EV SSL - EV SSL SGC - EssentialSSL - EssentialSSL Wildcard - InstantSSL - InstantSSL Pro - Multi Domain SSL - PositiveSSL - PositiveSSL Multi Domain - PositiveSSL Wildcard - PremiumSSL - PremiumSSL Wildcard - QuickSSL Premium - RapidSSL - RapidSSL Wildcard - SGC Supercert - SSL Web Server - SSL Webserver EV - SSL123 - Secure Site - Secure Site Pro - Secure Site Pro with EV - Secure Site with EV - True BusinessID - True BusinessID Multi Domain - True BusinessID Wildcard - True BusinessID with EV - True BusinessID with EV Multi Domain - Unified Communications http_dc_validation : False Set to ``True`` if a Comodo certificate and validation should be done with files instead of emails and to return the info to do so CLI Example: .. code-block:: bash salt 'my-minion' namecheap_ssl.parse_csr my-csr-file PremiumSSL r3 r4 r5 znamecheap.ssl.parseCSRr r NZCertificateTyper r ZSSLParseCSRResultr )r r r r r r r! r" r# r$ r% r& r( r) � xml_to_dict)r r> r r@ r- r. r1 Zsslparseresultr r r � parse_csrj s 3! �rF c K s� t jj�d�}| �� D ]\}}|||< q t jj�|�}|du r!g S |�d�d }g }|�d�D ]}t jj�|�}|�|� q/|S )a� Returns a list of SSL certificates for a particular user ListType : All Possible values: - All - Processing - EmailSent - TechnicalProblem - InProgress - Completed - Deactivated - Active - Cancelled - NewPurchase - NewRenewal SearchTerm Keyword to look for on the SSL list Page : 1 Page number to return PageSize : 20 Total number of SSL certificates to display per page (minimum: ``10``, maximum: ``100``) SoryBy One of ``PURCHASEDATE``, ``PURCHASEDATE_DESC``, ``SSLTYPE``, ``SSLTYPE_DESC``, ``EXPIREDATETIME``, ``EXPIREDATETIME_DESC``, ``Host_Name``, or ``Host_Name_DESC`` CLI Example: .. code-block:: bash salt 'my-minion' namecheap_ssl.get_list Processing znamecheap.ssl.getListNZ SSLListResultr ZSSL) r r r r! r' � get_requestr) r* �append) r r- r/ r0 r1 Z ssllistresultr2 �e�sslr r r �get_list� s ( rK c C s� t jj�d�}| |d< |r2d|d< |du r t�d� td��|dvr.t�d|� td | ��||d < t jj�|�}|du r?i S |�d �d }t jj� |�S ) a Retrieves information about the requested SSL certificate. Returns a dictionary of information about the SSL certificate with two keys: - **ssl** - Contains the metadata information - **certificate** - Contains the details for the certificate such as the CSR, Approver, and certificate data certificate_id Unique ID of the SSL certificate returncertificate : False Set to ``True`` to ask for the certificate in response returntype Optional type for the returned certificate. Can be either "Individual" (for X.509 format) or "PKCS7" .. note:: Required if ``returncertificate`` is ``True`` CLI Example: .. code-block:: bash salt 'my-minion' namecheap_ssl.get_info my-cert-id znamecheap.ssl.getinfoZ certificateIDr �returncertificateNzBreturntype must be specified when returncertificate is set to True)Z IndividualZPKCS7z;returntype must be specified as Individual or PKCS7, not %sz9returntype must be specified as Individual or PKCS7, not � returntypeZSSLGetInfoResultr ) r r r r! r r r rG r) rE )r rL rM r- r1 Z sslinforesultr r r �get_info s2 ����rN )NF)N)NN)F)FN)�__doc__�loggingZsalt.utils.filesr Zsalt.utils.stringutilsZsalt.utils.namecheapr � ImportError� getLogger�__name__r r r r r rA rD rF rK rN r r r r �<module> s2 � �W �S a t :h;
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings