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

Примечание

Этот плагин входит в состав коллекции community.general (версия 2.0.1).

Для его установки используйте: 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, значение или список значений, используемых при создании записи. Это может быть строка или фактический список строк.
referrals_chasing строка добавлен в 2.0.0 community.general	Варианты: disabled anonymous ←	Установите поведение отслеживания рефералов. `anonymous` следовать рефералам анонимно. Это поведение по умолчанию. `disabled` отключить отслеживание рефералов. Это устанавливает `OPT_REFERRALS` в выключенное состояние.
sasl_class строка добавлен в 2.0.0 community.general	Варианты: external ← gssapi	Класс, используемый для аутентификации SASL. возможные варианты `external`, `gssapi`.
server_uri строка	Значение по умолчанию: "ldapi:///"	URI LDAP-сервера. Значение по умолчанию позволяет базовой библиотеке LDAP клиента искать сокет домена UNIX в стандартном расположении.
start_tls булево	Варианты: no ← yes	Если true, будет использовано расширение START_TLS LDAP.
state строка	Варианты: present ← absent	Целевое состояние записи.
validate_certs булево	Варианты: no yes ←	Если установлено `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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/ldap_entry_module.html