File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/win_snmp.cpython-310.pyc
Back
o ;j 6 � @ s� d Z ddlZddlZddlmZmZ dZdZe� d�Z e� d�Z dZ e � d�Z d d d d d d�Z dd d d d dd�Ze�e�ZdZdd� Zdd� Zdd� Zdd� Zd%dd�Zd d � Zd&d d �Zd!d"� Zd#d$� ZdS )'zu Module for managing SNMP service settings on Windows servers. The Windows feature 'SNMP-Service' must be installed. � N)�CommandExecutionError�SaltInvocationErrorZHKLMz1SYSTEM\CurrentControlSet\Services\SNMP\Parametersz \RFC1156Agentz\ValidCommunitiesz!SOFTWARE\Policies\SNMP\Parameters� � � � � )�NoneZNotifyz Read Onlyz Read Writez Read Create�@ )r ZPhysicalzDatalink and subnetworkZInternetz End-to-endZ ApplicationsZwin_snmpc C s& t jj�� sdS td tt�sdS tS )z( Only works on Windows systems. )Fz!Module win_snmp: Requires Windows�reg.key_exists)Fz#Module win_snmp: SNMP not installed)�salt�utils�platformZ is_windows� __utils__�_HKEY� _SNMP_KEY�__virtualname__� r r �I/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/win_snmp.py� __virtual__* s r c C � t t�S )z� Get the sysServices types that can be configured. Returns: list: A list of service types. CLI Example: .. code-block:: bash salt '*' win_snmp.get_agent_service_types )�list�_SERVICE_TYPESr r r r �get_agent_service_types7 � r c C r )z� Get the permission types that can be configured for communities. Returns: list: A list of permission types. CLI Example: .. code-block:: bash salt '*' win_snmp.get_permission_types )r �_PERMISSION_TYPESr r r r �get_permission_typesG r r c C s� t � } tt�� dd� d�}t� | d< td ttd�d | d< td ttd �d | d < td ttd �d }|d krD| d �|d d � n!|D ] \}}|durd|d krd|| }|d krc|}| d �|� qF t| d �| d< | S )z� Determine the value of the SNMP sysContact, sysLocation, and sysServices settings. Returns: dict: A dictionary of the agent settings. CLI Example: .. code-block:: bash salt '*' win_snmp.get_agent_settings c S s | d | d fS )Nr r r )�xr r r �<lambda>f s z$get_agent_settings.<locals>.<lambda>)�key�services�reg.read_value� sysContact�vdata�contact� sysLocation�location� sysServicesr ���N) �dict�sortedr �itemsr r r � _AGENT_KEY�append)�retZ sorted_typesZcurrent_bitmask�serviceZbitmaskZremaining_bitmaskr r r �get_agent_settingsW s0 ��� �r0 c C sh |dur t t|��}|D ]}|tvr d�|t� �}t|��q | ||d�}t� }||kr2t�d� dS | durF| |d krFt d t t d| d � |durZ||d krZt d t t d |d � |dur�t|�t|d �kr�t d d� |D ��}t�d|� t d t t d|d� t� }t � } |D ]} || dur�|| || kr�|| | | < q�| r�t�d| � dS t�d|�� � dS )a� Manage the SNMP sysContact, sysLocation, and sysServices settings. Args: contact (:obj:`str`, optional): The SNMP contact. location (:obj:`str`, optional): The SNMP location. services (:obj:`list`, optional): A list of selected services. The possible service names can be found via ``win_snmp.get_agent_service_types``. To disable all services pass a list of None, ie: ['None'] Default is ``None``. Returns: bool: ``True`` if successful, otherwise ``False``. CLI Example: .. code-block:: bash salt '*' win_snmp.set_agent_settings contact='Contact Name' location='Place' services='["Physical"]' Nz2Invalid service '{}' specified. Valid services: {})r$ r& r z3Agent settings already contain the provided values.Tr$ � reg.set_valuer" ZREG_SZr& r% r c s s � | ]}t | V qd S )N)r )�.0r/ r r r � <genexpr>� s � z%set_agent_settings.<locals>.<genexpr>z Setting sysServices vdata to: %sr' � REG_DWORDz&Unable to configure agent settings: %sFz*Agent settings configured successfully: %s)r* �setr �formatr r r0 �_LOG�debugr r r, �sumr) �error�keys) r$ r& r r/ �messageZsettingsZcurrent_settingsr# Z new_settingsZfailed_settingsZsettingr r r �set_agent_settings� sT �� � � � � r= c C s0 t d ttd�} | d dkrdS t| d pd�S )z� Determine whether the host is configured to send authentication traps. Returns: bool: ``True`` if traps are enabled, otherwise ``False`` CLI Example: .. code-block:: bash salt '*' win_snmp.get_auth_traps_enabled r! �EnableAuthenticationTrapsr# z(value not set)Fr )r r r �bool)Zreg_retr r r �get_auth_traps_enabled� s r@ Tc C st d}t � }t| �|krt�d|� dS t| �}td tt||d� t � }| |kr1t�d||� dS t�d||� dS ) a| Manage the sending of authentication traps. Args: status (:obj:`bool`, optional): ``True`` to enable traps. ``False`` to disable. Default is ``True``. Returns: bool: ``True`` if successful, otherwise ``False``. CLI Example: .. code-block:: bash salt '*' win_snmp.set_auth_traps_enabled status='True' r> z'%s already contains the provided value.Tr1 r4 z&Setting %s configured successfully: %sz%Unable to configure %s with value: %sF) r@ r? r7 r8 �intr r r r: )�status�vnameZcurrent_statusr# Z new_statusr r r �set_auth_traps_enabled� s rD c C s� t � } td tt�r,t�d� td tt�}t|t�r,|D ]}t|t �s%q d| |d < q | sct�d� td tt�}t|t�rc|D ]!}t|t �sIqAd}t D ]}|d t | kr[|} nqM|| |d < qA| sjt�d � | S ) aE Get the current accepted SNMP community names and their permissions. If community names are being managed by Group Policy, those values will be returned instead like this: .. code-block:: bash TestCommunity: Managed by GPO Community names managed normally will denote the permission instead: .. code-block:: bash TestCommunity: Read Only Returns: dict: A dictionary of community names and permissions. CLI Example: .. code-block:: bash salt '*' win_snmp.get_community_names r z.Loading communities from Group Policy settingszreg.list_valueszManaged by GPOr# z&Loading communities from SNMP settings� rC z$Unable to find existing communities.) r) r r �_COMMUNITIES_GPO_KEYr7 r8 � isinstancer �_COMMUNITIES_KEYr )r. Zcurrent_valuesZ current_valueZ permissionsZpermission_namer r r �get_community_names s4 � rI c C s� t � }td tt�rt�d� td��t� }| |kr!t�d� dS | D ]*}| | s-d| |< zt| | }W n t yH t d� | | t� � ���w |||< q#|D ]#}||v rk|| || krjtd tt ||| d� qPtd tt |� qP|D ]}||vr�td tt ||| d� qvt� }t � }|D ] }|| vr�d ||< q�| D ]}| | || kr�| | ||< q�|r�t�d |� d S t�d | � � � dS )a2 Manage the SNMP accepted community names and their permissions. .. note:: Settings managed by Group Policy will always take precedence over those set using the SNMP interface. Therefore if this function finds Group Policy settings it will raise a CommandExecutionError Args: communities (dict): A dictionary of SNMP community names and permissions. The possible permissions can be found via ``win_snmp.get_permission_types``. Returns: bool: ``True`` if successful, otherwise ``False``. Raises: CommandExecutionError: If SNMP settings are being managed by Group Policy CLI Example: .. code-block:: bash salt '*' win_snmp.set_community_names communities='{"TestCommunity": "Read Only"}' r z6Communities on this system are managed by Group Policyz0Communities already contain the provided values.Tr z8Invalid permission '{}' specified. Valid permissions: {}r1 r4 zreg.delete_valueNz#Unable to configure communities: %sFz'Communities configured successfully: %s)r) r r rF r7 r8 r rI r �KeyErrorr r6 r; rH r: ) Z communities�valuesZcurrent_communitiesrC r# Z current_vnameZnew_communitiesZfailed_communitiesZ new_vnamer r r �set_community_namesz sp � ��� �� ��� � rL )NNN)T) �__doc__�loggingZsalt.utils.platformr Zsalt.exceptionsr r r r r, rH Z _SNMP_GPO_KEYrF r r � getLogger�__name__r7 r r r r r0 r= r@ rD rI rL r r r r �<module> sD �� 0X ' `
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings