ldap_entry – Добавить или удалить записи LDAP

Новое в версии 2.3.

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

Описание

Добавление или удаление записей 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, будем использовать расширение LDAP START_TLS.
state -	Варианты: присутствует ← отсутствует	Целевое состояние записи.
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. [community]

Авторы

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