theforeman.foreman.auth_source_ldap – Управление источниками аутентификации LDAP
Примечание
Этот плагин входит в состав коллекции theforeman.foreman (версия 1.5.1).
Для его установки используйте: ansible-galaxy collection install theforeman.foreman.
Для использования в книге задач укажите: theforeman.foreman.auth_source_ldap.
Новое в версии 1.0.0: of theforeman.foreman
Обзор
- Создание, обновление и удаление источников аутентификации LDAP
Требования
Ниже приведены требования к хосту, на котором будет выполняться этот модуль.
- requests
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| account строка | Имя учетной записи для доступа к серверу LDAP. | |
| account_password строка | Пароль учетной записи для доступа к серверу LDAP. Требуется при использовании onthefly_register. При установке этого параметра модуль не будет идемпотентным. | |
| attr_firstname строка | Атрибут, содержащий имя. Требуется при использовании onthefly_register. | |
| attr_lastname строка | Атрибут, содержащий фамилию. Требуется при использовании onthefly_register. | |
| attr_login строка | Атрибут, содержащий идентификатор входа. Требуется при использовании onthefly_register. | |
| attr_mail строка | Атрибут, содержащий адрес электронной почты. Требуется при использовании onthefly_register. | |
| attr_photo строка | Атрибут, содержащий фотографию пользователя | |
| base_dn строка | Базовая DN для поиска. | |
| groups_base строка | Базовая DN, где находятся группы. | |
| host строка / обязательно | Имя хоста сервера LDAP | |
| ldap_filter строка | Фильтр для применения к поискам LDAP | |
| locations список / элементы=строка | Список местоположений, которым должна быть назначена сущность | |
| name строка / обязательно | Имя источника аутентификации LDAP | |
| onthefly_register логический |
| Регистрировать ли пользователей на лету. |
| organizations список / элементы=строка | Список организаций, которым должна быть назначена сущность | |
| password строка / обязательно | Пароль пользователя, обращающегося к серверу Foreman. Если значение не указано в задаче, используется значение переменной среды FOREMAN_PASSWORD. | |
| port целое число | По умолчанию: 389 | Номер порта сервера LDAP |
| server_type строка |
| Тип сервера LDAP |
| server_url строка / обязательно | URL сервера Foreman. Если значение не указано в задаче, используется значение переменной среды FOREMAN_SERVER_URL. | |
| state строка |
| Состояние сущности |
| tls логический |
| Использовать ли TLS при обращении к серверу LDAP. |
| use_netgroups логический |
| Использовать ли NIS netgroups вместо posix групп, недействительно для server_type=active_directory |
| usergroup_sync логический |
| Синхронизировать ли внешние группы пользователей при входе |
| username строка / обязательно | Имя пользователя, обращающегося к серверу Foreman. Если значение не указано в задаче, используется значение переменной среды FOREMAN_USERNAME. | |
| validate_certs логический |
| Проверять ли сертификаты TLS сервера Foreman. Если значение не указано в задаче, используется значение переменной среды FOREMAN_VALIDATE_CERTS. |
Примеры
- name: LDAP Authentication source
theforeman.foreman.auth_source_ldap:
name: "Example LDAP"
host: "ldap.example.org"
server_url: "https://foreman.example.com"
locations:
- "Uppsala"
organizations:
- "Sweden"
username: "admin"
password: "changeme"
state: present
- name: LDAP Authentication with automatic registration
theforeman.foreman.auth_source_ldap:
name: "Example LDAP"
host: "ldap.example.org"
onthefly_register: True
account: uid=ansible,cn=sysaccounts,cn=etc,dc=example,dc=com
account_password: secret
base_dn: dc=example,dc=com
groups_base: cn=groups,cn=accounts, dc=example,dc=com
server_type: free_ipa
attr_login: uid
attr_firstname: givenName
attr_lastname: sn
attr_mail: mail
attr_photo: jpegPhoto
server_url: "https://foreman.example.com"
username: "admin"
password: "changeme"
state: present
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| entity словарь | успешно | Конечное состояние затронутых сущностей, сгруппированных по их типу. | |
| auth_source_ldaps список / элементы=словарь | успешно | Список источников аутентификации для LDAP. | |
Авторы
- Christoffer Reijer (@ephracis) Basalt AB
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/theforeman/foreman/auth_source_ldap_module.html