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

Новая версия 2.3.

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

Описание

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

Требования

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

base64
hashlib

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
displayname		Имя для отображения
gidnumber (добавлено в 2.5)		Идентификатор группы POSIX
givenname		Имя
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	Варианты: http https ←	Протокол, используемый сервером IPA. Если значение не указано в задаче, используется значение переменной среды `IPA_PROT`. Если переменная среды `IPA_PROT` и значение не указаны в задаче, используется значение по умолчанию. Механизм обратной замены переменной среды добавлен в версии 2.5.
ipa_user	По умолчанию: admin	Используемая учетная запись администратора на сервере IPA. Если значение не указано в задаче, используется значение переменной среды `IPA_USER`. Если переменная среды `IPA_USER` и значение не указаны в задаче, используется значение по умолчанию. Механизм обратной замены переменной среды добавлен в версии 2.5.
krbpasswordexpiration (добавлено в 2.5)		Дата истечения срока действия пароля пользователя В формате ГГГГММДДЧЧММСС Например, 20180121182022 истечет 21 января 2018 г. в 18:20:22
loginshell		Оболочка входа
mail		Список адресов электронной почты, назначенных пользователю. Если передается пустой список, все назначенные адреса электронной почты будут удалены. Если передается None, адреса электронной почты не будут проверяться или изменены.
password		Пароль нового пользователя
sn		Фамилия
sshpubkey		Список открытых ключей SSH. Если передается пустой список, все назначенные открытые ключи будут удалены. Если передается None, открытые ключи SSH не будут проверяться или изменены.
state	Варианты: present ← absent enabled disabled	Состояние для обеспечения
telephonenumber		Список телефонных номеров, назначенных пользователю. Если передается пустой список, все назначенные телефонные номера будут удалены. Если передается None, телефонные номера не будут проверяться или изменены.
title		Должность
uid обязательно		Идентификатор пользователя (UID) Псевдонимы: имя
uidnumber (добавлено в 2.5)		Номер UID/идентификатора пользователя POSIX
validate_certs	По умолчанию: yes	Это относится только если `ipa_prot` равно https. Если установлено `no`, сертификаты SSL не будут проверены. Это должно быть установлено в `no` только на контролируемых пользователем сайтах, использующих самозаверенные сертификаты.

Примеры

# Ensure pinky is present
- 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

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

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

Ключ	Возвращаемое значение	Описание
user 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_user_module.html