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

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

Обзор

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

Требования

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

python-ldap

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
attributes -		Если state=present, атрибуты, необходимые для создания записи. Существующие записи никогда не изменяются. Для проверки конкретных значений атрибутов существующей записи используйте модуль 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 логическое добавлено в 2.4	Варианты: нет да ←	Если установлено в `no`, сертификаты SSL не будут проверяться. Это следует использовать только на сайтах, использующих самозаверяющие сертификаты.

Примечания

Примечание

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

Примеры

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

- name: Make sure we have an admin user
  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
  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
  ldap_entry:
    dn: ou=stuff,dc=example,dc=com
    state: absent
  args: "{{ ldap_auth }}"

Статус

Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

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.9/modules/ldap_entry_module.html