#!/usr/bin/python # -*- coding: utf-8 -*- # (c) 2019, Simon Dodsley (simon@purestorage.com) # GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt) from __future__ import absolute_import, division, print_function __metaclass__ = type ANSIBLE_METADATA = {'metadata_version': '1.1', 'status': ['preview'], 'supported_by': 'community'} DOCUMENTATION = r''' --- module: purefa_dsrole version_added: '2.8' short_description: Configure FlashArray Directory Service Roles description: - Set or erase directory services role configurations. - Only available for FlashArray running Purity 5.2.0 or higher author: - Simon Dodsley (@sdodsley) options: state: description: - Create or delete directory service role default: present choices: [ absent, present ] role: description: - The directory service role to work on choices: [ array_admin, ops_admin, readonly, storage_admin ] group_base: description: - Specifies where the configured group is located in the directory tree. This field consists of Organizational Units (OUs) that combine with the base DN attribute and the configured group CNs to complete the full Distinguished Name of the groups. The group base should specify OU= for each OU and multiple OUs should be separated by commas. The order of OUs is important and should get larger in scope from left to right. - Each OU should not exceed 64 characters in length. group: description: - Sets the common Name (CN) of the configured directory service group containing users for the FlashBlade. This name should be just the Common Name of the group without the CN= specifier. - Common Names should not exceed 64 characters in length. extends_documentation_fragment: - purestorage.fa ''' EXAMPLES = r''' - name: Delete exisitng array_admin directory service role purefa_dsrole: role: array_admin state: absent fb_url: 10.10.10.2 api_token: e31060a7-21fc-e277-6240-25983c6c4592 - name: Create array_admin directory service role purefa_dsrole: role: array_admin group_base: "OU=PureGroups,OU=SANManagers" group: pureadmins fb_url: 10.10.10.2 api_token: e31060a7-21fc-e277-6240-25983c6c4592 - name: Update ops_admin directory service role purefa_dsrole: role: ops_admin group_base: "OU=PureGroups" group: opsgroup fb_url: 10.10.10.2 api_token: e31060a7-21fc-e277-6240-25983c6c4592 ''' RETURN = r''' ''' from ansible.module_utils.basic import AnsibleModule from ansible.module_utils.pure import get_system, purefa_argument_spec def update_role(module, array): """Update Directory Service Role""" changed = False role = array.list_directory_services_roles(names=[module.params['role']]) if role['group_base'] != module.params['group_base'] or role['group'] != module.params['group']: try: array.set_directory_services_roles(names=[module.params['role']], group_base=module.params['group_base'], group=module.params['group']) changed = True except Exception: module.fail_json(msg='Update Directory Service Role {0} failed'.format(module.params['role'])) module.exit_json(changed=changed) def delete_role(module, array): """Delete Directory Service Role""" changed = False try: array.set_directory_services_roles(names=[module.params['role']], group_base='', group='') changed = True except Exception: module.fail_json(msg='Delete Directory Service Role {0} failed'.format(module.params['role'])) module.exit_json(changed=changed) def create_role(module, array): """Create Directory Service Role""" changed = False try: array.set_directory_services_roles(names=[module.params['role']], group_base=module.params['group_base'], group=module.params['group']) changed = True except Exception: module.fail_json(msg='Create Directory Service Role {0} failed: Check configuration'.format(module.params['role'])) module.exit_json(changed=changed) def main(): argument_spec = purefa_argument_spec() argument_spec.update(dict( role=dict(required=True, type='str', choices=['array_admin', 'ops_admin', 'readonly', 'storage_admin']), state=dict(type='str', default='present', choices=['absent', 'present']), group_base=dict(type='str'), group=dict(type='str'), )) required_together = [['group', 'group_base']] module = AnsibleModule(argument_spec, required_together=required_together, supports_check_mode=False) state = module.params['state'] array = get_system(module) role_configured = False role = array.list_directory_services_roles(names=[module.params['role']]) if role['group'] is not None: role_configured = True if state == 'absent' and role_configured: delete_role(module, array) elif role_configured and state == 'present': update_role(module, array) elif not role_configured and state == 'present': create_role(module, array) else: module.exit_json(changed=False) if __name__ == '__main__': main()