Spec-Zone.ru › Ansible

Модуль community.general.udm_user — управление пользователями POSIX на сервере Univention Corporate Server

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: community.general.udm_user.

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

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

  • Этот модуль позволяет управлять пользователями POSIX на сервере Univention Corporate Server (UCS). Он использует API Python для UCS, чтобы создавать новые объекты или изменять их.

Требования

На узле, выполняющем этот модуль, необходимы следующие компоненты.

  • passlib (библиотека Python, рекомендуется) или legacycrypt в Python 3.13 и более поздних версиях
  • В Python 3.12 и более ранних версиях зависимости не требуются, но в этом случае используется устаревший модуль стандартной библиотеки crypt.

Параметры

Параметр

Комментарии

birthday

string

Дата рождения.

city

string

Город в рабочем адресе пользователя.

country

string

Страна в рабочем адресе пользователя.

department_number

псевдонимы: departmentNumber

string

Номер отдела в рабочем адресе пользователя.

description

string

Описание (не GECOS).

display_name

псевдонимы: displayName

string

Отображаемое имя (не GECOS).

email

list / элементы=string

Список адресов электронной почты.

По умолчанию: [""]

employee_number

псевдонимы: employeeNumber

string

Табельный номер сотрудника.

employee_type

псевдонимы: employeeType

string

Тип сотрудника.

firstname

string

Имя. Обязательно, если state=present.

gecos

string

GECOS.

groups

list / элементы=string

Группы POSIX; LDAP DN групп определяются с помощью LDAP-фильтра для каждой группы в формате $GROUP: (&(objectClass=posixGroup)(cn=$GROUP)).

По умолчанию: []

home_share

псевдонимы: homeShare

string

Общий ресурс NFS для домашнего каталога. Должен быть LDAP DN, например cn=home,cn=shares,ou=school,dc=example,dc=com.

home_share_path

псевдонимы: homeSharePath

string

Путь к общему ресурсу NFS для домашнего каталога, внутри homeShare.

home_telephone_number

псевдонимы: homeTelephoneNumber

list / элементы=string

Список личных телефонных номеров.

По умолчанию: []

homedrive

string

Домашний диск Windows, например "H:".

lastname

string

Фамилия. Обязательно, если state=present.

mail_alternative_address

псевдонимы: mailAlternativeAddress

list / элементы=string

Список дополнительных адресов электронной почты.

По умолчанию: []

mail_home_server

псевдонимы: mailHomeServer

string

Полное доменное имя почтового сервера.

mail_primary_address

псевдонимы: mailPrimaryAddress

string

Основной адрес электронной почты.

mobile_telephone_number

псевдонимы: mobileTelephoneNumber

list / элементы=string

Номер мобильного телефона.

По умолчанию: []

organisation

псевдонимы: organization

string

Организация.

ou

string

Подразделение в базовом DN LDAP, например school для LDAP OU ou=school,dc=example,dc=com.

По умолчанию: ""

overridePWHistory

псевдонимы: override_pw_history

boolean

Игнорировать историю паролей.

Варианты:

  • false ← (по умолчанию)
  • true

overridePWLength

псевдонимы: override_pw_length

boolean

Игнорировать проверку пароля.

Варианты:

  • false ← (по умолчанию)
  • true

pager_telephonenumber

псевдонимы: pagerTelephonenumber

list / элементы=string

Список телефонных номеров пейджера.

По умолчанию: []

password

string

Пароль. Обязателен, если state=present.

phone

list / элементы=string

Список телефонных номеров.

По умолчанию: []

position

string

Задает полное положение объекта пользователя в дереве LDAP, например cn=employee,cn=users,ou=school,dc=example,dc=com.

По умолчанию: ""

postcode

string

Почтовый индекс в рабочем адресе пользователя.

primary_group

псевдонимы: primaryGroup

string

Основная группа. Значение должно быть LDAP DN группы.

Если параметр не указан, используется значение cn=Domain Users,cn=groups,$LDAP_BASE_DN.

profilepath

string

Каталог профиля Windows.

pwd_change_next_login

псевдонимы: pwdChangeNextLogin

string

Сменить пароль при следующем входе в систему.

Варианты:

  • "0"
  • "1"

room_number

псевдонимы: roomNumber

string

Номер кабинета в рабочем адресе пользователя.

samba_privileges

псевдонимы: sambaPrivileges

list / элементы=string

Привилегии Samba, например разрешение на администрирование принтеров или присоединение к домену.

По умолчанию: []

samba_user_workstations

псевдонимы: sambaUserWorkstations

list / элементы=string

Разрешить аутентификацию только на этом узле Microsoft Windows.

По умолчанию: []

sambahome

string

Путь к домашнему каталогу Windows, например '\\$FQDN\$USERNAME'.

scriptpath

string

Сценарий входа в Windows.

secretary

list / элементы=string

Список руководителей, заданных в виде LDAP DN.

По умолчанию: []

serviceprovider

list / элементы=string

Включить пользователя для следующих поставщиков услуг.

По умолчанию: [""]

shell

string

Оболочка для входа в систему.

По умолчанию: "/bin/bash"

state

string

Должен ли пользователь существовать.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

street

string

Улица в рабочем адресе пользователя.

subpath

string

Подпуть LDAP внутри подразделения, например cn=teachers,cn=users для контейнера LDAP cn=teachers,cn=users,dc=example,dc=com.

По умолчанию: "cn=users"

title

string

Звание, например Prof..

unixhome

string

Домашний каталог Unix.

Если параметр не указан, используется значение /home/$USERNAME.

update_password

string

always обновляет пароли, если они отличаются.

on_create устанавливает пароль только для новых пользователей.

Варианты:

  • "always" ← (по умолчанию)
  • "on_create"

userexpiry

string

Дата истечения срока действия учетной записи, например 1999-12-31.

Если параметр не указан, используется текущая дата плюс один год.

username

псевдонимы: name

string / обязательный

Имя пользователя.

Атрибуты

Атрибут

Поддержка

Описание

check_mode

Поддержка: полная

Модуль может работать в режиме check_mode и возвращать прогноз изменений без изменения целевого узла.

diff_mode

Поддержка: частичная

В режиме diff возвращает сведения об изменениях (или возможных изменениях в check_mode).

Примечания

Примечание

  • Этот модуль использует passlib для хеширования паролей, если библиотека доступна; в противном случае используется модуль Python crypt или legacycrypt.

Примеры

- name: Create a user on a UCS
  community.general.udm_user:
    name: FooBar
    password: secure_password
    firstname: Foo
    lastname: Bar

- name: Create a user with the DN uid=foo,cn=teachers,cn=users,ou=school,dc=school,dc=example,dc=com
  community.general.udm_user:
    name: foo
    password: secure_password
    firstname: Foo
    lastname: Bar
    ou: school
    subpath: 'cn=teachers,cn=users'

# or define the position
- name: Create a user with the DN uid=foo,cn=teachers,cn=users,ou=school,dc=school,dc=example,dc=com
  community.general.udm_user:
    name: foo
    password: secure_password
    firstname: Foo
    lastname: Bar
    position: 'cn=teachers,cn=users,ou=school,dc=school,dc=example,dc=com'

Авторы

  • keachi (@keachi)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)
  • Задать вопрос
  • Сообщить об ошибке
  • Предложить новую функцию
  • Общение

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API