ipa_user – Управление пользователями FreeIPA

Описание
Требования
Параметры
Примеры
Возвращаемые значения
Статус

Описание

Добавление, изменение и удаление пользователей на сервере IPA

Требования

Ниже перечислены требования, которые должны быть выполнены на хосте, на котором выполняется этот модуль.

base64
hashlib

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
displayname -		Имя для отображения
gidnumber - добавлено в 2.5		Идентификатор группы Posix
givenname -		Имя
ipa_host строка	По умолчанию: "ipa.example.com"	IP-адрес или имя хоста сервера IPA. Если значение не указано в задаче, используется значение переменной окружения `IPA_HOST`. Если ни переменная окружения `IPA_HOST`, ни значение не указаны в задаче, то будет использоваться DNS для поиска сервера FreeIPA. В FreeIPA необходима запись 'ipa-ca'. Если ни запись в DNS, ни переменная окружения `IPA_HOST`, ни значение не указаны в задаче, используется значение по умолчанию. Функция обратной замены переменной окружения добавлена в Ansible 2.5.
ipa_pass строка / требуется		Пароль административного пользователя. Если значение не указано в задаче, используется значение переменной окружения `IPA_PASS`. Если доступна библиотека 'urllib_gssapi', можно использовать GSSAPI для аутентификации в FreeIPA. Если доступна переменная окружения `KRB5CCNAME`, модуль будет использовать кэш аутентификации Kerberos для аутентификации на сервере FreeIPA. Если доступна переменная окружения `KRB5_CLIENT_KTNAME`, и `KRB5CCNAME` недоступна, модуль будет использовать этот ключ Kerberos для аутентификации. Если GSSAPI недоступен, использование 'ipa_pass' обязательно. Функция обратной замены переменной окружения добавлена в Ansible 2.5.
ipa_port целое число	По умолчанию: 443	Порт сервера FreeIPA/IPA. Если значение не указано в задаче, используется значение переменной окружения `IPA_PORT`. Если ни переменная окружения `IPA_PORT`, ни значение не указаны в задаче, то устанавливается значение по умолчанию. Функция обратной замены переменной окружения добавлена в Ansible 2.5.
ipa_prot строка	Варианты: http https ←	Протокол, используемый сервером IPA. Если значение не указано в задаче, используется значение переменной окружения `IPA_PROT`. Если ни переменная окружения `IPA_PROT`, ни значение не указаны в задаче, устанавливается значение по умолчанию. Функция обратной замены переменной окружения добавлена в Ansible 2.5.
ipa_timeout целое число добавлено в 2.7	По умолчанию: 10	Устанавливает таймаут бездействия (в секундах) для подключения. Для массовых операций может потребоваться увеличить это значение, чтобы избежать таймаута от сервера IPA. Если значение не указано в задаче, используется значение переменной окружения `IPA_TIMEOUT`. Если ни переменная окружения `IPA_TIMEOUT`, ни значение не указаны в задаче, устанавливается значение по умолчанию.
ipa_user строка	По умолчанию: "admin"	Используемая административная учетная запись на сервере IPA. Если значение не указано в задаче, используется значение переменной окружения `IPA_USER`. Если ни переменная окружения `IPA_USER`, ни значение не указаны в задаче, устанавливается значение по умолчанию. Функция обратной замены переменной окружения добавлена в Ansible 2.5.
krbpasswordexpiration - добавлено в 2.5		Дата истечения срока действия пароля пользователя В формате YYYYMMddHHmmss Например, 20180121182022 истечёт 21 января 2018 года в 18:20:22
loginshell -		Логин оболочка
mail -		Список адресов электронной почты, назначенных пользователю. Если передан пустой список, все назначенные адреса электронной почты будут удалены. Если передано None, адреса электронной почты не будут проверены или изменены.
password -		Пароль пользователя. Не будет установлен для существующего пользователя, если `update_password` не установлено в значение `always`, что является значением по умолчанию.
sn -		Фамилия
sshpubkey -		Список открытых ключей SSH. Если передан пустой список, все назначенные открытые ключи будут удалены. Если передано None, открытые ключи SSH не будут проверены или изменены.
state -	Варианты: present ← absent enabled disabled	Требуемое состояние
telephonenumber -		Список телефонных номеров, назначенных пользователю. Если передан пустой список, все назначенные телефонные номера будут удалены. Если передано None, телефонные номера не будут проверены или изменены.
title -		Должность
uid - / требуется		uid пользователя псевдонимы: name
uidnumber - добавлено в 2.5		Номер идентификатора пользователя UID/Posix
update_password строка добавлено в 2.8	Варианты: always ← on_create	Установить пароль для пользователя.
validate_certs булево	Варианты: no yes ←	Это применимо только если `ipa_prot` равно https. Если установлено значение `no`, сертификаты SSL не будут проверены. Это следует установить в значение `no` только на сайтах, управляемых лично, использующих самозаверенные сертификаты.

Примеры

# Ensure pinky is present and always reset password
- ipa_user:
    name: pinky
    state: present
    krbpasswordexpiration: 20200119235959
    givenname: Pinky
    sn: Acme
    mail:
    - pinky@acme.com
    telephonenumber:
    - '+555123456'
    sshpubkey:
    - ssh-rsa ....
    - ssh-dsa ....
    uidnumber: 1001
    gidnumber: 100
    ipa_host: ipa.example.com
    ipa_user: admin
    ipa_pass: topsecret

# Ensure brain is absent
- ipa_user:
    name: brain
    state: absent
    ipa_host: ipa.example.com
    ipa_user: admin
    ipa_pass: topsecret

# Ensure pinky is present but don't reset password if already exists
- ipa_user:
    name: pinky
    state: present
    givenname: Pinky
    sn: Acme
    password: zounds
    ipa_host: ipa.example.com
    ipa_user: admin
    ipa_pass: topsecret
    update_password: on_create

Возвращаемые значения

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

Ключ	Возвращается	Описание
user словарь	всегда	Пользователь, возвращённый API IPA

Статус

Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

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.9/modules/ipa_user_module.html