File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/proxy/__pycache__/restconf.cpython-310.pyc
Back
o ;j� � @ s� d Z ddlZddlZddlZddlZddlmZ dgZdZ e� e �Z i Z dd� Zdd� Zd d � Zd d � Zd d� Zdd� Zddd�ZdS )a� Proxy Minion to manage RESTCONF Devices :codeauthor: Jamie (Bear) Murphy <jamiemurphyit@gmail.com> :maturity: new :platform: any Usage ===== .. note:: To be able to use this module you need to enable RESTCONF on your device and have https enabled. Cisco Configuration example: .. code-block:: bash switch# conf t switch(config)# restconf switch(config)# ip http secure-server .. note:: RESTCONF requires modern OS distributions. This plugin has been written specifically to use JSON RESTCONF endpoints Pillar ------ The ``restconf`` proxy configuration requires the following parameters in order to connect to the network switch: transport: ``https`` (str) Specifies the type of connection transport to use. Valid values for the connection are ``https``, and ``http``. The RESTCONF standard explicitly requires https, but http is included as an option as some manufacturers have ignored this requirement. hostname: (str) The IP address or DNS host name of the RESTCONF device. username: (str) The username for the device to authenticate the RESTCONF requests. password: (str) The password for the device to authenticate the RESTCONF requests. verify: ``True`` or ``False`` (str, optional, default:true) Verify the RESTCONF SSL certificate? When there is no certificate configuration on the device and this option is set as ``True`` (default), the commands will fail with the following error: ``SSLError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed``. .. warning:: In this case, you either need to configure a proper certificate on the device (*recommended*), or bypass the checks setting this argument as ``False`` with all the security risks considered as you may be MITM'd. Proxy Pillar Example -------------------- .. code-block:: yaml proxy: proxytype: restconf host: switch1.example.com username: example password: example verify: false � N)� SaltExceptionZrestconfc C s t S )zV This Proxy Module is widely available as there are no external dependencies. )�__virtualname__� r r �G/opt/saltstack/salt/lib/python3.10/site-packages/salt/proxy/restconf.py� __virtual__h s r c C s t �d� t�| �di ��}|�dd�| d< d|vr!t �d� dS d|vr,t �d � dS d |vr7t �d � dS d |vr?d|d < d |vrGd|d < |td< z1t� }|d rhdtd< dtd< t j d|d dd� W dS dtd< dtd< t j d|d dd� W dS t y� t j d|d dd� � w )zO Required. Initialize device config and test an initial connection z#RESTCONF proxy init(opts) called...�proxy�multiprocessingT�hostnamez1No 'hostname' key found in pillar for this proxy.F�usernamez1No 'username' key found in pillar for this proxy.�passwordz1No 'password' key found in pillar for this proxy.�verifyZ transport�https� conn_argsr � initializedZupzConnected to %s)�exc_infozUnable to connect to %sN) �log�debug�copy�deepcopy�get�pop�critical�restconf_device�connection_test�info�errorr )�optsr �responser r r �initt s< �r c C s4 t �d� tdddd�} dt| �v rd| fS d| fS ) zB Runs a connection test via http/https. Returns an array. z*RESTCONF proxy connection_test() called...z restconf/yang-library-version�GETN)�method� dict_payloadzyang-library-versionTF)r r �request�str)r r r r r � s r c C s t �d� t� d S )z= Triggers connection test. Returns True or False z RESTCONF proxy ping() called...r )r r r r r r r �ping� s r$ c C s t �dd�S )z+ Connection finished initializing? r F)r r r r r r r � s r c C s t �d| d � dS )z, Closes connection with the device. z*Shutting down the RESTCONF Proxy Minion %s�idN)r r )r r r r �shutdown� s r& r c C s� |du rd}n t |t�r|}nt�|�}tjjjdjdd| it d ��||ddt d d t d d t d d d d gd � }t � d |� |S )z( Trigger http request to device N� z {transport}://{hostname}/{path}�pathr Tr r r z=Accept: application/yang-data+json,application/yang.data+jsonz(Content-Type: application/yang-data+json)r �data�decode�statusZ verify_sslr r Z header_listz#proxy_restconf_request_response: %sr ) � isinstancer# �json�dumps�salt�utils�http�query�formatr r r )r( r r! r) r r r r r" � s0 �� �� r" )r N)�__doc__r r- �loggingZsalt.utils.httpr/ Zsalt.exceptionsr Z__proxyenabled__r � getLogger�__file__r r r r r r$ r r& r" r r r r �<module> s" J 1
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings