Vh'zddlmZmZmZeZdZdZdZddl m Z ddl m Z m Z GddeZd Zed k(rey y ) )absolute_importdivisionprint_functiona module: manageiq_user short_description: Management of users in ManageIQ extends_documentation_fragment: - community.general.manageiq - community.general.attributes author: Daniel Korn (@dkorn) description: - The manageiq_user module supports adding, updating and deleting users in ManageIQ. attributes: check_mode: support: none diff_mode: support: none options: state: type: str description: - V(absent) - user should not exist, - V(present) - user should be. choices: ['absent', 'present'] default: 'present' userid: type: str description: - The unique userid in manageiq, often mentioned as username. required: true name: type: str description: - The users' full name. password: type: str description: - The users' password. group: type: str description: - The name of the group to which the user belongs. email: type: str description: - The users' E-mail address. update_password: type: str default: always choices: ['always', 'on_create'] description: - V(always) will update passwords unconditionally. - V(on_create) will only set the password for a newly created user. a - name: Create a new user in ManageIQ community.general.manageiq_user: userid: 'jdoe' name: 'Jane Doe' password: 'VerySecret' group: 'EvmGroup-user' email: 'jdoe@example.com' manageiq_connection: url: 'http://127.0.0.1:3000' username: 'admin' password: 'smartvm' validate_certs: false # only do this when you trust the network! - name: Create a new user in ManageIQ using a token community.general.manageiq_user: userid: 'jdoe' name: 'Jane Doe' password: 'VerySecret' group: 'EvmGroup-user' email: 'jdoe@example.com' manageiq_connection: url: 'http://127.0.0.1:3000' token: 'sometoken' validate_certs: false # only do this when you trust the network! - name: Delete a user in ManageIQ community.general.manageiq_user: state: 'absent' userid: 'jdoe' manageiq_connection: url: 'http://127.0.0.1:3000' username: 'admin' password: 'smartvm' validate_certs: false # only do this when you trust the network! - name: Delete a user in ManageIQ using a token community.general.manageiq_user: state: 'absent' userid: 'jdoe' manageiq_connection: url: 'http://127.0.0.1:3000' token: 'sometoken' validate_certs: false # only do this when you trust the network! - name: Update email of user in ManageIQ community.general.manageiq_user: userid: 'jdoe' email: 'jaustine@example.com' manageiq_connection: url: 'http://127.0.0.1:3000' username: 'admin' password: 'smartvm' validate_certs: false # only do this when you trust the network! - name: Update email of user in ManageIQ using a token community.general.manageiq_user: userid: 'jdoe' email: 'jaustine@example.com' manageiq_connection: url: 'http://127.0.0.1:3000' token: 'sometoken' validate_certs: false # only do this when you trust the network!  ) AnsibleModule)ManageIQmanageiq_argument_specc:eZdZdZdZdZdZdZdZdZ dZ y ) ManageIQUserzG Object to execute user management operations in manageiq. c||_|jj|_|jj|_|jj|_y)N)manageiqmoduleapi_urlclient)selfr s s/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/modules/manageiq_user.py__init__zManageIQUser.__init__s<  mm** }},, mm** c|jjd|}|s|jjd|z|dS)z Search for group id by group description. Returns: the group id, or send a module Fail signal if group not found. groups) descriptionz#group %s does not exist in manageiqmsgid)r find_collection_resource_byr fail_json)rrgroups rgroup_idzManageIQUser.group_idsM  99(P[9\ KK ! !9[I " KT{rc<|jjd|S)zn Search for user object by userid. Returns: the user, or None if user not found. usersuserid)r r)rr"s ruserzManageIQUser.users }}888PPrcd|xr|d|k7xs |duxs|xr|d|k7xs |xr|d|k7}| S)z Compare user fields with new field values. Returns: false if user fields have some difference from new fields, true o/w. nameNemailcurrent_group_id)rr#r%rpasswordr&found_differences r compare_userzManageIQUser.compare_userse *d6ld* @ T ! @  -tG}- @ >$12h> $##rc  |jd|d}|jj|d}td d  S#t$r8}|jj d|ddt |Yd }~Ld }~wwxYw) zx Deletes a user from manageiq. Returns: a short message describing the operation executed. /users/rdelete)actionzfailed to delete user r": rNTmessagechangedr)rrpost Exceptionrrstrdict)rr#urlresultes r delete_userzManageIQUser.delete_users  a#'<<dx.&QS S a KK ! !XX[\]X^&_ ! ` ` as$C D!.DDc t|||jD])\}}|dvs |jjd|z+|j |}d|j z} |||d|id} ||| d < |j j| d | } tdd|d  dS#t$r5} |jjd |d t| Yd} ~ Od} ~ wwxYw)z Creates the user in manageiq. Returns: the created user id, name, created_on timestamp, updated_on timestamp, userid and current_group_id. )r%rr))Nzmissing required argument: %srz%s/usersr)r"r%r)rNr&creater@zfailed to create user r0Tzsuccessfully created the user resultsr2) r7itemsrrrrrr4r5r6) rr"r%rr)r&keyvaluerr8rAr9r:s r create_userzManageIQUser.create_users DIOOQ SJC " %%*IS*Q%R S=='DLL)$dTXZbScd   %HW  Y[[%%c(X%NF:@&BSTV V Y KK ! !PSTUPV&W ! X X Ys:B.. C,7+C''C,N) __name__ __module__ __qualname____doc__rrr#r+r;rCrKr(rrr r s.+ Q $ 9'SRVrr c ttddttdtttddgdtdd gd }|jtt| }|jd }|jd }|jd}|jd}|jd}|jd}t |}t |} | j|} |dk(r$| r| j| } ntdd|z} |dk(r-| r| j| ||||} n| j|||||} |jdi y)NTr6)requiredtype)no_logabsentpresent)choicesdefaultalwaysr>)r"r%r)rr&stater=) argument_specr"r%r)rr&rYFz#user %s: does not exist in manageiqr2r() r7updater rrBrr r#r;rCrK exit_json) rZrr"r%r)rr&rYr manageiq_userr#res_argss rmainr_sqT. VT"ffHi0)Dh %<%-/ M/12 #F]]8 $F == D}}Z(H MM' "E MM' "E MM' "EH *M   f %D  $006H9VDFH   $..tT5(ERH%00uhPUVHF x r__main__N) __future__rrrrR __metaclass__ DOCUMENTATIONEXAMPLESRETURNansible.module_utils.basicrCansible_collections.community.general.plugins.module_utils.manageiqrr objectr r_rLr(rrris]CB 5 n? B 5pBV6BVJ2!j zFr