Vh=ddlmZmZmZeZdZdZddlZddl Z ddl Z ddl Z ddl m Z ddlmZmZmZmZddlmZddlmZdd lmZdd lmZdd lmZdd lmZdd lm Z dZ!e"dk(re!yy))absolute_importdivisionprint_functiona author: - Dag Wieers (@dagwieers) module: mail short_description: Send an email description: - This module is useful for sending emails from playbooks. - One may wonder why automate sending emails? In complex environments there are from time to time processes that cannot be automated, either because you lack the authority to make it so, or because not everyone agrees to a common approach. - If you cannot automate a specific step, but the step is non-blocking, sending out an email to the responsible party to make them perform their part of the bargain is an elegant way to put the responsibility in someone else's lap. - Of course sending out a mail can be equally useful as a way to notify one or more people in a team that a specific action has been (successfully) taken. extends_documentation_fragment: - community.general.attributes attributes: check_mode: support: none diff_mode: support: none options: sender: description: - The email-address the mail is sent from. May contain address and phrase. type: str default: root aliases: [from] to: description: - The email-address(es) the mail is being sent to. - This is a list, which may contain address and phrase portions. type: list elements: str default: root aliases: [recipients] cc: description: - The email-address(es) the mail is being copied to. - This is a list, which may contain address and phrase portions. type: list elements: str default: [] bcc: description: - The email-address(es) the mail is being 'blind' copied to. - This is a list, which may contain address and phrase portions. type: list elements: str default: [] subject: description: - The subject of the email being sent. required: true type: str aliases: [msg] body: description: - The body of the email being sent. type: str username: description: - If SMTP requires username. type: str password: description: - If SMTP requires password. type: str host: description: - The mail server. type: str default: localhost port: description: - The mail server port. - This must be a valid integer between V(1) and V(65534). type: int default: 25 attach: description: - A list of pathnames of files to attach to the message. - Attached files will have their content-type set to C(application/octet-stream). type: list elements: path default: [] headers: description: - A list of headers which should be added to the message. - Each individual header is specified as V(header=value) (see example below). type: list elements: str default: [] charset: description: - The character set of email being sent. type: str default: utf-8 subtype: description: - The minor mime type, can be either V(plain) or V(html). - The major type is always V(text). type: str choices: [html, plain] default: plain secure: description: - If V(always), the connection will only send email if the connection is Encrypted. If the server does not accept the encrypted connection it will fail. - If V(try), the connection will attempt to setup a secure SSL/TLS session, before trying to send. - If V(never), the connection will not attempt to setup a secure SSL/TLS session, before sending. - If V(starttls), the connection will try to upgrade to a secure SSL/TLS connection, before sending. If it is unable to do so it will fail. type: str choices: [always, never, starttls, try] default: try timeout: description: - Sets the timeout in seconds for connection attempts. type: int default: 20 ehlohost: description: - Allows for manual specification of host for EHLO. type: str version_added: 3.8.0 message_id_domain: description: - The domain name to use for the L(Message-ID header, https://en.wikipedia.org/wiki/Message-ID). - Note that this is only available on Python 3+. On Python 2, this value will be ignored. type: str default: ansible version_added: 8.2.0 a& - name: Example playbook sending mail to root community.general.mail: subject: System {{ ansible_hostname }} has been successfully provisioned. delegate_to: localhost - name: Sending an e-mail using Gmail SMTP servers community.general.mail: host: smtp.gmail.com port: 587 username: username@gmail.com password: mysecret to: John Smith subject: Ansible-report body: System {{ ansible_hostname }} has been successfully provisioned. delegate_to: localhost - name: Send e-mail to a bunch of users, attaching files community.general.mail: host: 127.0.0.1 port: 2025 subject: Ansible-report body: Hello, this is an e-mail. I hope you like it ;-) from: jane@example.net (Jane Jolie) to: - John Doe - Suzie Something cc: Charlie Root attach: - /etc/group - /tmp/avatar2.png headers: - Reply-To=john@example.com - X-Special="Something or other" charset: us-ascii delegate_to: localhost - name: Sending an e-mail using the remote machine, not the Ansible controller node community.general.mail: host: localhost port: 25 to: John Smith subject: Ansible-report body: System {{ ansible_hostname }} has been successfully provisioned. - name: Sending an e-mail using Legacy SSL to the remote machine community.general.mail: host: localhost port: 25 to: John Smith subject: Ansible-report body: System {{ ansible_hostname }} has been successfully provisioned. secure: always - name: Sending an e-mail using StartTLS to the remote machine community.general.mail: host: localhost port: 25 to: John Smith subject: Ansible-report body: System {{ ansible_hostname }} has been successfully provisioned. secure: starttls - name: Sending an e-mail using StartTLS, remote server, custom EHLO, and timeout of 10 seconds community.general.mail: host: some.smtp.host.tld port: 25 timeout: 10 ehlohost: my-resolvable-hostname.tld to: John Smith subject: Ansible-report body: System {{ ansible_hostname }} has been successfully provisioned. secure: starttls N)encoders) parseaddr formataddr formatdate make_msgid)MIMEBase) MIMEMultipart)MIMEText)Header) AnsibleModule)PY3) to_nativec ttdfidtddtdddtdd d td d d tdd dtdddgdtdddgdgdtddgdtddgdtdddgdtddtddgdtddgd tdd! d"tdd#d$d#g%d&tdd'gd(%d)td d* d+tdd, ddgg-}|jjd}|jjd}|jjd}|jjd }|jjd }|jjd}|jjd}|jjd}|jjd} |jjd} |jjd} |jjd} |jjd} |jjd }|jjd"}|jjd&}|jjd)}|jd+}d.}d/}t |\}}| s| } |d0k7rO t rt j||||1}nt j||2}|j||\}}d}|sLt rt j ||||1}nt j ||2}|j||\}} j%t'|d.kDrZ|sX|d;vrTj)d<r% |j+d} |j%n|d=k(r|jd4d>|d6|?|r@|r>j)d@r |j-||n|jd4dD|d6|?|s|r|r|j1dEt3|F}t5||f|dG<t7dH|dI<t9| ||dJ< t;|K|dL<dN|_| D]q}|jAdODcgc]}|jCc}D]?} |jAdPd4\}}tt9||}|jE||AsdR|vr|jEdRdSg} | Dcgc]}|jCc}D]}!| jGt |!d4!g}"|Dcgc]}|jCc}D]B}!|"jGt5t |!| jGt |!d4DdTjI|"|dU<g}#|Dcgc]}|jCc}D]B}!|#jGt5t |!| jGt |!d4DdTjI|#|dV<tK| dWz||X}$|jM|$| D]}% tOdYdZ}$tQ|%d[5}&|$jS|&jUdddtWjX|$|$jEd\d]tZj\j_|%^|jM|$|ja}' jc|te| |'}(jg(r@|(D](})|j1d`|)da|(|)d.db|(|)d4*|jidc|(d|jide|(dy#tj$rH}|d3k(r8|jd4d5|d6|d7t|tj8Yd}~d}~wt$rYwxYw#t j"$rC}|jd4d9|d6|d7t|tj8Yd}~d}~wwxYw#t j"$rC}|jd4d:|d6|d7t|tj8Yd}~9d}~wwxYw#t j"$rC}|jd4d5|d6|d7t|tj8Yd}~Zd}~wwxYw#t j"$rC}|jd4d:|d6|d7t|tj8Yd}~d}~wwxYw#t j.$r|jd4dA|d6|dB?Yyt j"$r|jd4dC|d6|?YwxYw#t<$r"t;|dL<|j1dMYtwxYwcc}w#t$r|j1dQ|zYdwxYwcc}wcc}wcc}w#1swYxYw#t$r@}|jd4d_|%d7t|tj8Yd}~d}~wwxYw#t$rX}|jd4d`dTjIte| dat|tj8Yd}~d}~wwxYw)gNusernamestr)typepasswordT)rno_loghost localhost)rdefaultportintehlohostsenderrootfrom)rraliasestolist recipients)relementsrr"cc)rr&rbccsubjectmsg)rrequiredr"bodyattachpathheaderscharsetzutf-8subtypeplainhtml)rrchoicessecuretry)alwaysneverstarttlsr6timeoutmessage_id_domainansible) argument_specrequired_togetherrFr8)rrlocal_hostnamer:)r@r:r7z(Unable to start an encrypted session to :z: )rcr* exceptionzUnable to Connect zHelo failed for host )r9r6STARTTLSr9z"StartTLS is not offered on server )rCr*AUTHzAuthentication to z3 failed, please check your username and/or passwordz/No Suitable authentication method was found on z#No Authentication on the server at z1Username and Password was sent without encryption)_charsetFrom) localtimeDateSubject)domainz Message-IDzNThe Message-ID domain cannot be set on Python 2; the system's hostname is usedzMultipart message|=z%Skipping header '%s', unable to parsezX-MailerzAnsible mail modulez, ToCcz )_subtyperG applicationz octet-streamrbzContent-disposition attachment)filenamez9Failed to send community.general.mail: can't attach file zFailed to send mail to 'z':  z-Failed to send mail to at least one recipient)r*resultzMail sent successfully)5rdictparamsgetrrsmtplibSMTP_SSLconnectsslSSLError fail_jsonr traceback format_exc ExceptionSMTP SMTPExceptionehlorhas_extnr9loginSMTPAuthenticationErrorwarnr rr rr TypeErrorpreamblesplitstrip add_headerappendjoinr r-r open set_payloadreadr encode_base64osr.basename as_stringsendmailsetquit exit_json)*modulerrrrr@rr%copies blindcopiesr)r, attach_filesr/r0r1r5r:r<code secure_state sender_phrase sender_addrsmtp smtpmessageer*headerxhdrh_keyh_val addr_listaddrto_listcc_listpartrUfpcomposedrWkeys* j/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/modules/mail.pymainrs  u% uT2 5+6 5"-  ud3  UFVHE  %&L>Z %< &5"= edUGD 5! VfbA fubA eW5 eWvw>OP UE;ab! "eR0# $#yA% (' 34+F0}}  ,H}}  ,H ==  V $D ==  V $D]]&&z2N ]]  x (F""4(J ]]  t $F--##E*Kmm *G ==  V $D==$$X.Lmm *Gmm *Gmm *G ]]  x (Fmm *G &9: DL!*6!2M; A W  "++DQ_ipqD"++>SZ$(LLt$<!k# ||Dahi||>7S $ T4 8 D+ D  4y1}*= =}}Z(cMMO#'LPIIKZ'$$\`bf/g$hH ==  r 8X.   UY[_'`  a X( GH  )Cm[9:CKt,CKGW-C Nf&.?@L 'CLK'-||C'89!AGGI9 KC K"yya0 u!&"89ue,  KK z#89I$/0q0-4+,-G$./q/-z)D/234+,- '"CIG$*+q+-z)D/234+,- '"CI D6MGg FDJJt! Y YM>:Dh% ,  + ,  " "4 ( OO1<"''JZJZ[cJdO e JJt  Y}}Hf{C NHE  IIK  fC KKVC[QR^U[\_U`abUcd e fLU[\ 1&A}<< mX%$$04dIaL0JU^UiUiUk%m    AAD$PYZ[P\#]iri}i}i A AA  DAtTS\]^S_#`lumAmAmC D DD,,c$$&*D)A,0@KTK_K_Ka%ccc ,,P$$SWY]_hij_k/lyByMyMyO$PPP22 H  A{BF,G H(( r  Aeiko+p q r f&LL def:  K CcIJ K10 , , ,  Y   & ! (6AJAUAUAW  Y Y Y fA))C N3Yq\$CNWNbNbNd  f ffs6aA_.)Aa8b0.d e"f;h2i j j:Aj,k.a=a>a aaaab-*8b((b-0d8dd e8ee"f858f33f8;-h++hh'iii10i1j j k5kk l=%A l88l=__main__)# __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESrwr\r_rbemailr email.utilsrrr r email.mime.baser email.mime.multipartr email.mime.textr email.headerransible.module_utils.basicransible.module_utils.sixr+ansible.module_utils.common.text.convertersrr__name__rXrrsmA@ D LI V  EE$.$4(A{B| zFr