Использование LDAP в IP-телефонах Yealink
LDAP — это прикладной протокол для доступа и обеспечения работы информационных служб для распределенного каталога по IP-сети. Телефоны можно настроить для взаимодействия с корпоративным сервером каталогов, который поддерживает LDAP версии 2 или 3, для использования этого каталога в качестве корпоративной телефонной книги компании.
Настройка LDAP
Предварительно убедитесь, что сервер LDAP запущен, и у телефона есть к нему доступ.
Для проверки доступности сервера можно, например, пропинговать сервер с помощью команды ping, запущенной из экранного меню или веб-интерфейса телефона.
Экранное меню: Меню -> Функции -> Диагностика -> Сеть -> Пинг
Веб-интерфейс: Сеть -> Диагностика -> Команда [выбрать Ping в выпадающем меню]
Пример выполнения команды ping
Подключение и настройка справочника
Перейдите в веб-интерфейс телефона.
Веб-интерфейс: Контакты -> LDAP
Заполните поля параметров справочника LDAP.
Значение параметра Статус LDAP/Включение LDAP измените на Включено.
Параметры LDAP — TLS режим, Адрес сервера LDAP, Порт, LDAP Username, Пароль LDAP, LDAP Base, Protocol, LDAP Name Atributes, LDAP Number Atributes — сообщает администратор сервера LDAP. Такие параметры LDAP, как Label, Max hits, LDAP Sorting Results, заполняются согласно предпочтениям компании. Параметры LDAP Display Name, LDAP Name Filter, LDAP Number Filter заполняются согласно предпочтениям компании в соответствии с параметрами LDAP Name Atributes, LDAP Number Atributes.
Если необходимо, чтобы при входящих/исходящих вызовах в справочнике LDAP выполнялся поиск на соответствие номера абонента, включите параметр Поиск по LDAP при входящем/исходящем вызове.
После заполнения всех параметров нажмите кнопку Сохранить. Если все сделано правильно, книга отобразится в списке телефонных книг в экранном меню телефона.
Пример настроек LDAP телефонной книги (старая версия веб-интерфейса)
Пример настроек LDAP телефонной книги (новая версия веб-интерфейса)
Просмотр контактов, поиск по контактам
Для просмотра списка контактов и осуществления поиска по контактам необходимо в экранном меню телефона выбрать LDAP-справочник, нажать Вход. Если сервер требует авторизацию и она не была выполнена автоматически (параметры LDAP username и Пароль LDAP), при входе в справочник может потребоваться авторизация.
Экранное меню: Меню -> Контакты -> Имя справочника LDAP
Список параметров для ручной настройки и автопровижининга, их расположение и описание
Все нижеперечисленные параметры можно настроить через веб-интерфейс по пути Контакты -> LDAP и нельзя настроить через экранное меню устройства.
LDAP Enable — включение/отключение LDAP.
Параметр в .cfg:
ldap.enable = значение,
где значение 0 — отключен, 1 — включен.
Пример: ldap.enable = 1
LDAP Label — отображаемое имя каталога.
Параметр в .cfg:
ldap.customize_label = значение,
где значение — имя каталога.
Пример: ldap.customize_label = book1
LDAP Name Filter — параметр фильтра для поиска контактов на сервере.
Параметр в .cfg:
ldap.name_filter = значение,
где значение — перечень параметров фильтра;
символ * обозначает любой символ атрибута;
символ % обозначает название атрибута.
Пример: ldap.name_filter = (&(cn=*)(sn=%))
LDAP Number Filter — параметр фильтра для отображения списка телефонных номеров контакта.
Параметр в .cfg:
ldap.number_filter = значение,
где значение — перечень параметров фильтра;
символ * обозначает любой номер;
символ % обозначает номер, введенный пользователем.
Пример: ldap.number_filter = telephoneNumber=*
LDAP TLS режим — параметр, настраивающий тип защищенного подключения к серверу LDAP.
Параметр в .cfg:
ldap.tls_mode = значение,
где значение — 0, 1, 2,
0 — LDAP; 1 — LDAP TLS start; 2 — LDAPs.
Пример: ldap.tls_mode = 2
Адрес сервера LDAP — адрес сервера, на котором расположен справочник.
Параметр в .cfg:
ldap.host = значение,
где значение — адрес сервера.
Пример: ldap.host = 192.168.205.5
Порт — порт сервера LDAP.
Параметр в .cfg:
ldap.port = значение,
где значение — порт, используемый для доступа к службе. По умолчанию при подключении без TLS используется порт 389, при подключении с TLS используется порт 636.
Пример: ldap.port = 389
LDAP username — имя пользователя, используемое для авторизации на LDAP-сервере.
Параметр в .cfg:
ldap.user = значение,
где значение — имя пользователя.
Пример: ldap.user = ldap.user = cn=manager,dc=yealink,dc=cn
Пароль LDAP — пароль, используемый для авторизации на LDAP-сервере.
Параметр в .cfg:
ldap.password = значение,
где значение — пароль пользователя.
Пример: ldap.password = qwerty123
LDAP Base — базовый каталог для поиска по справочнику.
Параметр в .cfg:
ldap.base = значение,
где значение — расположение каталога.
Пример: ldap.base = ldap.base = dc=yealink,dc=cn
Max Hits — максимальное количество возвращаемых сервером контактов при поиске (по умолчанию — 50, допустимое — 1-1000). Обратите внимание, что при большом значении данного параметра поиск по LDAP-справочнику может занять много времени.
Параметр в .cfg:
ldap.max_hits = значение,
где значение — количество.
Пример: ldap.max_hits = 50
LDAP Name Atributes — определяет, какие атрибуты имен будут возвращены сервером при обработке запроса. Может содержать несколько значений, разделенных пробелами.
Параметр в .cfg:
ldap.name_attr = значение,
где значение — список атрибутов.
Пример: ldap.name_attr = cn sn
LDAP Number Atributes — определяет, какие атрибуты номеров будут возвращены сервером при обработке запроса. Может содержать несколько значений, разделенных пробелами.
Параметр в .cfg:
ldap.numb_attr = значение,
где значение — список атрибутов.
Пример: ldap.numb_attr = telephoneNumber mobile ipPhone
LDAP Display Name — настраивает отображаемые на экране атрибуты имен. Каждое значение должно начинаться с %.
Параметр в .cfg:
ldap.display_name = значение,
где значение — список атрибутов.
Пример: ldap.display_name = %cn
Protocol — версия протокола LDAP.
Параметр в .cfg:
ldap.version = значение,
где значение — версия протокола (2 или 3).
Пример: ldap.version = 3
Поиск по LDAP при исходящем вызове — осуществление поиска соответствий по LDAP-справочнику для исходящих вызовов.
Параметр в .cfg:
ldap.call_out_lookup = значение,
где значение 0 — отключен, 1 — включен.
Пример: ldap.call_out_lookup = 1
Поиск по LDAP при входящем вызове — осуществление поиска соответствий по LDAP-справочнику для входящих вызовов.
Параметр в .cfg:
ldap.call_in_lookup = значение,
где значение 0 — отключен, 1 — включен.
Пример: ldap.call_in_lookup = 1
LDAP Sorting Results — включение или отключение сортировки результатов поиска в алфавитном или числовом порядке.
Параметр в .cfg:
ldap.ldap_sort = значение,
где значение 0 — отключен, 1 — включен.
Пример: ldap.ldap_sort = 0
Список наиболее распространенных атрибутов LDAP
| Аббревиатура | Полное название | Описание |
| gn | givenName | Имя |
| cn | commonName | Атрибут LDAP, состоящий из имени и фамилии |
| sn | surname | Фамилия |
| dn | distinguishedName | Уникальный идентификатор записи |
| dc | dc | Компонент домена |
| - | company | Название организации |
| - | telephoneNumber | Рабочий номер |
| mobile | mobilephoneNumber | Мобильный номер |
| ipPhone | IPphoneNumber | Домашний номер |
Информацию об атрибутах используемого компанией сервера LDAP можно уточнить у администратора данного сервера.
Ручное редактирование и загрузка конфигурационного файла
Конфигурационный файл импортируется из веб-интерфейса телефона.
Веб-интерфейс: Настройки -> Конфигурации -> Конфигурационный файл .cfg -> Экспорт конфигурационного файла (с параметром Все настройки).
Импортированный файл необходимо открыть текстовым редактором (Блокнот, Notepad ++ и пр.), его редактирование осуществляется путем добавления, изменения или удаления строк.
Конфигурационный файл импортируется обратно на телефон.
Веб-интерфейс: Настройки -> Конфигурации -> Конфигурационный файл .cfg -> Импорт конфигурационного файла.
Редактирование конфигурационного файла (старая версия веб-интерфейса)
Редактирование конфигурационного файла (новая версия веб-интерфейса)
Продолжение следует
