Vhs" ddlmZmZmZeZdZdZdZddl m Z m Z ddl m Z mZddlmZddlmZmZmZej*d e d  5dd lZdd lZd d d Gd deZdZedk(rey y #1swY%xYw))absolute_importdivisionprint_functiona module: ldap_inc short_description: Use the Modify-Increment LDAP V3 feature to increment an attribute value version_added: 10.2.0 description: - Atomically increments the value of an attribute and return its new value. notes: - When implemented by the directory server, the module uses the ModifyIncrement extension defined in L(RFC4525, https://www.rfc-editor.org/rfc/rfc4525.html) and the control PostRead. This extension and the control are implemented in OpenLdap but not all directory servers implement them. In this case, the module automatically uses a more classic method based on two phases, first the current value is read then the modify operation remove the old value and add the new one in a single request. If the value has changed by a concurrent call then the remove action will fail. Then the sequence is retried 3 times before raising an error to the playbook. In an heavy modification environment, the module does not guarante to be systematically successful. - This only deals with integer attribute of an existing entry. To modify attributes of an entry, see M(community.general.ldap_attrs) or to add or remove whole entries, see M(community.general.ldap_entry). author: - Philippe Duveau (@pduveau) requirements: - python-ldap attributes: check_mode: support: full diff_mode: support: none options: dn: required: true type: str description: - The DN entry containing the attribute to increment. attribute: required: true type: str description: - The attribute to increment. increment: required: false type: int default: 1 description: - The value of the increment to apply. method: required: false type: str default: auto choices: [auto, rfc4525, legacy] description: - If V(auto), the module determines automatically the method to use. - If V(rfc4525) or V(legacy) force to use the corresponding method. extends_documentation_fragment: - community.general.ldap.documentation - community.general.attributes a) - name: Increments uidNumber 1 Number for example.com community.general.ldap_inc: dn: "cn=uidNext,ou=unix-management,dc=example,dc=com" attribute: "uidNumber" increment: "1" register: ldap_uidNumber_sequence - name: Modifies the user to define its identification number (uidNumber) when incrementation is successful community.general.ldap_attrs: dn: "cn=john,ou=posix-users,dc=example,dc=com" state: present attributes: - uidNumber: "{{ ldap_uidNumber_sequence.value }}" when: ldap_uidNumber_sequence.incremented a! incremented: description: - It is set to V(true) if the attribute value has changed. returned: success type: bool sample: true attribute: description: - The name of the attribute that was incremented. returned: success type: str sample: uidNumber value: description: - The new value after incrementing. returned: success type: str sample: "2" rfc4525: description: - Is V(true) if the method used to increment is based on RFC4525, V(false) if legacy. returned: success type: bool sample: true ) AnsibleModulemissing_required_lib) to_nativeto_bytes)deps) LdapGeneric gen_specsldap_required_togetherldapz python-ldap)reasonNc4eZdZdZdZdZdZedZy)LdapIncctj|||jjd|_|jjd|_|jjd|_y)N attribute incrementmethod)r __init__moduleparamsattrrr)selfrs n/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/modules/ldap_inc.pyrzLdapInc.__init__sTT6*KK&&{3 ++K8kk((2 cxtj|jtt |j gfgSN)r MOD_INCREMENTrr strrrs r inc_rfc4525zLdapInc.inc_rfc4525s-##TYY#dnn:M1N0OPQQrctj|jt|gftj|jt|gfgSr)r MOD_DELETErr MOD_ADD)rcurr_valnew_vals r inc_legacyzLdapInc.inc_legacysB$))hx.@-ABtyy8G+<*=>@ @rcntjjj|jggS)N)attrList)rcontrols readentryPostReadControlrr!s rserverControlszLdapInc.serverControlss) ''77$))7MNNrz 1.3.6.1.1.14N) __name__ __module__ __qualname__rr"r(r.r LDAP_MOD_INCREMENTrrrrs&3R@O".1rrc  tttddtdddtddgd   dt }t j |t |}d}d }d} |jdk7r?|js2d}|jdk7r|jdk(}n|jjd tjddg}t|dk(rTttj |dddvr0|j"|dddvs|j"|dddvrd}|rz|jj%|j&|j)|j+d\}}}}t|dk(r|dj,|j.d}nd}d} || kr|dz}|jj|j&tjd|j.z|j.g} t| dk7r|j1dy t3t5| dd|j.d|jz}|jj7|j&|j9| dd|j.d|n|jj|j&tjd|j.z|j.g} t| dk(rGt3t5| dd|j.d|jz}|jdk7}n|j1d|jA|||j.||!y#tj:$r+|| k(r#|j1dt3| zdzYyYnwxYw|| krj#t<$r&} |j1dt?|  Yd} ~ d} ~ wwxYw)"Nr T)typerequiredintF)r5defaultr6auto)r:rfc4525legacy)r5r9choices)rrr) argument_specsupports_check_moderequired_togetherrrfc425*+)basescopeattrlistsupportedControlsupportedFeaturessupportedExtension)dnmodlist serverctrls clientctrlsz(%s=*))rErF filterstrrGzEThe entry does not exist or does not contain the specified attribute.)msg)rKrLz)The increment could not be applied after z tries.zAttribute action failed.)rQdetails)changed incrementedrvaluer;)!rr dictr r validaterr check_moder connection search_ext_sr SCOPE_BASElenr CONTROL_POST_READr2 modify_ext_srKr"r.entryr fail_jsonr r7modify_sr(NO_SUCH_ATTRIBUTE Exceptionr exit_json) rmodrSretr;rootDSEdummy resp_ctrlstries max_triesresultes rmainrns 5q5AUFr{sA@ 4 n $ <KKKzzT\\&!5m!DE#"# 2k2*Wkt zFi##s A::B