Roles and playbooks to deploy FreeIPA servers, replicas and clients
Repositories
AppStream
Description
Ansible roles to install and uninstall FreeIPA servers, replicas and clients,
roles for backups and SmartCard configuration, modules for management and also
playbooks for all roles and modules.
Note: The Ansible playbooks and roles require a configured Ansible environment
where the Ansible nodes are reachable and are properly set up to have an IP
address and a working package manager.
Features
- Server, replica and client deployment
- Cluster deployments: Server, replicas and clients in one playbook
- One-time-password (OTP) support for client installation
- Repair mode for clients
- Backup and restore, also to and from controller
- Smartcard setup for servers and clients
- Modules for automembership rule management
- Modules for automount key management
- Modules for automount location management
- Modules for automount map management
- Modules for certificate management
- Modules for config management
- Modules for delegation management
- Modules for dns config management
- Modules for dns forwarder management
- Modules for dns record management
- Modules for dns zone management
- Modules for group management
- Modules for hbacrule management
- Modules for hbacsvc management
- Modules for hbacsvcgroup management
- Modules for host management
- Modules for hostgroup management
- Modules for idoverridegroup management
- Modules for idoverrideuser management
- Modules for idp management
- Modules for idrange management
- Modules for idview management
- Modules for location management
- Modules for netgroup management
- Modules for permission management
- Modules for privilege management
- Modules for pwpolicy management
- Modules for role management
- Modules for self service management
- Modules for server management
- Modules for service management
- Modules for service delegation rule management
- Modules for service delegation target management
- Modules for sudocmd management
- Modules for sudocmdgroup management
- Modules for sudorule management
- Modules for topology management
- Modules for trust management
- Modules for user management
- Modules for vault management
Supported FreeIPA Versions
FreeIPA versions 4.6 and up are supported by all roles.
The client role supports versions 4.4 and up, the server role is working with
versions 4.5 and up, the replica role is currently only working with versions
4.6 and up.
Supported Distributions
- RHEL/CentOS 7.4+
- Fedora 26+
- Ubuntu
- Debian 10+ (ipaclient only, no server or replica!)
Requirements
Controller
- Ansible version: 2.13+
Node
- Supported FreeIPA version (see above)
- Supported distribution (needed for package installation only, see above)
Limitations
External signed CA is now supported. But the currently needed two step process
is an issue for the processing in a simple playbook.
Work is planned to have a new method to handle CSR for external signed CAs in
a separate step before starting the server installation.
* Fri Mar 29 2024 MSVSphere Packaging Team <packager@msvsphere-os.ru> - 1.12.1-1
- Rebuilt for MSVSphere 8.10 beta
* Mon Feb 12 2024 Thomas Woerner <twoerner@redhat.com> - 1.12.1-1
- Update to version 1.12.1
https://github.com/freeipa/ansible-freeipa/releases/tag/v1.12.1
Resolves: RHEL-13746
- ipauser module lacks the "rename" field.
Resolves: RHEL-4963
- Add missing support for rename in ipagroup module
Resolves: RHEL-13759
- The IDP module does not support the modification of IDP options
Resolves: RHEL-17955
- The IDP module does not support resetting IDP options
Resolves: RHEL-17958
- ipauser is not idempotent when random is defined
Resolves: RHEL-4934
- ipasudorule: Allow setting groups for runasuser
Resolves: RHEL-19129
- Idempotency fixes
Resolves: RHEL-13755
- ipadnszone: Add support for per-zone privilege delegation
Resolves: RHEL-19133
- Handle data type or empty string in module_utils
Resolves: RHEL-19135
- ipa-server installation failing
Resolves: RHEL-23633
* Tue Nov 28 2023 Thomas Woerner <twoerner@redhat.com> - 1.12.0-2
- Fix test_pwpolicy for https://pagure.io/freeipa/issue/9297
Related: RHEL-13746
* Mon Nov 27 2023 Thomas Woerner <twoerner@redhat.com> - 1.12.0-1
- Update to version 1.12.0
https://github.com/freeipa/ansible-freeipa/releases/tag/v1.12.0
Resolves: RHEL-13746
- New idoverridegroup management module.
Resolves: RHEL-16935
- New idoverrideuser management module.
Resolves: RHEL-16941
- New idview management module.
Resolves: RHEL-16933
- New idp management module.
Resolves: RHEL-16938
- idoverride{user,group}: Fix delete_continue with state absent
Resolves: RHEL-16682
* Mon Jul 24 2023 Thomas Woerner <twoerner@redhat.com> - 1.11.1-1
- Update to version 1.11.1
https://github.com/freeipa/ansible-freeipa/releases/tag/v1.11.1
Resolves: RHBZ#2170371
- ipaautomountmap: add support for indirect maps
Resolves: RHBZ#2050158
- ipauser: Add support to modify GECOS field
Resolves: RHBZ#2168022
- ipauser: Add support for parameter "street"
Resolves: RHBZ#2215532
- ipauser: Add support for SMB attributes
Resolves: RHBZ#2215534
- ipauser: Support for External IdP attributes
Resolves: RHBZ#2215539
- Fix handling of ipapwpolicy attributes usercheck and dictcheck
Resolves: RHBZ#2215543
- Update authtypes authind
Resolves: RHBZ#2215540
* Mon Jun 12 2023 Thomas Woerner <twoerner@redhat.com> - 1.11.0-1
- Update to version 1.11.0
https://github.com/freeipa/ansible-freeipa/releases/tag/v1.11.0
Resolves: RHBZ#2170371
- Multiple service management
Resolves: RHBZ#2175769
- New ipacert module
Resolves: RHBZ#2127906
- Fix maxsequence handling in ipapwpolicy module
Resolves: RHBZ#2214295
* Wed Apr 05 2023 Thomas Woerner <twoerner@redhat.com> - 1.10.0-1
- Update to version 1.10.0
https://github.com/freeipa/ansible-freeipa/releases/tag/v1.10.0
Resolves: RHBZ#2170371
- ipareplica/server: Enable removal from domain with undeployment
Resolves: RHBZ#2127901
- ipagroup: Allow multiple group management
Resolves: RHBZ#2175762
- ipaserver: Allow deployments with random serial numbers
Resolves: RHBZ#2127904
- ipagroup: Fix ensuring external group members (without trust-ad)
Resolves: RHBZ#2183820
- ipaclient: Add subid option to select the sssd profile with-subid
Resolves: RHBZ#2175766
- ipaclient: Fix allow_repair with removed krb5.conf and DNS lookup
Resolves: RHBZ#1759785
- ipaclient: Keep server affinity while deploying as long as possible
Resolves: RHBZ#2175755
* Tue Jan 31 2023 Thomas Woerner <twoerner@redhat.com> - 1.9.2-1
- Update to version 1.9.2
https://github.com/freeipa/ansible-freeipa/releases/tag/v1.9.2
Resolves: RHBZ#2125591
- ipabackup: Use ipabackup_item again in copy_backup_to_server
Resolves: RHBZ#2165951
* Mon Jan 30 2023 Thomas Woerner <twoerner@redhat.com> - 1.9.1-1
- Update to version 1.9.1
https://github.com/freeipa/ansible-freeipa/releases/tag/v1.9.1
Resolves: RHBZ#2125591
- pwpolicy: Allow clearing policy values
Resolves: RHBZ#2150332
- Use netgroup_find instead of netgroup_show to workaround IPA bug
Resolves: RHBZ#2144724
* Wed Dec 07 2022 Thomas Woerner <twoerner@redhat.com> - 1.9.0-1
- Update to version 1.9.0
https://github.com/freeipa/ansible-freeipa/releases/tag/v1.9.0
Related: RHBZ#2125591
- pwpolicy: Add support for password check and grace limit
Resolves: RHBZ#2015288
- ipaconfig: Do not allow enable_sid set to False
Resolves: RHBZ#2127447
- ipaclient: No kinit on controller for deployment using OTP
Resolves: RHBZ#2127885
- ipaclient: Configure DNS resolver
Resolves: RHBZ#2127894
- New netgroup management module
Resolves: RHBZ#2127908
- sudorule: Add support for 'hostmask' parameter
Resolves: RHBZ#2127912
- ipaconfig: Fix fail_json calls
Resolves: RHBZ#2128460
- ipaconfig: Do not require enable_sid for add_sids or netbios_name
Resolves: RHBZ#2134530
- ipaserver: Add missing idstart check
Resolves: RHBZ#2132729