Для работы настройки обязателен параметр AuP.Autoprovision.

Параметр Common.RemotePhoneBook.v2 предназначен для настройки удаленных адресных книг (Remote PhoneBook) в системе AuP. Он позволяет гибко управлять источниками контактов (ECSS Address Book, RestFS, Custom) и их параметрами, поддерживая до 10 серверов адресных книг.

Структура параметра

Общие настройки (опционально):

  • Common.RemotePhoneBook.v2.Enable – включение/отключение адресных книг для устройства;

    Влияет только на запись URL в конфигурацию телефона. Обработка запросов к адресным книгам работает независимо от этого флага.

  • Common.RemotePhoneBook.v2.UpdateInterval – интервал обновления адресной книги (в минутах).

Настройки серверов адресных книг:

  • Common.RemotePhoneBook.v2.Server.[X] – конфигурация сервера с индексом X (от 1 до 10).

Обязательные параметры:

  • Источник данных: 

    • ECSS Address Book, RestFS или Custom.

Опциональные параметры:

    • Имя адресной книги (отображается на телефоне).

Типы источников данных и их настройки

ECSS Address Book

Контакты загружаются с сервера ECSS Address Book.

Обязательные параметры: Нет.
Опциональные параметры:

  • Alias ID – идентификатор пользователя для добавления персональных контактов;

  • Формат полного имени (например, «Фамилия Имя Отчество»);

  • Смещение (offset) и лимит (limit) для пагинации контактов.

RestFS

Контакты загружаются с сервера RestFS.

Обязательные параметры:

  • Сервис данных: SSW, MySQL или LDAP;

  • PBX домен.

Опциональные параметры:

  • Смещение и лимит контактов;

  • Пропуск контактов без имени;

  • Транслитерация имени контакта.

Custom

Используется пользовательский URL для загрузки адресной книги.

Обязательные параметры:

  • URL адресной книги.

Опциональные параметры:

  • Данные авторизации (имя пользователя и пароль);

  • Проксирование через AuP – если включено, AuP обрабатывает запросы к URL;

  • Пропуск проверки SSL-сертификата (для HTTPS).

Генерация URL в конфигурации телефона

  • Для RestFS и ECSS Address Book URL генерируется автоматически в формате:
    https://<AuP-хост>/phonebook-<X>.xml, где <X> – индекс сервера.

  • Для Custom:

    • Если проксирование отключено – URL передается «как есть»;

    • Если проксирование включено – URL генерируется как для RestFS/ECSS Address Book.

Обработка запросов к адресным книгам

  • AuP обрабатывает запросы к https://<AuP-хост>/phonebook-<X>.xml;

  • Из URL извлекается индекс сервера (X), и AuP загружает контакты из соответствующего источника;

  • Для Custom с проксированием AuP выполняет запрос к указанному URL и возвращает результат.

Важные замечания

  1. Не используйте одновременно Common.RemotePhoneBook.v2 и устаревший Common.RemotePhoneBook – это приведет к конфликтам.

  2. Параметры Common.RemotePhoneBook.v2 не зависят от состояния Common.RemotePhoneBook.v2.Enable при обработке запросов.

  3. Для работы с RestFS/ECSS Address Book должны быть настроены глобальные параметры:

    • AuP.Dynamic.RestFs (хост, порт, SSL-настройки);

    • AuP.Dynamic.EcssAddressBook (хост, порт, SSL-настройки).

  4. Для генерации URL в конфигурации телефона используется свойство AuP.Autoprovision (хост, схема, порт AuP).

Рекомендации

  • Используйте Common.RemotePhoneBook.v2 для новых конфигураций;

  • При изменении настроек адресных книг обновите конфигурацию телефона, чтобы избежать несоответствий.

Пример конфигурации (Yealink)

plaintext

features.remote_phonebook.enable = 1
remote_phonebook.data.1.url = https://10.25.88.149:80/phonebook-1.xml
remote_phonebook.data.2.url = https://10.25.88.149:80/phonebook-2.xml
remote_phonebook.data.3.url = http://example.com/phonebook.xml
remote_phonebook.data.3.username = user
remote_phonebook.data.3.password = pass
  • Нет меток