artem
05.11.2014
16499

Настройка DUNDi для динамической маршрутизации вызовов между хостами Asterisk

DUNDi (Distributed Universal Number Discovery) — это протокол для передачи информации о местонахождении экстеншена между хостами Asterisk. В данной статье будет рассмотрен пример настройки DUNDi для динамической маршрутизации вызовов между двумя хостами Asterisk.

  1. Исходные данные
  2. Подготовка к настройке
  3. Настройка DUNDi
  4. Настройка диалплана Asterisk (совершение вызовов с использованием DUNDi)
  5. Добавление хоста в сеть DUNDi

Исходные Данные

     Первый сервер Asterisk (pbx1):              Второй сервер Asterisk (pbx2):   
               CentOS 6, Asterisk 11                 CentOS 6, Asterisk 11
                           eth0                            eth0
              IP: 192.168.10.111/24               IP: 192.168.10.222/24
             MAC: 00:11:11:11:11:01              MAC: 00:11:11:11:22:02


На обоих серверах настроено большое количество трёхзначных номеров без соблюдения конкретных диапазонов, нужно настроить маршрутизацию вызовов между серверами. Можно конечно прописать каждый номер вручную, но не желательно, т.к. полученный ворох экстеншенов придётся потом поддерживать в актуальном состоянии при заведении новых номеров и при переходе номеров между АТС. Лучше воспользоваться протоколом DUNDi.

Подготовка к настройке


1) Протокол DUNDi по умолчанию использует UDP-порт 4520, для вызовов будет использоваться протокол IAX2 (4569 UDP). Для начала, нужно разрешить входящие пакеты на эти порты.

Пример:

# на pbx1
iptables -N PBXS
iptables -A PBXS -s 192.168.10.222 -j ACCEPT
iptables -A INPUT -p udp --dport 4520 -j PBXS
iptables -A INPUT -p udp --dport 4569 -j PBXS
# на pbx2
iptables -N PBXS
iptables -A PBXS -s 192.168.10.111 -j ACCEPT
iptables -A INPUT -p udp --dport 4520 -j PBXS
iptables -A INPUT -p udp --dport 4569 -j PBXS

2) DUNDi использует RSA-ключи для шифрования. Создать их можно с помощью скрипта astgenkey (входит в стандартный пакет Asterisk)

Выполняем:

# на обоих хостах нужно создать директорию /var/lib/asterisk/keys если она не существует
mkdir -p /var/lib/asterisk/keys
chown asterisk. /var/lib/asterisk/keys
chmod 700 /var/lib/asterisk/keys
  # далее нужно создать пару ключей и зарытый ключ переместить в директорию /var/lib/asterisk/keys текущего хоста,
# а открытый ключ скопировать на все хосты, которые будут связаны с текущим по DUNDi
  # на pbx1
astgenkey -n pbx1
mv ./pbx1.key /var/lib/asterisk/keys
scp ./pbx1.pub 192.168.10.222:/var/lib/asterisk/keys
  # на pbx2
astgenkey -n pbx2
mv ./pbx2.key /var/lib/asterisk/keys
scp ./pbx2.pub 192.168.10.111:/var/lib/asterisk/keys
  # параметр -n означает что создаваемый закрытый ключ не нужно шифровать

Чтобы Asterisk увидел новые ключи, нужно перезагрузить модуль res_crypto.so (на обоих хостах).
После этого командой CLI Asterisk «keys show» можно проверить подгруженные ключи.

asterisk -rx «module reload res_crypto.so»

3) Сам по себе, протокол DUNDi обеспечивает только передачу информации о местонахождении экстеншена, для совершения вызова нужно использовать VoIP протокол. В данном примере будет использоваться протокол IAX2.
Описываем в файле iax.conf IAX-пользователя, которым другие хосты будут пользоваться для вызова экстеншенов, найденных на данном хосте через DUNDi (это нужно сделать на обоих хостах).

[iax_dundi]
type=user
dbsecret=dundi/secret
context=from-pbxs
disallow=all
allow=alaw
allow=ulaw
deny=0.0.0.0/0.0.0.0
permit=192.168.0.0/255.255.0.0

Опция dbsecret означает, что пароль пользователя будет храниться в AstDB в ключе dundi/secret, пароль будет периодически генерировать модуль pbx_dundi (о нём ниже)

Применяем изменения:

asterisk -rx «iax2 reload»

4) Теперь нужно описать контекст from-pbxs, который используется для IAX-пользователя, созданного на предыдущем шаге (это нужно сделать на обоих хостах).

Данный контекст будет использоваться для обработки входящих вызовов с других хостов, также, все экстеншены в этом контексте будут маршрутизироваться через DUNDi на данный хост.
В данном примере предположим, что внутренние номера описаны в контексте ext-local

на pbx1

[ext-local]
exten => 101,1,Dial(SIP/101,60)
exten => 201,1,Dial(SIP/201,60)

на pbx2

[ext-local]
exten => 102,1,Dial(SIP/102,60)
exten => 202,1,Dial(SIP/202,60)

Просто включим контекст ext-local в from-pbxs (на обоих хостах).

[from-pbxs]
include => ext-local

Применяем изменения:

asterisk -rx «dialplan reload»

Настройка DUNDi


Приступаем непосредственно к настройке DUNDi. Настройки находятся в файле /etc/asterisk/dundi.conf.

dundi.conf на pbx1

[general]
department = pbx1
organization = Organization
locality = Moscow
stateprov = MSK
country = RU
email = root@localhost
phone = 84950000000

bindaddr = 0.0.0.0
port = 4520
entityid = 00:11:11:11:11:01
ttl = 5
autokill = 4000
cachetime = 600
secretpath = dundi

[mappings]
direct => from-pbxs,0,IAX2,iax_dundi:${SECRET}@192.168.10.111/${NUMBER},nopartial

[00:11:11:11:22:02]
model = symmetric
host = 192.168.10.222
inkey = pbx2
outkey = pbx1
include = direct
permit = direct
qualify = yes
order = primary

dundi.conf на pbx2

[general]
department = pbx2
organization = Organization
locality = Moscow
stateprov = MSK
country = RU
email = root@localhost
phone = 84950000000
  bindaddr = 0.0.0.0
port = 4520
entityid = 00:11:11:11:22:02
ttl = 5
autokill = 4000
cachetime = 600
secretpath = dundi
  [mappings]
direct => from-pbxs,0,IAX2,iax_dundi:${SECRET}@192.168.10.222/${NUMBER},nopartial
  [00:11:11:11:11:01]
model = symmetric
host = 192.168.10.111
inkey = pbx1
outkey = pbx2
include = direct
permit = direct
qualify = yes
order = primary

Теперь подробнее о параметрах:

[general]
Информацию из первых семи параметров хосты, подключенные по DUNDi, могут запрашивать друг у друга, их можно заполнить как угодно.
bindaddr, port — адрес и порт привязки сервера DUNDi
entityid — DUNDi-идентификатор хоста, должен быть равен MAC-адресу какого-либо сетевого интерфейса хоста
ttl — TTL DUNDi-запросов (сколько раз DUNDi-запрос может быть передан от хоста к хосту) для предотвращения бесконечных запросов
autokill — время в миллисекундах, по истечении которого, опрос другого хоста будет прекращен (для обхода недоступных хостов)
cachetime — время кэширования DUNDi-ответов в секундах. Если местонахождение запрашивоемого экстеншена есть в кэше, то запрос не будет совершен
secretpath — Ветка в AstDB, в которой модуль pbx_dundi будет генерировать случайный пароль для вызова на данный хост

[mappings]
В этом разделе описывается, маршруты на какие экстеншены будет отдавать данный хост. Формат:

контекст_DUNDi => контекст_Asterisk,приоритет,протокол,адрес,опции

Здесь:

контекст_DUNDi — произвольное имя контекста DUNDi
контекст_Asterisk — имя существующего в диалплане Asterisk контекста. Все экстеншены в этом контексте будут маршрутизироваться на данный хост
приоритет — поиск экстеншена будет производиться в первую очередь в маппингах с меньшим значением этого параметра
протокол — VoIP протокол, используемый для вызова
адрес — адрес вызова. Должен содержать имя пользователя, пароль, IP-адрес и вызываемый номер.
переменная ${NUMBER} заменяется на номер, запрашиваемый через DUNDi
переменная ${SECRET} заменяется на автоматически сгенерированный пароль
опции — есть ряд опций, вносящих дополнительные ограничения, но, в данном случае, нас интересует только опция nopartial, которая предотвращает выдачу маршрутов с частичным совпадением искомого экстеншена

Итого: на обоих хостах описан DUNDi-контекст direct, ему соответствует контекст в диалплане from-pbxs. Вызов предлагается делать по протоколу IAX2 с использованием пользователя iax_dundi и случайного пароля (текущий пароль будет входить в возвращаемый маршрут).

DUNDi-пиры
Далее идёт описание DUNDi-пиров. Текущий хост будет опрашивать только описанные пиры и будет отвечать на запросы только описанных здесь пиров.
Описание пира начинается с его entityid в квадратных скобках.
model — режим взаимодействия с пиром. Может быть:
inbound — текущий хост будет отвечать на запросы пира, но не будет опрашивать его при поиске маршрута
outbound — текущий хост будет опрашивать пир при поиске маршрута, но не будет отвечать на его запросы
symmetric — текущий хост будет опрашивать пир при поиске маршрута и будет отвечать на его запросы

host — IP-адрес пира
inkey — этот ключ будет использоваться для расшифровки сообщений от пира
outkey — этот ключ будет использоваться для шифрования сообщений, адресованных пиру
include — пир будет опрашиваться при поиске экстеншена в перечисленных здесь DUNDi-контекстах
permit — пиру разрешается отдавать маршруты из перечисленных здесь DUNDi-контекстов
qualify — если поставить «yes», то доступность пира будет периодически проверяться
order — может содержать значения «primary», «secondary», «tertiary» и «quartiary». Опция нужна для добавления избыточных пиров. Пиры со значением «secondary» будут опрашиваться только если все пиры со значением «primary» недоступны и т.д.

Для применения указанных настроек нужно на обоих хостах выполнить команду:

module reload pbx_dundi.so

или, если модуль pbx_dundi.so ранее не был загружен

module load pbx_dundi.so

Тестирование

Проверяем правильность настройки в CLI Asterisk:

dundi show peers

Эта команда выдаёт список DUNDi-пиров и их доступность (с каждого хоста должен быть доступен противоположный)

dundi query 00:11:11:11:22:02@direct

Если выполнить эту команду на на первом хосте, должна быть возвращена общая информация о втором хосте (department, organization, locality, stateprov, country, email и phone)
Наконец, проверяем нахождение маршрутов к экстеншенам:

dundi lookup 101@direct

Данная команда, выполненная на pbx2, должна вернуть маршрут к экстеншену 101 через pbx1.
Следует заметить, что полученный маршрут будет закеширован на время, определённое настройками (у нас — 10 минут). Если за это время местонахождение экстеншена 101 изменится, то pbx2 узнает об этом только по истечении времени кэширования. Для запроса маршрута, игнорируя кэш, нужно использовать параметр bypass:

dundi lookup 101@direct bypass

Также, эта команда обновит значение в кэш.

Настройка диалплана Asterisk (совершение вызовов с использованием DUNDi)


Предполпжим, что на pbx1 и pbx2 для внутренних вызовов используется контекст from-internal следующего вида:

[from-internal]
include => ext-local
include => ext-features
include => outbound-1
include => outbound-2

Добавляем макрос для вызова через DUNDi и вызывающий его контекст:

[macro-dundi-direct]
switch => DUNDI/direct
exten => s,1,Goto(${ARG1},1)
  [outbound-dundi]
extem => _XXX,1,Macro(dundi-direct,${EXTEN})

Добавляем полученный контекст outbound-dundi в from-internal

[from-internal]
include => ext-local
include => ext-features
include => outbound-dundi
include => outbound-1
include => outbound-2

Можно тестировать вызовы между хостами.
Вызов с использованием DUNDi устанавливает переменную DIALSTATUS также, как и Dial, но DIALSTATUS будет присвоено пустое значение, если экстеншен не будет найден через DUNDi.

Добавление хоста в сеть DUNDi


Предположим, что нужно добавить к сети DUNDi третий сервер Asterisk (new-pbx)
IP: 192.168.20.15/24
MAC: 00:11:11:11:33:03

Выполняем на хосте new-pbx все шаги из раздела Подготовка к настройке.

Запросы в сети DUNDi рекурсивны, поэтому необязательно соединять каждый хост с каждым. В нашем случае, достаточно соединить new-pbx, например, только с pbx1 и DUNDi-запросы от pbx2 будут распространяться на new-pbx через pbx1 (если параметр ttl будет это позволять).

dundi.conf на new-pbx

[general]
department = new-pbx
organization = Organization
locality = Moscow
stateprov = MSK
country = RU
email = root@localhost
phone = 84950000000
  bindaddr = 0.0.0.0
port = 4520
entityid = 00:11:11:11:33:03
ttl = 5
autokill = 4000
cachetime = 600
secretpath = dundi
  [mappings]
direct => from-pbxs,0,IAX2,iax_dundi:${SECRET}@192.168.20.15/${NUMBER},nopartial
  [00:11:11:11:11:01]
model = symmetric
host = 192.168.10.111
inkey = pbx1
outkey = new-pbx
include = direct
permit = direct
qualify = yes>
order = primary

dundi.conf на pbx1 Нужно добавить:

[00:11:11:11:33:03]
model = symmetric
host = 192.168.20.15
inkey = new-pbx
outkey = pbx1
include = direct
permit = direct
qualify = yes
order = primary

После применения настроек, вызовы на трёхзначные номера должны заработать между всеми тремя хостами. Для резервирования, new-pbx можно соединить по DUNDi также и с pbx2.

Подписаться
Уведомить о
guest
0 комментариев
Межтекстовые Отзывы
Посмотреть все комментарии

Остались вопросы?

Я - Компаниец Никита, менеджер компании Voxlink. Хотите уточнить детали или готовы оставить заявку? Укажите номер телефона, я перезвоню в течение 3-х секунд.

VoIP оборудование


ближайшие курсы

10 доводов в пользу Asterisk

Распространяется бесплатно.

Asterisk – программное обеспечение с открытым исходным кодом, распространяется по лицензии GPL. Следовательно, установив один раз Asterisk вам не придется дополнительно платить за новых абонентов, подключение новых транков, расширение функционала и прочие лицензии. Это приближает стоимость владения станцией к нулю.

Безопасен в использовании.

Любое программное обеспечение может стать объектом интереса злоумышленников, в том числе телефонная станция. Однако, сам Asterisk, а также операционная система, на которой он работает, дают множество инструментов защиты от любых атак. При грамотной настройке безопасности у злоумышленников нет никаких шансов попасть на станцию.

Надежен в эксплуатации.

Время работы серверов некоторых наших клиентов исчисляется годами. Это значит, что Asterisk работает несколько лет, ему не требуются никакие перезагрузки или принудительные отключения. А еще это говорит о том, что в районе отличная ситуация с электроэнергией, но это уже не заслуга Asterisk.

Гибкий в настройке.

Зачастую возможности Asterisk ограничивает только фантазия пользователя. Ни один конструктор шаблонов не сравнится с Asterisk по гибкости настройки. Это позволяет решать с помощью Asterisk любые бизнес задачи, даже те, в которых выбор в его пользу не кажется изначально очевидным.

Имеет огромный функционал.

Во многом именно Asterisk показал какой должна быть современная телефонная станция. За многие годы развития функциональность Asterisk расширилась, а все основные возможности по-прежнему доступны бесплатно сразу после установки.

Интегрируется с любыми системами.

То, что Asterisk не умеет сам, он позволяет реализовать за счет интеграции. Это могут быть интеграции с коммерческими телефонными станциями, CRM, ERP системами, биллингом, сервисами колл-трекинга, колл-бэка и модулями статистики и аналитики.

Позволяет телефонизировать офис за считанные часы.

В нашей практике были проекты, реализованные за один рабочий день. Это значит, что утром к нам обращался клиент, а уже через несколько часов он пользовался новой IP-АТС. Безусловно, такая скорость редкость, ведь АТС – инструмент зарабатывания денег для многих компаний и спешка во внедрении не уместна. Но в случае острой необходимости Asterisk готов к быстрому старту.

Отличная масштабируемость.

Очень утомительно постоянно возвращаться к одному и тому же вопросу. Такое часто бывает в случае некачественного исполнения работ или выбора заведомо неподходящего бизнес-решения. С Asterisk точно не будет такой проблемы! Телефонная станция, построенная на Asterisk может быть масштабируема до немыслимых размеров. Главное – правильно подобрать оборудование.

Повышает управляемость бизнеса.

Asterisk дает не просто набор полезных функций, он повышает управляемость организации, качества и комфортности управления, а также увеличивает прозрачность бизнеса для руководства. Достичь этого можно, например, за счет автоматизации отчетов, подключения бота в Telegram, санкционированного доступа к станции из любой точки мира.

Снижает расходы на связь.

Связь между внутренними абонентами IP-АТС бесплатна всегда, независимо от их географического расположения. Также к Asterisk можно подключить любых операторов телефонии, в том числе GSM сим-карты и настроить маршрутизацию вызовов по наиболее выгодному тарифу. Всё это позволяет экономить с первых минут пользования станцией.