Vh^ddlmZmZmZeZdZdZddlZddl Z ddl Z ddl Z ddl m Z mZddlmZddlmZddlmZdd lmZGd d eZd Zed k(reyy))absolute_importdivisionprint_functiona module: dnsmadeeasy short_description: Interface with dnsmadeeasy.com (a DNS hosting service) description: - 'Manages DNS records using the v2 REST API of the DNS Made Easy service. It handles records only; there is no manipulation of domains or monitor/account support yet. See: U(https://www.dnsmadeeasy.com/integration/restapi/).' extends_documentation_fragment: - community.general.attributes attributes: check_mode: support: none diff_mode: support: none options: account_key: description: - Account API Key. required: true type: str account_secret: description: - Account Secret Key. required: true type: str domain: description: - Domain to work with. Can be the domain name (for example V(mydomain.com)) or the numeric ID of the domain in DNS Made Easy (for example V(839989)) for faster resolution. required: true type: str sandbox: description: - Decides if the sandbox API should be used. Otherwise (default) the production API of DNS Made Easy is used. type: bool default: false record_name: description: - Record name to get/create/delete/update. If record_name is not specified; all records for the domain will be returned in "result" regardless of the state argument. type: str record_type: description: - Record type. choices: ['A', 'AAAA', 'CNAME', 'ANAME', 'HTTPRED', 'MX', 'NS', 'PTR', 'SRV', 'TXT'] type: str record_value: description: - 'Record value. HTTPRED: , MX: , NS: , PTR: , SRV: , TXT: ".' - If record_value is not specified; no changes will be made and the record will be returned in 'result' (in other words, this module can be used to fetch a record's current ID, type, and ttl). type: str record_ttl: description: - Record's "Time-To-Live". Number of seconds the record remains cached in DNS servers. default: 1800 type: int state: description: - Whether the record should exist or not. required: true choices: ['present', 'absent'] type: str validate_certs: description: - If V(false), SSL certificates will not be validated. This should only be used on personally controlled sites using self-signed certificates. type: bool default: true monitor: description: - If V(true), add or change the monitor. This is applicable only for A records. type: bool default: false systemDescription: description: - Description used by the monitor. default: '' type: str maxEmails: description: - Number of emails sent to the contact list by the monitor. default: 1 type: int protocol: description: - Protocol used by the monitor. default: 'HTTP' choices: ['TCP', 'UDP', 'HTTP', 'DNS', 'SMTP', 'HTTPS'] type: str port: description: - Port used by the monitor. default: 80 type: int sensitivity: description: - Number of checks the monitor performs before a failover occurs where Low = 8, Medium = 5,and High = 3. default: 'Medium' choices: ['Low', 'Medium', 'High'] type: str contactList: description: - Name or ID of the contact list that the monitor will notify. - The default V('') means the Account Owner. type: str httpFqdn: description: - The fully qualified domain name used by the monitor. type: str httpFile: description: - The file at the Fqdn that the monitor queries for HTTP or HTTPS. type: str httpQueryString: description: - The string in the httpFile that the monitor queries for HTTP or HTTPS. type: str failover: description: - If V(true), add or change the failover. This is applicable only for A records. type: bool default: false autoFailover: description: - If true, fallback to the primary IP address is manual after a failover. - If false, fallback to the primary IP address is automatic after a failover. type: bool default: false ip1: description: - Primary IP address for the failover. - Required if adding or changing the monitor or failover. type: str ip2: description: - Secondary IP address for the failover. - Required if adding or changing the failover. type: str ip3: description: - Tertiary IP address for the failover. type: str ip4: description: - Quaternary IP address for the failover. type: str ip5: description: - Quinary IP address for the failover. type: str notes: - The DNS Made Easy service requires that machines interacting with the API have the proper time and timezone set. Be sure you are within a few seconds of actual time by using NTP. - This module returns record(s) and monitor(s) in the RV(ignore:result) element when O(state=present). These values can be be registered and used in your playbooks. - Only A records can have a O(monitor) or O(failover). - To add failover, the O(failover), O(autoFailover), O(port), O(protocol), O(ip1), and O(ip2) options are required. - To add monitor, the O(monitor), O(port), O(protocol), O(maxEmails), O(systemDescription), and O(ip1) options are required. - The monitor and the failover will share O(port), O(protocol), and O(ip1) options. requirements: [hashlib, hmac] author: "Brice Burgess (@briceburg)" a5 - name: Fetch my.com domain records community.general.dnsmadeeasy: account_key: key account_secret: secret domain: my.com state: present register: response - name: Create a record community.general.dnsmadeeasy: account_key: key account_secret: secret domain: my.com state: present record_name: test record_type: A record_value: 127.0.0.1 - name: Update the previously created record community.general.dnsmadeeasy: account_key: key account_secret: secret domain: my.com state: present record_name: test record_value: 192.0.2.23 - name: Fetch a specific record community.general.dnsmadeeasy: account_key: key account_secret: secret domain: my.com state: present record_name: test register: response - name: Delete a record community.general.dnsmadeeasy: account_key: key account_secret: secret domain: my.com record_type: A state: absent record_name: test - name: Add a failover community.general.dnsmadeeasy: account_key: key account_secret: secret domain: my.com state: present record_name: test record_type: A record_value: 127.0.0.1 failover: true ip1: 127.0.0.2 ip2: 127.0.0.3 - name: Add a failover community.general.dnsmadeeasy: account_key: key account_secret: secret domain: my.com state: present record_name: test record_type: A record_value: 127.0.0.1 failover: true ip1: 127.0.0.2 ip2: 127.0.0.3 ip3: 127.0.0.4 ip4: 127.0.0.5 ip5: 127.0.0.6 - name: Add a monitor community.general.dnsmadeeasy: account_key: key account_secret: secret domain: my.com state: present record_name: test record_type: A record_value: 127.0.0.1 monitor: true ip1: 127.0.0.2 protocol: HTTP # default port: 80 # default maxEmails: 1 systemDescription: Monitor Test A record contactList: my contact list - name: Add a monitor with http options community.general.dnsmadeeasy: account_key: key account_secret: secret domain: my.com state: present record_name: test record_type: A record_value: 127.0.0.1 monitor: true ip1: 127.0.0.2 protocol: HTTP # default port: 80 # default maxEmails: 1 systemDescription: Monitor Test A record contactList: 1174 # contact list id httpFqdn: http://my.com httpFile: example httpQueryString: some string - name: Add a monitor and a failover community.general.dnsmadeeasy: account_key: key account_secret: secret domain: my.com state: present record_name: test record_type: A record_value: 127.0.0.1 failover: true ip1: 127.0.0.2 ip2: 127.0.0.3 monitor: true protocol: HTTPS port: 443 maxEmails: 1 systemDescription: monitoring my.com status contactList: emergencycontacts - name: Remove a failover community.general.dnsmadeeasy: account_key: key account_secret: secret domain: my.com state: present record_name: test record_type: A record_value: 127.0.0.1 failover: false - name: Remove a monitor community.general.dnsmadeeasy: account_key: key account_secret: secret domain: my.com state: present record_name: test record_type: A record_value: 127.0.0.1 monitor: false N)strftimegmtime) AnsibleModule) fetch_url) urlencode) string_typesceZdZdZdZdZdZddZdZdZ d Z d Z d Z d Z d ZdZdZdZdZdZdZdZdZdZdZy)DME2c||_||_||_|r1d|_|jj d|jznd|_t ||_d|_d|_d|_ d|_ d|_ |j js#|j|j d|_dt |j zdz|_d|_d |_y) Nz)https://api.sandbox.dnsmadeeasy.com/V2.0/z;Sandbox is enabled. All actions are made against the URL %s)warningz!https://api.dnsmadeeasy.com/V2.0/idz dns/managed/z/recordsmonitor contactList)moduleapisecretbaseurlwarnstrdomain domain_map record_maprecords all_recordscontactList_mapisdigitgetDomainByName record_url monitor_urlcontactList_url)selfapikeyrrsandboxrs q/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/modules/dnsmadeeasy.py__init__z DME2.__init__ws  FDL KK  %beieqeq%q  r>DL&k  #{{""$..t{{;DADK(3t{{+;;jH$,cj|j}|j|}|j||dd}|S)Nzapplication/json)zx-dnsme-apiKeyz x-dnsme-hmaczx-dnsme-requestDatez content-type) _get_date _create_hashr)r$currTime hashstringheaderss r'_headersz DME2._headerss<>>#&&x0 %)XX#-*2#57r)crtjtjdtdt S)NCz%a, %d %b %Y %H:%M:%S GMT)locale setlocaleLC_TIMErrr$s r'r+zDME2._get_dates&-3VX>>r)ctj|jj|jtj j SN)hmacnewrencodehashlibsha1 hexdigest)r$rightnows r'r,zDME2._create_hashs6xx **,hoo.?NXXZZr)Nc`|j|z}|rt|ts t|}t |j ||||j \}}|ddvr*|j j|d|dd|d tj|S#t$ricYSwxYw)N)datamethodr/status)z returned z , with body: msgrG) r isinstancer r r rr0 fail_jsonjsonload Exception)r$resourcerBrAurlresponseinfos r'queryz DME2.querysllX%  46T?D"4;;$vW[WdWdWfg$ > 0 KK ! !dS[n^bch^i&j ! k 99X& & I s B B-,B-ct|js|jd|jj|dS)NrF)r_instMapdomainsget)r$ domain_ids r' getDomainzDME2.getDomain, MM( #|| 511r)c|js|jd|j|jj|dS)Nrr)rrTrXrV)r$ domain_names r'r zDME2.getDomainByNames5 MM( #~~doo11+qABBr)c,|jdddS)Nz dns/managedGETrA)rRr6s r' getDomainszDME2.getDomainsszz-/77r)ct|js|jd|jj|dS)NrecordF)rrTrrVr$ record_ids r' getRecordzDME2.getRecordrYr)c|js|j|_|dvr'|jD]}|d|k(s |d|k(s|cSy|dvr}|jD]m}|dk(r|jdd}n3|d k(rd j|}n|d k(r|jdd }n|}|d|k(sY|d|k(sb|d |k(sk|cSyt d)N)CNAMEANAMEHTTPREDPTRnametypeF)AAAAAMXNSTXTSRVrm roz"{0}"rpvaluezrecord_type not yet supported)r getRecordssplitformatrM)r$ record_name record_type record_valueresultrts r'getMatchingRecordzDME2.getMatchingRecords#0D  > >** "&>[0VF^{5R!M " C C** "$&(..s3A6E E)#NN<8E E)(..s3A6E(E&>[0VF^{5RW]^eWfjoWo!M ";< ?A +F"(,Cv $*GF4L ! + dVmS)dSj'*r)c0tj|dSN),:) separatorsrKdumpsr$rAs r' prepareRecordzDME2.prepareRecordzz$:66r)c<|j|jd|S)NPOSTrrs r' createRecordzDME2.createRecordszz$//6488r)cZ|j|jdzt|zd|SN/PUTrRr!rr$rbrAs r' updateRecordzDME2.updateRecords'zz$//C/#i.@%NNr)cX|j|jdzt|zdS)NrDELETErras r' deleteRecordzDME2.deleteRecords%zz$//C/#i.@(KKr)cX|j|jdzt|zdS)Nrr]rRr"rras r' getMonitorzDME2.getMonitors'zz$**S03y>A5IIr)cZ|j|jdzt|zd|Srrrs r' updateMonitorzDME2.updateMonitor s)zz$**S03y>A5$OOr)c0tj|dSrrrs r'prepareMonitorzDME2.prepareMonitor rr)ct|js|jd|jj|dS)NrF)rrT contactListsrV)r$contact_list_ids r'getContactListzDME2.getContactLists0## MM- (  $$_e<>r)c|js|jd|j|jj|dS)Nrr)rrTrrV)r$ris r'getContactListByNamezDME2.getContactListByNames;## MM- (""4#7#7#;#;D!#DEEr)r8)__name__ __module__ __qualname__r(r0r+r,rRrXr r^rcr|rurTrrrrrrrrrrr)r'r r usw-6?[ 2 C 82=6: +79OLJP7= ?Fr)r c  ttdYidtdddtdddtddtdd d tdd d gdtddtdgddtddtddddtdd dtddtdd dtdgd d!td"d d#td$gd% d&tdd'tdd(tdd)tdd*tdd d+tdd d,tdd-tdd.tdd/tdd0tdd1tdd gd2gd*dgd3gddgd4gg5}tdd6d7d8d9d:}td;d9d7%}t|jd|jd|jd|jd|}|jd }|jd}|jd}|jd}|7|j }|s|j d<=|j d|>|j|||} d?|i} d@D]0} |j| |j| | | tdAd<2| dBdCk(r4| dDjdEdF| dG<| dDjdEd| dD<| dBdHk(rh| dDjdEdF| dI<| dDjdEd| dJ<| dDjdEd6| d!<| dDjdEd7| dD<t} t} | r-| dBdKk(r%| jdr|j| dL} dMD]} |j| | dk(r||j| | dN<.| d#k(r||j| | | <I| d&k(rp|j| }|jsK|dk7rF|j|}|s!|j dOj|=|jdLd}|| dP<|j| | | <d}| rG| D]1} t| | j!dQt| | k7s0d}3t| dL| dL<d}| r3| D].} t| j| t| | k7s-d}0|d k(rtdD| vrF| s&|j dR|dS|jddT=|j dt| | U>| s|j#|j%| }| jdrH|dKk(rC|j'|dL|j)| }|j dt||U>n|j dt|| U>d}|r&|j+| dL|j%| d}|r&|j'| dV|j)| d}|r|j dt| | U>|j dt| | U>y|d k(r=d}| r&|j-| dL|j dW|j |Wy|j dX|z=y)ZN account_keyT)requiredno_logaccount_secretr)rr&Fbool)defaultrjstatepresentabsent)rchoicesrxry) rkrlrerfrgrmrnrhrprorz record_ttliint)rrrjrsystemDescription)r maxEmailsrrprotocolHTTP)TCPUDPrDNSSMTPHTTPS)rrportP sensitivityMedium)LowrHighrhttpFqdnhttpFilehttpQueryStringfailover autoFailoverip1ip2ip3ip4ip5validate_certs)rzrry)rrrrr)rrrrr) argument_specrequired_together required_ifrszYThe requested domain name is not accessible with this api_key; try using its ID if known.rH)changedr{ri)rzryrrecord_rjrmrtrqrmxLevelrppriorityweightrkr)rrrrrrrrrrrrrrrrr protocolIdzContact list {0} does not exist contactListId"zA record with name 'z' does not exist for domain 'z.')r`rrecordId)rz/'%s' is an unknown value for the state argumentr)rdictr paramsrurJ exit_jsonr|lenrvrVrrrrwrstriprrrrrr)r protocols sensitivitiesDMErrxryrzdomain_recordscurrent_record new_recordicurrent_monitor new_monitorr contact_listrecord_changedmonitor_changedr`rupdatedrs r'mainr#s  d48 d; & V4  y(.CD  e,  e6hi u- UDuE V4 #2. 151 &2`a bu- X7PQ! "T*# $5)% &5)' (!%0) *%f5+ ,e&9- .e$/ 0e$1 2e$3 4e$5 6e$7 8 6:9 > : Q R [ \ E&FPqqBIQqq1M v}}]+V]].!"(--"96==;SU[ ]C MM' "E-- .K-- .K==0L)   o  q~>**; \RN+&J :>}}Q'-3]]1-=JqY) *>&T! *7 3 9 9# >q A 9(177 6(177M2 ==  'J,5fmmA6F,G L)m#!.v}}Q/?!@ Am#"(--"2&..0_5J#&#;#;O#LL'((-N-U-UVe-f(g&2&6&6tR&@O/> O,"(q!1 A+20N &A>!$%++C0C 1 4FF!%  & ~d34 4O 'A?&&q)*c+a..AA"& '   * $!  U`bhbobopxbyz!|   U4~Wf3g  h%%c&7&7 &CDFy)kS.@++F4L#:L:L[:YZ  d&RY6Z [  d&Ra6b c    ^D133D3DZ3P QG    oj93;M;Mk;Z [G    T$jR]2^  _ t>Sb/cd (     ^D1 2   T  * ) AEI  Kr)__main__) __future__rrrrj __metaclass__ DOCUMENTATIONEXAMPLESrKr<r9r3timerransible.module_utils.basicransible.module_utils.urlsr +ansible.module_utils.six.moves.urllib.parser ansible.module_utils.sixr objectr rrrr)r'r soA@ } ~X |  !4/A1gF6gF\hKV zFr)