community.general.ldap_entry – Добавление или удаление записей LDAP.

Примечание

Этот плагин является частью коллекции community.general (версия 1.3.2).

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

Для использования в книге задач укажите: community.general.ldap_entry.

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

Добавляет или удаляет записи LDAP. Этот модуль только проверяет существование или отсутствие записи LDAP, а не ее атрибуты. Для проверки значений атрибутов записи см. community.general.ldap_attr.

Требования

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

python-ldap

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
attributes словарь		Если state=present, необходимые атрибуты для создания записи. Существующие записи никогда не изменяются. Для проверки конкретных значений атрибутов в существующей записи используйте модуль community.general.ldap_attr вместо этого.
bind_dn строка		DN для привязки. Если это опущено, мы попробуем привязку SASL с механизмом EXTERNAL. Если это пусто, будет использоваться анонимная привязка.
bind_pw строка		Пароль для использования с bind_dn.
dn строка / обязательно		DN записи для добавления или удаления.
objectClass список / элементы=строка		Если state=present, значение или список значений для использования при создании записи. Это может быть строка или фактический список строк.
server_uri строка	По умолчанию: "ldapi:///"	URI сервера LDAP. Значение по умолчанию позволяет базовой библиотеке LDAP клиента искать сокет доменной UNIX в его стандартном расположении.
start_tls булево	Варианты: нет ← да	Если true, мы будем использовать расширение START_TLS LDAP.
state строка	Варианты: present ← absent	Целевое состояние записи.
validate_certs булево	Варианты: нет да ←	Если установлено значение `no`, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, использующих самоподписанные сертификаты.

Примечания

Примечание

Настройки аутентификации по умолчанию попытаются использовать привязку SASL EXTERNAL через сокет доменной UNIX. Это хорошо работает с установкой Ubuntu по умолчанию, например, которая включает правило ACL cn=peercred,cn=external,cn=auth, позволяющее root изменять конфигурацию сервера. Если вам нужно использовать простую привязку для доступа к серверу, передайте учетные данные в bind_dn и bind_pw.
Параметр params был удален из-за обхода обработки параметров Ansible. Параметр params начал запрещать установку параметра bind_pw в Ansible-2.7, поскольку установка параметра таким способом была небезопасной.

Примеры

- name: Make sure we have a parent entry for users
  community.general.ldap_entry:
    dn: ou=users,dc=example,dc=com
    objectClass: organizationalUnit

- name: Make sure we have an admin user
  community.general.ldap_entry:
    dn: cn=admin,dc=example,dc=com
    objectClass:
      - simpleSecurityObject
      - organizationalRole
    attributes:
      description: An LDAP administrator
      userPassword: "{SSHA}tabyipcHzhwESzRaGA7oQ/SDoBZQOGND"

- name: Get rid of an old entry
  community.general.ldap_entry:
    dn: ou=stuff,dc=example,dc=com
    state: absent
    server_uri: ldap://localhost/
    bind_dn: cn=admin,dc=example,dc=com
    bind_pw: password

#
# The same as in the previous example but with the authentication details
# stored in the ldap_auth variable:
#
# ldap_auth:
#   server_uri: ldap://localhost/
#   bind_dn: cn=admin,dc=example,dc=com
#   bind_pw: password
#
# In the example below, 'args' is a task keyword, passed at the same level as the module
- name: Get rid of an old entry
  community.general.ldap_entry:
    dn: ou=stuff,dc=example,dc=com
    state: absent
  args: "{{ ldap_auth }}"

Авторы

Jiri Tyr (@jtyr)

© 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/community/general/ldap_entry_module.html