freeipa.ansible_freeipa.ipaselfservice (1.11.1) — module

Manage FreeIPA selfservices

Authors: Thomas Woerner (@t-woerner)

preview | supported by community

Install collection

Install with ansible-galaxy collection install freeipa.ansible_freeipa:==1.11.1


Add to requirements.yml

  collections:
    - name: freeipa.ansible_freeipa
      version: 1.11.1

Description

Manage FreeIPA selfservices and selfservice attributes

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# Ensure selfservice "Users can manage their own name details" is present
- freeipa.ansible_freeipa.ipaselfservice:
    ipaadmin_password: SomeADMINpassword
    name: "Users can manage their own name details"
    permission: read
    attribute:
    - title
    - initials
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# Ensure selfservice "Users can manage their own name details" member
# attribute departmentnumber is present
- freeipa.ansible_freeipa.ipaselfservice:
    ipaadmin_password: SomeADMINpassword
    name: "Users can manage their own name details"
    attribute:
    - initials
    action: member
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# Ensure selfservice "Users can manage their own name details" member
# attributes employeetype and employeenumber are present
- freeipa.ansible_freeipa.ipaselfservice:
    ipaadmin_password: SomeADMINpassword
    name: "Users can manage their own name details"
    attribute:
    - title
    - initials
    action: member
    state: absent
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# Ensure selfservice "Users can manage their own name details" is absent
- freeipa.ansible_freeipa.ipaselfservice:
    ipaadmin_password: SomeADMINpassword
    name: "Users can manage their own name details"
    state: absent

Inputs

    
name:
    aliases:
    - aciname
    description: The list of selfservice name strings.
    elements: str
    required: true
    type: list

state:
    choices:
    - present
    - absent
    default: present
    description: The state to ensure.
    required: false
    type: str

action:
    choices:
    - selfservice
    - member
    default: selfservice
    description: Work on selfservice or member level.
    required: false
    type: str

attribute:
    aliases:
    - attrs
    description: Attribute list to which the selfservice applies
    elements: str
    required: false
    type: list

permission:
    aliases:
    - permissions
    description: Permissions to grant (read, write). Default is write.
    elements: str
    required: false
    type: list

ipaapi_context:
    choices:
    - server
    - client
    description: 'The context in which the module will execute. Executing in a

      server context is preferred. If not provided context will be

      determined by the execution environment.

      '
    required: false
    type: str

ipaadmin_password:
    description: The admin password.
    required: false
    type: str

ipaapi_ldap_cache:
    default: true
    description: Use LDAP cache for IPA connection.
    type: bool

ipaadmin_principal:
    default: admin
    description: The admin principal.
    type: str