Параметр ldap_connection#

Последовательность параметров ldap_connection предназначена для определения параметров подключения LDAP.

connection_type

Задает тип заводского подключения.

Тип параметра: текстовое значение.
- «SINGLE» - настроено только одно подключение;
- «POOLED» - настроен пул подключений.
По умолчанию:
```
connection_type: single
```
init_pool_size

Размер пула инициализации при использовании типа подключения connection_type: pooled.

Обязательно в случае:
```
connection_type: pooled
```
Тип параметра: целочисленное значение.
max_pool_size

Максимальный размер пула при использовании типа подключения connection_type: pooled. По умолчанию используется значение, заданное в параметре init_pool_size.

Используется в случае:
```
connection_type: pooled
```
Тип параметра: целочисленное значение.
url_list

Список URL-адресов сервера LDAP, разделенных пробелом. Обязательный параметр.

Тип параметра: текстовое значение.
connect_timeout

Время ожидания установки соединения с сервером LDAP.

Тип параметра: текстовое значение.

По умолчанию:
```
connect_timeout: 1m
```
response_timeout

Время ожидания получения ответа от сервера LDAP.

Тип параметра: текстовое значение.

По умолчанию:
```
connect_timeout: 1m
```
auto_reconnect

Включает автоматическое переподключение при обрыве соединения с сервером LDAP.

Тип параметра: булево значение.
- true;
- false.
По умолчанию:
```
auto_reconnect: true
```
auto_reconnect_condition

Задает условия переподключения.

Тип параметра: текстовое значение.
- «ONE» - будет предпринята только одна попытка повторного подключения;
- «INFINITE» - будут предприняты бесконечные попытки;
- «INFINITE_BACKOFF» - будут предприняты попытки восстановить соединение через каждые 5 секунд после первой попытки.
reconnect_timeout

Таймаут при попытке повторного подключения.

Тип параметра: текстовое значение.
connection_strategy

Тип параметра: последовательность параметров и их значений.
- name
  
  Определяет стратегию балансировки.
  
  Тип параметра: текстовое значение.
  - «ROUND_ROBIN» - используется алгоритм round_robin;
  - «ACTIVE_PASSIVE» - активен только первый сервер в списке URL, если он вышел из балансировки, активным будет установлен следующий сервер;
  - «RANDOM» - случайный выбор сервера;
  - «DNS_SRV» - запрашивает у DNS-сервера SRV записи и использует их для создания списка URL-адресов;
  - «DNS_RESOLVE» - стратегия подключения, которая проверяет все IP-адреса, разрешенные с помощью DNS.
- ttl
  
  ttl dns-ответа при использовании значений dns_srv или dns_resolve параметра connection_strategy.
  
  Используется в случае:
```
name: dns_srv
```
  или
```
name: dns_resolve
```
  Тип параметра: текстовое значение.
ssl

Определяет ssl-параметры подключения.

Тип параметра: последовательность параметров и их значений.
- enabled
  
  Включает/отключает ssl/startTls.
  
  Тип параметра: булево значение.
  - true;
  - false.
- handshake_timeout
  
  Таймаут операции подтверждения связи.
  
  Тип параметра: текстовое значение.
- disable_hostname_check
  
  Если установлено значение true, то проверка хоста не будет произведена. При указании значения по умолчанию будет использоваться алгоритм проверки имени хоста по умолчанию.
  
  Тип параметра: булево значение.
  
  По умолчанию:
```
disable_hostname_check: false
```
- cipher_suites
  
  Список доступных наборов шифров.
  
  Тип параметра: последовательность текстовых значений.
- protocols
  
  Список доступных протоколов.
  
  Тип параметра: последовательность текстовых значений.
  - «TLSv1.3»;
  - «TLSv1.2»;
  - «TLSv1.1»;
  - «SSLv3».
- trust_all
  
  Доверять сертификатам всех серверов LDAP. Только для тестового использования.
  
  Тип параметра: булево значение.
  - true;
  - false.
  По умолчанию:
```
trust_all: false
```
- credentials
  
  Клиентские удостоверения в формате X509.
  
  Тип параметра: последовательность параметров и их значений.
  - trusted_certificate
    
    Файл доверенного сертификата.
    
    Тип параметра: текстовое значение.
    - «file_secure»;
    - «file».
  - auth_certificate
    
    Файл сертификата аутентификации.
    
    Тип параметра: текстовое значение.
    - «file_secure»;
    - «file».
  - auth_key
    
    Файл с закрытым ключом.
    
    Тип параметра: текстовое значение.
    - «file_secure»;
    - «file».
binding

Параметры операции привязки. Если не указано - используется анонимный доступ к серверу LDAP.

Тип параметра: последовательность параметров и их значений.
- bind_type
  
  Тип привязки. Обязательный параметр.
  
  Тип параметра: текстовое значение.
  - «ANONYMOUS»;
  - «SIMPLE»;
  - «SASL».
- sasl_mechanism
  
  Используется в случае:
```
bind_type: sasl
```
  Тип параметра: текстовое значение.
  - «EXTERNAL»;
  - «DIGEST-MD5»;
  - «CRAM-MD5»;
  - «GSSAPI».
- bind_dn
  
  Dn, используемый в операции bind, после установления соединения. Может содержать переменные, если значение do_not_reuse_connection в действиях, использующих данные соединения, установлен в false.
  
  Тип параметра: текстовое значение.
- bind_credential
  
  Аутентифицирующая информация, используемая при выполнении операции привязки. Может содержать переменные, если значение do_not_reuse_connection в действиях, использующих данные соединения, установлен в false.
  
  Тип параметра: текстовое значение.
- kerberos_auth
  
  Параметры SASL Kerberos.
  
  Тип параметра: последовательность параметров и их значений.
  - principal
    
    Основное имя.
    
    Тип параметра: текстовое значение.
    - «file_secure»;
    - «file».
  - keytab
    
    Файл keytab. По умолчанию используется /etc/krb5.keytab.
    
    Тип параметра: текстовое значение.
    - «file_secure»;
    - «file».