ipa_role - Управление ролью FreeIPA
Новое в версии 2.3.
Обзор
- Добавление, изменение и удаление роли на сервере FreeIPA с использованием API FreeIPA
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| cn обязательно | Имя роли. Не может быть изменено, так как является уникальным идентификатором. псевдонимы: имя | |
| description | Описание этой группы ролей. | |
| group | Список имен групп, назначаемых этой роли. Если передан пустой список, все назначенные группы будут отменены для этой роли. Если опция опущена, группы не будут проверяться или изменены. Если опция передана, все назначенные группы, которые не были переданы, будут отменены для роли. | |
| host | Список имен хостов для назначения. Если передан пустой список, все назначенные хосты будут отменены для роли. Если опция опущена, хосты не будут проверяться или изменены. Если опция передана, все назначенные хосты, которые не были переданы, будут отменены для роли. | |
| hostgroup | Список имен групп хостов для назначения. Если передан пустой список, все назначенные группы хостов будут удалены из роли. Если опция опущена, группы хостов не будут проверяться или изменены. Если опция передана, все назначенные группы хостов, которые не были переданы, будут отменены для роли. | |
| ipa_host | Значение по умолчанию: ipa.example.com | IP-адрес или имя хоста сервера IPA. Если значение не указано в задаче, будет использовано значение переменной среды IPA_HOST.Если ни переменная среды IPA_HOST, ни значение не указаны в задаче, то устанавливается значение по умолчанию.Механизм обратной замены переменной среды добавлен в версии 2.5. |
| ipa_pass обязательно | Пароль административного пользователя. Если значение не указано в задаче, будет использовано значение переменной среды IPA_PASS.Если ни переменная среды IPA_PASS, ни значение не указаны в задаче, то устанавливается значение по умолчанию.Механизм обратной замены переменной среды добавлен в версии 2.5. | |
| ipa_port | Значение по умолчанию: 443 | Порт сервера FreeIPA/IPA. Если значение не указано в задаче, будет использовано значение переменной среды IPA_PORT.Если ни переменная среды IPA_PORT, ни значение не указаны в задаче, то устанавливается значение по умолчанию.Механизм обратной замены переменной среды добавлен в версии 2.5. |
| ipa_prot |
| Протокол, используемый сервером IPA. Если значение не указано в задаче, будет использовано значение переменной среды IPA_PROT.Если ни переменная среды IPA_PROT, ни значение не указаны в задаче, то устанавливается значение по умолчанию.Механизм обратной замены переменной среды добавлен в версии 2.5. |
| ipa_user | Значение по умолчанию: admin | Используемый административный учетная запись на сервере IPA. Если значение не указано в задаче, будет использовано значение переменной среды IPA_USER.Если ни переменная среды IPA_USER, ни значение не указаны в задаче, то устанавливается значение по умолчанию.Механизм обратной замены переменной среды добавлен в версии 2.5. |
| privilege (добавлен в 2.4) | Значение по умолчанию: None | Список привилегий, предоставленных роли. Если передан пустой список, все назначенные привилегии будут удалены. Если опция опущена, привилегии не будут проверяться или изменены. Если опция передана, все назначенные привилегии, которые не были переданы, будут удалены. |
| service | Список имен служб для назначения. Если передан пустой список, все назначенные службы будут удалены из роли. Если опция опущена, службы не будут проверяться или изменены. Если опция передана, все назначенные службы, которые не были переданы, будут удалены из роли. | |
| state |
| Состояние для обеспечения |
| user | Список имен пользователей для назначения. Если передан пустой список, все назначенные пользователи будут удалены из роли. Если опция опущена, пользователи не будут проверяться или изменены. | |
| validate_certs | Значение по умолчанию: yes | Это применимо только в том случае, если ipa_prot равно https.Если установлено значение no, сертификаты SSL не будут проверены.Это значение должно быть установлено в no только для сайтов, контролируемых лично, использующих самозаверенные сертификаты. |
Примеры
# Ensure role is present
- ipa_role:
name: dba
description: Database Administrators
state: present
user:
- pinky
- brain
ipa_host: ipa.example.com
ipa_user: admin
ipa_pass: topsecret
# Ensure role with certain details
- ipa_role:
name: another-role
description: Just another role
group:
- editors
host:
- host01.example.com
hostgroup:
- hostgroup01
privilege:
- Group Administrators
- User Administrators
service:
- service01
# Ensure role is absent
- ipa_role:
name: dba
state: absent
ipa_host: ipa.example.com
ipa_user: admin
ipa_pass: topsecret
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| role dict | всегда | Роль, возвращённая API IPA. |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантирует обратной совместимости.
Автор
- Thomas Krahn (@Nosmoht)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/ipa_role_module.html
