community.general.ipa_sudocmdgroup модуль – Управление группой команд sudo FreeIPA

Примечание

Этот модуль является частью коллекции community.general (версия 9.5.0).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general.

Для использования в playbook, укажите: community.general.ipa_sudocmdgroup.

Краткое описание
Параметры
Атрибуты
Примеры
Возвращаемые значения

Краткое описание

Добавление, изменение или удаление группы команд sudo на сервере IPA с использованием IPA API.

Параметры

Параметр	Комментарии
cn псевдонимы: name строка / обязательно	Группа команд Sudo.
description строка	Описание группы.
ipa_host строка	IP-адрес или имя хоста сервера IPA. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `IPA_HOST`. Если и переменная окружения `IPA_HOST`, и значение не указаны в задаче, то для обнаружения сервера FreeIPA будет использоваться DNS. Необходимая запись в FreeIPA - это запись `ipa-ca`. Если недоступны ни запись DNS, ни переменная окружения `IPA_HOST`, ни значение в задаче, то будет использовано значение по умолчанию. По умолчанию: `"ipa.example.com"`
ipa_pass строка	Пароль административного пользователя. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `IPA_PASS`. Обратите внимание, что если доступна библиотека `urllib_gssapi`, можно использовать GSSAPI для аутентификации в FreeIPA. Если доступна переменная окружения `KRB5CCNAME`, модуль будет использовать этот кеш учетных данных Kerberos для аутентификации на сервере FreeIPA. Если доступна переменная окружения `KRB5_CLIENT_KTNAME`, а `KRB5CCNAME` нет; модуль будет использовать этот ключ Kerberos для аутентификации. Если GSSAPI недоступен, необходимо использование `ipa_pass`.
ipa_port целое число	Порт сервера FreeIPA / IPA. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `IPA_PORT`. Если и переменная окружения `IPA_PORT`, и значение не указаны в задаче, то будет установлено значение по умолчанию. По умолчанию: `443`
ipa_prot строка	Протокол, используемый сервером IPA. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `IPA_PROT`. Если и переменная окружения `IPA_PROT`, и значение не указаны в задаче, то будет установлено значение по умолчанию. Варианты: `"http"` `"https"` ← (по умолчанию)
ipa_timeout целое число	Указывает время ожидания простоя (в секундах) для соединения. Для массовых операций может потребоваться увеличить это значение, чтобы избежать тайм-аута со стороны сервера IPA. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `IPA_TIMEOUT`. Если и переменная окружения `IPA_TIMEOUT`, и значение не указаны в задаче, то будет установлено значение по умолчанию. По умолчанию: `10`
ipa_user строка	Административная учетная запись, используемая на сервере IPA. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `IPA_USER`. Если и переменная окружения `IPA_USER`, и значение не указаны в задаче, то будет установлено значение по умолчанию. По умолчанию: `"admin"`
state строка	Состояние, которое необходимо обеспечить. Варианты: `"absent"` `"disabled"` `"enabled"` `"present"` ← (по умолчанию)
sudocmd список / элементы=строка	Список команд sudo, которые нужно назначить группе. Если передан пустой список, все назначенные команды будут удалены из группы. Если параметр опущен, команды sudo проверяться или изменяться не будут.
validate_certs логическое	Это применимо только если `ipa_prot` равно `https`. Если установлено в `false`, SSL-сертификаты проверяться не будут. Это должно быть установлено только в `false` на лично контролируемых сайтах, использующих самозаверяющие сертификаты. Варианты: `false` `true` ← (по умолчанию)

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в `check_mode` и возвращать прогноз состояния "изменено" без изменения цели.
diff_mode	Поддержка: отсутствует	Возвращает подробную информацию о том, что изменилось (или, возможно, нуждается в изменении в `check_mode`), в режиме diff.

Примеры

- name: Ensure sudo command group exists
  community.general.ipa_sudocmdgroup:
    name: group01
    description: Group of important commands
    sudocmd:
    - su
    ipa_host: ipa.example.com
    ipa_user: admin
    ipa_pass: topsecret

- name: Ensure sudo command group does not exist
  community.general.ipa_sudocmdgroup:
    name: group01
    state: absent
    ipa_host: ipa.example.com
    ipa_user: admin
    ipa_pass: topsecret

Значения возврата

Общие значения возврата документированы здесь, следующие являются полями, уникальными для этого модуля:

Ключ	Описание
sudocmdgroup словарь	Группа команд sudo, как возвращается API IPA Возвращаемое значение: всегда

Авторы

Thomas Krahn (@Nosmoht)

Ссылки на сборку

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/ipa_sudocmdgroup_module.html