Current File : //usr/lib/python2.7/site-packages/salt/modules/win_smtp_server.pyo
�
���^c @@ su d Z d d l m Z m Z m Z d d l Z d d l Z d d l m Z d d l Z
d d l Z
d d l m
Z
y" d d l Z d d l Z
e Z Wn e k
r� e Z n Xd Z d Z e j e � Z d Z d � Z d
� Z d � Z d � Z d
� Z d � Z e d � Z e d � Z! e d � Z" e d � Z# e e d � Z$ d e e d � Z& e d � Z' d e d � Z( d S( u�
Module for managing IIS SMTP server configuration on Windows servers.
The Windows features 'SMTP-Server' and 'Web-WMI' must be installed.
:depends: wmi
i ( t absolute_importt unicode_literalst print_functionN( t SaltInvocationError( t sixu SmtpSvc/1u MicrosoftIISv2u win_smtp_serverc C@ s t j j j � r t r t St S( u(
Only works on Windows systems.
( t saltt utilst platformt
is_windowst _HAS_MODULE_DEPENDENCIESt __virtualname__t False( ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/win_smtp_server.pyt __virtual__1 s c
C@ s� t j j j � �� yM t j d t � } t | | � } | | g d | �d } t | | � } WnT t j k
r� } t j
d | j � n, t t
f k
r� } t j
d | | � n XWd QX| S( u>
Get the value of the setting for the provided class.
t namespacet Namei u Encountered WMI error: %su Error getting %s: %sN( R R t winapit Comt wmit WMIt _WMI_NAMESPACEt getattrt x_wmit _LOGt errort com_errort AttributeErrort
IndexError( t wmi_class_namet settingt servert
connectiont wmi_classt objst retR ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/win_smtp_server.pyt _get_wmi_setting: s c
C@ s t j j j � �� y8 t j d t � } t | | � } | d | � d } WnT t j k
rv } t j
d | j � n, t t
f k
r� } t j
d | | � n Xy t | | | � t SWnN t j k
r� } t j
d | j � n& t k
r
} t j
d | | � n XWd QXt S( u>
Set the value of the setting for the provided class.
R
R i u Encountered WMI error: %su Error getting %s: %su Error setting %s: %sN( R R R R R R R R R R R R R R t setattrt TrueR ( R R t valueR R R R R ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/win_smtp_server.pyt _set_wmi_settingL s" c K@ s� t � } t j j j | � } xr | D]j } t | | t � r� t j d | | � t t j
| | � � } d j | � | | <q% | | | | <q% W| S( u_
Convert setting values that had been improperly converted to a dict back to a string.
u Fixing value: %su {{{0}}}( t dictR R t argst clean_kwargst
isinstanceR t debugt nextR t iterkeyst format( t settingsR! R t value_from_key( ( s@ /usr/lib/python2.7/site-packages/salt/modules/win_smtp_server.pyt _normalize_server_settingse s
c
C@ s t � } d } t j j j � �� yj t j d t � } | j � } xE | D]= } t j
| j � j | d d � } t j
| j
� | | <qJ WWnQ t j k
r� } t j d | j � n) t t f k
r� } t j d | � n XWd QX| s� t j d � n | S( u�
Get all available log format names and ids.
:return: A dictionary of the log format names and ids.
:rtype: dict
CLI Example:
.. code-block:: bash
salt '*' win_smtp_server.get_log_format_types
u logging/R
u i u Encountered WMI error: %su% Error getting IISLogModuleSetting: %sNu Unable to get log format types.( R' R R R R R R R t IISLogModuleSettingR t text_typeR t replacet LogModuleIdR R R R R R ( R! t prefixR R t objt nameR ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/win_smtp_server.pyt get_log_format_typesw s
! c
C@ s� t � } t j j j � �� yL t j d t � } | j � } x' | D] } | j t
j | j � � qD WWnQ t j
k
r� } t j d | j � n) t t f k
r� } t j d | � n XWd QXt j d | � | S( u�
Get the SMTP virtual server names.
:return: A list of the SMTP virtual servers.
:rtype: list
CLI Example:
.. code-block:: bash
salt '*' win_smtp_server.get_servers
R
u Encountered WMI error: %su& Error getting IIsSmtpServerSetting: %sNu Found SMTP servers: %s( t listR R R R R R R t IIsSmtpServerSettingt appendR R3 R R R R R R R R+ ( R! R R R7 R ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/win_smtp_server.pyt get_servers� s
!c
C@ s� t � } | s t j d � | St j j j � �� y\ t j d t � } | j
| d | �d } x* | D]" } t j t
| | � � | | <qh WWnQ t j k
r� } t j d | j � n) t t f k
r� } t j d | � n XWd QX| S( u|
Get the value of the setting for the SMTP virtual server.
:param str settings: A list of the setting names.
:param str server: The SMTP server name.
:return: A dictionary of the provided settings and their values.
:rtype: dict
CLI Example:
.. code-block:: bash
salt '*' win_smtp_server.get_server_setting settings="['MaxRecipients']"
u No settings provided.R
R i u Encountered WMI error: %su& Error getting IIsSmtpServerSetting: %sN( R' R t warningR R R R R R R R; R R3 R R R R R R ( R/ R R! R R R R ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/win_smtp_server.pyt get_server_setting� s
$c
C@ s7 | s t j d � t St | � } t d | j � d | � } | | k r[ t j d � t St j j
j � �(y, t j
d t � } | j d | � d } WnQ t j k
r� } t j d | j � n) t t f k
r� } t j d | � n Xx� | D]� } t j | | � t j | | � k r� y t | | | | � Wq�t j k
rd} t j d | j � q�t k
r�} t j d
| | � q�Xq� q� WWd QXt d | j � d | � } t � } xE | D]= } t j | | � t j | | � k r�| | | | <q�q�W| r t j d | � t St j d
| j � � t S( u�
Set the value of the setting for the SMTP virtual server.
.. note::
The setting names are case-sensitive.
:param str settings: A dictionary of the setting names and their values.
:param str server: The SMTP server name.
:return: A boolean representing whether all changes succeeded.
:rtype: bool
CLI Example:
.. code-block:: bash
salt '*' win_smtp_server.set_server_setting settings="{'MaxRecipients': '500'}"
u No settings providedR/ R u- Settings already contain the provided values.R
R i u Encountered WMI error: %su& Error getting IIsSmtpServerSetting: %su Error setting %s: %sNu Failed to change settings: %su$ Settings configured successfully: %s( R R> R R1 R? t keysR+ R$ R R R R R R R R; R R R R R R R3 R# R' ( R/ R t current_settingsR R R R t new_settingst failed_settings( ( s@ /usr/lib/python2.7/site-packages/salt/modules/win_smtp_server.pyt set_server_setting� sD
&$
&c C@ sZ t � } t d d | � } x+ | D]# } t j | � | | k r" | Sq" Wt j d � d S( u
Get the active log format for the SMTP virtual server.
:param str server: The SMTP server name.
:return: A string of the log format name.
:rtype: str
CLI Example:
.. code-block:: bash
salt '*' win_smtp_server.get_log_format
u IIsSmtpServerSettingu LogPluginClsidu Unable to determine log format.N( R9 R" R R3 R R> t None( R t log_format_typest format_idt key( ( s@ /usr/lib/python2.7/site-packages/salt/modules/win_smtp_server.pyt get_log_format$ s
c C@ s� d } t � } | j | d � } | sN d j | | j � � } t | � � n t j d | | � t | � } | | k r� t j d | � t St
d | | | � t | � } | | k } | r� t j d | | � n t j d | | � | S( uo
Set the active log format for the SMTP virtual server.
:param str log_format: The log format name.
:param str server: The SMTP server name.
:return: A boolean representing whether the change succeeded.
:rtype: bool
CLI Example:
.. code-block:: bash
salt '*' win_smtp_server.set_log_format 'Microsoft IIS Log File Format'
u LogPluginClsidu6 Invalid log format '{0}' specified. Valid formats: {1}u Id for '%s' found: %su( %s already contains the provided format.u IIsSmtpServerSettingu& Setting %s configured successfully: %su% Unable to configure %s with value: %sN( R9 t getRE R. R@ R R R+ RI R$ R& R ( t
log_formatR R RF RG t messaget current_log_formatt new_log_formatR! ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/win_smtp_server.pyt set_log_format? s& c C@ s� t � } d } d } | r' t � } n t d | | � } xR | D]J } t j | | � \ } } | r� | j d j | | � � q@ | | | <q@ W| s� t j d | � n | S( uu
Get the IPGrant list for the SMTP virtual server.
:param bool as_wmi_format: Returns the connection IPs as a list in the format WMI expects.
:param str server: The SMTP server name.
:return: A dictionary of the IP and subnet pairs.
:rtype: dict
CLI Example:
.. code-block:: bash
salt '*' win_smtp_server.get_connection_ip_list
u IPGrantu ,\s*u IIsIPSecuritySettingu {0}, {1}u %s is empty.( R' R: R" t ret splitR< R. R R+ ( t
as_wmi_formatR R! R t
reg_separatort addressest unnormalized_addresst
ip_addresst subnet( ( s@ /usr/lib/python2.7/site-packages/salt/modules/win_smtp_server.pyt get_connection_ip_listl s
c
C@ sd d } t � } | s1 t � } t j d | � n x7 | D]/ } | j d j | j � | | j � � � q8 Wt d t d | � } t | � t | � k r� t j d | � t St
d d | � } | | k r� t j d | � t d d | | � n t d | | | � t d t d | � } t | � t | � k } | rMt j d
| | � | St j d | | � | S( u�
Set the IPGrant list for the SMTP virtual server.
:param str addresses: A dictionary of IP + subnet pairs.
:param bool grant_by_default: Whether the addresses should be a blacklist or whitelist.
:param str server: The SMTP server name.
:return: A boolean representing whether the change succeeded.
:rtype: bool
CLI Example:
.. code-block:: bash
salt '*' win_smtp_server.set_connection_ip_list addresses="{'127.0.0.1': '255.255.255.255'}"
u IPGrantu Empty %s specified.u {0}, {1}RR R u+ %s already contains the provided addresses.u IIsIPSecuritySettingu GrantByDefaultu Setting GrantByDefault to: %su %s configured successfully: %su% Unable to configure %s with value: %s(
R: R' R R+ R< R. t stripRX R$ t setR" R& R (
RT t grant_by_defaultR R t formatted_addressest addresst current_addressest current_grant_by_defaultt
new_addressesR! ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/win_smtp_server.pyt set_connection_ip_list� s0
c C@ s� t � } d } t d | | � } | s\ t j d | | � | d k rR d g } n t | � Sd } xi | t | � k r� g | | | d !D] } t j | � ^ q� } d j | � } | j | � | d 7} qe W| S( u
Get the RelayIpList list for the SMTP virtual server.
:param str server: The SMTP server name.
:return: A list of the relay IPs.
:rtype: list
.. note::
A return value of None corresponds to the restrictive 'Only the list below' GUI parameter
with an empty access list, and setting an empty list/tuple corresponds to the more
permissive 'All except the list below' GUI parameter.
CLI Example:
.. code-block:: bash
salt '*' win_smtp_server.get_relay_ip_list
u RelayIpListu IIsSmtpServerSettingu %s is empty: %si i u .N(
R: R" R R+ RE t lenR R3 t joinR< ( R R! R t linest it xt octetsR] ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/win_smtp_server.pyt get_relay_ip_list� s
-
c C@ s d } t � } t | � } t | � | k rA t j d | � t S| r� | d d k r` d } q� x8 | D]- } x$ | j d � D] } | j | � q} Wqg Wn t j d | | � t d | | | � t | � } t | � | k } | r� t j d | | � | St j d | | � | S(
u*
Set the RelayIpList list for the SMTP virtual server.
Due to the unusual way that Windows stores the relay IPs, it is advisable to retrieve
the existing list you wish to set from a pre-configured server.
For example, setting '127.0.0.1' as an allowed relay IP through the GUI would generate
an actual relay IP list similar to the following:
.. code-block:: cfg
['24.0.0.128', '32.0.0.128', '60.0.0.128', '68.0.0.128', '1.0.0.0', '76.0.0.0',
'0.0.0.0', '0.0.0.0', '1.0.0.0', '1.0.0.0', '2.0.0.0', '2.0.0.0', '4.0.0.0',
'0.0.0.0', '76.0.0.128', '0.0.0.0', '0.0.0.0', '0.0.0.0', '0.0.0.0',
'255.255.255.255', '127.0.0.1']
.. note::
Setting the list to None corresponds to the restrictive 'Only the list below' GUI parameter
with an empty access list configured, and setting an empty list/tuple corresponds to the
more permissive 'All except the list below' GUI parameter.
:param str addresses: A list of the relay IPs. The order of the list is important.
:param str server: The SMTP server name.
:return: A boolean representing whether the change succeeded.
:rtype: bool
CLI Example:
.. code-block:: bash
salt '*' win_smtp_server.set_relay_ip_list addresses="['192.168.1.1', '172.16.1.1']"
u RelayIpListu+ %s already contains the provided addresses.i u .u Formatted %s addresses: %su IIsSmtpServerSettingu %s configured successfully: %su% Unable to configure %s with value: %sN(
R: Rh R R+ R$ RE RQ R< R& R ( RT R R R\ R^ R] t octetR` R! ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/win_smtp_server.pyt set_relay_ip_list� s* #
() t __doc__t
__future__R R R t loggingRP t salt.exceptionsR t salt.utils.argsR t salt.utils.platformt salt.extR R t salt.utils.winapiR$ R t ImportErrorR t _DEFAULT_SERVERR t getLoggert __name__R R
R R" R& R1 R9 R= R? RD RI RO RX RE Ra Rh Rj ( ( ( s@ /usr/lib/python2.7/site-packages/salt/modules/win_smtp_server.pyt <module> s>
# $ G -': +
Mini Shell