Настройка провиженинга телефонов с помощью модуля phoneprov на примере телефона Yealink.

В рамках данной статьи будет рассмотрен модуль Asterisk phoneprov. А также настройка на примере телефона Yealink. Данный модуль позволяет на основе шаблонов строить конфигурационные файлы под провиженинг телефонов. Для функционирования данной возможно необходимо собрать Asterisk c модулем res_phoneprov.so.

Исходные данные:
— Серверная ОС: Centos 7
— Asterisk версии 17
— Телефонный аппарат Yealink SIP T22

Все настройки производятся в конфигурационных файлах Asterisk. Затрагиваются следующие файлы:
— manager.conf
— http.conf
— users.conf
— phoneprov.conf

Файл manager.conf необходимо чтобы следующие параметры были включены в разделе general:

enabled = yes
webenabled = yes

В файле http.conf также в разделе general нужно указать следующие параметры:

enabled=yes
bindaddr=192.168.170.187 — указывается адрес сервера Asterisk
bindport=8088 — указывается порт на котором предполагается работа встроенного веб-сервера Asterisk, по-умолчанию 8088

Далее необходимо настроить модуль res_phoneprov, все его настройки производятся в файле phoneprov.conf

Все шаблоны конфигурационных файлов телефонных аппаратов, а также прошивки размещаются в директории /var/lib/asterisk/phoneprov. В файле phoneprov.conf все пути прописываются относительно указанной директории. В этом файле прописываются статические файлы, например, прошивки, конфигурационные файлы общие для модели телефонных аппаратов, а также шаблоны имен динамически генерируемых файлов

в разделе general файла phoneprov.conf прописываются следующие параметры:

• default_profile=yealink — какой профиль использовать по-умолчанию. если он не указан в явном виде в файле users.conf
• serveraddr=192.168.170.187 — задание переменной ${SERVER}, необходимой для добавления в динамически генерируемые файлы
• serverport=5060 — задание переменной ${SERVER_PORT}, необходимой для добавления в динамически генерируемые файлы

Далее необходимо описать профили аппаратов, в данном примере для телефонов модели Yealink SIP-T22
[yealink]

• mime_type => text/xml, text/plain — тип файлов конфигурации
• static_file => 7.73.0.50.rom — файл прошивки
• static_file => y000000000005.cfg — конфигурационный файл, общий для всех телефонов настраиваемой модели
• ${MAC}.cfg => yealink_mac.cfg — маска имени динамически генерируемых файлов, а также указание из какого шаблона их генерировать

Затем необходимо загрузить файл прошивки, общий конфигурационный файл и шаблон индивидуального конфигурационного файла в директорию /var/lib/asterisk/phoneprov

Общий файл содержит довольно много параметров настройки телефонных аппаратов, ранее в другой статье они уже упоминались: https://voxlink.ru/kb/ip-phones-configuration/yealink/nastrojka-provisioninga-telefonov-yealink-t21/

Но шаблон под индивидуальный файл приведем ниже (показан необходимый минимум).

 account.1.enable = 1
account.1.label = ${USERNAME}
account.1.display_name = ${USERNAME}
account.1.auth_name = ${USERNAME}
account.1.password = ${SECRET}   
account.1.user_name = ${USERNAME}
account.1.sip_server.2.address = ${SERVER}
account.1.sip_server_port = ${SERVER_PORT}
account.1.sip_server_host = ${SERVER}
account.1.outbound_proxy_enable = 0
account.1.outbound_host =
account.1.outbound_port = ${SERVER_PORT}
account.1.transport = 0
account.1.sip_server.1.expires = 180

Здесь переменные ${USERNAME}, ${SECRET}, ${SERVER}, ${SERVER_PORT}  это переменные зарезервированные модулем res_phoneprov и вместо них при генерации файла будут подставляться необходимые данные.

Далее необходимо завести внутренние номера в  файле users.conf
Примерный набор параметров:

[101]
username = 101
fullname = Test
secret = MKIJKLSeio5u4857jk
macaddress = 00156527bc30
autoprov = yes
context = test
profile=yealink
host = dynamic
qualify = yes

Для корректной работы res_phoneprov необходимы следующие опции:

• autoprov=yes — указывает модулю, что данный номер должен быть заведен на телефоне провиженингом
• macaddress — указывается MAC телефонного аппарата на котором должен быть зарегистрирован номер
• profile — имя профиля из файла phoneprov.conf, который используется для автопровиженинга телефона
• username — из этого параметра phoneprov берет аккаунт, который необходимо зарегистрировать на телефонном аппарате

Для применения настроек рекомендуется выполнить команды:
sip reload и module reload res_phoneprov.so, если нет  сообщения о каких-либо ошибках, то  значит все настроено корректно. Для просмотра настроек модуля провиженинга используется команда: phoneprov show routes, она выведет список файлов настроенных в phoneprov.conf

Далее необходимо указать для телефонов путь к серверу провиженинга, вообщем виде он выглядит следующим образом: http://asterisk_ip:8088/phoneprov
Передать его на телефоны можно, например, с помощью option 66 DHCP-сервера.

На этом настройка провиженинга телефонов с помощью модуля res_phoneprov.so завершена.