Почему я решил обновиться

За прошедшие годы изменился не только WordPress. Началась эпоха генеративного искусственного интеллекта, и вместе с ней возник более общий вопрос: нужны ли теперь такие технические блоги?

Я и сам стал заметно реже искать ответы в отдельных статьях. Во многих случаях проще задать вопрос ИИ, уточнить несколько деталей и получить объяснение именно в том виде, который нужен сейчас. Не приходится собирать ответ по кускам из документации, форумов и материалов десятилетней давности. С этой точки зрения возвращение к старому блогу может показаться немного странным. Зачем вкладывать время в сайт, если читатель всё равно спросит у нейросети? Но есть и другая сторона. ИИ хорошо обобщает уже существующие знания, однако этим знаниям всё равно нужно откуда-то появляться. Особую ценность имеют не очередные пересказы документации, а первичный опыт: что действительно заработало, где документация оказалась неполной, какие ограничения обнаружились в эксплуатации и что пришлось исправлять вручную. Именно такие материалы когда-то и составляли основную ценность UCExpert. Кроме того, мне не хотелось однажды потерять весь накопленный архив только потому, что устаревший движок больше невозможно запустить на современном сервере. Поэтому я решил сначала привести в порядок сам сайт, а вопрос о регулярности новых публикаций оставить открытым.

Старый WordPress

Исходное состояние было типичным для сайта, который долго работал без серьёзного обслуживания. Старый WordPress зависел от старой версии PHP. Обновить PHP мешала тема оформления Arthemia, разработчик которой давно прекратил выпускать новые версии. Тема, в свою очередь, использовала устаревшие функции WordPress и JavaScript-библиотеки прежних лет. Несколько старых плагинов тоже давно не поддерживались. Получилась цепочка зависимостей: нельзя обновить один компонент, не затронув остальные. Простое нажатие кнопки «Обновить» могло закончиться белой страницей, ошибками PHP или неработающей административной панелью. На руках у меня были архив файлов сайта и дамп базы данных. С них мы и начали. Я говорю «мы», потому что вторым участником этой работы стал Codex — ИИ-агент, который умеет разбирать проект, изменять код, запускать команды и проверять результат. Первым делом была собрана локальная копия сайта в Docker. WordPress с Apache и PHP работал в одном контейнере, база MySQL — в другом. Это позволило экспериментировать без риска для действующего сайта, повторять обновления с чистого состояния и перед каждым опасным изменением делать резервную копию. Основной принцип был простым: не переделывать всё сразу и не пытаться превратить старый блог в совершенно другой сайт. Мне хотелось сохранить узнаваемый вид UCExpert, но убрать технические ограничения, из-за которых он застрял в прошлом.

Этапы обновления

Со стороны работа с ИИ иногда выглядит почти магически: сформулировал задачу, подождал и получил готовый результат. В реальности этот проект выглядел иначе. За время обновления получилось около сотни коротких итераций. Я открывал сайт, проверял конкретный экран, находил новую проблему, присылал описание, снимок экрана или фрагмент журнала. Codex изучал связанный код, предлагал или сразу вносил исправление, после чего всё проверялось заново. Финальная серия изменений, связанных с развёртыванием сайта, была разделена на двенадцать отдельных коммитов.

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

Сложности при обновлении и переработки блога

Главной трудностью была не какая-то одна большая ошибка, а множество небольших несовместимостей. Панель настроек Arthemia сначала открывалась пустой. Когда её удалось вернуть, выяснилось, что блоки параметров нельзя перетащить в рабочую область: старый JavaScript рассчитывал на поведение библиотек, давно изменившееся в WordPress. Отдельно пришлось восстанавливать загрузчик изображений и другие элементы административного интерфейса. Некоторые страницы панели управления открывались примерно по двадцать секунд, хотя сам сайт отвечал быстро. Причиной оказался старый механизм проверки обновлений темы. Он пытался связаться с давно не существующим сервером разработчика и каждый раз ждал сетевого тайм-аута. После отключения этого механизма административная панель снова стала работать нормально.

В старом содержимом тоже нашлись неожиданные проблемы. Повреждённое изображение могло вызвать критическую ошибку при создании миниатюры. Блоки команд, которые когда-то красиво оформлялись плагином, после изменений превращались в красный текст или обычные абзацы. Встречались устаревшие и уже перехваченные посторонними владельцами ссылки. Несколько десятков материалов пришлось просматривать отдельно: восстанавливать разметку кода, исправлять явные опечатки, убирать лишние рамки у изображений и осторожно обновлять пояснения, не переписывая историю задним числом.

Даже отправка почты потребовала отдельного расследования. Один SMTP-порт на сервере оказался недоступен, а другой работал нормально. Чтобы отправка формы не заставляла посетителя ждать ответа внешнего почтового сервера, письма были вынесены в фоновую очередь с повторными попытками. Были и обычные инфраструктурные детали: получение HTTPS-сертификата зависит от DNS и доступности сервера извне; контейнер может сохранить старые файлы WordPress в томе даже после замены образа; а настройки сайта находятся не только в Git, но и в базе данных. Всё это пришлось не только исправить, но и подробно записать, чтобы через год не разгадывать собственную систему заново.

Результаты

Сейчас сайт работает на WordPress 7, PHP 8.3 и MySQL 8. Старую тему Arthemia удалось сохранить, но её код был адаптирован к современным версиям PHP и WordPress. Работают её настройки, административная панель, медиабиблиотека, виджеты и основные шаблоны страниц.

Все плагины были пересмотрены. Ненужные и заброшенные удалены, используемые обновлены, а изменения, которые должны переживать обновление сторонних компонентов, вынесены из их кода. Для сайта появились два небольших самостоятельных плагина: интерактивное облако тегов и собственная форма обратной связи.

Старые комментарии сохранены как часть материалов, но добавление новых отключено. Из базы формы обратной связи были удалены накопившиеся за годы тысячи спам-сообщений. Новая форма использует капчу, скрытое поле-приманку и ограничение частоты отправок. Сообщение сохраняется в базе на ограниченный срок, а его копия отправляется администратору по электронной почте.

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

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

Изменилась и серверная часть. Конфигурация хранится отдельно от содержимого сайта, секреты не попадают в репозиторий, база данных не публикуется в интернет. Caddy принимает веб-трафик и автоматически продлевает HTTPS-сертификаты. Доступ к административной панели можно ограничить доверенными адресами и сетями. Для файлов и базы подготовлены сценарии резервного копирования, восстановления и переноса на другой сервер.

В результате получился не просто сайт, который однажды удалось запустить, а воспроизводимая схема: её можно проверить локально, развернуть на новом сервере и восстановить из резервной копии.

О работе с ИИ

Для такого проекта ИИ оказался особенно полезен не потому, что написал много нового кода. Основная работа напоминала техническую археологию: прочитать чужой код пятнадцатилетней давности, понять его намерение, найти несовместимость, сопоставить её с журналами и аккуратно изменить только необходимое. Человеку такая работа быстро становится утомительной. Codex мог последовательно просматривать десятки файлов, искать одинаковые конструкции, сравнивать настройки, готовить сценарии миграции и одновременно вести техническую документацию. Он заметно ускорил путь от сообщения «здесь пустая страница» до конкретной причины в старом PHP или JavaScript. Но этот опыт не подтвердил идею, что ИИ можно просто оставить наедине с проектом. Ему требовалась обратная связь: как выглядит страница, соответствует ли результат оригиналу, действительно ли письмо пришло, не сломалась ли мобильная версия. Иногда он исправлял техническую проблему, но предлагал визуальное решение, которое мне не нравилось. Иногда новая правка обнаруживала более старую скрытую ошибку. Лучше всего сработало разделение ролей. Я определял, что важно сохранить, проверял сайт глазами пользователя и принимал решения. Codex быстро исследовал техническую часть, выполнял рутинную работу и фиксировал результат. Без одного из этих участников итог был бы хуже.

Будущее

Я пока не готов сказать, что UCExpert снова будет обновляться. Моя работа изменилась, а вместе с ней изменился и набор тем, о которых я могу писать на основании реального опыта.

Да и формат технической информации становится другим. Краткую справку, типовую конфигурацию или объяснение протокола сегодня действительно проще получить у ИИ. Вероятно, доля статей, которые лишь пересказывают документацию, будет уменьшаться. Но это не означает, что писать больше незачем. Скорее, возрастает ценность материалов, в которых есть личный опыт, проверяемый результат и контекст. ИИ может объяснить, как в общем случае обновляется WordPress, но сам по себе он не знает историю конкретного старого сайта, не видел его ошибок и не принимал решений о том, что стоит сохранить. Пока кто-то не опишет такой опыт, обобщать будет нечего.

Я не столько «вернул блог», сколько снова сделал продолжение возможным. Сайт больше не держится на версии PHP десятилетней давности, его можно резервировать, переносить и обновлять. А будет ли здесь следующая статья и о чём она окажется — теперь это снова содержательный вопрос, а не ограничение старого движка. UCExpert может оставаться живым архивом и иногда пополняться материалами, для которых у меня действительно есть собственные наблюдения. Эта статья — как раз один из таких материалов.

The post После семилетней паузы: как я обновил UCExpert с ИИ first appeared on Unified Communications Expert.

Задача: при помощи веб-форм размещённых на веб-сервере, добавлять удалять и просматривать правила сетевого фильтра iptables на удалённых серверах, также запускать ping и traceroute, получать результат вывода в веб-интерфейс. Такой функциона полезен для упрощения процесса конфигурирования сетевого экрана, позволяет исключить использование консоли при конфигурировании, и соответственно не давать доступ пользователям в shell, если есть дублирующие сервера, управлять правилами сетевых фильтров на всех одновременно.
Ниже представлена общая схема работы. Данный материал не приследует цель дать полную инструкцию по реализации такой схемы, а лишь даёт идею для реализации с некоторыми техническим подробностями.

Пользователь, при помощи веб-браузера, авторизуется (при помощи встроенного в веб-сервера Apache механизма) на странице, которая сорержит CGI-скрипт, когда пользователь добавляет удаляет или просматриваем правила в iptables через веб-форму, скрипт по ssh «дёргает» другие скрипты находящиеся на удалённом сервере и возвращает в веб-браузер клиента результат выполнения скрипта с удалённого сервера.

Процесс настройки выглядит следующим образом:
1) Настройка веб-сервера Apache и его работу с CGI
2) Защита логином и паролем директорию веб-сервера где находятся скрипты
3) Создание пользователя на удалённом хосте, где будут выполняться команды от CGI скриптов
при помощи ssh
4) Добавление прав пользователю на выполнения команд требующих повышения прав при помощи sudo
5) Загрузка bash скриптов обработчиков команд по ssh от веб-сервера на удалённом хосте
6) Разрешаем авторизацию по ключам для sshd
7) Настройка авторизации по ключам ssh
8) Загрузка bash скриптов в директорию CGI назначение им прав
9) Тестирование работы

Шаг 1. Настройка веб-сервера Apache и cgi

В Linux Centos открываем /etc/httpd/conf/ httpd.conf, находим строки:

ScriptAlias /cgi-bin/ "/var/www/cgi-bin/"
#
# "/var/www/cgi-bin" should be changed to whatever your ScriptAliased
# CGI directory exists, if you have that configured.
#
<Directory "/var/www/cgi-bin">
    #AllowOverride None
    AllowOverride All
    Options None
    Order allow,deny
    Allow from all
</Directory>

Здесь нас интересует параметр AllowOverride, который по умолчанию установлен как None, меняем её на AllowOverride All.

Далее рестартуем Apache:

/etc/init.d/httpd restart

Тоже самое, но для Debian, здесь будет отличаться настройка Apache.

Переходим в /etc/apache2/sites-available
создаём файл firewall-web
# > firewall-web
Порт 80 на котором будет находиться виртуальный хост:

Listen *:80
<VirtualHost *:80>
ServerAdmin ignat@spb.ru

DocumentRoot /usr/lib/cgi-bin
<Directory />
Options FollowSymLinks
AllowOverride None
</Directory>
ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
<Directory "/usr/lib/cgi-bin">
AllowOverride All
Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
Order allow,deny
Allow from all
</Directory>

ErrorLog ${APACHE_LOG_DIR}/error-firewall-web.log

# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.
LogLevel warn
CustomLog ${APACHE_LOG_DIR}/access-firewall-wb.log combined
</VirtualHost>

Сохраняем.

Далее переходим в директорию /etc/apache2/sites-enabled
И создаём символическую ссылку на /etc/apache2/sites-available/firewall-web

Теперь делаем reload конфигурации Apache:

#/etc/init.d/apache2 reload

Также нужно проверить что в /etc/apache2/mods-enabled есть ссылка на файл /etc/apache2/mods-available/cgi.load
Если нет, то создать, и перечитать конфигурацию веб-сервера:
#/etc/init.d/apache2 reload
Отлично, теперь надо защитить наши скрипты от неавторизованного доступа, один из простейших вариантов добавить http аутентификацию и авторизацию.

Шаг 2. Защита логином и паролем директорию веб-сервера где находятся скрипты

Настройка простой аутентификации и авторизации в Apache

Настраивается аутентификация либо в файле httpd.conf, либо в файле .htaccess. При настройке посредством .htaccess, необходимо сначала убедиться, что директива AllowOverride в файле httpd.conf разрешает получение настроек из файла .htaccess. Директива AllowOverride может принимать следующие значения:

— AllowOverride None — файлы .htaccess игнорируются веб-сервером. Данное значение оказывает положительное влияние на быстродействие веб-сервера.

— AllowOverride All — обрабатываются все без исключения директивы из файлов .htaccess.

— AllowOverride AuthConfig — разрешены директивы аутентификации-авторизации, такие как AuthName, AuthType, AuthUserFile, AuthGroupFile, Require и т.д.

Чтобы авторизация заработала, нам надо сделать следующее:

— Разрешить аутентификацию в конфигурационном файле Apache (файл httpd.conf)

— Прописать защищаемый ресурс в конфигурацию Apache (в файле .htaccess).

— Создать файл с паролями .htpasswd.

Далее, предполгаем что наши скрипты лежат в директории /var/www/cgi-bin/.
Мы защищаем директорию с нашими скриптами /var/www/cgi-bin/ поэтому создаём в ней файл .htaccess с правами apache:

#> .htaccess
#chown apache:apache .htaccess
В файл .htaccess добавим:
AuthName "Authentication"
AuthType Basic
AuthUserFile /var/www/cgi-bin/.htpasswd
require valid-user

Что обозначает каждая из директив:

AuthName – текст содержащийся в данной директиве, выводится в окне ввода пароля. Он должен быть написан в одну строку и заключен в двойные кавычки.
AuthType — типы аутентификации: Basic или Digest. Рекомендуется использовать первый, так как второй поддерживается не всеми браузерами.
AuthUserFile — полный путь к файлу с логинами и паролями, для аутентификации пользователей. Пароли содержаться в шифрованном виде. Рекомендуется хранить данный файл в папке, к которой нет доступа для пользователей, это необходимо, чтобы предотвратить кражу паролей.
require valid-user – директива предписывает, что к URL получают доступ только, пользователи, успешно прошедшие аутентификацию.

Сохраняем. Теперь нужно создать файл .htpasswd
Это делается при помощи утилиты htpasswd
Ключи:
-cm — ключи утилиты:
-с – указывает, что необходимо создать новый файл
-m –шифрует пароли по алгоритму MD5
.htpasswd – имя файла с паролями
firewall – логин
Создаём пользователя с новом файле:

#htpasswd -cm .htpasswd firewall

Дважды вводим пароль для пользователя firewall.
Листинг содержимого получившегося файла:

# cat .htpasswd
firewall:$apr1$xMW8mAaG$259lBs0uXj.M/t1Yu7T2u1

Добавить ещё одного пользователя в существующий файл:
#htpasswd -m .htpasswd ignat

Теперь при открытии адреса http://192.168.1.252/cgi-bin/ будет появляться окно авторизации:

После успешной перезагрузки переходим в директорию /usr/lib/cgi-bin и размещаем здесь файлы CGI-скриптов.

Шаг 3. Создание пользователя на удалённом хосте, где будут выполняться команды от CGI-скриптов при помощи ssh

Добавляем авторизацию по ключам ssh. Мы поставили веб-сервер Apache на одной машине 192.168.1.252, залить туда скрипты и при помощи команд SSH удалённо выполнять команды на хосте 192.168.1.16 и анализировать из результат, например:

ssh firewall-edit @192.168.1.16 'uptime'
13:32:59 up 584 days,  1:26,  4 users,  load average: 0.41, 0.34, 0.27

Для этого нужно настроить авторизацию по ключам на ssh-клиенте (192.168.1.252) и на удалённом ssh-сервере (192.168.1.16).

Создадим пользователя на удалённом сервере, дадим ему права на выполнение без пароля команд iptables и iptables-save:

#useradd firewall-edit  --create-home --comment 'Remote firewall editor' --shell /bin/bash
#passwd firewall-edit

Шаг. 4 Добавление прав пользователю на выполнения команд требующих повышения прав при помощи sudo

Отлично, теперь нужно добавить возможно выполнять команды iptables и iptables-save без прав root.
Пропишем в /etc/sudoers, из под root отредактируем данный файл:

#aptitiude install sudo
#sudoedit /etc/sudoers

Добавим следующие строки:

firewall-edit  ALL=(ALL) NOPASSWD:/sbin/iptables
firewall-edit  ALL=(ALL) NOPASSWD:/sbin/iptables-save

Сохраняем.

Шаг. 5 Загрузка bash скриптов обработчиков команд по ssh от веб-сервера на удалённом хосте

Конечно, можно посылать по ssh просто команды, затем обрабатывать их вывод на веб-сервере (192.168.1.252), но зачем «гонять» лишние данные? Поэтому загрузим скрипты которым будут передаваться нужные параметры, они буду их обрабатывать и выдавать результат, который мы передадим назад веб-серверу и покажем пользователю на веб-странице.

Ниже пример:

ucexpert.ru:/home/firewall-edit# cat firewall-find-ip.sh
#!/bin/bash 
sudo iptables -L CLIENTS -n -v --line-number| sed '1,1d'| grep $1 |  awk '{print "<tr><td>" $1 "</td><td>" $9 "</td></tr>"}'

Обращаю внимание что в вывод сразу же добавлена html разметка для отображении в веб-браузере клиента.
На стороне веб-сервера (192.168.1.252) этот скрипт будет вызываться так:

sudo ssh firewall-edit@192.168.1.16 "./firewall-find-ip.sh $IP"

Первый скрипт получает IP-адрес, ищет его в таблице и отправляет результат.

ucexpert.ru:/home/firewall-edit# cat firewall-get-ip.sh
#!/bin/bash 
sudo /sbin/iptables -L CLIENTS -n -v --line-number| sed '1,1d' |  awk '{print "<tr><td>" $1 "</td><td>" $9 "</td></tr>"}'

На стороне веб-сервера (192.168.1.252) этот скрипт будет передаваться как:

sudo ssh firewall-edit@192.168.1.16 './firewall-get-ip.sh'

Второй скрипт возвращает назад все правила с номерами (--line-number) в цепочке CLIENTS, в виде html таблицы.

Команды ping и traceroute будем запускать без скриптов.

sudo ssh firewall-edit@192.168.1.16 "ping $IP -I $RTU -c 5" 
sudo ssh firewall-edit@192.168.1.16 "traceroute $IP"

Создаём окружение для скриптов на 192.168.1.16

Создаём файл iptables в нашей домашней директории, сюда мы будем сохранять правила iptables.

/home/firewall-edit# > iptables

Копируем скрипты:

firewall-find-ip.sh
firewall-get-ip.sh
firewall.sh

Далее, назначаем необходимые права нашему пользователю, который будет удалённо выполнят команды:

#/home/firewall-edit# chown firewall-edit:firewall-edit firewall.sh
#/home/firewall-edit# chown firewall-edit:firewall-edit iptables

Скрипте на сервере запускаем при помощи sudo

#sudo /sbin/iptables -L -n -v | grep 84.84.84.84
#sudo ./firewall.sh add 84.84.84.84
#sudo ./firewall.sh del  84.84.84.84

Устанавливаем права на скрипты, пример:

#/home/firewall-edit# chown www-data:www-data firewall.sh
#/home/firewall-edit# chmod +x firewall.sh

Для отладки команд, которые передаются на удалённый сервер по SSH можно также использовать ttyrec или поставить утилиту snoopy:

ucexpert.ru:/home/firewall-edit# #aptitude install snoopy

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

ucexpert.ru:/home/firewall-edit# #tail -f /var/log/auth
Apr 13 11:25:43 rtu4-1 sshd[3273]: Accepted publickey for firewall-edit from 192.168.1.252 port 53822 ssh2
Apr 13 11:25:43 rtu4-1 sshd[3273]: pam_unix(sshd:session): session opened for user firewall-edit by (uid=0)
Apr 13 11:25:43 rtu4-1 sudo: firewall-edit : TTY=unknown ; PWD=/home/firewall-edit ; USER=root ; COMMAND=/sbin/iptables -L CLIENTS -n -v --line-number
Apr 13 11:25:43 rtu4-1 sshd[3296]: Received disconnect from 192.168.1.252: 11: disconnected by user

Шаг 6. Разрешаем авторизацию по ключам для sshd на удалённом хосте
Открываем /etc/ssh/sshd_config
Проверяем, что следующие строки присутствуют и не закомментированы:

RSAAuthentication yes
PubkeyAuthentication yes

После чего перезапускаем sshd.

Шаг 7. Настройка авторизации по ключам ssh

На клиенте (192.168.1.16) локальной машине нужно сгенерировать пару ключей:

приватный id_rsa – хранится у клиента в файле /home/$user/.ssh/id_rsa
публичный id_rsa.pub – хранится в файле /home/$user/.ssh/id_rsa.pub

Где $user пользователь который генерирует ключ. Для root этот путь будет /root/.ssh

Мы генерируем файл из под root, соответственно чтобы подключаться по ssh веб-сервере и пользователь www-data должны запускать ssh с правами root или sudo ssh.

Сгенерируем пару ключей на клиенте (192.168.1.252) при помощи утилиты ssh-keygen (если ключ уже создан для нового хоста его генерировать не требуется)

# ssh-keygen 
Generating public/private rsa key pair.
Enter file in which to save the key (/root/.ssh/id_rsa): 
Created directory '/root/.ssh'.
Enter passphrase (empty for no passphrase): 
Enter same passphrase again: 
Your identification has been saved in /root/.ssh/id_rsa.
Your public key has been saved in /root/.ssh/id_rsa.pub.
The key fingerprint is:
SHA256:GXgitSSV+S66HjiNW9A9pcehP3WECulLpi5tuPrt2bs root@CDR-serv
The key's randomart image is:
+---[RSA 2048]----+
|    ..+o         |
|     +o+   .     |
|    . *.= . .    |
|   . + O.= .     |
|  . . O.S . .    |
|   = +.=.. .     |
|  +o=...o        |
|  o*++   .       |
|.o+*B.Eo         |
+----[SHA256]-----+

Чтобы авторизоваться на 192.168.1.16, предварительно открытый или публичный ключ должен быть загружен на сервер, для этого загрузим ключ на сервер 192.168.1.16 при помощи утилиты ssh-copy-id:

# ssh-copy-id firewall-edit@192.168.1.16
/usr/bin/ssh-copy-id: INFO: Source of key(s) to be installed: "/root/.ssh/id_rsa.pub"
The authenticity of host '192.168.1.16 (192.168.1.16)' can't be established.
RSA key fingerprint is SHA256:Ma5zmprv9jGPkwdSwEgwFK2L4jyzCqc1xxoXYW5I7e0.
Are you sure you want to continue connecting (yes/no)? yes
/usr/bin/ssh-copy-id: INFO: attempting to log in with the new key(s), to filter out any that are already installed
/usr/bin/ssh-copy-id: INFO: 1 key(s) remain to be installed -- if you are prompted now it is to install the new keys
firewall-edit@192.168.1.16's password: 

Number of key(s) added: 1

Now try logging into the machine, with:   "ssh 'firewall-edit@192.168.1.16'"
and check to make sure that only the key(s) you wanted were added.

Таким образом ключ успешно инсталлирован.

Проверим работу авторизации по ключу:

# ssh firewall-edit@192.168.1.16 'uptime'
 18:13:03 up 582 days,  6:06,  2 users,  load average: 0.14, 0.21, 0.19

Теперь проверяем: из под пользователя firewall-edit заходим на удалённый хост по ключу и запускаем команду iptables.

# ssh firewall-edit@192.168.1.16 ' sudo /sbin/iptables -L -n -v '

Если будет возвращён вывод запущенной конфигурации iptables, то всё настроено правильно.
На этом настройка авторизации по ssh ключам завершена.

Шаг 8. Загрузка bash скриптов в директорию CGI веб-сервера 192.168.1.252 назначение им прав

Создаём окружение для скриптов на клиенте.

Здесь есть один важный момент: скрипты запускаются из под пользователя www-data
Чтобы запускать ssh с авторизацией по ключам надо повысить уровень прав, нам поможет sudo.
Пропишем в /etc/sudoers, из под root отредактируем данный файл:

#sudoedit /etc/sudoers

Добавим следующие строки:

www-data  ALL=(ALL) NOPASSWD: /usr/bin/ssh

Сохраняем.

Теперь создаём cgi скрипт который будет выполняться при открытии и успешной авторизации в веб-браузере ссылки http://192.168.1.252/cgi-bin

Листинг скрпита index.cgi с комментариями:

root@CDR-serv:/var/www/html/cgi-bin# cat index.cgi
#!/bin/bash
echo "Content-type: text/html"
echo ""
echo '<html>'
echo '<head>'
echo '<meta http-equiv="Content-Type" application/x-www-form-urlencoded; charset=UTF-8">'
#Загружаем favicon
echo '<link rel="icon" href="http://192.168.1.252/favicon.png" sizes="32x32" />'
echo '<link rel="shortcut icon" href="http://192.168.1.252/favicon.png" />'

#Заголовок страницы
echo '<title>FIREWALL EDITOR for RTU4 </title>'
echo '</head>'
echo '<body>'
#Заголовок 3 уровня на странице
echo '<h3>' RTU 4 FIREWALL EDITOR
echo '</h3>'
echo '<p>'Проветить есть IP-адрес в списке разрешённых \(можно ввести часть, например: 84.52.\) без маски или префикса сети:
echo '</p>'
#Начало формы поиска разрешённых IP-адресов в списке
echo "<form method="POST" action="find-ip-addr.cgi">"
 echo '<table nowrap>
                  <tr><td>IP-адрес</td><td><input type="text" name="IP" pattern="^[0-9\.]{3,15}$" size="12"> </td>
                                      </tr></table>
                                      <button type="submit">Проверить</button>
                                      <input type="reset" value="Очистить"> </form>'
echo '<p>'Добавить IP-адрес и префикс сети \(опционально, например 29\):
echo '</p>'
echo "<form method="POST" action="firewall-add.cgi">"
 echo '<table nowrap>
                  <tr><td>IP-адрес</td><td><input type="text" name="IP" pattern="^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$" size=12></td></tr>
                            <tr><td>Префикс сети</td><td><input type="text" pattern="[0-9]{1,2}" name="MASK" size=12 value=""></td></tr>
                                <tr><td>Комментарий: </td><td><textarea rows="5" cols="22" autocomplete="off" placeholder="Опционально" name="COMMENT" ></textarea> </td>
                                      </tr></table>
                                      <button type="submit">Добавить</button>
                                      <input type="reset" value="Очистить"> </form>'

#Конец формы поиска IP-адрес в списке разрешённых, при нажатии кнопки "Проверить" выполнится скрипт find-ip-addr.cgi причём он примет единственный аргумент IP и в браузер вернётся результат выполнения скрипта
echo '<p>'Удалить IP-адрес \(без маски или префикса сети\):
echo '</p>'

#Начало формы добавления IP-адреса или подсети в список разрешённых, тут кроме аргумента IP - адреса и MASK - маску IP которую следует удалить, может опционально передаваться комментарий
echo '<p>'Добавить IP-адрес и префикс сети \(опционально, например 29\):
echo '</p>'

echo "<form method="POST" action="firewall-add.cgi">"
 echo '<table nowrap>
                  <tr><td>IP-адрес</td><td><input type="text" name="IP" pattern="^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$" size=12></td></tr>
                            <tr><td>Префикс сети</td><td><input type="text" pattern="[0-9]{1,2}" name="MASK" size=12 value=""></td></tr>
                                <tr><td>Комментарий: </td><td><textarea rows="5" cols="22" autocomplete="off" placeholder="Опционально" name="COMMENT" ></textarea> </td>
                                      </tr></table>
                                      <button type="submit">Добавить</button>
                                      <input type="reset" value="Очистить"> </form>'

#Конец формы добавления IP-адреса в списке разрешённых, при нажатии кнопки "Добавить" выполнится скрипт firewall-add.cgi, с входными аргументами - IP-адрес и маску, опционально комментарий и в браузер вернётся результат выполнения скрипта			
				
#Аналогично, начало формы удаления IP-адреса из iptables.				
echo '<p>'Удалить IP-адрес \(без маски или префикса сети\):
echo '</p>'

echo "<form method="POST" action="firewall-del.cgi">"
 echo '<table nowrap>
                  <tr><td>IP-адрес</TD><TD><input type="text" name="IP" pattern="^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$" size=12></td></tr>
                 <tr><td>Комментарий: </td><td><textarea rows="5" cols="22" autocomplete="off" placeholder="Опционально" name="COMMENT" ></textarea> </td>
                                      </tr></table>
                                      <button type="submit">Удалить</button>
                                      <input type="reset" value="Очистить"> </form>'
									  
#Конец формы. При нажатии на кнопку "Удалить" выполнится скрипт firewall-del.cgi

#Форма отображения полного списка разрешённых IP-адресов
echo '<p>' Показать полный список разрешенныйх IP-адресов для транков РТУ 4
echo '</p>'
echo "<form method="POST" action="get-ip-list.cgi"> <button type="Submit"/>Показать</button></form>"
#Конец формы отображения полного списка разрешённых IP-адресов.
echo '</body>'
echo '</html>'
exit

При обращении к веб-серверу по адресу http://192.168.1.252/cgi-bin/ выполняется скрипт написанный на языке bash, а результат его выполения отдаётся веб-сервером в веб-браузер клиенту который запросил страницу, логично что это должен быть код HTML (хотя и не обязательно)
А а вот как будет выгядеть html-код страницы когда скрипт index.cgi будет выполнен и результат его работы будет возращён в веб-браузер клиента.

<html>
<head>
<meta http-equiv="Content-Type" application/x-www-form-urlencoded; charset=UTF-8">
<link rel="icon" href="http://192.168.1.252/favicon.png" sizes="32x32" />
<link rel="shortcut icon" href="http://192.168.1.252/favicon.png" />
<title>FIREWALL EDITOR for RTU4 and NET DIAGNOSTIC</title>
</head>
<body>

<h3> RTU 4 FIREWALL EDITOR
</h3>

Листинг скрпита find-ip-addr.cgi который запускается из скрпита index.cgi при использовании веб-формы поиска IP-адреса:

Проветить есть IP-адрес в списке разрешённых (можно ввести часть, например: 84.52.) без маски или префикса сети:

<form method=POST action=find-ip-addr.cgi>

<table nowrap>
                  
<tr>
<td>IP-адрес</td>
<td><input type="text" name="IP" pattern="^[0-9\.]{3,15}$" size="12"> </td>

                                      </tr>
</table>

                                      <button type="submit">Проверить</button>
                                      <input type="reset" value="Очистить"> </form>

Добавить IP-адрес и префикс сети (опционально, например 29):

<form method=POST action=firewall-add.cgi>

<table nowrap>
                  
<tr>
<td>IP-адрес</td>
<td><input type="text" name="IP" pattern="^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$" size=12></td>
</tr>

<tr>
<td>Префикс сети</td>
<td><input type="text" pattern="[0-9]{1,2}" name="MASK" size=12 value=""></td>
</tr>

<tr>
<td>Комментарий: </td>
<td><textarea rows="5" cols="22" autocomplete="off" placeholder="Опционально" name="COMMENT" ></textarea> </td>

                                      </tr>
</table>

                                      <button type="submit">Добавить</button>
                                      <input type="reset" value="Очистить"> </form>

Удалить IP-адрес (без маски или префикса сети):

<form method=POST action=firewall-del.cgi>

<table nowrap>
                  
<tr>
<td>IP-адрес</TD>
<TD><input type="text" name="IP" pattern="^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$" size=12></td>
</tr>

<tr>
<td>Комментарий: </td>
<td><textarea rows="5" cols="22" autocomplete="off" placeholder="Опционально" name="COMMENT" ></textarea> </td>

                                      </tr>
</table>

                                      <button type="submit">Удалить</button>
                                      <input type="reset" value="Очистить"> </form>

 Показать полный список разрешенныйх IP-адресов для транков РТУ 4

<form method=POST action=get-ip-list.cgi> <button type=Submit/>Показать</button></form>

</body>
</html>

Здесь скриптом генеририуются html формы, затем этими веб-формами может воспользоваться клиент, к каждой веб-форме привязан скрипт (например, find-ip-addr.cgi), который также выполниться при запуске веб-формы и вернет результат обработки. Этот скрипт «лезет» на удалённый сервер, запускает другой скрипт, например firewall.sh и возвращает результат назад, затем результат в виде веб-страницы возвращается пользователю.

Теперь рассмотрим файл find-ip-addr.cgi

#!/bin/bash

echo "Content-type: text/html"
echo ""
echo '<html>'

echo '<head>'

echo '
 <style type="text/css">
   TABLE {
    width: 300px; /* Ширина таблицы */
    border-collapse: collapse; /* Убираем двойные линии между ячейками */
   }
   TD, TH {
    padding: 3px; /* Поля вокруг содержимого таблицы */
    border: 1px solid black; /* Параметры рамки */
    text-align: center;
   }
   TH {
    background: #b0e0e6; /* Цвет фона */
   }
    hr {
    border: none; /* Убираем границу */
    background-color: black; /* Цвет линии */
    color: black; /* Цвет линии для IE6-7 */
    height: 2px; /* Толщина линии */
   }
}
html,
body {
  height: 100%;
}
.wrapper {
  display: flex;
  flex-direction: column;
  height: 100%;
}
.content {
  flex: 1 0 auto;
}
.footer {
  flex: 0 0 auto;
}
  </style>'

echo '<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">'
echo '<link rel="icon" href="http://192.168.1.252/favicon.png" sizes="32x32" />'
echo '<link rel="stylesheet" href="http://www.megacorp.com/style.css" type="text/css">'

echo '<title>Firewall</title>'

echo '</head>'

echo '<body>'

echo '<h3>'Результат поиска:
echo '</h3>'
DATE=`date +%Y-%m-%d-%H:%M:%S`

if [ "$REQUEST_METHOD" = "POST" ]; then
    QUERY_STRING=`cat -`
    fi
    #echo `cat -` #Дебаг
    #echo "QUERY_STRING ==><> $QUERY_STRING </br>" #Дебаг
    IP=`echo $QUERY_STRING | sed -n 's/^.*IP=\([^&]*\).*$/\1/p' | sed "s/%20/ /g"` #Дебаг
    COMMENT=`echo $QUERY_STRING | sed -n 's/^.*COMMENT=\([^&]*\).*$/\1/p' | sed "s/%20/ /g"` #Дебаг
    REMOTE_USER=`echo $REMOTE_USER`
    REMOTE_ADDR=`echo $REMOTE_ADDR`
    HTTP_USER_AGENT=`echo $HTTP_USER_AGENT`
    #echo "IP ==> $IP </br>" #Дебаг
    echo "<b>Результат поиска для введённого IP-адреса: $IP </b></br></br>"
echo "<b>Найдены правила в таблице брандмауэра РТУ 4:</b></br></br>"
echo '<table border=1 cellpadding="4" cellspacing="0">'
echo '<td>№ Правила</td><td>IP-адрес или подсеть</td></tr>'
sudo ssh firewall-edit@192.168.1.16 "./firewall-find-ip.sh $IP"
export LANG="ru_RU.UTF-8" # Это очень важный момент, без неё скрипту insert-log.py не передаётся аргумент закодированный кириллицей
echo '</table>'
echo '<pre>'
./insert-log.py "$DATE" "ПОИСК" "$IP" "N/A" "$REMOTE_ADDR" "$REMOTE_USER" "$HTTP_USER_AGENT" "N/A" "$COMMENT"
echo '</pre>'
./get-ip-history.py "$IP"
echo "<br><br><small>Дата запроса: $DATE </small></br>"
echo "<small>Пользователь: $REMOTE_USER </small></br>"
echo "<small>Ваш адрес: $REMOTE_ADDR </small></br>"
echo '</body>'
echo '</html>'

Ниже пример листинга скрипта firewall-find-ip.sh который выполняется на 192.168.1.16 который ищет запрошенные пользователем правила iptables.

#!/bin/bash 
sudo iptables -L CLIENTS -n -v --line-number| sed '1,1d'| grep $1 |  awk '{print "<tr><td>" $1 "</td><td>" $9 "</td></tr>"}

Шаг 9. Тестирование работы

Вот как выглядит веб-страница сгенерированная index.cgi:

Мы запускаем поиск первых трёх актетов IP-адреса, например 84.52.72

и нажимаем кнопку «Проверить». Ниже результат:

Найдено несколько правил и они выведены в виде таблицы. Что произошло: пользователь загрузил страницу index.cgi с несколькими формами, передал переменную 84.52.72 в форму поиска IP-адреса, которая в свою очередь передала управление CGI-скрипту find-ip-addr.cgi данный скрипт выполняет команду

sudo ssh firewall-edit@192.168.1.16 "./firewall-find-ip.sh $IP"

То есть, подключается к удалённому серверу 192.168.1.16, выполняет на нём скрипт firewall-find-ip.sh и возвращает результат в веб-браузер клиенту.

Автор: Игнат Кудрявцев

The post Управление iptables при помощи CGI-скриптов first appeared on Unified Communications Expert.

В консоли Asterisk посмотрим описание функции HANGUPCAUSE.

CLI> core show function HANGUPCAUSE

  -= Info about function 'HANGUPCAUSE' =-

[Synopsis]
Gets per-channel hangupcause information from the channel.

[Description]
Gets technology-specific or translated Asterisk cause code information from the
channel for the specified channel that resulted from a dial.

[Syntax]
HANGUPCAUSE(channel,type)

[Arguments]
channel
    The name of the channel for which to retrieve cause information.
type
    Parameter describing which type of information is requested. Types are:
    tech - Technology-specific cause information
    ast - Translated Asterisk cause code

[See Also]
HANGUPCAUSE_KEYS, HangupCauseClear()

Всё достаточно просто. Но есть нюанс, что каналы, которые участвовали в соединении, могут не иметь коды отбоев.
Поэтому в Asterisk есть специальная функция HANGUPCAUSE_KEYS, которая содержим имена каналов, содержащие коды отбоя:

*CLI> core show function HANGUPCAUSE_KEYS

  -= Info about function 'HANGUPCAUSE_KEYS' =-

[Synopsis]
Gets the list of channels for which hangup causes are available.

[Description]
Returns a comma-separated list of channel names to be used with the HANGUPCAUSE
function.

[Syntax]
HANGUPCAUSE_KEYS()

[Arguments]
Not available

[See Also]
HANGUPCAUSE, HangupCauseClear()

Всё вместе это выглядит так:

h => {

if ($[${LEN(${HANGUPCAUSE_STRING})} = 0])
 goto stop;

NoOp(SIP cause:  ${HANGUPCAUSE(${HANGUPCAUSE_KEYS()},tech)});
NoOp(Ast cause:  ${HANGUPCAUSE(${HANGUPCAUSE_KEYS()},ast)});
NoOp(Hangupcause keys: ${HANGUPCAUSE_KEYS()});
Set(CDR(userfield)=${HANGUPCAUSE(${HANGUPCAUSE_KEYS()},tech)} | ${HANGUPCAUSE(${HANGUPCAUSE_KEYS()},ast)} |  ${HANGUPCAUSE_KEYS()});

stop:
 NoOp(HANGUPCAUSE is empty);
};

В дайлплане удачный звонок на номер 5500:

-- Channel SIP/CCM61-WC-00006071 left 'simple_bridge' basic-bridge <5e218c7f-08e4-402b-a201-9fe95e43645c>
    -- Channel SIP/AST-CC-ERT-2-00006070 left 'simple_bridge' basic-bridge <5e218c7f-08e4-402b-a201-9fe95e43645c>
  == Spawn extension (ERT-IN, 5500, 6) exited non-zero on 'SIP/AST-CC-ERT-2-00006070'
    -- Executing [h@ERT-IN:1] NoOp("SIP/AST-CC-ERT-2-00006070", "SIP cause:  SIP 200 OK") in new stack
    -- Executing [h@ERT-IN:2] NoOp("SIP/AST-CC-ERT-2-00006070", "Ast cause:  Normal Clearing") in new stack
    -- Executing [h@ERT-IN:3] NoOp("SIP/AST-CC-ERT-2-00006070", "Hangupcause keys: SIP/CCM61-WC-00006071") in new stack
    -- Executing [h@ERT-IN:4] Set("SIP/AST-CC-ERT-2-00006070", "CDR(userfield)=SIP 200 OK | Normal Clearing | SIP/CCM61-WC-00006071") in new stack

То есть в бридже у нас были каналы SIP/CCM61-WC-00006071 и SIP/AST-CC-ERT-2-00006070, первым брижд покинул Channel SIP/CCM61-WC-00006071, то есть он является инициатором отбоя, но в переменной HANGUPCAUSE_KEYS() содержится только код отбоя второго канала SIP/AST-CC-ERT-2-00006070.

Теперь, посмотрим что содержит сама переменная:

• Translated Asterisk cause code: Normal Clearing
• Translated Asterisk cause code: SIP 200 OK

Если вызов состоялся, а переменная пустая, то значит ни один канал не содержал кода отбоя.

Возьмём звонок на сервис, то есть по сути с одним плечом SIP, в таком случае переменная HANGUPCAUSE_KEYS() будет пустая:

[Jan 22 18:17:15] WARNING[13817][C-0000306d]: func_hangupcause.c:140 hangupcause_read: Unable to find information for channel
    -- Executing [h@WC-IN:1] NoOp("SIP/CCM61-WC-0000608c", "SIP cause:  ") in new stack
[Jan 22 18:17:15] WARNING[13817][C-0000306d]: func_hangupcause.c:140 hangupcause_read: Unable to find information for channel
    -- Executing [h@WC-IN:2] NoOp("SIP/CCM61-WC-0000608c", "Ast cause:  ") in new stack
    -- Executing [h@WC-IN:3] NoOp("SIP/CCM61-WC-0000608c", "Hangup keys: ") in new stack
[Jan 22 18:17:15] WARNING[13817][C-0000306d]: func_hangupcause.c:140 hangupcause_read: Unable to find information for channel
[Jan 22 18:17:15] WARNING[13817][C-0000306d]: func_hangupcause.c:140 hangupcause_read: Unable to find information for channel
    -- Executing [h@WC-IN:4] Set("SIP/CCM61-WC-0000608c", "CDR(userfield)= |  |  ") in new stack

Вызов который завершился неудачей:

-- Got SIP response 503 "Service Unavailable" back from 10.101.1.7:5060
    -- SIP/ASTERISK-ERT-1-00006090 is circuit-busy
  == Everyone is busy/congested at this time (1:0/1/0)
    -- Executing [22000@WC-IN:7] NoOp("SIP/CCM61-WC-0000608f", "CONGESTION") in new stack
    -- Executing [22000@WC-IN:8] Goto("SIP/CCM61-WC-0000608f", "sw_378_CONGESTION,10") in new stack
    -- Goto (WC-IN,sw_378_CONGESTION,10)
    -- Executing [sw_378_CONGESTION@WC-IN:10] Hangup("SIP/CCM61-WC-0000608f", "") in new stack
  == Spawn extension (WC-IN, sw_378_CONGESTION, 10) exited non-zero on 'SIP/CCM61-WC-0000608f'
    -- Executing [h@WC-IN:1] NoOp("SIP/CCM61-WC-0000608f", "SIP cause:  SIP 503 Service Unavailable") in new stack
    -- Executing [h@WC-IN:2] NoOp("SIP/CCM61-WC-0000608f", "Ast cause:  Circuit/channel congestion") in new stack
    -- Executing [h@WC-IN:3] NoOp("SIP/CCM61-WC-0000608f", "Hangup keys: SIP/ASTERISK-ERT-1-00006090") in new stack
    -- Executing [h@WC-IN:4] Set("SIP/CCM61-WC-0000608f", "CDR(userfield)=SIP 503 Service Unavailable | Circuit/channel congestion | SIP/ASTERISK-ERT-1-00006090 ") in new stack

Посмотрим что содержит сама переменная:

• Hangup keys: SIP/ASTERISK-ERT-1-00006090
• Translated Asterisk cause code: Circuit/channel congestion
• Translated Asterisk cause code: SIP 503 Service Unavailable

Я заметил, что если lastapp в CDR != Hangup, а Dial, то поля в CDR которые я пытаюсь обновить CDR(userfield|dialstatus) не обновляются, вот пример с одним uniqueid и две записи:

mysql> select * from  cdr where uniqueid=1548253072.2783;
+-----+---------------------+----------------------------+--------+-------------+----------+-----------------------+-----------------------------+---------+------------------------------+----------+---------+-------------+----------+-------------+-----------------+------------+--------------------------------------------------------------+
| id  | calldate            | clid                       | src    | dst         | dcontext | channel               | dstchannel                  | lastapp | lastdata                     | duration | billsec | disposition | amaflags | accountcode | uniqueid        | dialstatus | userfield                                                    |
+-----+---------------------+----------------------------+--------+-------------+----------+-----------------------+-----------------------------+---------+------------------------------+----------+---------+-------------+----------+-------------+-----------------+------------+--------------------------------------------------------------+
| 986 | 2019-01-23 17:17:52 | "Kudr Ignat" <015166> | 015166 | 12345       | WC-IN    | SIP/CCM61-WC-00000706 | SIP/ASTERISK-ERT-1-00000707 | Dial    | SIP/ASTERISK-ERT-1/12345,,tT |        4 |       0 | BUSY        |        3 |             | 1548253072.2783 |            |                                                              |
| 987 | 2019-01-23 17:17:56 | "Kudr Ignat" <015166> | 015166 | sw_525_BUSY | WC-IN    | SIP/CCM61-WC-00000706 |                             | Hangup  |                              |        0 |       0 | BUSY        |        3 |             | 1548253072.2783 |            | SIP 486 Busy Here | User busy |  SIP/ASTERISK-ERT-1-00000707 |
+-----+---------------------+----------------------------+--------+-------------+----------+-----------------------+-----------------------------+---------+------------------------------+----------+---------+-------------+----------+-------------+-----------------+------------+--------------------------------------------------------------+
2 rows in set (0.01 sec)

Это связано с тем, что вызов хоть и попал на h, но CDR не записался на диск.
Who Hung Up? Asterisk Wiki

По ссылке описывается более сложный пример, в нём мы разбираем пременную HANGUPCAUSE_KEYS(), ведь он в теории может содержать больше имени одного канала, и тогда в моём примере попросту будет ошибка. Но у меня было максимум 1 переменная.

Приведу пример ниже:

[foo]
exten => s,1,Dial(SIP/bar)
 
exten => h,1,noop()
exten => h,n,set(HANGUPCAUSE_STRING=${HANGUPCAUSE_KEYS()})
; start loop
exten => h,n(hu_begin),noop()
 
; check exit condition (no more array to check)
exten => h,n,gotoif($[${LEN(${HANGUPCAUSE_STRING})} = 0]?hu_exit)
 
; pull the next item
exten => h,n,set(ARRAY(item)=${HANGUPCAUSE_STRING})
exten => h,n,set(HANGUPCAUSE_STRING=${HANGUPCAUSE_STRING:${LEN(${item})}})
 
; display the channel ID and cause code
exten => h,n,noop(got channel ID ${item} with pvt cause ${HANGUPCAUSE(${item},tech)})
 
; check exit condition (no more array to check)
exten => h,n,gotoif($[${LEN(${HANGUPCAUSE_STRING})} = 0]?hu_exit)
 
; we still have entries to process, so strip the leading comma
exten => h,n,set(HANGUPCAUSE_STRING=${HANGUPCAUSE_STRING:1})
; go back to the beginning of the loop
exten => h,n,goto(hu_begin)
exten => h,n(hu_exit),noop(All HANGUPCAUSE entries processed)

Можно создать свою таблицу CDR или содержащую иную информацию по вкусу и записывать в БД.
В примере ниже, по результатам вызова, в таблицу Mysql c именем cdr_custom записываются нужные переменные CDR плюс коды отбоя, ниже приводится подробный пример.

Предпологается? что мы будем использовать ранее созданное MySQL ODBC соединение.
Все поля, кроме dialstatus и REL будем брать из функции CDR().

Переменная REL формируется из функции HANGUPCAUSE:

Set(REL=${HANGUPCAUSE(${HANGUPCAUSE_KEYS()},tech)} | ${HANGUPCAUSE(${HANGUPCAUSE_KEYS()},ast)} |  ${HANGUPCAUSE_KEYS()});

Переменная ${DIALSTATUS} также стандартная переменная.

${DIALSTATUS}: This is the status of the call
    CHANUNAVAIL
    CONGESTION
    NOANSWER
    BUSY
    ANSWER
    CANCEL
    DONTCALL: For the Privacy and Screening Modes. Will be set if the called
    party chooses to send the calling party to the 'Go Away' script.
    TORTURE: For the Privacy and Screening Modes. Will be set if the called
    party chooses to send the calling party to the 'torture' script.
    INVALIDARGS

Ниже строка дайлплана Asterisk:

NoOp(${CDR(uniqueid)},${CDR(start)},${CDR(clid)},${CDR(src)},${CDR(dst)},${CDR(dcontext)},${CDR(channel)},${CDR(dstchannel)},${CDR(duration)},${CDR(billsec)},${CDR(disposition)},${DIALSTATUS},${REL})

В консоли Asterisk строка выше с подставленными переменными будет выглядить так:

1548251202.2649,2019-01-23 16:46:42,"79210001122" <79210001122>,79210001122,600,WC-IN,SIP/CCM61-WC-000006aa,SIP/AST-CC-ERT-1-000006ab,409,409,ANSWERED,ANSWER,SIP 200 OK | Normal Clearing

Теперь все эти переменные нужно записать подготовленную для этих целей таблицу MySQL при помощи функции ODBC которая будет вызаться из дайлплана на экстеншене h.

Создадим новую таблицу cdr_custom в БД MySQL

mysql> use ertx_ast_cdr;
mysql> CREATE TABLE cdr_custom ( 
        id int(11) unsigned NOT NULL auto_increment PRIMARY KEY,
        uniqueid varchar(32) NOT NULL default '', 
        calldate datetime NOT NULL default '0000-00-00 00:00:00', 
        clid varchar(80) NOT NULL default '', 
        src varchar(80) NOT NULL default '', 
        dst varchar(80) NOT NULL default '', 
        dcontext varchar(80) NOT NULL default '', 
        channel varchar(80) NOT NULL default '', 
        dstchannel varchar(80) NOT NULL default '', 
        duration int(11) NOT NULL default '0', 
        billsec int(11) NOT NULL default '0', 
        disposition varchar(45) NOT NULL default '', 
        dialstatus varchar(17) NOT NULL default '' ,cause varchar(120) NOT NULL default '' );

mysql> desc cdr_custom;
+-------------+------------------+------+-----+---------------------+----------------+
| Field       | Type             | Null | Key | Default             | Extra          |
+-------------+------------------+------+-----+---------------------+----------------+
| id          | int(11) unsigned | NO   | PRI | NULL                | auto_increment |
| uniqueid    | varchar(32)      | NO   |     |                     |                |
| calldate    | datetime         | NO   |     | 0000-00-00 00:00:00 |                |
| clid        | varchar(80)      | NO   |     |                     |                |
| src         | varchar(80)      | NO   |     |                     |                |
| dst         | varchar(80)      | NO   |     |                     |                |
| dcontext    | varchar(80)      | NO   |     |                     |                |
| channel     | varchar(80)      | NO   |     |                     |                |
| dstchannel  | varchar(80)      | NO   |     |                     |                |
| duration    | int(11)          | NO   |     | 0                   |                |
| billsec     | int(11)          | NO   |     | 0                   |                |
| disposition | varchar(45)      | NO   |     |                     |                |
| dialstatus  | varchar(17)      | NO   |     |                     |                |
| cause       | varchar(120)     | NO   |     |                     |                |
+-------------+------------------+------+-----+---------------------+----------------+
14 rows in set (0.00 sec)

Теперь создадим функцию в /etc/asterisk/func_odbc.conf

[INSERT_CUSTOM_CDR]
dsn=asterisk
writesql=INSERT INTO cdr_custom (uniqueid,calldate,clid,src,dst,dcontext,channel,dstchannel,duration,billsec,disposition,dialstatus,cause) VALUES ('${ARG1}','${ARG2}','${ARG3}','${ARG4}','${ARG5}','${ARG6}','${ARG7}','${ARG8}','${ARG9}','${ARG10}','${ARG11}','${ARG12}','${ARG13}')

Настала очередь dialplan.

Ловим вызова на специальном экстеншене h куда попадает вызов после заверешния:

>h => {
Set(REL=${HANGUPCAUSE(${HANGUPCAUSE_KEYS()},tech)} | ${HANGUPCAUSE(${HANGUPCAUSE_KEYS()},ast)} |  ${HANGUPCAUSE_KEYS()});
Set(ODBC_INSERT_CUSTOM_CDR(${CDR(uniqueid)},${CDR(start)},${CDR(clid)},${CDR(src)},${CDR(dst)},${CDR(dcontext)},${CDR(channel)},${CDR(dstchannel)},${CDR(duration)},${CDR(billsec)},${CDR(disposition)},${DIALSTATUS},${REL})=);

{

Причём обращаю внимание, что для записи значений из dialplan в ODBC нужно использовать SET!!!

Если в дайлплане используется case

Тогда в CDR в столбце dst может быть вместо Б-номера может быть значение sw_564_CHANUNAVAIL или что-то похожее вместо Б-номера:

mysql> select * from ertx_ast_cdr.cdr_custom where src in ('49000','015136') and calldate >= '2019-03-06 09:00:00';
+-------+------------------+---------------------+---------------------------+--------+--------------------+----------+-----------------------+-----------------------------+----------+---------+-------------+------------+------------------------------------------------------------------+
| id    | uniqueid         | calldate            | clid                      | src    | dst                | dcontext | channel               | dstchannel                  | duration | billsec | disposition | dialstatus | cause                                                            |
+-------+------------------+---------------------+---------------------------+--------+--------------------+----------+-----------------------+-----------------------------+----------+---------+-------------+------------+------------------------------------------------------------------+
| 27633 | 1551942737.86893 | 2019-03-07 10:12:17 | Kudryavcev Ignat <015136> | 015136 | 450000              | WC-IN    | SIP/CCM61-WC-0000de97 | SIP/ASTERISK-ERT-1-0000de98 |        2 |       0 | NO ANSWER   | CANCEL     | SIP 180 Ringing | Normal Clearing |  SIP/ASTERISK-ERT-1-0000de98 |
| 27634 | 1551942783.86900 | 2019-03-07 10:13:03 | Kudryavcev Ignat <015136> | 015136 | sw_564_CHANUNAVAIL | WC-IN    | SIP/CCM61-WC-0000de9d |                             |        0 |       0 | CONGESTION  | CONGESTION |  |  |  SIP/ASTERISK-ERT-2-0000de9f                               |
| 27635 | 1551942795.86906 | 2019-03-07 10:13:15 | Kudryavcev Ignat <015136> | 015136 | 450000              | WC-IN    | SIP/CCM61-WC-0000dea0 | SIP/ASTERISK-ERT-1-0000dea1 |        2 |       0 | NO ANSWER   | CANCEL     | SIP 180 Ringing | Normal Clearing |  SIP/ASTERISK-ERT-1-0000dea1 |
| 27636 | 1551942821.86912 | 2019-03-07 10:13:41 | Kudryavcev Ignat <015136> | 015136 | sw_577_BUSY        | WC-IN    | SIP/CCM61-WC-0000dea5 |                             |        0 |       0 | BUSY        | BUSY       | SIP 486 Busy here | User busy |  SIP/ASTERISK-ERT-1-0000dea6     |

Ниже пример Dialplan в котором может возникнуть такая ситуация:

_[56]XX => {
            NoOp(Call from Westcall);
            //Set(CALLERID(num)=01${CALLERID(num)});
            Set(CALLERID(num)=${IF($[${LEN(${CALLERID(num)})} = 4]?01${CALLERID(num)}:${CALLERID(num)})});
            Verbose(!!! DEBUG Call from Westcall to ERTEL from ${CALLERID(num)} ${CALLERID(name)} --called-number-> ${EXTEN} !!!);
            Verbose(!!! ${CALLERID(all)} !!!);
            Set(_REAL_DST=${EXTEN});
            Dial(SIP/${EXTEN}@AST-CC-ERT-1,,tT);
            //Dial(SIP/5136@10.10.10.10);
            NoOp(${DIALSTATUS});
            switch(${DIALSTATUS}) {
        case BUSY:
                  Hangup;
        case ANSWER:
                  Hangup;
        case NOANSWER:
                  Hangup;
        case CONGESTION:
                  Hangup;
        default:
                  Dial(SIP/${EXTEN}@AST-CC-ERT-2,,tT);
                  Hangup;

В данном примере, мы пытаемся перемаршрутизировать вызов на резервный сервер в зависимости от ответа основного.
Поэтому сохраним набранный номер в переменную Set(_REAL_DST=${EXTEN});

Затем при сохранении CDR заменим сохранение dst как ${CDR(dst)} на ${REAL_DST}

На Asterisk перезагрузить func_odbc.so и dialplan (dialplan reload/ael reload)

voip-gate-aster*CLI> module reload func_odbc.so
Module 'func_odbc.so' reloaded successfully.
    -- Reloading module 'func_odbc.so' (ODBC lookups)
  == Parsing '/etc/asterisk/func_odbc.conf': Found
  == Unregistered custom function ODBC_PRESENCE
  == Unregistered custom function ODBC_ANTIGF
  == Unregistered custom function ODBC_SQL
  == Registered custom function 'ODBC_SQL'
  == Registered custom function 'ODBC_ANTIGF'
  == Registered custom function 'ODBC_PRESENCE'
  == Registered custom function 'ODBC_INSERT_CUSTOM_CDR'
  
  voip-gate-aster*CLI> odbc write ODBC_
ODBC_ANTIGF      ODBC_PRESENCE    ODBC_INSERT_CUSTOM_CDR  ODBC_SQL

Запустим в dialplan:

-- Executing [h@WC-IN:1] Set("SIP/CCM61-WC-000006fa", "REL=SIP 200 OK | Normal Clearing |  SIP/ASTERISK-ERT-1-000006fb") in new stack
    -- Executing [h@WC-IN:2] Set("SIP/CCM61-WC-000006fa", "ODBC_INSERT_CUSTOM_CDR(1548252647.2763,2019-01-23 17:10:47,"" <015139>,015139,450000,WC-IN,SIP/CCM61-WC-000006fa,SIP/ASTERISK-ERT-1-000006fb,1,1,ANSWERED,ANSWER,SIP 200 OK | Normal Clearing |  SIP/ASTERISK-ERT-1-000006fb)=") in new stack

В таблице CDR:

mysql> select * from  cdr_custom  order by id desc limit 2;
+-----+-----------------+---------------------+---------------------------+-------------+-------+----------+---------------------------+-----------------------------+----------+---------+-------------+------------+-------------------------------------------------------------+
| id  | uniqueid        | calldate            | clid                      | src         | dst   | dcontext | channel                   | dstchannel                  | duration | billsec | disposition | dialstatus | cause                                                       |
+-----+-----------------+---------------------+---------------------------+-------------+-------+----------+---------------------------+-----------------------------+----------+---------+-------------+------------+-------------------------------------------------------------+
| 230 | 1548253896.2820 | 2019-01-23 17:31:36 | Kudr Ignat <015040>   | 015040      | 450000 | WC-IN    | SIP/CCM61-WC-0000071c     | SIP/ASTERISK-ERT-1-0000071d |       56 |      36 | ANSWERED    | ANSWER     | SIP 200 OK | Normal Clearing |  SIP/ASTERISK-ERT-1-0000071d |
| 229 | 1548253402.2799 | 2019-01-23 17:23:22 | 79053332211 <79053332211> | 79053332211 | 5500  | ERT-IN   | SIP/AST-CC-ERT-2-0000070e | SIP/CCM61-WC-0000070f       |      348 |     348 | ANSWERED    | ANSWER     | SIP 200 OK | Normal Clearing |  SIP/CCM61-WC-0000070f       |
+-----+-----------------+---------------------+---------------------------+-------------+-------+----------+---------------------------+-----------------------------+----------+---------+-------------+------------+-------------------------------------------------------------+
2 rows in set (0.00 sec)

Как в Asterisk узнать, какая из сторон была инициатором отбоя?

Пример дайлплана:

exten => _1XX,1,Set(HANGUPSIDE=originator)
exten => _1XX,2,Dial(SIP/${EXTEN},,g)
exten => _1XX,3,Set(HANGUPSIDE=terminator)
exten => _1XX,4,NoOp(${HANGUPSIDE})
exten => h,1,NoOp(${HANGUPSIDE})

На первом шаге мы устанавливаем, что по умолчанию в переменной HANGUPSIDE оригинатор завершит вызов.
На втором шаге мы отправляем вызов терминатору, но указываем, в приложении Dial опцию g.
Что такое опция g описано в Help Asterisk:

g: Proceed with dialplan execution at the next priority in the current
    extension if the destination channel hangs up.

Без опций, приложение Dial, после отбоя любой из сторон передаёт вызов сразу же на экстеншен h текущего контекста, выполнение следующего шага дайлплана не происходит.
Если поставить опцию g, то следующий шаг дайлплана после Dial будет выполняться если терминирующий канал первым завершил вызов, в данном случае установка переменной HANGUPSIDE равной terminator.
Таким образом легко установить, какая сторона является инициатором завершения, что иногда может очень сильно помочь в диагностике проблем.

Автор: Игнат Кудрявцев

The post Получение кодов отбоя SIP и стороны завершившей вызов в Asterisk first appeared on Unified Communications Expert.

Смысл в том, что пользователь вводит номер телефона своего смартфона\планшета\компьютера через веб-форму авторизации в Wi-Fi сети, далее, пользователь выбирает каким способом он подтвердит, что это действительно его мобильный номер: при помощи отправки SMS-сообщения или звонком на номер телефона, где ему должна проиграться голосовая подсказка о успешности\неуспешности авторизации, в зависимости от языка интерфейса (русский, английский, французский, немецкий или испанский). Голосовая платформа Asterisk\FreeSWITCH передаёт номер позвонившего серверу авторизации, сервер сверяет телефонный номер полученный через веб-форму с номером, который передала голосовая платформа, в ответ возвращается успешный или неуспешный код. Сообщение должно проигрываться в предответном состоянии до начала тарификации, чтобы абонент не платил деньги за звонок. Так как Asterisk и FreeSWITCH в этой схеме выполняют функции медиасерверов, будем называть далее их именно так.
Терминация из телефонных сетей на медиасерверы работала через два транковых шлюза Eltex SMG1016M, голосовых платформ тоже две: первая Asterisk 15.3.0 установленный на ОС Linux Debian 9.4, вторая FreeSWITCH Version 1.6.20 установленная на ОС Linux Debian 8.10. В июне 2018 FreeSWITCH ещё не поддерживал ОС Linux Debian 9 для «продакшен» режима.
Asterisk и FreeSWITCH запущены на виртуальных машинах, основные пики нагрузки приходились, когда начинались футбольные матчи.
Главный минус схемы с такой авторизацией – иногда из телефонной сети общего пользования может приходить искажённый номер вызывающего абонента (А-номер), в таком случае пользователь не будет авторизован, хотя правильно указал свои данные. Данная ситуация была замечена у одного сотового оператора для парных номеров: федеральный номер плюс местный городской номер в которых равны последние 7 цифр номера.

Техническая реализация

Создан пул телефонных номеров равный количеству языков – 5, звонки на любой из 5 телефонных номеров по очереди попадает на шлюзы SMG1016: 192.168.25.8 и 192.168.25.9, на каждом из шлюзов созданы транковые направления терминации состоящие из двух транковых групп, по одной на медиасервер (Asterisk и FreeSWITCH), алгоритм работы направлений для терминации: последовательно вперёд.

Транковое направление SMG

Заметку по маршрутизации на шлюзах Элекс SMG можно найти по данной ссылке.
Оба шлюза подключены к городской АТС, где также создана группа терминации с алгоритмом работы по очереди. Такая схема даёт равномерное распределение нагрузки по шлюзам и медиасерверам.
Когда медиасервер получает вызов, он делает запрос по http на сервер авторизации куда в формате JSON передаёт номер телефонный позвонившего и телефонный номер для авторизации куда позвонил пользователь:

data={'user_phone': user_phone,'gw_phone': gw_phone}

В ответ сервер передаёт код ответа и результат в формате:

resultCode=1&resultMessage=accepted

Если,

• resultCode = 1 – проиграть подсказку об успешной авторизации
• Любой другой код – проиграть сообщение об ошибке

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

Медиасервер Asterisk

IP-адрес=192.168.25.32

Здесь из дайлплана при помощи AGI вызываем внешний скрипт, который сделает запрос на сервер и вернёт результат.

Настройка внешних каналов SIP для приёма трафика от шлюзов, файл /etc/asterisk/sip.conf

[FIFA-1]
type=peer
context=FIFA-IN
host=192.168.25.8 ;Шлюз 1 SMG1016M
insecure=port,invite
disallow=all
allow=ulaw
nat=no
canreinvite=no
use_q850_reason = yes

[FIFA-2]
type=peer
context=FIFA-IN
host=192.168.25.9 ;Шлюз 2 SMG1016M
insecure=port,invite
disallow=all
allow=ulaw
nat=no
canreinvite=no
use_q850_reason = yes

Здесь вызовы с любого из двух шлюзов отправляются в контекст FIFA-IN.
Дайлплан Asterisk, файл /etc/asterisk/extensions.ael
Приведу только первые два номера, напомню, что всего языков подсказок 5 и номеров столько же, соответственно.

context FIFA-IN
{
78120002915 => {
        AGI(get-res.py,${CALLERID(num)},${EXTEN:1});
Set(CDR(userfield)=${ANSWER});
NoOp(RES => ${RES});
        switch (${RES}) {
                    case 1:
                    Progress();
                    Playback(/var/lib/asterisk/sounds/fifa/success_readyRUS1,noanswer);
                    Busy(10);
                    Hangup(16);
                  default:
                    Progress();
                    Playback(/var/lib/asterisk/sounds/fifa/Fail_RUS1,noanswer);
                    //Playback(/var/lib/asterisk/sounds/ru/agent-alreadyon,noanswer);
                    Busy(10);
                    Hangup(16);

                };
        };

78120002916 => {                                                                //English
        AGI(get-res.py,${CALLERID(num)},${EXTEN:1});
Set(CDR(userfield)=${ANSWER});
NoOp(RES => ${RES});
        switch (${RES}) {
                    case 1:
                    Progress();
                    Playback(/var/lib/asterisk/sounds/fifa/Success_readyEN1,noanswer);
                    Busy(10);
                    Hangup(16);
                  default:
                    Progress();
                    Playback(/var/lib/asterisk/sounds/fifa/Fail_EN1,noanswer);
                    //Playback(/var/lib/asterisk/sounds/ru/agent-alreadyon,noanswer);
                    Busy(10);
                    Hangup(16);

                };
        };

};

Любой вызов, пришедший со шлюзов 192.168.25.8 и 192.168.25.9 попадает в контекст FIFA-IN дайлплана Asterisk, здесь, в зависимости от одного из пяти набранных номеров, вызов попадает на нужный экстеншен, например, 78120002916, при помощи приложения AGI вызывается внешний скрипт из директории по умолчанию /var/lib/asterisk/agi-bin. Результат работы скрипта передаётся оператору выбора case, далее, приложение Progress() указывает Asterisk что не нужно посылать SIP 200OK, что равно соединению и началу тарификации, а проиграть голосовое сообщение в режиме предответа (early media) с помощью приложения Playback, затем послать сигнал занято — Busy(10) и повесить трубку Hangup. Аудиофайлы, которые нужно проиграть загружаются в /var/lib/asterisk/sounds/ru/.
Для контроля содержимого ответа в CDR Asterisk добавим содержимое переменной ANSWER при помощи приложения Set,
Set(CDR(userfield)=${ANSWER});
Далее, в примере CDR содержимое полученного значения переменной будет продемонстрировано.
Ниже два примера скрипта написанные на bash и Python3, скрипты передают номера и возвращают в дайлплан результат.
#cat /var/lib/asterisk/agi-bin/get-res.sh

#!/bin/bash

res=`curl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d"user_phone=$1&gw_phone=$2" http://wfff-loginpage:8008/ivr_auth| sed -n 's/^.*resultCode=\([^&]*\).*$/\1/p' | sed "s/%20/ /g"`

echo $res
echo -e "SET VARIABLE RES $res";
sleep 0
exit 0

Здесь я использовал консольную утилиту curl для http запроса на сервер авторизации. Кстати, последняя строчка exit 0, иначе в консоли Asterisk будут появляться ошибки результаты работы AGI-скрипта.
Ниже аналогичный скрипт на языке Python3, который я использовал в «боевой» конфигурации.

#!/usr/bin/env python3

import requests
from sys import argv
user_phone,gw_phone = argv[1:]
answer = requests.post('http://wfff-loginpage:8008/ivr_auth',headers={'Content-Type': 'application/x-www-form-urlencoded'},data={'user_phone': user_phone,'gw_phone': gw_phone})
#res='resultCode=0&resultMessage=rejected'
answer=str(answer.content)
print("SET VARIABLE RES %s" % answer[13] +"\n"+"SET VARIABLE ANSWER %s" % answer)

Здесь я использовал отличный модуль для http запросов requests. На этом настройка Asterisk закончена.

В CDR вызовы будут выглядить так:

"","+00000637658","sw_5_0","FIFA-IN",""""" <+00000637658>","SIP/FIFA-1-000034c0","","Busy","10","2018-07-15 18:54:34",,"2018-07-15 18:54:41",7,0,"BUSY","DOCUMENTATION","1531670074.27007","b'resultCode=0&resultMessage=rejected'"

"","79060003159","sw_4_1","FIFA-IN",""""" <79060003159>","SIP/FIFA-2-000034c1","","Busy","10","2018-07-15 18:55:22",,"2018-07-15 18:55:31",8,0,"BUSY","DOCUMENTATION","1531670122.27010","b'resultCode=1&resultMessage=accepted'"

По мониторингу Asterisk использую следующие основные параметры, ниже пример конфигурации для Zabbix файл /etc/zabbix/zabbix_agentd.conf в UserParameter:

### Option: UserParameter
#Текущие вызовы
UserParameter=asterisk.core.show.calls,/usr/bin/sudo /usr/sbin/asterisk -rx 'core show calls' | grep active| awk '{print $1}'
#Текущие каналы SIP
UserParameter=asterisk.sip.show.channels,/usr/bin/sudo /usr/sbin/asterisk -rx 'sip show channels' | grep "active SIP dialog" | awk '{print $1}'
#Обработанные звонки, накопительный счётчик
UserParameter=asterisk.sip.show.calls.processed,/usr/bin/sudo /usr/sbin/asterisk -rx 'core show calls' | grep processed | awk '{print $1}'

Медиасервер FreeSWITCH

IP-адрес=192.168.25.32
У FreeSWITCH есть встроенный модуль curl.
Нам надо добавить модуль mod_curl поэтому, при компиляции снимаем комментарий с требуемых модулей в
/usr/src/freeswitch/modules.conf

languages/mod_python
applications/mod_curl

Сохраняем. Запускаем конфигурирование, сборку и инсталляцию ещё раз:

./configure
make
make install

Теперь в конфигурационных файлах FreeSWITCH /usr/local/freeswitch/conf/autoload_configs/modules.conf.xml, удаляем комментарии:

<load module="mod_curl"/>
<load module="mod_python"/>

Проверим что модуль есть:

#fs_cli
$fs_cli
freeswitch@FS1.6> module_exists mod_python
true
freeswitch@FS1.6> module_exists mod_curl
true

В файле /freeswitch/conf/autoload_configs/switch.conf.xml можно увеличить следующие параметры:

<param name="max-sessions" value="1000"/>
    <!--Most channels to create per second -->
    <param name="sessions-per-second" value="30"/>
    <!-- Default Global Log Level - value is one of debug,info,notice,warning,err,crit,alert -->
    <param name="loglevel" value="debug"/>

Внешние каналы SIP, добавим новый профиль:

#touch /freeswitch/conf/sip_profiles/fifa.xml

Добавим в файл следующие строки:

<settings>
    <param name="debug" value="0"/>
    <param name="sip-trace" value="no"/>
    <param name="sip-capture" value="no"/>
    <param name="rfc2833-pt" value="101"/>
    <param name="sip-port" value="$${external_sip_port}"/>
    <param name="dialplan" value="XML"/>
    <param name="context" value="fifa"/>
    <param name="dtmf-duration" value="2000"/>
    <param name="inbound-codec-prefs" value="$${global_codec_prefs}"/>
    <param name="outbound-codec-prefs" value="$${outbound_codec_prefs}"/>
    <param name="hold-music" value="$${hold_music}"/>
    <param name="rtp-timer-name" value="soft"/>
    <param name="local-network-acl" value="localnet.auto"/>
    <param name="manage-presence" value="false"/>
  <param name="rtp-ip" value="192.168.25.32"/>
    <param name="sip-ip" value="192.168.25.32"/>
  </settings>

Значение $${external_sip_port} это глобальный параметр, его значение указано в /freeswitch/conf/vars.xml, и выглядит так: external_sip_port=5080.

Запустим наш новый профиль:

freeswitch@wfff-media2> sofia profile fifa start
Reload XML [Success]
fifa started successfully

В консоли Linux, проверим, что IP и порт прослушивает FreeSWITCH:

root@wfff-media2:/freeswitch/conf/sip_profiles# netstat -anp | grep 5080
tcp        0      0 192.168.25.32:5080      0.0.0.0:*               LISTEN      5499/freeswitch
udp        0      0 192.168.25.32:5080      0.0.0.0:*                           5499/freeswitch

Теперь переходим к настройке дайлплана, файл /freeswitch/conf/dialplan/fifa.xml:

<include>
  <context name="fifa">
<extension name="FIFA_NUM_POOL" continue="true">
    <condition field="destination_number" expression="^(.*)$">
            <action application="curl" data="http://wfff-loginpage:8008/ivr_auth content-type 'application/x-www-form-urlencoded' post user_phone=${caller_id_number}&gw_phone=${destination_number:1}" inline="true"/>
            <!--action application="set" data="answer=resultCode=0&resultMessage=rejected"/-->
            <!--action application="set" data="respdata=${curl_response_data}"/-->
            <action application="set" data="result=${curl_response_data:11:1}" inline="true"/>
            <action application="log" data="INFO result is ${result}" inline="true"/>
    </condition>
    <condition field="destination_number" expression="^78120002915$" break="on-true">   <!-- Russian -->
        <action application="log" data="ANI NUMBER IS ${ani} "/>
        <action application="log" data="78120002915 WARNING RESULT IS ${result} "/>
        <action application="pre_answer"/>
        <action application="playback" data="${cond(${result} == 1 ? /usr/local/freeswitch/sounds/fifa/success_readyRUS1.wav : /usr/local/freeswitch/sounds/fifa/Fail_RUS1.wav)}"/>
        <action application="sleep" data="3000"/>
        <action application="hangup" data="USER_BUSY"/>
    </condition>
        <condition field="destination_number" expression="^78120002916$" break="on-true"> <!-- English -->
        <action application="log" data="RESULT IS ${result} "/>
        <action application="pre_answer"/>
        <action application="playback" data="${cond(${result} == 1 ? /usr/local/freeswitch/sounds/fifa/Success_readyEN1.wav : /usr/local/freeswitch/sounds/fifa/Fail_EN1.wav"/>
        <action application="hangup" data="USER_BUSY"/>
    </condition>
 </context>
 </include>

Затем перезагружаем дайлплан:

freeswitch@wfff-media2> reloadxml
+OK [Success]

2019-02-22 13:32:23.277861 [INFO] mod_enum.c:879 ENUM Reloaded
2019-02-22 13:32:23.277861 [INFO] switch_time.c:1423 Timezone reloaded 1750 definitions

Всё, на этом настройка закончена.

Что происходит в дайлплан?

В модуль SIP медиасервера FreeSWITCH (использует Sofia) приходит вызов, в соответствии с созданным sip профилем FIFA вызов направляется в контекст fifa для обработки.
Контекст fifa содержит единственный эктеншен с именем FIFA_NUM_POOL. В первое условие (condition) содержит правило

<condition field="destination_number" expression="^(.*)$">

Поэтому туда попадает любой позвонивший пользователь. Начинается первая фаза ROUTING – формирования найденного по совпавшим в условиям списка действий (actions) TODO. Значение break в первом условии (condition) отсутствует, это равно break=”on-false”, то есть
не проверять следующее условие condition, если это условие ложно, но оно всегда в нашем случае истинно. Далее, проверяются остальные условия conditions которые содержат 5 номеров, соответствующих языку, на котором воспроизводятся голосовые подсказки, в примере я показываю только два номера 78120002915 и 78120002916. Когда условие по номеру позвонившего или destination_number совпадает с набранным пользователем номером, срабатывает директива break=»on-true», что значит прервать просмотр условий (condition) и запустить те условия, которые совпали. То есть первое и второе, одно из пяти. Причём условия как бы стекируются и связаны межу собой оператором И (AND).
Список на выполнение или TODO список действии (action) составлен, начинается фаза выполнения State EXECUTE.
Запускается первое приложение curl:

<action application="curl" data="http://wfff-loginpage:8008/ivr_auth content-type 'application/x-www-form-urlencoded' post user_phone=${caller_id_number}&gw_phone=${destination_number:1}"/>

Мы отправляем сообщение POST в формате JSON номер звонящего и номер телефона на который позвонили, при этому удаляем первую цифру номера.
В ответ получаем ответ, наподобие

resultCode=1&resultMessage=accepted

Приложение curl возвращает результа в стандартную переменную curl_response_data
Так как интересующее нас значение находится в 11 символе, извлечём её при помощи конструкции

<action application="set" data="result=${curl_response_data:11:1}" inline="true"/>

и присвоим переменной result.
Здесь запускается приложение curl, которое проверяет телефонный номер и возвращает результат в переменную ${result}. Далее, выполняются действия из второго найденного условия, во-первых

<action application="pre_answer"/>

означает что мы будем проигрывать сообщение в предответном состоянии, без начала тарификации.
Следующее действие:

<action application="playback" data="${cond(${result} == 1 ? /usr/local/freeswitch/sounds/fifa/success_readyRUS1.wav : /usr/local/freeswitch/sounds/fifa/Fail_RUS1.wav)}"/>

Тут мы воспроизводим файл success_readyRUS1.wav, если значение переменной ${result}=1 или файл Fail_RUS1.wav в противном случае.
Сследующие действия:

<action application="sleep" data="3000"/>
        <action application="hangup" data="USER_BUSY"/>

Ждём 3000 миллисекунд и запускаем приложение «отбой» с кодом USER_BUSY или SIP 486.
Результат в CDR FreeSWITCH представлен ниже.
Если абонент авторизован:

"70002783772","70002783772","78120002915","fifa","2018-07-17 13:40:58","","2018-07-17 13:41:05","7","0","ORIGINATOR_CANCEL","c6337123-7a94-4ba2-96ee-17d00d2e460b","","","PCMA","PCMA","resultCode=1&resultMessage=accepted"

Если абоненту отказано в авторизации:

"70002254963","70002254963","78120002918","fifa","2018-07-17 17:13:23","","2018-07-17 17:13:34","11","0","USER_BUSY","854529fc-62c6-479a-8c10-4c639fa624d9","","","PCMA","PCMA","resultCode=0&resultMessage=rejected"

Как видно, в cdr отображается содержимое переменной ${curl_response_data}

Чтобы добавить её в CDR, нужно сделать следующее:

Открыть на редактирование файл /usr/local/freeswitch/conf/autoload_configs/cdr_csv.conf.xml, далее, смотрим какой используется темплейт для CDR:

<param name=«default-template» value=«example»/>

Затем, в

<template name=«example»>

добавляем в конце по образцу «${curl_response_data}»
Получится:

<template name="example">"${caller_id_name}","${caller_id_number}","${destination_number}","${context}","${start_stamp}","${answer_stamp}","${end_stamp}","${duration}","${billsec}","${hangup_cause}","${uuid}","${bleg_uuid}","${accountcode}","${read_codec}","${write_codec}","${curl_response_data}"</template>

Сохраняем.

Затем делаем перезагрузку модуля из fs_cli

freeswitch@debian8> reload mod_cdr_csv

Ниже лог примера выполнения дайлплана FreeSWITCH.

====Вызов пришёл в модуль Sofia SIP====

2019-02-22 17:38:40.497865 [NOTICE] switch_channel.c:1104 New Channel sofia/fifa/79500090900@192.168.25.9 [dac48249-f16f-4026-b176-d29d0719b8dc]
2019-02-22 17:38:40.497865 [DEBUG] switch_core_state_machine.c:584 (sofia/fifa/79500090900@192.168.25.9) Running State Change CS_NEW (Cur 1 Tot 13675)
2019-02-22 17:38:40.497865 [DEBUG] sofia.c:9873 sofia/fifa/79500090900@192.168.25.9 receiving invite from 192.168.25.9:5060 version: 1.6.20 git 43a9feb 2018-05-07 18:56:11Z 64bit
2019-02-22 17:38:40.497865 [DEBUG] sofia.c:7084 Channel sofia/fifa/79500090900@192.168.25.9 entering state [received][100]
2019-02-22 17:38:40.497865 [DEBUG] sofia.c:7094 Remote SDP:
v=0
o=- 1060 847210 IN IP4 192.168.25.9
s=SMG SIP session
c=IN IP4 192.168.25.9
t=0 0
m=audio 25862 RTP/AVP 8 0
a=rtpmap:8 PCMA/8000
a=rtpmap:0 PCMU/8000
a=ptime:20

2019-02-22 17:38:40.497865 [DEBUG] sofia.c:7486 (sofia/fifa/79500090900@192.168.25.9) State Change CS_NEW -> CS_INIT
2019-02-22 17:38:40.497865 [DEBUG] switch_core_state_machine.c:603 (sofia/fifa/79500090900@192.168.25.9) State NEW
2019-02-22 17:38:40.497865 [DEBUG] switch_core_state_machine.c:584 (sofia/fifa/79500090900@192.168.25.9) Running State Change CS_INIT (Cur 1 Tot 13675)
2019-02-22 17:38:40.497865 [DEBUG] switch_core_state_machine.c:627 (sofia/fifa/79500090900@192.168.25.9) State INIT
2019-02-22 17:38:40.497865 [DEBUG] mod_sofia.c:90 sofia/fifa/79500090900@192.168.25.9 SOFIA INIT
2019-02-22 17:38:40.497865 [DEBUG] switch_core_state_machine.c:40 sofia/fifa/79500090900@192.168.25.9 Standard INIT
2019-02-22 17:38:40.497865 [DEBUG] switch_core_state_machine.c:48 (sofia/fifa/79500090900@192.168.25.9) State Change CS_INIT -> CS_ROUTING
2019-02-22 17:38:40.497865 [DEBUG] switch_core_state_machine.c:627 (sofia/fifa/79500090900@192.168.25.9) State INIT going to sleep
2019-02-22 17:38:40.517818 [DEBUG] switch_core_state_machine.c:584 (sofia/fifa/79500090900@192.168.25.9) Running State Change CS_ROUTING (Cur 1 Tot 13675)
2019-02-22 17:38:40.517818 [DEBUG] switch_channel.c:2249 (sofia/fifa/79500090900@192.168.25.9) Callstate Change DOWN -> RINGING
2019-02-22 17:38:40.517818 [DEBUG] switch_core_state_machine.c:643 (sofia/fifa/79500090900@192.168.25.9) State ROUTING
2019-02-22 17:38:40.517818 [DEBUG] mod_sofia.c:143 sofia/fifa/79500090900@192.168.25.9 SOFIA ROUTING
2019-02-22 17:38:40.517818 [DEBUG] switch_core_state_machine.c:236 sofia/fifa/79500090900@192.168.25.9 Standard ROUTING
2019-02-22 17:38:40.517818 [INFO] mod_dialplan_xml.c:637 Processing 79500090900 <79500090900>->78120002915 in context fifa

=== Вызов ушёл в контекст fifa =====

Dialplan: sofia/fifa/79500090900@192.168.25.9 parsing [fifa->FIFA_NUM_POOL] continue=false
Dialplan: sofia/fifa/79500090900@192.168.25.9 Regex (PASS) [FIFA_NUM_POOL] destination_number(78120002915) =~ /^(.*)$/ break=on-false

===Условие сработало, добавить действия в этом условии в TODO список, фаза 1 ===

Dialplan: sofia/fifa/79500090900@192.168.25.9 Action curl(http://wfff-loginpage:8008/ivr_auth content-type 'application/x-www-form-urlencoded' post user_phone=${caller_id_number}&gw_phone=${destination_number:1})
Dialplan: sofia/fifa/79500090900@192.168.25.9 Action set(result=${curl_response_data:11:1})
Dialplan: sofia/fifa/79500090900@192.168.25.9 Action log(INFO result is ${result})
Dialplan: sofia/fifa/79500090900@192.168.25.9 Regex (FAIL) [FIFA_NUM_POOL] ani(79500090900) =~ /^71110007780$/ break=on-true
Dialplan: sofia/fifa/79500090900@192.168.25.9 Regex (PASS) [FIFA_NUM_POOL] destination_number(78120002915) =~ /^78120002915$/ break=on-true

===Условие destination_number(78120002915)  сработало, добавить действия в этом условии в TODO список, другие условия проверяться не будут так как установлено break=on-true ===

Dialplan: sofia/fifa/79500090900@192.168.25.9 Action log(ANI NUMBER IS ${ani} )
Dialplan: sofia/fifa/79500090900@192.168.25.9 Action log(78120002915 WARNING RESULT IS ${result} )
Dialplan: sofia/fifa/79500090900@192.168.25.9 Action pre_answer()
Dialplan: sofia/fifa/79500090900@192.168.25.9 Action playback(${cond(${result} == 1 ?  /usr/local/freeswitch/sounds/fifa/success_readyRUS1.wav : /usr/local/freeswitch/sounds/fifa/Fail_RUS1.wav)})
Dialplan: sofia/fifa/79500090900@192.168.25.9 Action sleep(3000)
Dialplan: sofia/fifa/79500090900@192.168.25.9 Action hangup(USER_BUSY)
2019-02-22 17:38:40.517818 [DEBUG] switch_core_state_machine.c:286 (sofia/fifa/79500090900@192.168.25.9) State Change CS_ROUTING -> CS_EXECUTE
2019-02-22 17:38:40.517818 [DEBUG] switch_core_state_machine.c:643 (sofia/fifa/79500090900@192.168.25.9) State ROUTING going to sleep
2019-02-22 17:38:40.517818 [DEBUG] switch_core_state_machine.c:584 (sofia/fifa/79500090900@192.168.25.9) Running State Change CS_EXECUTE (Cur 1 Tot 13675)
2019-02-22 17:38:40.517818 [DEBUG] switch_core_state_machine.c:650 (sofia/fifa/79500090900@192.168.25.9) State EXECUTE
2019-02-22 17:38:40.517818 [DEBUG] mod_sofia.c:198 sofia/fifa/79500090900@192.168.25.9 SOFIA EXECUTE
2019-02-22 17:38:40.517818 [DEBUG] switch_core_state_machine.c:328 sofia/fifa/79500090900@192.168.25.9 Standard EXECUTE

====Начало запуска условии в состоянии EXECUTE, фаза 2. Выполняются действия из совпавших условий.

EXECUTE sofia/fifa/79500090900@192.168.25.9 curl(http://wfff-loginpage:8008/ivr_auth content-type 'application/x-www-form-urlencoded' post user_phone=79500090900&gw_phone=8120002915)
2019-02-22 17:38:40.517818 [DEBUG] mod_curl.c:182 method: post, url: http://wfff-loginpage:8008/ivr_auth, content-type: application/x-www-form-urlencoded
2019-02-22 17:38:40.517818 [DEBUG] mod_curl.c:211 Post data: user_phone=79500090900&gw_phone=8120002915
EXECUTE sofia/fifa/79500090900@192.168.25.9 set(result=0)

=== От curl получен результат 0 ===

2019-02-22 17:38:40.557875 [DEBUG] mod_dptools.c:1548 SET sofia/fifa/79500090900@192.168.25.9 [result]=[0]
EXECUTE sofia/fifa/79500090900@192.168.25.9 log(INFO result is 0)
2019-02-22 17:38:40.557875 [INFO] mod_dptools.c:1742 result is 0
EXECUTE sofia/fifa/79500090900@192.168.25.9 log(ANI NUMBER IS 79500090900 )
2019-02-22 17:38:40.557875 [DEBUG] mod_dptools.c:1742 NUMBER IS 79500090900
EXECUTE sofia/fifa/79500090900@192.168.25.9 log(78120002915 WARNING RESULT IS 0 )
EXECUTE sofia/fifa/79500090900@192.168.25.9 pre_answer()

=== Состояние предответа ===

2019-02-22 17:38:40.557875 [INFO] mod_dptools.c:1355 Sending early media
2019-02-22 17:38:40.557875 [DEBUG] switch_core_media.c:4449 Audio Codec Compare [PCMA:8:8000:20:64000:1]/[opus:116:48000:20:0:1]
2019-02-22 17:38:40.557875 [DEBUG] switch_core_media.c:4449 Audio Codec Compare [PCMA:8:8000:20:64000:1]/[G722:9:8000:20:64000:1]
2019-02-22 17:38:40.557875 [DEBUG] switch_core_media.c:4449 Audio Codec Compare [PCMA:8:8000:20:64000:1]/[PCMU:0:8000:20:64000:1]
2019-02-22 17:38:40.557875 [DEBUG] switch_core_media.c:4449 Audio Codec Compare [PCMA:8:8000:20:64000:1]/[PCMA:8:8000:20:64000:1]
2019-02-22 17:38:40.557875 [DEBUG] switch_core_media.c:4504 Audio Codec Compare [PCMA:8:8000:20:64000:1] ++++ is saved as a match
2019-02-22 17:38:40.557875 [DEBUG] switch_core_media.c:4449 Audio Codec Compare [PCMU:0:8000:20:64000:1]/[opus:116:48000:20:0:1]
2019-02-22 17:38:40.557875 [DEBUG] switch_core_media.c:4449 Audio Codec Compare [PCMU:0:8000:20:64000:1]/[G722:9:8000:20:64000:1]
2019-02-22 17:38:40.557875 [DEBUG] switch_core_media.c:4449 Audio Codec Compare [PCMU:0:8000:20:64000:1]/[PCMU:0:8000:20:64000:1]
2019-02-22 17:38:40.557875 [DEBUG] switch_core_media.c:4504 Audio Codec Compare [PCMU:0:8000:20:64000:1] ++++ is saved as a match
2019-02-22 17:38:40.557875 [DEBUG] switch_core_media.c:4449 Audio Codec Compare [PCMU:0:8000:20:64000:1]/[PCMA:8:8000:20:64000:1]
2019-02-22 17:38:40.557875 [DEBUG] switch_core_media.c:3061 Set Codec sofia/fifa/79500090900@192.168.25.9 PCMA/8000 20 ms 160 samples 64000 bits 1 channels
2019-02-22 17:38:40.557875 [DEBUG] switch_core_codec.c:111 sofia/fifa/79500090900@192.168.25.9 Original read codec set to PCMA:8
2019-02-22 17:38:40.557875 [DEBUG] switch_core_media.c:4738 No 2833 in SDP. Liberal DTMF mode adding 101 as telephone-event.
2019-02-22 17:38:40.557875 [DEBUG] switch_core_media.c:4767 sofia/fifa/79500090900@192.168.25.9 Set 2833 dtmf send payload to 101 recv payload to 101
2019-02-22 17:38:40.557875 [DEBUG] switch_core_media.c:6878 AUDIO RTP [sofia/fifa/79500090900@192.168.25.9] 192.168.25.32 port 16452 -> 192.168.25.9 port 25862 codec: 8 ms: 20
2019-02-22 17:38:40.557875 [DEBUG] switch_rtp.c:4137 Starting timer [soft] 160 bytes per 20ms
2019-02-22 17:38:40.557875 [DEBUG] switch_core_media.c:7180 sofia/fifa/79500090900@192.168.25.9 Set 2833 dtmf send payload to 101
2019-02-22 17:38:40.557875 [DEBUG] switch_core_media.c:7187 sofia/fifa/79500090900@192.168.25.9 Set 2833 dtmf receive payload to 101
2019-02-22 17:38:40.557875 [DEBUG] switch_core_media.c:7210 sofia/fifa/79500090900@192.168.25.9 Set rtp dtmf delay to 40
2019-02-22 17:38:40.557875 [NOTICE] sofia_media.c:92 Pre-Answer sofia/fifa/79500090900@192.168.25.9!
2019-02-22 17:38:40.557875 [DEBUG] switch_channel.c:3474 (sofia/fifa/79500090900@192.168.25.9) Callstate Change RINGING -> EARLY
2019-02-22 17:38:40.557875 [DEBUG] switch_core_media.c:6861 Audio params are unchanged for sofia/fifa/79500090900@192.168.25.9.
2019-02-22 17:38:40.557875 [DEBUG] mod_sofia.c:2364 Ring SDP:
v=0
o=FreeSWITCH 1550829868 1550829869 IN IP4 192.168.25.32
s=FreeSWITCH
c=IN IP4 192.168.25.32
t=0 0
m=audio 16452 RTP/AVP 8 101
a=rtpmap:8 PCMA/8000
a=rtpmap:101 telephone-event/8000
a=fmtp:101 0-16
a=ptime:20
a=sendrecv

=== Начало проигрывания звукового файла Fail_RUS1.wav ===

EXECUTE sofia/fifa/79500090900@192.168.25.9 playback(/usr/local/freeswitch/sounds/fifa/Fail_RUS1.wav)
2019-02-22 17:38:40.557875 [DEBUG] sofia.c:7084 Channel sofia/fifa/79500090900@192.168.25.9 entering state [early][183]
2019-02-22 17:38:40.557875 [DEBUG] switch_ivr_play_say.c:1498 Codec Activated L16@8000hz 1 channels 20ms
2019-02-22 17:38:40.657867 [DEBUG] switch_rtp.c:7308 Correct audio ip/port confirmed.
2019-02-22 17:38:49.677867 [DEBUG] sofia.c:7084 Channel sofia/fifa/79500090900@192.168.25.9 entering state [terminated][487]
2019-02-22 17:38:49.677867 [NOTICE] sofia.c:8273 Hangup sofia/fifa/79500090900@192.168.25.9 [CS_EXECUTE] [ORIGINATOR_CANCEL]
2019-02-22 17:38:49.677867 [DEBUG] switch_ivr_play_say.c:1942 done playing file /usr/local/freeswitch/sounds/fifa/Fail_RUS1.wav
2019-02-22 17:38:49.677867 [DEBUG] switch_core_session.c:2815 sofia/fifa/79500090900@192.168.25.9 skip receive message [APPLICATION_EXEC_COMPLETE] (channel is hungup already)
2019-02-22 17:38:49.677867 [DEBUG] switch_core_state_machine.c:650 (sofia/fifa/79500090900@192.168.25.9) State EXECUTE going to sleep
2019-02-22 17:38:49.677867 [DEBUG] switch_core_state_machine.c:584 (sofia/fifa/79500090900@192.168.25.9) Running State Change CS_HANGUP (Cur 1 Tot 13675)
2019-02-22 17:38:49.677867 [DEBUG] switch_core_state_machine.c:850 (sofia/fifa/79500090900@192.168.25.9) Callstate Change EARLY -> HANGUP
2019-02-22 17:38:49.677867 [DEBUG] switch_core_state_machine.c:852 (sofia/fifa/79500090900@192.168.25.9) State HANGUP
2019-02-22 17:38:49.677867 [DEBUG] mod_sofia.c:438 Channel sofia/fifa/79500090900@192.168.25.9 hanging up, cause: ORIGINATOR_CANCEL
2019-02-22 17:38:49.677867 [DEBUG] switch_core_state_machine.c:60 sofia/fifa/79500090900@192.168.25.9 Standard HANGUP, cause: ORIGINATOR_CANCEL
2019-02-22 17:38:49.677867 [DEBUG] switch_core_state_machine.c:852 (sofia/fifa/79500090900@192.168.25.9) State HANGUP going to sleep
2019-02-22 17:38:49.677867 [DEBUG] switch_core_state_machine.c:619 (sofia/fifa/79500090900@192.168.25.9) State Change CS_HANGUP -> CS_REPORTING
2019-02-22 17:38:49.677867 [DEBUG] switch_core_state_machine.c:584 (sofia/fifa/79500090900@192.168.25.9) Running State Change CS_REPORTING (Cur 1 Tot 13675)
2019-02-22 17:38:49.677867 [DEBUG] switch_core_state_machine.c:938 (sofia/fifa/79500090900@192.168.25.9) State REPORTING
2019-02-22 17:38:49.677867 [DEBUG] switch_core_state_machine.c:174 sofia/fifa/79500090900@192.168.25.9 Standard REPORTING, cause: ORIGINATOR_CANCEL
2019-02-22 17:38:49.677867 [DEBUG] switch_core_state_machine.c:938 (sofia/fifa/79500090900@192.168.25.9) State REPORTING going to sleep
2019-02-22 17:38:49.677867 [DEBUG] switch_core_state_machine.c:610 (sofia/fifa/79500090900@192.168.25.9) State Change CS_REPORTING -> CS_DESTROY
2019-02-22 17:38:49.677867 [DEBUG] switch_core_session.c:1665 Session 13675 (sofia/fifa/79500090900@192.168.25.9) Locked, Waiting on external entities
2019-02-22 17:38:49.677867 [NOTICE] switch_core_session.c:1683 Session 13675 (sofia/fifa/79500090900@192.168.25.9) Ended
2019-02-22 17:38:49.677867 [NOTICE] switch_core_session.c:1687 Close Channel sofia/fifa/79500090900@192.168.25.9 [CS_DESTROY]
2019-02-22 17:38:49.677867 [DEBUG] switch_core_state_machine.c:741 (sofia/fifa/79500090900@192.168.25.9) Running State Change CS_DESTROY (Cur 0 Tot 13675)
2019-02-22 17:38:49.677867 [DEBUG] switch_core_state_machine.c:751 (sofia/fifa/79500090900@192.168.25.9) State DESTROY
2019-02-22 17:38:49.677867 [DEBUG] mod_sofia.c:343 sofia/fifa/79500090900@192.168.25.9 SOFIA DESTROY
2019-02-22 17:38:49.677867 [DEBUG] switch_core_state_machine.c:181 sofia/fifa/79500090900@192.168.25.9 Standard DESTROY
2019-02-22 17:38:49.677867 [DEBUG] switch_core_state_machine.c:751 (sofia/fifa/79500090900@192.168.25.9) State DESTROY going to sleep

По мониторингу FreeSWITCH использую следующие основные параметры, ниже пример конфигурации для Zabbix файл /etc/zabbix/zabbix_agentd.conf в UserParameter:

### Option: UserParameter
####Channel count
UserParameter=fs.channels.count.current, /usr/local/freeswitch/bin/fs_cli -x "show channels count" | grep total | awk {'print $1'}
UserParameter=fs.channels.count.max.5.min, /usr/local/freeswitch/bin/fs_cli -x "status" | grep 'session(s) - peak' |  awk '{print $8}'
####CPS count
UserParameter=fs.cps.count.current, /usr/local/freeswitch/bin/fs_cli -x "status" | grep ' session(s) - peak' | awk '{print $1}'
UserParameter=fs.cps.count.max.5.min,/usr/local/freeswitch/bin/fs_cli -x "status" | grep 'session(s) per Sec out of max' | awk '{print $13}'
###Sessions count since startup
UserParameter=fs.sessions.count.since.startup,/usr/local/freeswitch/bin/fs_cli -x "status" | grep "session(s) since startup" | awk {'print $1'}

Итог

Для задачи авторизации в сети Wi-Fi по звонку отлично подойдёт любое из решений, Asterisk проще в конфигурировании, FreeSWITCH несколько сложнее, зато у него есть модуль curl и не нужно вызывать внешний скрипт, но скрипт написать не сложно. По производительности я не заметил разницы, наверное, потому что нагрузка была не существенная. Вот по качеству воспроизведения подсказок, по моей субъективной оценке, FreeSWITCH звучал лучше. По отладке и мониторингу, больше нравится FreeSWITCH, потому что логичнее и понятнее сообщения FreeSWITCH, также можно мониторить больше переменных, особенно порадовало наличие параметра Call per Second (CPS). В целом, по логической организации FreeSWITCH тоже больше нравится, но xml конфигурация FreeSWITCH несколько сложнее для восприятия, чем язык ael дайлплана Asterisk, хотя со временем чтение и написание xml не вызывает никаких сложностей.

Автор: Игнат Кудрявцев

The post Сравниваем конфигурации FreeSWITCH и Asterisk для одной задачи first appeared on Unified Communications Expert.

Эта система призвана облегчить инженерам поиск и устранение неисправностей в VoIP-сетях при помощи мощного анализа и визуализации SIP-диалогов между узлами и детальный просмотр всех SIP-сообщений. Решение позволяет сохранять выгружать SIP-трейсы вызовов в виде pcap дампов или текстовых файлов. Еще одним преимуществом решения является возможность разнесения компонентов системы по разным узлам, что позволяет масштабировать систему.

Обзор похожего, но платного решения, разработка которого, к сожалению, давно прекращена можно найти по данной ссылке – Мониторинг сети VoIP с помощью VQManager
Решение Homer состоит из нескольких  подсистем. Рассмотрим эти подсистемы и механизм их взаимодействия межу собой.

В составе Homer можно выделить три основные подсистемы:

• HOMER CAPTURE AGENT – агент захватывает трафик из VoIP-сети, копирует и инкапсулирует  SIP и RTCP пакеты  при помощи протокола HEP/EPP и передаёт их на CAPTURE SERVER, причём агент может представлять из себя как модуль для SIP-сервера (Asterisk, FreeSWITCH, Kamailio,OpenSIPS), так и сервис захвата «сырого» трафика с сетевого интерфейса, который может зеркалироваться с порта (-ов) ethernet-коммутатора куда подключен SIP-сервер (например, модуль транзита трафика РТУ МТТ) на порт (-ы) CAPTURE AGENT.
• HOMER CAPTURE SERVER – сервер на базе SIP маршрутизатора Kamailio с базой данных MySQL, где аккумулируется и хранятся SIP и RTCP пакеты полученные от CAPTURE AGENT
• HOMER USER INTERFACE – веб-интерфейс для поиска, анализа и визуализации SIP-трейсов которые хранятся в CAPTURE SERVER.

Итак, общая схема работы  Homer выглядит так:
CAPTURE AGENT — это системная служба которая постоянно запущена на узле. Через узел проходит VoIP-трафик требующий анализа. CAPTURE AGENT захватывает трафик и создает копии сигнальных SIP-сообщений, затем инкапсулирует эти копии пакетов в формат HEP/ EEP и передаёт их по сети в коллектор сервера CAPTURE SERVER, сервер получает SIP и RTCP пакеты, разбирает их и помещает в базу данных MySQL. Фактически все SIP-сообщения целиком хранятся в базе данных, но естественно не просто так, а с метаданными, которые и позволяют существенно ускорить поиск и отображение запрашиваемой из веб-интерфейса информации.
Веб-интерфейс USER INTERFACE подключается к базе данных CAPTURE SERVER и загружает данные запрашиваемые пользователем веб-интерфейса.

Основные функции компонентов Homer

Capture Server

• Высокая производительность – тысячи пакетов в секунду
• Поддержка нескольких баз данных
• Мощный пользовательский интерфейс для поиска и фильтрации
• Визуальные диалоги SIP  и возможность их вызгрузки в pcap-файлы
• Графики со статистикой и аналитикой
• Поддержка REST API и виджетов
• Авторизация пользователей по RADIUS и LDAP
• Angular/JS интерфейс пользователя

Capture Agent

• HEP3 инкапсуляция
• Шифрование и сжатие содержимого
• Модульный дизайн
• SIP,RTP/RTCP,Журналы,CDRs
• Поддержка TLS
• Высокопроизводительный
• Поддержка Linux,Solaris,BSD/OSX,Win32

Функции  Ядра

• Протокол HEP/EEP
• SIP-сигналинг
• WebRTC-сигналинг
• Протокол RTCP
• Протокол RTCP-XR
• Коллектор журналов
• Гео-меппинг
• Поддержка Docker

Варианты использования Homer

На сайте Homer по адресу sipcapture.org предлагают два метода.
Первый – облачный (cloud), заказчик устанавливает у себя в сети HEP Capture Agent который копирует VoIP-трафик из сети заказчика, упаковывает в HEP пакеты, если надо шифрует при помощи SSL/TLS и отправляет в облако SIPCAPTURE.IO где находится Capture Server и Homer UI – веб-интерфейс Homer. В таком случае заказчику не придётся думать о поддержке и обновления Homer. Услуга конечно же не бесплатная, и в зависимости от пакета составляет от 80 до 500 евро в месяц.

Второй – в сети заказчика (on-permise), заказчик инсталлирует, обслуживает и обновляет все компоненты Homer в своей сети. Мы рассмотрим второй вариант.

Требования к программному обеспечению Homer 5

• Apache2 or Nnginx
• PHP-5, MySQL + InnoDB (barracuda) ( >= 5.6)
• Kamailio + sipcapture
• Homer-API + Homer-UI

Аппаратные требования и тестирование производительности

Каких-либо официальных аппаратных требований на сайтах sipcapture.org или github.com/sipcapture я не нашёл. Для тестирования производительности, решил сравнить две копии Homer запущенные на разных серверах но с абсолютно одинаковым реальным трафиком следующего объёма:
Зеркалируемый узел: 310 одновременных вызовов в среднем. CPS  в среднем 3,48 макс 19 вызовов в секунду, все данные за сутки.
Вызовов за 24 часа примерно 650000
В основном SIP-вызовы без SIP-регистраций, OPTIONS и других сообщений свойственным терминалом.
Узел 1:
— Сервер: HP Proliant DL380 G5
— 1 CPU Xeon E5420 4 2.5 GHz 4 Cores
— RAM 8 GB DDR2 677Mhz ECC
— RAID0 2 x 2.5 SAS 10K RPM  + Controller P400 256Mbt
— 2NIC 1000Mb\sec

 
Нагрузка на машину не большая, хотя она молотит. Ниже вывод htop.

# :/var/lib/mysql# date;du -h -c
Thu Apr 20 14:12:49 MSK 2017
676K    ./sys
22M     ./mysql
1.1M    ./performance_schema
439M    ./homer_statistic
1.1M    ./homer_configuration
71G     ./homer_data
72G     .
72G     total

72 Гигабайта за 10 дней.Узел 2:

— Система виртуализации VMWare ESX6.5
Виртуальная машина с максимально возможными ресурсами.
— Сервер: Intel S3210SH
— Система виртуализации VMWare ESX5.5
— 1 CPU Intel Core 2 Quad Q6700 2.66 Mhz 4 Cores
— RAM 8GB DDR2 677Mhz nonECC
— 2 DISK Seagate 3.5 SATA 7.2K RPM
— 2 NIC 1000Mb\sec

На нём виртуальна машина со следующими ресурсами:
— 4 ядра процессора
— RAM 5GB

Под эту виртуальную машину зарезервирован отдельный физический диск под виртуальную машину.

Постоянное число регистраций: 8 тысяч и 149 одновременных вызовов в среднем.

# :/var/lib/mysql# date;du -h -c
Thu Apr 20 14:11:52 MSK 2017
100G    ./homer_data
22M     ./mysql
1.1M    ./performance_schema
2.7G    ./homer_statistic
676K    ./sys
1.1M    ./homer_configuration
103G    .
103G    total

103 Гигабайта за 10 дней.

В течение двух месяцев работы система показала отличные результаты как по скорости работы так и по аппаратным ресурсам необходимым для работы.
Через несколько месяцев на второй машине накрылся жесткий диск SATA 7200
Данный диск был заменен на новый, но его через месяц постигла та же участь.
Поэтому при большой нагрузке рекомендую использовать SAS + RAID 0

Или попробовать вынести файлы базы данных Mysql на отдельный диск

Например, подклюаем отдельный диск с точкой монтирования /var/lib/mysql

cat /etc/fstab
UUID=4a439b75-c7aa-4bd6-ad27-88ff5f44d38d /var/lib/mysql  ext4    defaults        0       2

# df -h
Filesystem      Size  Used Avail Use% Mounted on
/dev/sda1       397G  1.9G  375G   1% /
udev             10M     0   10M   0% /dev
tmpfs           1.6G  8.6M  1.6G   1% /run
tmpfs           4.0G     0  4.0G   0% /dev/shm
tmpfs           5.0M     0  5.0M   0% /run/lock
tmpfs           4.0G     0  4.0G   0% /sys/fs/cgroup

# /etc/init.d/mysql stop
# mv /var/lib/mysql /var/lib/mysql_temp
# mkdir /var/lib/mysql
# mount /var/lib/mysql
# df -h
Filesystem      Size  Used Avail Use% Mounted on
/dev/sda1       397G  1.9G  375G   1% /
udev             10M     0   10M   0% /dev
tmpfs           1.6G  8.5M  1.6G   1% /run
tmpfs           4.0G     0  4.0G   0% /dev/shm
tmpfs           5.0M     0  5.0M   0% /run/lock
tmpfs           4.0G     0  4.0G   0% /sys/fs/cgroup
/dev/sdb1       413G  264M  392G   1% /var/lib/mysql

# cp -r /var/lib/mysql_temp/* /var/lib/mysql
# chown mysql:mysql -R /var/lib/mysql
# chmod 755 /var/lib/mysql
# /etc/init.d/mysql start
[ ok ] Starting mysql (via systemctl): mysql.service.
# /etc/init.d/mysql status
● mysql.service - MySQL Community Server
   Loaded: loaded (/lib/systemd/system/mysql.service; enabled)
   Active: active (running) since Tue 2017-12-26 15:00:11 MSK; 12s ago
  Process: 12878 ExecStart=/usr/sbin/mysqld --daemonize --pid-file=/var/run/mysqld/mysqld.pid (code=exited, status=0/SUCCESS)
  Process: 12842 ExecStartPre=/usr/share/mysql/mysql-systemd-start pre (code=exited, status=0/SUCCESS)
 Main PID: 12881 (mysqld)
   CGroup: /system.slice/mysql.service
           └─12881 /usr/sbin/mysqld --daemonize --pid-file=/var/run/mysqld/mysqld.pid

Dec 26 15:00:11 Homer-2 systemd[1]: Started MySQL Community Server.

Если mysql запустится нормально и все файлы на месте, то можно удалить временную директорию.

# rm -rf /var/lib/mysql_temp

Инсталляция Homer

Установка состоит из двух этапов.
Первый этап. Установка самого Homer состоящего из “HEP-коллектора” в виде SIP машрутизатора Kamailio, который складывает полученные от него пакеты в БД, плюс к этому, сервер Apache2 на котором находятся файлы API-скриптов и GUI-интерфейса Homer. Именно GUI -интерфейс используя API  Homer фильтрует и «рисует» SIP-трейсы, графики и выводит прочую информацию.
Второй этап. Установка агента, который перерабатывает трейсы и статистику, приходящую из специального модуля программных SIP-серверов, таких как Asterisk, FreeSWITCH, Kamailio и OpenSIPS и передает по протоколу HEP в коллектор Homer. Также возможен вариант установки агента, который берет данные от зеркалированного на порты коммутатора VoIP-трафика, в таком случае неважно какой SIP-сервер используется и никакие модули на него не нужно устанавливать.

Для VMWare, создаём VM и сети.

Создаём сети:

Причем для Mirror-Interface, на вкладке Security для Promiscuous Mode ставим галку и выбираем Accept.

Для установки используем дистрибутив Debian 8.7 (jessie), также оттестировано на Debian 9.2.

/etc/network/interfaces
source /etc/network/interfaces.d/*

# The loopback network interface
auto lo
iface lo inet loopback

# The primary network interface
allow-hotplug eth0
#iface eth0 inet dhcp
iface eth0 inet static
        address 172.17.36.37/26
        gateway 172.17.36.26
        # dns-* options are implemented by the resolvconf package, if installed
        dns-nameservers 84.52.107.107 195.177.123.1
        post-up /sbin/route add -net 192.168.133.0/24 gw 172.17.36.62
allow-hotplug eth1
iface eth1 inet static
address 0.0.0.0

Самый простой способ и лёгкий способ выполнить команды:

#aptitude install curl (если у вас он не установлен)
# bash <( curl -s https://cdn.rawgit.com/sipcapture/homer-installer/master/homer_installer.sh )

С сайта будет автоматически загружен и выполнен скрипт homer_installer.sh, который сам всё скачает и установит. Нужно будет задать пользователя и пароль пользователя Mysql, который будет работать с БД Homer.

Сервисы:

• Kamailio
• Apache2
• Сервер MySQL

Будут автоматически добавлены в автозагрузку. Диалог инсталляции будет выглядить примерно так:

**************************************************************

      ,;;;;;,       HOMER SIP CAPTURE (http://sipcapture.org)
     ;;;;;;;;;.     Single-Node Auto-Installer (beta 5.0.1)
   ;;;;;;;;;;;;;
  ;;;;  ;;;  ;;;;   <--------------- INVITE ---------------
  ;;;;  ;;;  ;;;;    --------------- 200 OK --------------->
  ;;;;  ...  ;;;;
  ;;;;       ;;;;   WARNING: This installer is intended for
  ;;;;  ;;;  ;;;;   dedicated/vanilla OS setups without any
  ,;;;  ;;;  ;;;;   customization and with default settings
   ;;;;;;;;;;;;;
    :;;;;;;;;;;     THIS SCRIPT IS PROVIDED AS-IS, USE AT
     ^;;;;;;;^      YOUR *OWN* RISK, REVIEW LICENSE & DOCS

**************************************************************
OS: Dectecting System....
OS: DEBIAN detected
This script expect a Vanilla OS and will override settings. Continue (y/N)? y

Затем установка таких пакетов, как apache2,php5, git, cpp, gcc и  вспомогательных библиотек.	

Module php5 already enabled
Enabling module rewrite.
To activate the new configuration, you need to run:
  service apache2 restart
Generating a 2048 bit RSA private key
..................+++
.............+++
writing new private key to '/etc/ssl/localcerts/apache.key'
-----
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Country Name (2 letter code) [AU]:RU
State or Province Name (full name) [Some-State]:
Locality Name (eg, city) []:Saint-Petersburg
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Westcall LTD
Organizational Unit Name (eg, section) []:Homer-1
Common Name (e.g. server FQDN or YOUR name) []:Ignat
Email Address []:i.kudryavtsev@somemail.com

Далее будут сгенерированы сертификаты для ssl.
Далее будут установлены пакеты Kamailio и БД MySQL.
После успешной установки, скрипт предложит сконфигурировать БД MySQL.

База данных: Homer_1
Пользователь БД: Homer_1
Пароль: БД:121212badrebZL

Если всё ок, в конце установки будет нечто похожее:

cp: omitting directory ‘/usr/src/homer-api/scripts/old’
cp: omitting directory ‘/usr/src/homer-api/scripts/pgsql’
no crontab for root
Enter the SQL User details for the HOMER Client: Homer_1
MYSQL Homer User: (empty for default) Homer_1_password

MYSQL Homer Pass: (empty for randomized) 121212badrebZL _
WARNING: Choose a password for MySQL ROOT account (empty by default!)
Beginning initial data load....
Starting mysqld
Starting mysql (via systemctl): mysql.service.
Creating Databases...
Creating Tables...
ERROR 1062 (23000) at line 1: Duplicate entry '1' for key 'PRIMARY'
Setting root password....
Patching Homer configuration...
Restarting apache2 (via systemctl): apache2.service.
Restarting kamailio (via systemctl): kamailio.serviceroot@homer:~# .
*************************************************************
      ,;;;;,
     ;;;;;;;;.     Congratulations! HOMER has been installed!
   ;;;;;;;;;;;;
  ;;;;  ;;  ;;;;   <--------------- INVITE ---------------
  ;;;;  ;;  ;;;;    --------------- 200 OK --------------->
  ;;;;  ..  ;;;;
  ;;;;      ;;;;   Your system should be now ready to rock!
  ;;;;  ;;  ;;;;   Please verify/complete the configuration
  ,;;;  ;;  ;;;;   files generated by the installer below.
   ;;;;;;;;;;;;
    :;;;;;;;;;     THIS SCRIPT IS PROVIDED AS-IS, USE AT
     ;;;;;;;;      YOUR *OWN* RISK, REVIEW LICENSE & DOCS

*************************************************************

     * Verify configuration for HOMER-API:
         '/var/www/html//api/configuration.php'
         '/var/www/html//api/preferences.php'

     * Verify capture settings for Homer/Kamailio:
         '/etc/kamailio/kamailio.cfg'

     * Start/stop Homer SIP Capture:
         '/sbin/kamctl start|stop'

     * Access HOMER UI:
         http://192.168.85.150 or http://192.168.85.150
         [default: admin/test123 or test1234]

     * Send HEP/EEP Encapsulated Packets:
         hep://192.168.85.150:9060

**************************************************************

 IMPORTANT: Do not forget to send Homer node some traffic! ;)
 For our capture agents, visit http://github.com/sipcapture
 For more help and information visit: http://sipcapture.org

**************************************************************
 Installer Log saved to: /tmp/homer_installer.log

Как следует из журнала установки коллектор HEP это 192.168.85.150:9060

Доступ на веб-интерфейс Homer http://192.168.85.150

Также на странице sipcapture сайта github описана ручная установка Homer. Если кратко, то она состоит из следующих этапов:
С github качаем файлы homer-api и homer-ui, ставим Apache2, копируем эти файлы в директорию Apache2. Далее, ставим MySQL-сервер, затем добавляем базы данных homer_data, homer_users, homer_configuration, homer_statistic и создаём в них структуру из соответствующих шаблонах в .sql файлах. Затем создаём пользователя mysql и даём ему полные права на эти БД, затем конфигурируем Homer API путём редактирования php файла к с конфигурацией /var/www/html/api/configuration.php, дополнительно настраиваем ротацию данных в БД homer по времени. Теперь ставим kamailio, настраиваем файл конфигурации kamailio.cfg (копируем из примера), запускаем Kamailio. Проверяем что он запущен и порт коллектора HEP, например, 9060 открыт. Проверяем, что веб-интерфейс работает, открыв IP-адрес сервера в веб-браузере. Логин и пароль по умолчанию:  admin / test123 его можно поменять в БД или посмотреть в файле шаблона schema_configuration.sql

Установка Сaptagent

Дистрибутив Linux Debian 8.7 (jessie). Установим дополнительные пакеты:

#apt-get install libexpat-dev libpcap-dev libjson0-dev libtool automake flex bison libuv-dev make

Клонирование при помощи git и компиляция:

 #cd /usr/src
 #git clone https://github.com/sipcapture/captagent.git captagent
 #cd captagent
 #./build.sh
 #./configure

Если всё ок, то будет такой результат: Если всё ок, то будет такой результат:

captagent 6.2.0.2

Build directory............. :
Installation prefix......... : /usr/local/captagent
HEP Compression............. : no
IPv6 support.................: no
HEP SSL/TLS................. : no
Flex........................ : flex
Bison....................... : bison -y

Build with REDIS............ : no
Build with MySQL............ : no
Build with PCRE............. : no
Build with LibUV............ : yes

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

# make && make install

Если всё ок, ошибок не будет, по окончании будут сообщения что библиотеки успешно инсталлированы:

Libraries have been installed in:
   /usr/local/captagent/lib/captagent/modules

If you ever happen to want to link against installed libraries
in a given directory, LIBDIR, you must either use libtool, and
specify the full pathname of the library, or use the `-LLIBDIR'
flag during linking and do at least one of the following:
   - add LIBDIR to the `LD_LIBRARY_PATH' environment variable
     during execution
   - add LIBDIR to the `LD_RUN_PATH' environment variable
     during linking
   - use the `-Wl,-rpath -Wl,LIBDIR' linker flag
   - have your system administrator add LIBDIR to `/etc/ld.so.conf'

See any operating system documentation about shared libraries for
more information, such as the ld(1) and ld.so(8) manual pages.
----------------------------------------------------------------------
make[5]: Leaving directory '/usr/src/captagent/src/modules/interface/http'
make[4]: Leaving directory '/usr/src/captagent/src/modules/interface/http'
make[3]: Leaving directory '/usr/src/captagent/src/modules/interface/http'
make[2]: Leaving directory '/usr/src/captagent/src'
make[1]: Leaving directory '/usr/src/captagent/src'
Making install in include
make[1]: Entering directory '/usr/src/captagent/include'
make[2]: Entering directory '/usr/src/captagent/include'
make[2]: Nothing to be done for 'install-exec-am'.
make[2]: Nothing to be done for 'install-data-am'.
make[2]: Leaving directory '/usr/src/captagent/include'
make[1]: Leaving directory '/usr/src/captagent/include'
make[1]: Entering directory '/usr/src/captagent'
make[2]: Entering directory '/usr/src/captagent'
make[2]: Nothing to be done for 'install-exec-am'.
make[2]: Nothing to be done for 'install-data-am'.
make[2]: Leaving directory '/usr/src/captagent'
make[1]: Leaving directory '/usr/src/captagent'

Настройка Captagent

Модули ядра загружаются через основной файл конфигурации captagent.xml, таким образом, они могут быть легко объединены для создания нескольких независимых цепей захвата трафика. Графически это можно представить следующим образом:

SOCKET -> PROFILE -> CAPTURE PLAN <—> MODULES (функции)

Те мы используем, например, pcap захват трафика, тогда в файле socket_pcap.xml, прописываем в нём «ловить» SIP и  RTCP на определенном интерфейсе и определённых портах. И указываем планы захвата трафика sip_capture_plan.cfg и rtcp_capture_plan.cfg для способа захвата через pcap.

• Файлы конфигурации: /usr/local/etc/captagent
• Файлы Capture Plans: /usr/local/etc/captagent/captureplans
• Файлы Modules: /usr/local/lib/captagent/modules

Итак, начнём настройку в указанной выше последовательности.

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

• Устройство-приёмник для зеркалирования: eth1
• Порт SIP: 9955
• Порт RTCP: 10000-25999
• Файл Capture Plan: sip_capture_plan.cfg

Настройка интерфейса eth1 для зеркалирования /etc/network/interfaces

allow-hotplug eth1
iface eth1 inet static
address 0.0.0.0

На коммутаторе Cisco 3750G

SW-3750#monitor session 1 source interface Gi1/0/2 - 7 , Gi1/0/9
SW-3750#monitor session 1 destination interface Gi1/0/25

Настройка PROFILE. Основная конфигурация находится в файле /usr/local/captagent/etc/captagent/captagent.xml. По умолчанию данный файл конфигурации редактировать не нужно.
Настройка SOCKET. Проверим и изменим конфигурацию в файле /usr/local/captagent/etc/captagent/socket_pcap.xml

<profile name="socketspcap_sip" description="HEP Socket" enable="true" serial="2014010402">
<settings>
<param name="dev" value="any"/>
<param name="promisc" value="true"/>
<param name="reasm" value="false"/> // comments here to explain the option?
<param name="tcpdefrag" value="false"/> // comments here to explain the option?
<param name="capture-plan" value="sip_capture_plan.cfg"/>
<param name="filter">
<value>portrange 9955</value>
</param>
</settings>
</profile>

Обращаю внимание, что значение может не сработать, тогда нужно указывать конкретный интерфейс, например, eth1. Если нужно поставить более точный фильтр можно сделать так:

portrange 9955 and host 90.90.90.90
portrange 5060-5090 and (host 10.0.0.1 or host 10.0.0.2)

Плюс к этому настроим RTCP статистику в том же файле:

<profile name="socketspcap_rtcp" description="RTCP Socket" enable="false" serial="2014010402">
<settings>
<param name="dev" value="eth1"/>
<param name="promisc" value="true"/>
<param name="reasm" value="false"/>
<!-- size in MB -->
<param name="ring-buffer" value="20"/>
<!-- for rtp && rtcp < 250 -->
<param name="snap-len" value="256"/>
<param name="capture-filter" value="rtcp"/>
<param name="capture-plan" value="rtcp_capture_plan.cfg"/>
<param name="filter">
<value>portrange 10000-25999 and len >=50 </value>
</param>
</settings>
</profile>
</module>
</document>

В данном файле указывается устройство dev=eth1 откуда снимать трафик и разрешить неразборчивый режим promisc=true. Также в строках:

<profile name="socketspcap_sip" description="HEP Socket" enable="true" serial="2014010402">
<profile name="socketspcap_rtcp" description="RTCP Socket" enable="false" serial="2014010402">

Параметр enable должен стоять «true» иначе не будет работать!!!

Примечание: В версии 6.2.11 если sip (порт 9955) и rtcp (10000-25999) включить одновременно, то возникает ошибка – по HEP не улетает ни одного сообщения в коллектор kamailio, хотя диапазоны портов не пересекаются. Если они пересекутся, то официально это не рабочая схема.
Настройка CAPTURE PLAN. Теперь переходим к /usr/src/captagent/conf/captureplans/sip_capture_plan.cfg

capture[pcap] {
# Perform checks against source/destination IP/port, message size
if(msg_check("size", "100")) {
if(source_ip(“10.0.0.99”)) { drop; }
# Parse the Message
if(parse_sip()) {
# Send using one or multiple profiles defined in transport_hep.xml
if(!send_hep("hepsocket")) {
clog("ERROR", "Error sending HEP!!!!");
}
}
}
drop;
}

Тут ничего менять не надо, если конфигурация по умолчанию устраивает. Здесь же, как и в файле captagent.xml, можно устанавливать фильтры на трафик, наподобие if (source_ip (“10.0.0.99”)) { drop; }

Настройка Transport Modules. Далее, переходим к конфигурации транспортного сокета. Транспортный сокет необходим для доставки инкапсулированных пакетов в коллектор сервера Homer. Файл конфигурации /usr/local/captagent/etc/captagent/transport_hep.xml В нашем случае, файл будет выглядить так:

<?xml version="1.0"?>
<document type="captagent_module/xml">
<module name="transport_hep" description="HEP Protocol" serial="2014010402">
<profile name="hepsocket" description="Transport HEP" enable="true" serial="2014010402">
<settings>
<param name="version" value="3"/>
<param name="capture-host" value="127.0.0.1"/>
<param name="capture-port" value="9060"/>
<param name="capture-proto" value="udp"/>
<param name="capture-id" value="2001"/>
<param name="capture-password" value=" "/>
<param name="payload-compression" value="false"/>
</settings>
</profile>
</module>
</document>

То есть, конфигурация говорит, что коллектор сервера Homer находится по адресу 127.0.0.1, порт 9060, пароль пустой.

Настройка Protocol Modules. Модули протоколов загружаются из файла /usr/local/captagent/etc/captagent/captagent.xml

<configuration name="modules.conf" description="Modules">
<modules>
...
<load module="transport_hep" register="local"/>
<load module="protocol_sip" register="local"/>
<load module="database_hash" register="local"/>
<load module="protocol_rtcp" register="local"/>>
<load module="socket_pcap" register="local"/> 
...
</modules>
</configuration>

Тут можно всё оставить по умолчанию и проверить что загружаются модули SIP и RTCP. Теперь необходимо настроить ротацию данных в БД Homer, если этого не сделать, то на рабочей системе размеры БД могут достигнуть огромных размеров что скажется не только на объёме свободного на диске, но и на скорости обработки и выдачи поисковых запросов в веб-интерфейсе Homer. Для этого запускаем редактор cron, командой crontab -e, и проверяем наличие строки:

30 3 * * * /opt/homer/homer_rotate >> /var/log/cron.log 2>&1

которая указывает что нужно ежедневно, в 3-30 нужно выполнять скрипт ротации /opt/homer/homer_rotate. В данном скрипте, есть ссылка на /opt/homer/rotation.ini, где настраивается сколько дней какие данные требуется хранить. Нас интересует раздел, DATA_TABLE_ROTATION, в котором всё понятно без дополнительных комментариев.

[DATA_TABLE_ROTATION]
    #how long data keeps
    sip_capture_call = 10 #days
    sip_capture_registration = 10 # 10 days
    sip_capture_rest = 10 # 10 days
    rtcp_capture = 10 # days
    logs_capture = 10 # days
    report_capture = 10 # days
    webrtc_capture_all = 10 # days
    isup_capture_all = 10

Обращаю внимание, что в разделе [MYSQL] находятся данные для подключения к БД Homer, которые используются для ротации.
Запуск Captagent. Исполняемый файл находится по следующему пути:

/usr/local/captagent/sbin/captagent

Проверим версию:

#./captagent -v
version: 6.2.0.2

Параметры запуска могут быть следующие:

./captagent -h
usage: captagent <-vh> <-f config>
   -h  is help/usage
   -v  is version information
   -f  is the config file
   -D  is use specified pcap file instead of a device from the config
   -c  is checkout
   -d  is daemon mode
   -n  is foreground mode
   -K  is hardware key of your system

Самый простой вариант запуска:

#/usr/local/captagent/sbin/captagent -f /usr/local/captagent/etc/captagent/captagent.xml -n

Для отладки такой способ запуска полезен, вот пример запуска с ошибкой в конфигурации:

root@homer-1:/usr/local/captagent/sbin# ./captagent -f /usr/local/captagent/etc/captagent/captagent.xml
[NOTICE] Loaded core config
[ERR] socket_pcap.c:657 Failed to compile filter "portrange 9955,5060": illegal token: ,
[ERR] protocol_sip.c:377 sipPacket CALLID has 0 len
[ERR] protocol_sip.c:353 SIP PARSE ERROR [-1]

[ERR] protocol_sip.c:372 bad parsing
[ERR] protocol_sip.c:353 SIP PARSE ERROR [-1]

[ERR] protocol_sip.c:372 bad parsing
[ERR] protocol_sip.c:353 SIP PARSE ERROR [-1]

Или вот такая ошибка:

[ERR] protocol_sip.c:133 Couldnot find this call

IS RTCP

[DEBUG] database_hash.c:165 IP PORT: 192.168.250.250:10535
[DEBUG] database_hash.c:280 IP PORT: [192.168.250.250:10535]
[DEBUG] database_hash.c:280 IP PORT: [192.168.250.245:25363]

Тут проблема в том, что коллектор получает RTCP статистику и не может понять к чему она относится. В интернете чаще всего пишут, что причина в том, что диапазоны RTCP и SIP портов пересекаются. У меня проблема оказалось что по дебагу запуска captagent в профилях socketspcap_sip и socketspcap_rtcp, нужно выставить параметр enable=»true», а в конфигурации по умолчанию стояло false именно для SIP.

…
[DEBUG] socket_pcap.c:609 Activated device: [eth1]

[NOTICE] Using filter: (portrange 10000-25999 and len >=50 ) and (ip and ip[6] & 0x2 = 0 and ip[6:2] & 0x1fff = 0 and udp and udp[8] & 0xc0 = 0x80 and udp[9] >= 0xc8 && udp[9] <= 0xcc)
[DEBUG] conf_function.c:453 find_export_record: found  in module protocol_sip [/usr/local/captagent/lib/captagent/modules]
…

Явно грузился только RTCP фильтр в файле socket_pcap.xml. Плюс к этому, в основном файле конфигурации captagent.xml можно установить параметра более высокий, например, 9, тогда отладочные сообщения будут выводиться более детальными. Но это не очень удобно. Поэтому сделаем авто запуск captagent и добавим стартовый скрипт. Переходим в директорию, где находятся исходники captagent и копируем init.d скрипт, затем меняем права доступа к нему:
#cp /usr/src/captagent/init/deb/debian/captagent.init /etc/init.d/captagent
#chmod 755 /etc/init.d/captagent
В скрипте /etc/init.d/captagent проверим значения:

DAEMON=/usr/local/captagent/sbin/captagent
CFGFILE=/usr/local/captagent/etc/captagent/captagent.xml
#USER=captagent
#GROUP=captagent

Обращаю внимание что пользователь и группа закомментированы. Тк они не существуют. Также копируем конфигурационный файл для запуска captagent в /etc/default/#cp /usr/src/captagent/init/deb/debian/captagent.default /etc/default/captagent
В данном файле /etc/default/captagent проверим настройки:

# Set to yes to enable captagent, once configured properly.
RUN_CAPTAGENT=yes

# Config file
CFGFILE=/usr/local/captagent/etc/captagent/captagent.xml

Добавим созданный скрпипт в автозапуск #update-rc.d captagent defaults Если требуется удалить скрипт из автозапуска:
# update-rc.d -f captagent remove
Теперь после перезагрузки системы captagent будет запускаться автоматически. Если требуется перезапустить вручную:
# /etc/init.d/captagent restart [ ok ] Restarting captagent (via systemctl): captagent.service.
Советую перезагрузить машину и проверить сервис автоматически стартует. После успешного запуска, проверим корректность работы captagent 1) Что отзеркалированный трафик приходит на порт eth1:

root@homer: # tshark -i eth1 -f "port 9955" -Y "sip"
  3   0.605801 192.168.85.148 -> 84.52.103.XX SIP 485 Request: REGISTER sip:84.52.103.XX:9955  (remove 1 binding) |
  4   0.607631 84.52.103.XX -> 192.168.85.148 SIP 549 Status: 200 Ok  (removed 2 bindings) |
  5   1.879704 192.168.85.148 -> 84.52.103.XX SIP 585 Request: REGISTER sip:84.52.103.XX:9955  (1 binding) |
  6   1.881698 84.52.103.37 -> 192.168.85.148 SIP 534 Status: 401 Unauthorized |
  7   1.882641 192.168.85.148 -> 84.52.103.XX SIP 766 Request: REGISTER sip:84.52.103.XX:9955  (1 binding) |
  8   1.966359 84.52.103.XX -> 192.168.85.148 SIP 553 Status: 200 Ok  (1 binding) |

Отлично, трафик есть. Теперь, то, что captagent отправляет трафик в коллектор Homer:

#:/usr/local/captagent/etc/captagent# tshark -i lo -f "port 9060"
  1   0.000000    127.0.0.1 -> 127.0.0.1    UDP 590 Source port: 56044  Destination port: 9060
  2   0.000659    127.0.0.1 -> 127.0.0.1    UDP 654 Source port: 56044  Destination port: 9060
  3   1.191771    127.0.0.1 -> 127.0.0.1    UDP 690 Source port: 56044  Destination port: 9060
  4   1.193478    127.0.0.1 -> 127.0.0.1    UDP 639 Source port: 56044  Destination port: 9060

Трафик есть. Можно использовать команду с ключом (-V), чтобы убедиться, что приходит содержимое SIP-пакетов и RTCP-статистика. Также можно сравнить сколько сообщений на интерфейс:

tshark -i eth1 -f "host 109.167.135.20" -V | grep @192_168_1_169

И сколько отправлено по HEP:

tshark -i any -f "port 9060" -V | grep @192_168_1_169
mysql> select * from homer_data.sip_capture_call_20171110 where callid='62507640C928E0E9AD0249F00C4AF61B';
mysql>  select * from homer_data.sip_capture_call_20171110 where callid like '%192_168_1_169%';

На этом настройка закончена.

Поддержка  GeoIP

GeoIP позволяет отслеживать из каких стран от клиентов приходит SIP-трафик. В Debian, проверим что пакеты ниже установлены в системе:

# apt-get install geoip-database geoip-database-extra

В файле /etc/kamailio/kamailio.cfg находим

##!define WITH_HOMER_GEO

Проверяем что есть:

#!ifdef WITH_HOMER_GEO
modparam("geoip", "path", "/usr/share/GeoIP/GeoIPCity.dat")
#!endif

Для версии MySQL больше 5.7 в конфигурационном файле my.cnf редактируем его, в моём случае /etc/mysql/mysql.conf.d/mysqld.cnf

В секции [mysqld]
добавил
sql_mode = NO_ENGINE_SUBSTITUTION,STRICT_TRANS_TABLE

Плюс сразу же добавил
bind-address    = 172.17.36.37

В веб-интерфейсе Homer выглядит как карта с “температурой” количества регистраций по странам мира:

У себя на абонентском сервере я этот функционал в итоге отключил.

Возможные проблемы

Не подходит пароль по умолчанию. Установленный по умолчанию пароль можно посмотреть в шаблоне БД который копировался в БД Homer.

$GIT/homer-api/sql/schema_configuration.sql

Если вы зашли в в веб-интерфейс (admin / test123), а там «No Data Available».

При этом вы уверены в следующем: Трафик от агента поступает в коллектор и настройки фильтрации по временному интервалу для этого трафика установлены корректно. То нужно проверить следующее:
Настройки в Panels -> System Admin, апплет Admin Node. Здесь находим запись нужную нам, например, с id 1.

Затем, смотрим учётные данные.

Проверяем учётную запись:

# mysql -uhomer_user -pmysql_password
mysql: [Warning] Using a password on the command line interface can be insecure.
ERROR 1045 (28000): Access denied for user 'homer_user'@'localhost' (using password: YES)

Заходим под root и проверяем пользователей:

mysql> select User from mysql.user;
+-----------+
| User      |
+-----------+
| homer     |
| mysql.sys |
| root      |
+-----------+
3 rows in set (0.00 sec)

Видим, что такого пользователя нет.

mysql> show grants for homer;
+--------------------------------------------+
| Grants for homer@%                         |
+--------------------------------------------+
| GRANT ALL PRIVILEGES ON *.* TO 'homer'@'%' |
+--------------------------------------------+
1 row in set (0.00 sec)

Посмотреть пароль для пользователя homer можно в конфигурации kamailio, файл /etc/kamailio/kamailio.cfg, строки:

#!substdef "!HOMER_DB_USER!homer!g"
#!substdef "!HOMER_DB_PASSWORD!0msFqy2RF!g"
#!substdef "!HOMER_DB_HOST!127.0.0.1!g"
#!substdef "!HOMER_LISTEN_PROTO!udp!g"
#!substdef "!HOMER_LISTEN_IF!0.0.0.0!g"
#!substdef "!HOMER_LISTEN_PORT!9060!g"

Пароль 0msFqy2RF

Проверяем:

# mysql -uhomer -p0msFqy2RF

Список БД:

mysql> show databases;
+---------------------+
| Database            |
+---------------------+
| information_schema  |
| homer_configuration |
| homer_data          |
| homer_statistic     |
| mysql               |
| performance_schema  |
| sys                 |
+---------------------+
7 rows in set (0.00 sec)

Заодно проверим сохраняются ли данные из коллектора:

mysql> homer_data;
mysql> select * from  homer_data.sip_capture_call_20170208 limit 1;

+----+---------------------+------------------+--------+--------------+-----------------------------------+-------------+--------------+-------------+--------------+----------------------------------+-------------+--------------+--------+----------+--------------+-----------+----------------------------------+-------------+-----------------------------------------------------------------------------------------+-------------------------------------------+--------------+-----------+--------+-----------------+------+-----------------+----------------+-------------+----------------+------------------+----------------+--------------+---------------+-----------------+---------+----------------------------------+---------------+---------------+---------------+-------+--------+----------+------+-----------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| id | date                | micro_ts         | method | reply_reason | ruri                              | ruri_user   | ruri_domain  | from_user   | from_domain  | from_tag                         | to_user     | to_domain    | to_tag | pid_user | contact_user | auth_user | callid                           | callid_aleg | via_1                                                                                   | via_1_branch                              | cseq         | diversion | reason | content_type    | auth | user_agent      | source_ip      | source_port | destination_ip | destination_port | contact_ip     | contact_port | originator_ip | originator_port | expires | correlation_id                   | custom_field1 | custom_field2 | |
+----+---------------------+------------------+--------+--------------+-----------------------------------+-------------+--------------+-------------+--------------+----------------------------------+-------------+--------------+--------+----------+--------------+-----------+----------------------------------+-------------+-----------------------------------------------------------------------------------------+-------------------------------------------+--------------+-----------+--------+-----------------+------+-----------------+----------------+-------------+----------------+------------------+----------------+--------------+---------------+-----------------+---------+----------------------------------+---------------+---------------+---------------+-------+--------+----------+------+-----------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|  1 | 2017-02-08 14:52:50 | 1486554770263477 | INVITE |              | sip:79627277780@84.52.103.XX:9955 | 79627277780 | 84.52.103.XX | 327$td | 84.52.103.XX | 81d174040f934c7cbe2702c755b52a79 | 79627277780 | 84.52.103.XX |        |          | 327$td  |           | bee940acfd204d13a6b1347c34104daa |             | SIP/2.0/UDP 192.168.85.148:50933;rport;branch=z9hG4bKPj556ce0e730e84e38b7513b761e8005c4 | z9hG4bKPj556ce0e730e84e38b7513b761e8005c4 | 24262 INVITE |           |        | application/sdp |      | MicroSIP/3.11.0 | 192.168.85.148 |       50933 | 84.52.103.XX   |             9955 | 192.168.85.148 |        50933 |               |               0 |      -1 | bee940acfd204d13a6b1347c34104daa |               |               |               |     1 |      2 |          |    1 | homer01:0 | INVITE sip:79627277780@84.52.103.XX:9955 SIP/2.0
Via: SIP/2.0/UDP 192.168.85.148:50933;rport;branch=z9hG4bKPj556ce0e730e84e38b7513b761e8005c4
Max-Forwards: 70
From: ;tag=81d174040f934c7cbe2702c755b52a79
To: 
Contact: 
Call-ID: bee940acfd204d13a6b1347c34104daa
CSeq: 24262 INVITE
Allow: PRACK, INVITE, ACK, BYE, CANCEL, UPDATE, INFO, SUBSCRIBE, NOTIFY, REFER, MESSAGE, OPTIONS
Supported: replaces, 100rel, timer, norefersub
Session-Expires: 1800
Min-SE: 90
User-Agent: MicroSIP/3.11.0
Content-Type: application/sdp
Content-Length:   554

v=0
o=- 3695554377 3695554377 IN IP4 192.168.1.239
s=pjmedia
b=AS:84
t=0 0
a=X-nat:0
m=audio 4008 RTP/AVP 117 107 9 8 0 110 96 97 3 18 101
c=IN IP4 192.168.1.239
b=TIAS:64000
a=rtcp:4009 IN IP4 192.168.1.239
a=sendrecv
a=rtpmap:117 speex/16000
a=rtpmap:107 SILK/16000
a=rtpmap:9 G722/8000
a=rtpmap:8 PCMA/8000
a=rtpmap:0 PCMU/8000
a=rtpmap:110 speex/8000
a=rtpmap:96 SILK/8000
a=rtpmap:97 iLBC/8000
a=fmtp:97 mode=30
a=rtpmap:3 GSM/8000
a=rtpmap:18 G729/8000
a=fmtp:18 annexb=no
a=rtpmap:101 telephone-event/8000
a=fmtp:101 0-16
 |
+----+---------------------+------------------+--------+--------------+-----------------------------------+-------------+--------------+-------------+--------------+----------------------------------+-------------+--------------+--------+----------+--------------+-----------+----------------------------------+-------------+-----------------------------------------------------------------------------------------+-------------------------------------------+--------------+-----------+--------+-----------------+------+-----------------+----------------+-------------+----------------+------------------+----------------+--------------+---------------+-----------------+---------+----------------------------------+---------------+---------------+---------------+-------+--------+----------+------+-----------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
1 row in set (0.00 sec)

mysql> select id,date,method from  homer_data.sip_capture_call_20170208 order by date desc limit 10;
+----+---------------------+--------+
| id | date                | method |
+----+---------------------+--------+
|  5 | 2017-02-08 14:52:50 | 100    |
|  6 | 2017-02-08 14:52:50 | 100    |
| 20 | 2017-02-08 14:53:02 | 100    |
| 22 | 2017-02-08 14:53:02 | 100    |
| 35 | 2017-02-08 14:53:34 | 100    |
| 36 | 2017-02-08 14:53:34 | 100    |
| 50 | 2017-02-08 14:55:03 | 100    |
| 51 | 2017-02-08 14:55:04 | 100    |
|  9 | 2017-02-08 14:52:52 | 200    |
| 12 | 2017-02-08 14:52:52 | 200    |
+----+---------------------+--------+
10 rows in set (0.00 sec)

mysql> select id,date,method from  homer_data.sip_capture_registration_20170208 order by date desc limit 10;
+----+---------------------+--------+
| id | date                | method |
+----+---------------------+--------+
|  2 | 2017-02-08 14:53:29 | 200    |
|  3 | 2017-02-08 14:58:24 | 200    |
|  5 | 2017-02-08 15:03:19 | 200    |
|  7 | 2017-02-08 15:08:14 | 200    |
|  9 | 2017-02-08 15:10:45 | 200    |
| 14 | 2017-02-08 15:10:46 | 200    |
| 15 | 2017-02-08 15:12:24 | 200    |
| 20 | 2017-02-08 15:12:26 | 200    |
| 21 | 2017-02-08 15:17:21 | 200    |
| 23 | 2017-02-08 15:22:16 | 200    |
+----+---------------------+--------+
10 rows in set (0.00 sec)

Теперь с учётом данных настроек, правим пользователя, также можно поправить имя ноды.

Вторую запись «external» – пример подключения ноды с БД MySQL находящуюся на внешнем сервере, можно деактивировать или удалить.

Включение HEP на Asterisk

Очень просто, но поддерживается только pjsip стек!!! С обычным sip который используется у многих HEP работать не будет!!! Asterisk версий 12+ в Проверяем что модули загружены:

asterisk*CLI> module show like res_hep
Module                         Description                              Use Count  Status      Support Level
res_hep.so                     HEPv3 API                                0          Running          extended
res_hep_rtcp.so                RTCP HEPv3 Logger                        0          Running           unknown

Далее, редактируем /etc/asterisk/hep.conf

;
; res_hep Module configuration for Asterisk
;

; All settings are currently set in the general section.
[general]
enabled = yes                       ; Enable/disable forwarding of packets to a
                                   ; HEP server. Default is "yes".
capture_address = 172.17.36.36:9060 ; The address of the HEP capture server.
capture_password = foo             ; If specified, the authorization passsword
                                   ; for the HEP server. If not specified, no
                                   ; authorization password will be sent.
capture_id = 1235                  ; A unique integer identifier for this
                                   ; server. This ID will be embedded sent
                                   ; with each packet from this server.
uuid_type = call-id                ; Specify the preferred source for the Homer
                                   ; correlation UUID. Valid options are:
                                   ; - 'call-id' for the PJSIP SIP Call-ID
                                   ; - 'channel' for the Asterisk channel name

Применяем конфигурацию:

asterisk*CLI> module reload res_hep.so
Module 'res_hep.so' reloaded successfully.
    -- Reloading module 'res_hep.so' (HEPv3 API)
  == Parsing '/etc/asterisk/hep.conf': Found
asterisk *CLI> module reload res_rtp_asterisk.so
Module 'res_rtp_asterisk.so' reloaded successfully.
    -- Reloading module 'res_rtp_asterisk.so' (Asterisk RTP Stack)

Отправка трафика в коллектор при помощи sngrep и sipgrep

sngrep -H udp:192.168.85.150:9060 -N –q
sipgrep  -H 192.168.85.150:9060

sngrep -H udp:172.17.36.36:9060 -N –q
sipgrep  -H 172.17.36.36:9060

Ограничение в выдаче поиска на 100 записей

Нужно добавить поле «Add Form Field» с именем Limit Query. По умолчанию оно равно 100, далее изменить на нужное значение. Пример ниже.

Что делать если Homer теряет пакеты

Ответ: увеличивать производительность. Чаще всего слабое место – дисковая подсистема. Если трафика много, то нагрузка на неё сильно возрастает. Самый простой способ посмотреть что происходит можно при помощи утилиты iotop:

#iotop
Total DISK READ :       0.00 B/s | Total DISK WRITE :       4.81 M/s
Actual DISK READ:       0.00 B/s | Actual DISK WRITE:       4.84 M/s
  TID  PRIO  USER     DISK READ  DISK WRITE  SWAPIN     IO>    COMMAND
  328 be/3 root        0.00 B/s    0.00 B/s  0.00 % 95.36 % [jbd2/sdb1-8]
  630 be/4 mysql       0.00 B/s    0.00 B/s  0.00 %  4.54 % mysqld --daemonize --pid-file=/var/run/mysqld/mysqld.pid
  921 be/4 mysql       0.00 B/s   92.40 K/s  0.00 %  4.44 % mysqld --daemonize --pid-file=/var/run/mysqld/mysqld.pid
  635 be/4 mysql       0.00 B/s    4.29 M/s  0.00 %  3.04 % mysqld --daemonize --pid-file=/var/run/mysqld/mysqld.pid
  932 be/4 mysql       0.00 B/s  161.70 K/s  0.00 %  0.76 % mysqld --daemonize --pid-file=/var/run/mysqld/mysqld.pid
  925 be/4 mysql       0.00 B/s   80.85 K/s  0.00 %  0.61 % mysqld --daemonize --pid-file=/var/run/mysqld/mysqld.pid
  927 be/4 mysql       0.00 B/s  100.10 K/s  0.00 %  0.18 % mysqld --daemonize --pid-file=/var/run/mysqld/mysqld.pid
  929 be/4 mysql       0.00 B/s   88.55 K/s  0.00 %  0.17 % mysqld --daemonize --pid-file=/var/run/mysqld/mysqld.pid
  607 be/4 root        0.00 B/s    3.85 K/s  0.00 %  0.00 % rsyslogd -n [rs:main Q:Reg]

Total DISK WRITE: 4.81 M/s

Способ 0. Не писать не нужные пакеты.

Для этого отключим запись OPTIONS, Notify и всё остальное. Также GeoIP Все метоты типа OPTIONS и другие сливаются в таблицы ip_capture_rest_годмесяцдень. Посмотрим такую таблицу:

mysql> select date,method  from sip_capture_rest_20180510 ORDER BY date desc limit 5;
+---------------------+-----------+
| date                | method    |
+---------------------+-----------+
| 2018-05-10 14:04:57 | 501       |
| 2018-05-10 14:04:57 | NOTIFY    |
| 2018-05-10 14:04:57 | 404       |
| 2018-05-10 14:04:57 | SUBSCRIBE |
| 2018-05-10 14:04:56 | 501       |
+---------------------+-----------+
5 rows in set (0.01 sec)

Видим, что туда оно и пишется. Открываем kamailio.cfg и меняем строки:

route[STORE] {

        if($rm == "REGISTER") {
                $var(table) = "sip_capture_registration";.......
	drop; #DROP registrations!!!
        }
        else if($rm =~ "(INVITE|UPDATE|BYE|ACK|PRACK|REFER|CANCEL)$")
        {
                $var(table) = "sip_capture_call";
        }.
        else if($rm =~ "(NOTIFY)$" && is_present_hf("Event") && $hdr(Event)=~"refer;")
        {
        #        $var(table) = "sip_capture_call";
	drop; # DROP NOTIFY PACKETS!
        }
        else if($rm =~ "(INFO)$")
        {
                $var(table) = "sip_capture_call";
        }
        else if($rm =~ "(OPTIONS)$" )
        {
        #    $var(table) = "sip_capture_rest";
	drop; # DROP OPTIONS PACKETS!
        }
        else {...
        #    $var(table) = "sip_capture_rest";
	drop; #DROP OTHER!!!!
        }

Можно также частично или полностью отключить регистрации Например, не принимать пакеты REGISER из локальных сетей, редактируем kamailio.cfg:

              if($rm == "REGISTER") {

if(src_ip=~ "192.168.|172.2|10.25") {
drop;
}
                $var(table) = "sip_capture_registration";
#drop; #DROP registrations!!!
        }

Проверяем:

use homer_data;
mysql> select date,method,source_ip  from sip_capture_registration_20180510 ORDER BY date desc limit 20;
+---------------------+----------+----------------+
| date                | method   | source_ip      |
+---------------------+----------+----------------+
| 2018-05-10 17:37:27 | REGISTER | XX.250.251.34  |
| 2018-05-10 17:37:27 | REGISTER | XX.244.27.158  |
| 2018-05-10 17:37:27 | 200      | XX.52.103.50   |
| 2018-05-10 17:37:27 | REGISTER | XX.187.187.229 |
| 2018-05-10 17:37:27 | REGISTER | XX.138.73.46   |
| 2018-05-10 17:37:27 | REGISTER | XX.203.170.220 |
| 2018-05-10 17:37:27 | 200      | XX.52.103.50   |
| 2018-05-10 17:37:27 | 200      | XX.52.103.50   |
| 2018-05-10 17:37:27 | 200      | XX.52.103.50   |
| 2018-05-10 17:37:27 | 200      | XX.52.103.50   |
| 2018-05-10 17:37:27 | REGISTER | XX.249.183.10  |
| 2018-05-10 17:37:27 | REGISTER | XX.244.27.158  |
| 2018-05-10 17:37:27 | 200      | XX.52.103.50   |
| 2018-05-10 17:37:27 | REGISTER | XX.244.27.158  |
| 2018-05-10 17:37:27 | REGISTER | XX.244.27.158  |
| 2018-05-10 17:37:27 | 200      | XX.52.103.50   |
| 2018-05-10 17:37:27 | 401      | XX.52.103.50   |
| 2018-05-10 17:37:27 | 200      | XX.52.103.50   |
| 2018-05-10 17:37:27 | 200      | XX.52.103.50   |
| 2018-05-10 17:37:27 | REGISTER | XX.244.27.158  |
+---------------------+----------+----------------+
20 rows in set (0.00 sec)

Регистрации из серых сетей 192.168.|172.2|10.25 действительно исчезли.

Способ 1. Можно перенести БД на отдельный физический диск.Способ 2. Частичное или полное отключение журналирования файловой системы.

О режимах журналирования ФС: О режимах: Режим data=writeback > файловая система не производит какого либо журналирования данных. При неожиданных перезагрузках системы это может вызвать потерю данных в обновляемых файлах. Данный режим обеспечивает самую высокую производительность. Режим data=ordered > файловая система журналирует только метаданные (данные и метаданные группируются в один модуль – транзакцию). Этот режим, хотя без гарантии, защищает данные при неожиданной перезагрузке, в отличие от предыдущего. Тем не менее полного журналирования не происходит. Производительность уступает data=writeback, но она гораздо быстрее полного журналирования. Режим data=journal > обеспечивает полное журналирование метаданных и самих данных. Данные сначала пишутся в журнал и потом только переносятся на постоянное место. При аварийных ситуациях журнал можно перечитать – приведя данные в непротиворичивое состояние. Данный режим самый медленный, но в отдельных случаях он показывает хорошие результаты. Он имеет преимущества при одновременных операциях ввода/вывода данных (при записи и одновременном чтении, скорость чтения в тестах была выше на порядок чем при других режимах). Попробуем:

# df -h
Filesystem      Size  Used Avail Use% Mounted on
/dev/sda1       397G  2.2G  375G   1% /
udev             10M     0   10M   0% /dev
tmpfs           1.6G  149M  1.5G  10% /run
tmpfs           4.0G     0  4.0G   0% /dev/shm
tmpfs           5.0M     0  5.0M   0% /run/lock
tmpfs           4.0G     0  4.0G   0% /sys/fs/cgroup
/dev/sdb1       413G   17G  376G   5% /var/lib/mysql

# /etc/init.d/captagent stop
[ ok ] Stopping captagent (via systemctl): captagent.service.
# /etc/init.d/kamailio stop
[ ok ] Stopping kamailio (via systemctl): kamailio.service.
# /etc/init.d/mysql stop
[ ok ] Stopping mysql (via systemctl): mysql.service.

В /etc/fstab выставляем data=ordered для нашего раздела mysql

UUID=4a439b75-c7aa-4bd6-ad27-88ff5f44d38d /var/lib/mysql  ext4    defaults,data=ordered        0       2

# umount /dev/sdb1
# tune2fs -o journal_data_ordered /dev/sdb1
# tune2fs 1.42.12 (29-Aug-2014)
# e2fsck -f /dev/sdb1
# e2fsck -f /dev/sdb1
e2fsck 1.42.12 (29-Aug-2014)
Pass 1: Checking inodes, blocks, and sizes
Pass 2: Checking directory structure
Pass 3: Checking directory connectivity
Pass 4: Checking reference counts
Pass 5: Checking group summary information
/dev/sdb1: 485/27475968 files (13.2% non-contiguous), 5957890/109886720 blocks

Проверить как работает:

# dumpe2fs /dev/sdb1 | more
Default mount options:    journal_data_ordered user_xattr acl

# mount /dev/sdb1

# cat /var/log/messages
Dec 28 17:00:02 Homer-2 kernel: [174342.839424] EXT4-fs (sdb1): mounted filesystem with ordered data mode. Opts: (null)

# /etc/init.d/mysql start
# /etc/init.d/kamailio start
# /etc/init.d/captagent start

Режим отключения журналирования.

Очень осторожно, операционная система может не загрузиться. Если мы меняем настройку – ключ ядра, то после старта система пытается проверять раздел sdb и в итоге не грузится вообще. С режимом полного отключения журналирования в журалируемой ФС надо быть крайне осторожным.

# nano /etc/default/grub.cfg

Добавляем в существующие строки:

GRUB_CMDLINE_LINUX="rootflags=data=writeback"

Обновляем grub.

sudo update-grub

Правим fstab:

mcedit /etc/fstab

В моём случае, добавляем data=writeback:

# /var/lib/mysql was on /dev/sdc1 during installation

 UUID=4a439b75-c7aa-4bd6-ad27-88ff5f44d38d /var/lib/mysql ext4 defaults,data=writeback 0 2
 
Выполняем:

  tune2fs -o journal_data_writeback /dev/sdb1

Проверяем:

tune2fs -l /dev/sdb1

Этот метод чреват тем, что можете потерять некоторые данные при неожиданном выключении системы, например если у вас неожиданно отключилось питание (мне это не грозит, поскольку у меня ещё батарея есть)

Веб-интерфейс Homer

Открываем IP-адрес сервера в веб-браузере, логин и пароль по умолчанию:  admin / test123.
После успешной авторизации мы попадаем в главное меню где размещаются настраиваемые виджеты

Виджет вверху слева – быстрый поиск, справа – график количества различных SIP-сообщений за указанный интервал. Сам интервал выбирается в верхнем правом углу. С выбором интервала нужно быть очень внимательным. Система запоминает какой  интервал был выбран даже после повторной авторизации. Так, после повторного входа через месяц установиться временной интервал месячной давности. Он же будет использован при поиске SIP-трейсов и отображения статистики, со всеми вытекающими “No Data Available”.

Меню выбора даты выглядит вот так:

Выставляем нужный интервал и интервал по шаблону. Можно выставить авто обновление диапазона времени. Основное меню выглядит следующим образом:

SIP-search – меню поиска по сохранённым SIP-трейсам. Ниже форма поиска, она настраивается.

Поиск можно осуществлять как по одному из полей так и по их комбинации “И”. Можно использовать не точный поиск  наподобие %7962727%.
Значение параметра Limit Query определяет какое максимальное количество результатов будет выдаваться за раз. Обращаю внимание на параметр DB Node. В Homer можно подключить кроме локальной БД, любое количество внешних БД и одновременно искать в них нужные трейсы. Например, у меня есть две инсталляции Homer с двумя отдельными БД, я подключил обе БД в веб-интерфейсе и могу искать нужные мне вызовы или в одной или сразу в двух БД. Это очень удобно. Таким образом можно агрегировать огромный объём трафика и разделить нагрузку и ускорить поиск нужных данных.

Не забыть проверить:

root@homer-2:/etc/mysql/conf.d#  netstat -anp | grep mysql
tcp        0      0 127.0.0.1:3306          0.0.0.0:*               LISTEN      12015/mysqld

nano /etc/mysql/mysql.conf.d/mysqld.cnf

#bind-address = 127.0.0.1
bind-address = 0.0.0.0


root@homer-2:/etc/mysql/mysql.conf.d# /etc/init.d/mysql restart
[ ok ] Restarting mysql (via systemctl): mysql.service.
root@homer-2:/etc/mysql/mysql.conf.d# netstat -anp | grep mysql
tcp        0      0 0.0.0.0:3306            0.0.0.0:*               LISTEN      12219/mysqld

Ищем по двум БД:

Получаем следующий вывод:

Мы нашли SIP-трейсы для указанного номера на двух узлах. При нажатии на CallID вызова всплывает модальное окно с детальным обменом SIP-сообщениями.

Здесь есть 3 вкладки, собственно Call-Flow это сам трейс. Он представлен в графическом виде, стрелками указаны направления сообщений – кто инициатор и кто получатель. При нажатии на каждое из SIP-сообщений диалога открывается его полный листинг (вкладка Messages)

На вкладке Details представлены все поля по которым может быть найдено сообщение. В примере ниже на изображении часть из них.

Рассмотрим другие вкладки.

Вкладка QoS Reports показывает RTP статистику:

Вкладка Export служит для экспорта вызова в различных форматах

• PCAP дамп
• Текстовый файл
• Изображение png
• Архивом
• Share Cloud и Share Link крайне удобно чтобы просто отправить ссылку но настраивается отдельно.

Следующий пункт меню Alarm Settings.

Здесь можно добавить оповещение администратора о том что превышена заданное число тех или иных сообщений

Пункт Geo Chart отображает статистику по IP-адресам на карте мира.
Пункт Get Started – краткий обзор веб-интерфейса
Пункт Stats: VoIP Traffic – статистика по трафику за заданный интервал.

Пункт System Admin. Здесь настраиваются:

• Пользователи и их права. Каждый пользователь может настроить персонально виджеты и их расположение.
• Алиасы узлов, например, чтобы в выдаче поиска вместо его IP-адреса 10.10.10.10 Homer показывал алиас 3053_CCM6-pub
• БД Homer

Вкладка IP-network показывает статистику по IP.

Homer также имеет API при помощи которых можно получить нужную информацию путём HTTP запросов в формате JSON.

Выводы

Homer является отличным бесплатным решением для анализа SIP-трафика. Уже сегодня  активно используется различными компаниями и операторами связи.

Плюсы

• Простота установки и настройки
• Отсутствие лицензирования
• “Перемалывает” большие объёмы трафика
• Хорошая визуализация SIP-трейсов
• Возможность экспорта SIP-трейсов в различные форматы

Минусы

• Отсутствие подробной документации
• Требователен к дисковой подсистеме
• “Тихая” потеря трафика при высокой нагрузке

Автор: Игнат Кудрявцев

The post Обзор Homer 5 first appeared on Unified Communications Expert.

Значения 1 кнопки Standby/Active LED приведены в таблице ниже:

Значения на первом из шести диодов линий резервного электропитания DC Output LED показывают статус линии. Каждый диод отвечает за соответствующее гнездо, куда включен кабель от коммутатора (всё вместе образует линию электропитания).

Кнопка Select служит для выбора или всех портов или индивидуального порта RPS
Кнопка Standby/Active для изменения  выбранных портов (или всех портов) между режимом ожидания standby mode (мигает жёлтым) или активного режима (горит зелёным). STDBY/ACTIVE LED диод отображает статус конкретного порта.
После включения RPS 2300 все порты находятся в активном режиме
Для изменения состояния всего RPS 2300 или конкретного пора в активный режим или режим ожидания, нужно сделать следующее:
Нажать кнопку Select. При нажатии один раз, будут выбраны все порты – они одновременно замигают желтым и зелёным цветом, продолжайте нажимать кнопку Select пока не замигает нужный порт, также зелёным и жёлтым цветом, теперь нажмите кнопку Standby/Active для установки порта линии электропитания в активный или режим ожидания, повторите процедуру для всех нужных портов.
Важно!!! Если вы нажмёте кнопку Standby/Active на RPS 2300 до нажатия кнопки Select, RPS ПЕРЕКЛЮЧИТ ВСЕ 6 ПОРТОВ между активным режимом и режимом ожидания. Если это произошло нужно нажать кнопку Select ещё раз для выбора нужного порта.
Когда RPS 2300 в режиме ожидания, все диоды портов к которым подключены коммутаторы мигают жёлтым, это значит что RPS 2300 подключен, но не функционирует.
При нажатии кнопки Standby/Active на выбранном порте линии электропитания, цвет диода порта изменит цвет на зелёный указывая что RPS 2300 резервировать линию электропитания порта.

Если основное электропитание на коммутаторе отключилось, то диод DC Output LED будет мигать зелёным сигнализируя что электропитание переключено на RPS 2300.
Теперь, даже если на основном источнике вновь появилось электропитание, коммутатор всё равно будет брать его от RPS и если вы просто вытащите из коммутатора кабель резервного питания, то он попросту выключится, автоматом назад он не переключится. И тут многие сразу удивятся, ведь любой сервер с двумя блоками питания или подобное устройство с нормальным резервированием питания не выключится! Но не устройство зарезервированное Cisco RPS2300!
Чтобы его переключить назад, надо перевести  линию коммутатора (а не всю RPS!) на RPS в режим Standy путём нажатия на кнопку Standby/Active,  затем  кнопкой Select выбрать нужную линию (должна замигать желто-зелёным), нажать Standby/Active, диод линии должен замигать Жёлтым и соответствующий коннектор DC Output также замигать жёлтым.
Вот после этого коммутатор вновь начнёт работать от основного источника.
Если коммутатор переключился на резервное питание, лучше перевести его назад, так как если что случиться с RPS коммутатор выключится.
Есть ещё один вариант: из консоли свитча перевести порт rps из состояния active в standby это описано на странице 12-29 руководства Catalyst 3750 Switch Software Configuration Guide:

If you do not want the RPS 2300 to provide power to a switch, but do not want to disconnect the cable between the switch and the RPS 2300, use the power rps switch-number port rps-port-id mode standby user EXEC command.
mode –  Set the mode of the RPS 2300 port:
•    active  – The RPS 2300 can provide the power to a switch when the switch internal
power supply cannot.
•    Standby –The RPS 2300 is not providing power to a switch. The default mode for RPS ports is active.

Итак,
чтобы переключать на нужный порт нужно нажать кнопку Select столько раз чтобы замигал номер диода соответствующий разъёму (DC Output LEDs) куда подключен кабель.
Если диод Standby/Active LED мигает жёлтым то RPS 2300 находится в режиме Standby, те выключено. При отключении основного питания на RPS переключения не будет и коммутатор отключится.
Если Standby/Active LED выключен, то один из блоков питания RPS  не подключен.
Если один или больше разъём RPS (DC Output LEDs) мигает жёлтым, то он находится в режиме Standby, при помощи кнопки Standby/Active его нужно переключить в активный режим (Ready), еще может быть вариант что RPS не может подключиться к устройству.
Если коммутатор подключен к основному питанию, нужно убедиться что RPS Standby/Active LEDs горит зелёным, если это не так, мигает жёлтым, то система не будет резервировать питание.
Далее, включаем коммутатор в коннектор DC Output при помощи силового кабеля, порт должен загореться зелёным, это значит, что коммутатор готов резервировать систему.
Мануал где всё описано Cisco Redundant Power System 2300 Hardware Installation Guide.

Лучше сразу купить коммутатор с двумя блоками питания, чем потом докупать такую хитрую штуку, которая, кстати, давно уже End-of-sale, а если вам нужно её использовать, то очень внимательно читайте инструкцию во избежание потери питания на коммутаторе.

Несколько фотографий RPS 2300

Шасси и вытащенные из него блоки питания.

Порты линий электропитания для подключения силовых кабелей.

Кабель питания для коммутаторов, очень добротно сделан. Стоят такие кабели доброго наверное из за логотипа Cisco на них.

Заглушки шасси.

Комплект крепления шасси.

Замена блока питания на коммутаторе Cisco Catlyst 3750

Заказал такой БП: LITEON PA-1201-1 Cisco

Вообще, купил Cisco RPS2300 потому что на Cisco Catlyst 3750 сгорел блок питания, вероятно из за скачка напряжения. Коммутатор работал до этого около пяти лет постоянно. Заменил в нем БП на такой как на фотографии ниже, это достаточно просто сделать. А вот найти и купить такой блок питания было не просто.

Коммутатор Cisco Catalyst 3750 в разобранном состоянии без блока питания

Уже с новым блоком питания

Подключается вот таким коннектором

После установки коммутатор заработал как и прежде.

The post Cisco RPS 2300 и замена БП Catalyst 3750 first appeared on Unified Communications Expert.

Простота и удобство настройки виртуальной АТС через веб-интерфейс сегодня зачастую определяет успех и востребованность той или иной виртуальной АТС на рынке, поэтому многие разработчики борются за юзабилити графического интерфейса дабы реализовать концепцию «Easy PBX»(перевод с англ. Простая АТС), это когда ВАТС может настроить и использовать потребитель услуги не являющийся специалистом в области телефонии, тем более, технологий VoIP. Данная реализация является простой и удобной, приближенной к «Easy PBX», поэтому я решил написать о ней. Кстати, на вопрос чем отличается облачная АТС (ОАТС) от виртуальной АТС (ВАТС) могу дать ответ: в целом ничем не отличается, просто разные названия одной сути.

Данная ВАТС полностью управляется через веб-браузер при помощи веб-интерфейса.

В веб-интерфейсе есть два уровня доступа:

• Администратор с полными правами – «видит” все настройки ВАТС.
• Пользователь, «не видит” никаких настроек – рабочей области сценария и элементы схемы, но видит всю (и свою и чужую) историю вызовов и записи разговоров

Мне очень понравилась идея настройки виртуальной АТС (ВАТС) – слева в меню элементы схемы кружки – логические модули содержащие функции обработки вызова, например, голосовое меню, группа пользователей, анонс, внутренний пользователь, справа «рабочий стол» или область сценария, на который помещаются эти логические элементы в нужном порядке, начиная от точки поступления вызова вверху (например, входящий звонок с городского номера) и его выхода из логики виртуальной АТС внизу (например, на SIP-абонента), затем, в зависимости от желаемого сценария, модули соединяются линиями – логическими связями, которые определяют какой логический модуль будет следовать после завершения обработки вызова в предыдущем модуле. Например, модуль, «Входящий вызов» с городского номера – сюда первым делом попадает позвонивший в компанию клиент, в модуле можно включить мелодию вместо гудков, дальше, в соответствии с тем как мы решили строить сценарий, для нашего входящего вызова, перетаскиваем следующий модуль из меню слева – «Элементы схемы» и соединяем с предыдущим, например, фильтр звонков. В модуле «Фильтр звонков» вводим А-номера нежелательных клиентов, которых хотим отфильтровать, на выходе из этого модуля есть два варианта:

«Да» – вызов уходит по этому пути если в фильтре «попался» указанный номер, отправляем его на следующий модуль «Анонс», где проигрывается сообщение что компания не работает, затем передается уведомление по API – следующий модуль и отбой,

«Нет» – в этом случае на модуль «График работы». В модуле «График работы» проверяем расписание, если сейчас не рабочие часы компании, что соответствует результату «Нет», отправляем вызов на модуль «Анонс» где ему сообщается что «Мы закрыты» и вешается трубка. Если в данный момент рабочие часы, то вызов направляется на по пути «Да» на следующий модуль «Голосовое меню», где позвонившему проигрывается приветствие, здесь он может нажатием кнопки на телефоне (DTMF-сигналом) выбрать с каким отделом соединиться или подождать ответа оператора. И так далее.
Схема получается очень простой и наглядной. Для тестирования я создал сценарий представленный ниже.

Теперь по каждому модулю виртуальной АТС (ВАТС). Как я написал выше, модуль — это логический элемент общего сценария обработки вызова, пример которого представлен выше. Вызов с городского номера попадает в сценарий, двигается сверху вниз, проходя через логические модули обрабатывается в соответствии с настройками, указанными в этих модулях. На исходящую связь на внутренних номерах каждый из которых представлен отдельным модулем указывается каким городским номером закрывать внутренний номер.

При добавлении модулей в рабочую область они автоматически сохраняются, но клонировать модули нельзя. Если в дереве ошибка – сразу сброс. Есть интерактивная справка – описание большинства полей. Плюс есть общая справка с анимацией.

Модуль «Входящий звонок»

Модуль является отправной точкой обработки входящего вызова. Тут можно настроить только мелодию вместо гудков.

Модуль «Фильтр звонков»

Позволяет отфильтровать вызовы оп А-номерам или их маскам.

Определяет куда пойдут вызовы по условию Фильтра – подключаем на «Да». Будь то Сотрудник, Группа или другой элемент. На «Нет» уйдут все остальные звонки.

Модуль «График Работы»

Проверяет время, если фильтр по временным интервалам совпал с текущем временем, вызов уходит по направлению «Да», в противном случае – «Нет»

Ограничения:

• Только недельное расписание на 7 дней, без дат в году
• Нельзя настроить несколько рабочих интервалов для одного дня, но это можно решить каскадированием модулей «График работы» один за другим

Модуль «Голосовое меню»

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

Цифры выбора с 0-9,*(звёздочка) — соответствуют кнопкам при нажатии абонента на которые вызов переводится на указанный в меню модуль. Выбор «E» – соответствует ошибочному вводу абонента.
Ограничения:

• Нельзя указать таймаут ожидания ввода цифры меню
• Нельзя указать сколько раз проиграть аудио файл голосового меню
• Нельзя больше одно раза сделать ошибку ввода и остаться в меню
• Нет возможности разрешать/запрещать набор внутреннего номера сотрудника через меню – он просто всегда работает

Модуль «Анонс

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

Модуль «Уведомление»

Присылает уведомления по SMS с текстом, который указан в поле «Текст уведомления» + номер звонящего.

Ограничения:

• Нельзя отправлять уведомления по e-mail.

Модуль «API»

Как работает непонятно, в документации ничего нет.

Вот что прилетело на сервер 84.52.94.245  (видимо стиль Call Tuch):

47  14.093872 91.217.178.35 -> 84.52.94.245 HTTP 278 GET /action=callconnected&apikeytest&sessionid=1521725382.23&callid=1521725382.23&callerid=74732500000&phonenumber=78123332211 HTTP/1.1
49  14.095428 84.52.94.245 -> 91.217.178.35 HTTP 868 HTTP/1.1 500 Internal Server Error  (text/html)

А и Б номер и некие ID.

Модуль «Группа пользователей»

Модуль реализует функционал группового вызова. Когда вызов попадает в данный модуль, вызываются указанные в настройках внутренние пользователи по определённому алгоритму с определённым таймаутом.

Примечательно, что если соединить разные цифры с одним пользователем – возникает критическая ошибка. И все соединительные линии исчезают.

Вероятно, в группе может быть до 9 участников. Т – это таймаут обзвона (Время в очереди), может принимать дискретные значения из списка от 30 секунд до 10 минут, также при помощи соединительной линии с T можно «запетлевать» вызов.

В общем это группа с функцией очереди.

Есть следующие стратегии (алгоритмы) обзвона

Модуль «Внутренний пользователь»

Внутренний SIP-абонент.

Модуль добавляет внутреннего пользователя, на котором может быть 1 SIP-терминал.

Вкладка «Основные»:

Можно добавить переадресацию на мобильный. Здесь выбирается каким городским А-номером (или АОНом) на исходящую связь закрывать данный внутренний номер. Включить или выключить запись разговоров.
Тут же ещё есть одна интересная настройка «Номер в роуминге»:
Выбираем нужного пользователя и вызываем меню настройки. Вводим номер сотрудника в роуминге. Сохраняем изменения.
Теперь при звонке с роумингового номера на ВАТС, вызов будет отбит. Затем АТС перезвонит, и для связи с нужным абонентом нужно просто ввести его телефон.
Иными словами – это обратный вызов с контролем по А-номеру. Единственный минус – не всегда А-номер из за границы корректно передаётся (может прилететь “левый” номер).

Настройки SIP-терминала:

Веб-доступ:

Если включить администратора, то пользователь может настраивать ВАТС, иначе сможет только просмотреть ВСЕ вызовы и послушать ВСЕ записи вызовов, а не только свои. И логин 20179 (хотя учётная запись будет основного администратора домена) трудновато запомнить, пароль тоже символьный.

Модуль «Звонок с сайта»

Заставить его работать не удалось. Но в принципе сделано просто и симпатично.
Настраивается на 3 вкладках, я так и не понял, как указать кому из менеджеров должен прийти вызов.

Вот как выглядит на сайте:

При нажатии на трубку разворачивается форма.

Модуль «SIP-номер»

Можно завернуть на ВАТС SIP-номер от другого оператора.

Но только на входящую связь. То есть купить ВАТС без номера оператора не получится.

С внешними SIP-провайдерами работает отлично.

Модуль «Удалённый доступ»

Удаленный доступ – элемент используется в схеме для того, чтобы сотрудники смогли звонить через ВАТС со своих мобильных на другие внешние номера, например, на междугородние и международные.

Если сотрудник звонит с мобильного, затем попадает на этот модуль, сверяется его А-номер, если он в разрешён, сотрудник может набирать любой номер и звонить от имени ВАТС.

Модуль «Внешняя АТС»

Здесь можно подключить свою АТС. На виртуальной АТС выделяется SIP-акаунт, своя АТС (например, Asterisk клиента) регистрируется при помощи этого аккаунта. Можно авторизоваться по логину и паролю, можно по IP-адресу.
Выбрать городской А-номер, которым будут закрываться вызовы в город через виртуальную АТС, чтобы позвонить на АТС выделяется номер 400, внутренний абонент, например, 201 набирает 400 и попадает на виртуальная АТС.

История вызовов и записи разговоров

Отлично сделано — всё просто, но вся необходимая информация присутствует. Сразу видно кто куда звонил, во сколько, кто принял вызов. Вызовы можно прослушать в браузере или скачать.
Единственное – нет массовой выгрузки. Здесь не отображается стоимость совершённых вызовов.

Готовые шаблоны ВАТС

Для совсем «ленивых» есть готовые шаблоны настроек, нажимаешь кнопку и есть преднастроенный вариант, например, «малый бизнес», «горячая линия», «интернет магазин» и так далее.

Выводы

Реализация удачная, виртуальную АТС действительно просто настроить и использовать. Тут просто один рабочий стол и конструктор. Есть готовые шаблоны настроек. Причём абонент может под своей учётной записью может настроить просто SIP-линию или целую виртуальную АТС. Грани между классическим услугами SIP-линии и виртуальной АТС стираются.
Минусы:

• Почти полное отсутствие интеграции с CRM. Так как в графической схеме обмен с CRM может происходить в разных точках, интересно как это будет реализовать на практике.
• Все уведомления построены только на SMS, хорошо бы добавить, e-mail и месседжер Telegram или подобный
• Не все по всем модулям есть справка
• Нет сервиса отправки факсов
• Нет личного кабинета для абонента, нельзя посмотреть только свои CDR и записи вызовов
• Нет массовой выгрузки записанных разговоров
• В истории вызовов не отображается их стоимость
• Ограниченная гибкость в настройки сценариев за счёт простоты – реализуются только базовые сценарии обработки вызовов
• Завести номера сторонних операторов можно только на входящую связь
• Сервер указан в виде IP-адреса, а не DNS имени. Для всех одинаковый
• Для RTP используется отдельный IP-адрес, который нигде не афишируется
• Внутренние номера нельзя менять, идут поп порядку с 200 при создании
• В состоянии регистрации нельзя посмотреть IP-адрес с которого зарегистрирован и модель терминала (UA) пользователя
• Есть ограничения в модуле «голосовом меню», подробнее в описании работы модуля
• Есть ограничения в модуле «график работы», подробнее в описании работы модуля
• Не удалось заставить работать модуль «Звонок с сайта». Также я не понял где указывается с кем из абонентов станции соединять посетителя сайта, который заказал вызов на сайте

The post Обзор удачной реализации интерфейса виртуальной АТС (ВАТС) first appeared on Unified Communications Expert.

Примечание на 2026 год. Cisco 79XX за NAT работает, но это хрупкая legacy-схема. По возможности держите телефоны и АТС в одной управляемой сети или используйте VPN/SBC. Внешний адрес в примере ниже — документационный 203.0.113.10; замените его на свой реальный публичный IP.

Пример ниже написан для телефона Cisco 7945, но также подойдет для остальных телефонов серии, например Cisco 7942, Cisco 7940 и т.д. Итак, проблемы с которыми придётся столкнуться при настройке телефона:

• Отсутствие веб-интерфейса (он есть, но в нём ничего не настроить)
• Необходимость использовать TFTP-сервер и написать конфигурацию в формате XML.
• Есть особенности настройки телефона за NAT
• Нужно знать как посмотреть состояние телефона и включить отладку

Сначала нужно обновить телефон правильной версии SIP-прошивки (cmterm-7945_7965-sip.8-5-4.zip), инструкция находится здесь: /archives/5468

У нас будет две линии. Ниже приводится пример настройки для оператора Telphin.

Линия L1:
userid/auth=000155555
pass=ClasddfH
812 3090000

Линия L2:
userid/auth=000155556
pass=ddfHClas
812 3090001
server=voice.telphin.com
port=5068

Внешний IP-адрес и порт маршрутизатора (документационный пример внешнего IP):

203.0.113.10:5068

Тут важный момент, что мы указываем для первой и второй линии один и тот же входящий порт 5068 (теги <sipPort> на первой и второй линиях), хотя можно использовать любой другой порт. На маршрутизаторе с внешним IP-адресом (203.0.113.10) нужно его прокинуть на IP-адрес телефона (192.168.2.5) и порт (5068). В нашем примере это 192.168.2.5, порт 5068. Также мы указываем телефону, что он находится за NAT и указываем внешний IP-адрес, который будет подставляться в тегах SIP-сообщений.

<natEnabled>true</natEnabled>
<natAddress>203.0.113.10</natAddress>

Для отладки телефона нужен доступ к его консоли по SSH, для этого нужно указать логин и пароль для доступа при помощи следующих тегов:

<sshUserId>cisco</sshUserId>
<sshPassword>badpassword</sshPassword>

В примере 192.168.2.5 это IP-адрес телефона Cisco 7945. Пишем конфигурацию и загружаем её в телефон (подробности как это сделать в предыдущей инструкции /archives/5468):

cat SEP00235E186B89.cnf.xml
<?xml version="1.0" encoding="UTF-8"?>
<device  xsi:type="axl:XIPPhone" ctiid="966" uuid="{ec039a47-2b24-d05b-6ae3-2c18e269a9df}">
<fullConfig>true</fullConfig>
<deviceProtocol>SIP</deviceProtocol>
<sshUserId>cisco</sshUserId>
<sshPassword>56awesZ</sshPassword>
<devicePool>
<revertPriority>0</revertPriority>
<name>Default</name>
<dateTimeSetting>
<name>CMLocal</name>
<dateTemplate>D.M.Y</dateTemplate>
<timeZone>Saudi Arabia Standard Time</timeZone>
<ntps>
<ntp>
<name>192.168.2.5</name>
<ntpMode>Unicast</ntpMode>
</ntp>
</ntps>
</dateTimeSetting>
<callManagerGroup>
<name>Default</name>
<tftpDefault>false</tftpDefault>
<members>
<member  priority="0">
<callManager>
<name>Telphin</name>
<description>ucexpert.ru</description>
<ports>
<ethernetPhonePort>2000</ethernetPhonePort>
<sipPort>5068</sipPort>
<securedSipPort>5061</securedSipPort>
<mgcpPorts>
<listen>2427</listen>
<keepAlive>2428</keepAlive>
</mgcpPorts>
</ports>
<processNodeName>127.0.0.1</processNodeName>
</callManager>
</member>
</members>
</callManagerGroup>
<srstInfo>
<name>Disable</name>
<srstOption>Disable</srstOption>
<userModifiable>false</userModifiable>
<ipAddr1></ipAddr1>
<port1>2000</port1>
<ipAddr2></ipAddr2>
<port2>2000</port2>
<ipAddr3></ipAddr3>
<port3>2000</port3>
<sipIpAddr1></sipIpAddr1>
<sipPort1>5068</sipPort1>
<sipIpAddr2></sipIpAddr2>
<sipPort2>5068</sipPort2>
<sipIpAddr3></sipIpAddr3>
<sipPort3>5068</sipPort3>
<isSecure>false</isSecure>
</srstInfo>
<mlppDomainId>-1</mlppDomainId>
<mlppIndicationStatus>Default</mlppIndicationStatus>
<preemption>Default</preemption>
<connectionMonitorDuration>120</connectionMonitorDuration>
</devicePool>
<sipProfile>
<sipProxies>
<registerWithProxy>true</registerWithProxy>
</sipProxies>
<sipCallFeatures>
<cnfJoinEnabled>true</cnfJoinEnabled>
<callForwardURI>x-cisco-serviceuri-cfwdall</callForwardURI>
<callPickupURI>x-cisco-serviceuri-pickup</callPickupURI>
<callPickupListURI>x-cisco-serviceuri-opickup</callPickupListURI>
<callPickupGroupURI>x-cisco-serviceuri-gpickup</callPickupGroupURI>
<meetMeServiceURI>x-cisco-serviceuri-meetme</meetMeServiceURI>
<abbreviatedDialURI>x-cisco-serviceuri-abbrdial</abbreviatedDialURI>
<rfc2543Hold>false</rfc2543Hold>
<callHoldRingback>2</callHoldRingback>
<localCfwdEnable>true</localCfwdEnable>
<semiAttendedTransfer>true</semiAttendedTransfer>
<anonymousCallBlock>2</anonymousCallBlock>
<callerIdBlocking>2</callerIdBlocking>
<dndControl>0</dndControl>
<remoteCcEnable>true</remoteCcEnable>
<retainForwardInformation>false</retainForwardInformation>
</sipCallFeatures>
<sipStack>
<sipInviteRetx>6</sipInviteRetx>
<sipRetx>10</sipRetx>
<timerInviteExpires>180</timerInviteExpires>
<timerRegisterExpires>300</timerRegisterExpires>
<timerRegisterDelta>5</timerRegisterDelta>
<timerKeepAliveExpires>120</timerKeepAliveExpires>
<timerSubscribeExpires>120</timerSubscribeExpires>
<timerSubscribeDelta>5</timerSubscribeDelta>
<timerT1>500</timerT1>
<timerT2>4000</timerT2>
<maxRedirects>70</maxRedirects>
<remotePartyID>true</remotePartyID>
<userInfo>None</userInfo>
</sipStack>
<autoAnswerTimer>1</autoAnswerTimer>
<autoAnswerAltBehavior>false</autoAnswerAltBehavior>
<autoAnswerOverride>true</autoAnswerOverride>
<transferOnhookEnabled>false</transferOnhookEnabled>
<enableVad>false</enableVad>
<preferredCodec>none</preferredCodec>
<dtmfAvtPayload>101</dtmfAvtPayload>
<dtmfDbLevel>3</dtmfDbLevel>
<dtmfOutofBand>avt</dtmfOutofBand>
<kpml>3</kpml>
<natEnabled>true</natEnabled>
<natAddress>203.0.113.10</natAddress>
<phoneLabel>Some Label</phoneLabel>
<stutterMsgWaiting>2</stutterMsgWaiting>
<callStats>true</callStats>
<offhookToFirstDigitTimer>15000</offhookToFirstDigitTimer>
<silentPeriodBetweenCallWaitingBursts>10</silentPeriodBetweenCallWaitingBursts>
<disableLocalSpeedDialConfig>true</disableLocalSpeedDialConfig>
<poundEndOfDial>false</poundEndOfDial>
<startMediaPort>16384</startMediaPort>
<stopMediaPort>32766</stopMediaPort>
<sipLines>
<line  button="1" lineIndex="1">
<featureID>9</featureID>
<featureLabel>812 3090000</featureLabel>
<proxy>voice.telphin.com</proxy>
<port>5068</port>
<name>000155555</name>
<displayName>000155555</displayName>
<autoAnswer>
<autoAnswerEnabled>2</autoAnswerEnabled>
</autoAnswer>
<callWaiting>3</callWaiting>
<authName>000155555</authName>
<authPassword>ClasddfH</authPassword>
<sharedLine>false</sharedLine>
<messageWaitingLampPolicy>3</messageWaitingLampPolicy>
<messageWaitingAMWI>0</messageWaitingAMWI>
<messagesNumber></messagesNumber>
<ringSettingIdle>4</ringSettingIdle>
<ringSettingActive>5</ringSettingActive>
<contact>000155555</contact>
<forwardCallInfoDisplay>
<callerName>true</callerName>
<callerNumber>false</callerNumber>
<redirectedNumber>false</redirectedNumber>
<dialedNumber>true</dialedNumber>
</forwardCallInfoDisplay>
</line>
<line  button="2" lineIndex="2">
<featureID>9</featureID>
<featureLabel>812 3090001</featureLabel>
<proxy>voice.telphin.com</proxy>
<port>5068</port>
<name>000155556</name>
<displayName>000155556</displayName>
<autoAnswer>
<autoAnswerEnabled>2</autoAnswerEnabled>
</autoAnswer>
<callWaiting>3</callWaiting>
<authName>000155556</authName>
<authPassword>ddfHClas</authPassword>
<sharedLine>false</sharedLine>
<messageWaitingLampPolicy>3</messageWaitingLampPolicy>
<messageWaitingAMWI>0</messageWaitingAMWI>
<messagesNumber></messagesNumber>
<ringSettingIdle>4</ringSettingIdle>
<ringSettingActive>5</ringSettingActive>
<contact>000155556</contact>
<forwardCallInfoDisplay>
<callerName>true</callerName>
<callerNumber>false</callerNumber>
<redirectedNumber>false</redirectedNumber>
<dialedNumber>true</dialedNumber>
</forwardCallInfoDisplay>
</line>
</sipLines>
<externalNumberMask></externalNumberMask>
<voipControlPort>5068</voipControlPort>
<dscpForAudio>184</dscpForAudio>
<dscpVideo>136</dscpVideo>
<ringSettingBusyStationPolicy>0</ringSettingBusyStationPolicy>
<dialTemplate>dialplan.xml</dialTemplate>
<alwaysUsePrimeLine>false</alwaysUsePrimeLine>
<alwaysUsePrimeLineVoiceMail>false</alwaysUsePrimeLineVoiceMail>
</sipProfile>
<MissedCallLoggingOption>10</MissedCallLoggingOption>
<commonProfile>
<phonePassword></phonePassword>
<backgroundImageAccess>true</backgroundImageAccess>
<callLogBlfEnabled>3</callLogBlfEnabled>
</commonProfile>
<loadInformation>SIP45.8-5-4S</loadInformation>
<vendorConfig>
<disableSpeaker>false</disableSpeaker><disableSpeakerAndHeadset>false</disableSpeakerAndHeadset><forwardingDelay>1</forwardingDelay><pcPort>0</pcPort><settingsAccess>1</settingsAccess><garp>1</garp><voiceVlanAccess>0</voiceVlanAccess><videoCapability>0</videoCapability><autoSelectLineEnable>0</autoSelectLineEnable><webAccess>0</webAccess><daysDisplayNotActive></daysDisplayNotActive><displayOnTime></displayOnTime><displayOnDuration></displayOnDuration><displayIdleTimeout>01:00</displayIdleTimeout><spanToPCPort>1</spanToPCPort><loggingDisplay>1</loggingDisplay><loadServer></loadServer><recordingTone>0</recordingTone><recordingToneLocalVolume>100</recordingToneLocalVolume><recordingToneRemoteVolume>50</recordingToneRemoteVolume><recordingToneDuration></recordingToneDuration><displayOnWhenIncomingCall>0</displayOnWhenIncomingCall><rtcp>0</rtcp><moreKeyReversionTimer>5</moreKeyReversionTimer><autoCallSelect>1</autoCallSelect><logServer></logServer><g722CodecSupport>0</g722CodecSupport><headsetWidebandUIControl>0</headsetWidebandUIControl><headsetWidebandEnable>0</headsetWidebandEnable><peerFirmwareSharing>0</peerFirmwareSharing><enableCdpSwPort>1</enableCdpSwPort><enableCdpPcPort>1</enableCdpPcPort><enableLldpSwPort>1</enableLldpSwPort><enableLldpPcPort>1</enableLldpPcPort><lldpAssetId></lldpAssetId><powerPriority>0</powerPriority><ehookEnable>0</ehookEnable><detectCMConnectionFailure>0</detectCMConnectionFailure><minimumRingVolume>0</minimumRingVolume><handsetHeadsetMonitor>1</handsetHeadsetMonitor><useEnblocDialing>1</useEnblocDialing><SWRemoteConfig>0</SWRemoteConfig><PCRemoteConfig>0</PCRemoteConfig><PortAutoLinkSync>0</PortAutoLinkSync></vendorConfig>
<userLocale>
<name>English_United_States</name>
<uid>1</uid>
<langCode>en_US</langCode>
<version></version>
<winCharSet>UTF-8</winCharSet>
</userLocale>
<networkLocale>United_States</networkLocale>
<networkLocaleInfo>
<name>United_States</name>
<uid>64</uid>
<version></version>
</networkLocaleInfo>
<deviceSecurityMode>1</deviceSecurityMode>
<idleTimeout>0</idleTimeout>
<authenticationURL>http://192.168.2.254/ccmcip/authenticate.jsp</authenticationURL>
<directoryURL>http://192.168.2.254/xmldirectory.xml</directoryURL>
<idleURL></idleURL>
<informationURL>http://192.168.2.254/GetTelecasterHelpText.jsp</informationURL>
<messagesURL></messagesURL>
<proxyServerURL></proxyServerURL>
<servicesURL>http://192.168.2.254/xmldirectory.xml</servicesURL>
<dscpForSCCPPhoneConfig>96</dscpForSCCPPhoneConfig>
<dscpForSCCPPhoneServices>0</dscpForSCCPPhoneServices>
<dscpForCm2Dvce>96</dscpForCm2Dvce>
<transportLayerProtocol>4</transportLayerProtocol>
<dndCallAlert>5</dndCallAlert>
<phonePersonalization>0</phonePersonalization>
<singleButtonBarge>0</singleButtonBarge>
<joinAcrossLines>0</joinAcrossLines>
<capfAuthMode>0</capfAuthMode>
<capfList>
<capf>
<phonePort>3804</phonePort>
<processNodeName>192.168.2.254</processNodeName>
</capf>
</capfList>
<certHash></certHash>
<encrConfig>false</encrConfig>
<advertiseG722Codec>1</advertiseG722Codec>
<mobility>
<handoffdn></handoffdn>
<dtmfdn></dtmfdn>
<ivrdn>3999</ivrdn>
<dtmfHoldCode>*81</dtmfHoldCode>
<dtmfExclusiveHoldCode>*82</dtmfExclusiveHoldCode>
<dtmfResumeCode>*83</dtmfResumeCode>
<dtmfTxfCode>*84</dtmfTxfCode>
<dtmfCnfCode>*85</dtmfCnfCode>
</mobility>
</device>

Загрузили всё в телефон и нет регистрации, что делать? Как понять что происходит, и посмотреть состояние телефона?Телефон представляет собой маленький компьютер, куда установлена операционная система, а в качестве системы ввода-вывода используются клавиатура, экран и трубка. К телефону можно подключиться по SSH, а затем посмотреть его логи, проверить состояние и прочее. Единственное что я не смог сделать — это перезагрузить телефон удаленно.
Итак, в загруженной нами конфигурации мы указали логин и пароль cisco badpassword
Открываем любой SSH клиент, например putty, используя логин и пароль выше подключаемся.
Сразу после ввода учётных данных нужно будет снова ввести логин и пароль пользователя, под которым мы будем выполнять дальнейшие действия.

Доступны следующие варианты, если посмотреть /etc/passwd:

$ cat /etc/passwd
root:8:0:0:Superuser:/:/bin/nologin
syslog:8:1:0:System Logging:/usr:/bin/nologin
netwk:8:2:0:Network Admin:/etc/inetd:/bin/nologin
security:8:3:1:Security Processes:/usr:/bin/nologin
debug:BQTMQYWL:4:256:Debug Shell:/usr/local:/bin/debugsh
log:OYPTEZXR:5:256:trace shell:/var:/sbin/strace
default:MZPUHGQY:256:256:Default User:/home/default:/bin/sh

Как видно, есть три реальных пользователя, под которыми мы можем залогиниться на телефон:

debug:BQTMQYWL:4:256:Debug Shell:/usr/local:/bin/debugsh
log:OYPTEZXR:5:256:trace shell:/var:/sbin/strace
default:MZPUHGQY:256:256:Default User:/home/default:/bin/sh

default — это пользователь, для которого загружается шелл операционной системы телефона под названием CNU-OS debugsh — под этим пользователем запускается дебаг шелл с несколькими полезными командами. log — под этим пользователем мы не можем вводить команды, но увидим все журналы которые включили под пользователем debugsh.

Логинимся под default со стандартным паролем user, попадаем в shell. Например, пропингуем хост ya.ru:

$ ping ya.ru
ping: reply received from 87.250.250.242, time = 2ms
ping: reply received from 87.250.250.242, time = 1ms
ping: reply received from 87.250.250.242, time = 1ms
^C
$

Кстати voice.telphin.com на ping не отвечает.

Дальше мы будем смотреть состояние телефона и включать нужные журналы под пользователем debugsh, для его запуска просто выполним команду:

$ /bin/debugsh

00235E186B89>

Для вывода полного списка команд:

Для вывода полного списка команд:

00235E186B89> ?

Вот некоторые полезные команды.

Информация о SIP-регистрациях:

00235E186B89> show register

00235E186B89>
LINE REGISTRATION TABLE
Proxy Registration: ENABLED, state: REGISTERED
line  APR  state          timer       expires     proxy:port
----  ---  -------------  ----------  ----------  ----------------------------
1     .11  REGISTERED     55          37          voice.telphin.com:5068
2     .11  REGISTERED     55          37          voice.telphin.com:5068
3     ...  NONE           0           0           undefined:0
4     ...  NONE           0           0           undefined:0
5     ...  NONE           0           0           undefined:0
6     ...  NONE           0           0           undefined:0

Вся информация по настройкам SIP, ниже часть вывода команды:

00235E186B89> show tech-sip

00235E186B89>
 --------------- Show Tech Sip -----------------

 ------------- Show config-cache --------------
------ Current *Cache* Configuration ------
startMediaPort : 16384
endMediaPort : 32766
callerIdBlocking : 0
anonymousCallBlock : 0
dndCallAlert : 5
preferredCodec : none
dtmfOutofBand : avt
dtmfAvtPayload : 101
dtmfDbLevel : 3
sipRetx : 10
sipInviteRetx : 6
timerT1 : 500
timerT2 : 4000
timerInviteExpires : 180
timerRegisterExpires : 300
registerWithProxy : 1
backupProxy :
backupProxyPort : 5060
emergencyProxy :
emergencyProxyPort : 5060
outboundProxy :
outboundProxyPort : 5060
natReceivedProcessing : 0
userInfo : none
cnfJoinEnabled : 1
remotePartyID : 1
semiAttendedTransfer : 1
callHoldRingback : 0
stutterMsgWaiting : 0
cfwd_URL :
callStats : 1
autoAnswer : 0
localCfwdEnable : 1
timerRegisterDelta : 5
MaxRedirects : 70
rfc2543Hold : 0
ccm1_address : 127.0.0.1
ccm2_address :
ccm3_address :
ccm1_sipPort : 0
ccm2_sipPort : 0
ccm3_sipPort : 0
ccm1_securityLevel : 0
ccm2_securityLevel : 0
ccm3_securityLevel : 0
ccm1_isValid : 0
ccm2_isValid : 0
ccm3_isValid : 0
ccmTftp_ipAddr :
ccmTftp_port : 0
ccmTftp_isValid : 0
ccmTftp_securityLevel : 0
ccmSrst_sipIpAddr1 :
ccmSrst_sipPort1 : 5060
ccmSrst_isValid : 0
ccmSrst_securityLevel : 0
ccmSrst_isSecure : 0
connectionMonitorDuration : 120
callPickupURI : x-cisco-serviceuri-pickup
callPickupListURI : x-cisco-serviceuri-opickup
callPickupGroupURI : x-cisco-serviceuri-gpickup
meetMeServiceURI : x-cisco-serviceuri-meetme
callForwardUri : x-cisco-serviceuri-cfwdall
abbreviatedDialURI : x-cisco-serviceuri-abbrdial
callLogBlfEnabled : 1
remoteCcEnabled : 1
timerKeepaliveExpires : 120
timerSubscribeExpires : 120
timerSubscribeDelta : 5
transportLayerProtocol : 4
kpml : 3
natEnabled : 1
natAddress : 203.0.113.10
voipControlPort : 5068
myIpAddr : 192.168.2.5
myMacAddr : 0023:5e18:6b89
enableVad : 0
autoAnswerAltBehavior : 0
autoAnswerTimer : 1
autoAnswerOverride : 1
offhookToFirstDigitTimer : 15000
silentPeriodBetweenCallWaitingBursts : 10
ringSettingBusyStationPolicy : 0
dscpForCm2Dvce : 96
speakerEnabled : 1
transferOnhookEnabled : 0
retainForwardInformation : 0
dndReminderTimer : 0
rollover : 2
joinAcrossLines : 0
blfAlertToneIdle : 0
blfAlertToneBusy : 0
autoPickupEnabled : 0
loadFileName : SIP45.8-5-4S
interDigitTimer : 15000
line1_featureID : 9
line2_featureID : 9
line3_featureID : 0
line4_featureID : 0
line5_featureID : 0
line6_featureID : 0
line7_featureID : 0

Регистрация первой линии:

00235E186B89> register line 1 1
00235E186B89> Registering line 1

Есть множество команд для включения отладки, вот их список:

00235E186B89> ?

  alias
      Creates a pseudonym or shorthand for a command

  clear cpr-memory
      cpr-memory

  clear mwi
      mwi

  cfg ui prompt
      Change prompt to a specified string

  exit
      Exit the shell

  help
      Display help for a command

  help commands
      Display this list

  debug all
      Enable/Disable all debugging

  debug cc
      cc

  debug auth
      auth

  debug config-app
      config-app

  debug cdp
      Enable cdp process debug settings

  debug cc-msg
      cc-msg

  debug cpr-memory
      cpr-memory

  debug cpr-info
      cpr-info

  debug config-cache
      config-cache

  debug dialplan
      dialplan

  debug dsp
      Enable dsp process debug settings

  debug dns
      Enable dns process debug settings

  debug fim
      fim

  debug gsm
      gsm

  debug fsm
      fsm

  debug flashfs
      Enable flashfs process debug settings

  debug dtmf
      dtmf

  debug dhcp
      Enable dhcp process debug settings

  debug inetd
      Enable inetd process debug settings

  debug jvm ALL
      NOTICE

  debug jvm AppStatus
      NOTICE

  debug jvm AutoService
      NOTICE

  debug jvm Application
      NOTICE

  debug jvm CallUI
      NOTICE

  debug jvm Go4
      NOTICE

  debug jvm Config
      NOTICE

  debug jvm Component
      NOTICE

  debug jvm CallAgent
      NOTICE

  debug jvm Http
      NOTICE

  debug jvm MediaManager
      NOTICE

  debug jvm Localization
      NOTICE

  debug jvm MIDP-LCDUI
      NOTICE

  debug jvm MIDP-MIDlet
      NOTICE

  debug jvm MIDP-Media
      NOTICE

  debug jvm MIDP-RMS
      NOTICE

  debug jvm MIDP-PushRegistry
      NOTICE

  debug jvm MIDP-MIDletSuite
      NOTICE

  debug jvm MIDP-IO
      NOTICE

  debug jvm Graphics
      NOTICE

  debug jvm PushService
      NOTICE

  debug jvm Services
      NOTICE

  debug jvm Security
      NOTICE

  debug jvm SIPCC
      NOTICE

  debug jvm SideCar
      NOTICE

  debug jvm Settings
      NOTICE

  debug jvm SubscriptionFramework
      NOTICE

  debug jvm Tftp
      NOTICE

  debug jvm System
      NOTICE

  debug jvm Util
      NOTICE

  debug jvm XML
      NOTICE

  debug jvm Video
      NOTICE

  debug jvm UserIO
      NOTICE

  debug jvm StartUp
      NOTICE

  debug jvm Properties
      NOTICE

  debug lsm
      lsm

  debug kpml
      kpml

  debug init
      Enable init process debug settings

  debug ntp
      Enable ntp process debug settings

  debug remote-cc
      remote-cc

  debug process
      Enable process process debug settings

  debug netkern
      Enable netkern process debug settings

  debug sip-adapter
      sip-adapter

  debug sip-dnd
      sip-dnd

  debug sip-dm
      sip-dm

  debug sip-presence
      sip-presence

  debug sip-reg-state
      sip-reg-state

  debug sip-messages
      sip-messages

  debug sip-trx
      sip-trx

  debug sip-task
      sip-task

  debug timers
      timers

  debug vcm
      vcm

  debug ui
      Enable UI debug setting

  debug tftpClient
      Enable tftpClient process debug settings

  debug sip-state
      sip-state

  debug secd
      Enable secure daemon debug settings

  debug imageauth
      Debug imgauthd process

  jvm logging level
      Enable jvm process to allow individual module debugging

  register bulk
      bulk

  register line
      line

  quit
      Alias for 'exit'
  test hide
      hide

  test close
      close

  test show
      show

  test open
      open

  test key
      key

  store sip-debugs
      sip-debugs

  show bulkreginfo
      bulkreginfo

  show cdp
      Show cdp configuration information

  show cpr-memory
      cpr-memory

  show cpr-msgq
      cpr-msgq

  show config-cache
      config-cache

  show dialplan
      dialplan

  show dhcp
      Show dhcp configuration information

  show dnd-settings
      dnd-settings

  show fim
      fim

  show driver
      Shows loaded drivers in the system

  show diskspace
      Displays disk usage statistics

  show fsmcnf
      fsmcnf

  show fsmb2bcnf
      fsmb2bcnf

  show fsmicom
      fsmicom

  show fsmxfr
      fsmxfr

  show fsmrelay
      fsmrelay

  show fsmdef
      fsmdef

  show fsm
      fsm

  show debug
      debug

  show inventory
      shows unique device identifier

  show kpml
      kpml

  show jvm Config

  show ipc stat
      shows ipc statistics

  show lsm
      lsm

  show memory
      show memory usage

  show load history
      shows load/image history

  show register
      register

  show sip-subscription-statistics
      sip-subscription-statistics

  show sip-publish-statistics
      sip-publish-statistics

  show remote-cc
      remote-cc

  show strpool
      strpool

  show tech
      Shows tech support related information

  show version
      Display current CNU version

  show tech-sip
      tech-sip

  show socket
      show socket information

  show process
      shows process information

  show inetd
      Show inetd configuration information

  history
      Displays the command history list

Нас интересует SIP:

debug sip-reg-state
debug sip-messages
debug sip-adapter

Теперь можно посмотреть включенные журналы по команде debug, выходим из оболочки:

00235E186B89> exit
Exiting shell...

Logging out...

Команда $ /sbin/strace запускает просмотр включенных ранее трассировок.

Также в телефоне есть оболочка cnush для работы с файлами телефона запускается она $ /bin/cnush

В списке команд:

% help
alias [name [command]]
unalias name
cd [dirname]
clear
exec filename [args]
exit
groups
help [args] ...
id
load svrIPaddr filename
limit [-h] [resource [limit]]
unlimit [resource]
logout
pwd
quit
resume
set [-r] var = value
unset var
setnet
shownet
setenv name value
printenv
shpri priority
size file ...
. filename
source filename
sync
touch filename
umask [mask]
ver file ...
where program
whoami

Если не получается зайти в оболочку или включить трассировку, то, скорее всего, в системе завис процесс, например, /bin/debugsh:

$ /bin/debugsh

Another debugsh session active. Exiting...
$

Его легко можно удалить вот так:

$ ps -a

 pid %cpu   state tty command
  24  0.0     run   0 /bin/login
   5  0.0     run   0 /sbin/espd
   2  0.1     run   0 /sbin/syslogd
   3  3.9     run   0 /bin/sshd
   1  0.0     run   0 /sbin/init
  19  0.0     run   0 /bin/tftpClient
  27  0.0     run   0 /sbin/rtsold
  22  1.5     run   0 /bin/sshd
   6  0.2     run   0 /sbin/strace
   4  0.0     run   0 /sbin/dhcp6
  10  0.0     run   0 /sbin/pae
   8  0.0     run   0 /sbin/imgauthd
  30  0.0     run   0 /sbin/inetd
   0 92.5     run   0 sysIdle
   9  0.0     run   0 /ubin/vieo
  18  0.0     run   0 /bin/ps
  11  0.5     run   0 /ubin/dsp
  16  8.3     run   0 /tmp/sunvm.unzip/sunvm.cnu
  20  0.0     run   0 /sbin/dhcp
  21  0.1     run   0 /sbin/dns
  29  0.0     run   0 /bin/secd
  28  0.5     run   0 /bin/sshd
  15  0.0     run   0 /bin/sh
  13  0.2     run   0 /sbin/strace
  31  0.0     run   0 /bin/ntp
  14  0.0     run   0 /bin/sh
  12  0.0     run   0 /bin/debugsh
  26  0.0     run   0 /sbin/cdp
   7  0.0     run   0 /bin/sh

$ kill 12

С этими знаниями можно настроить телефон Cisco за NAT.

The post Настройка IP-телефонов Cisco 79-й серии для работы за NAT и отладка first appeared on Unified Communications Expert.

Итак идея в общем: мы создадим несколько SIP профилей, по числу наборов ограничений или, иными словами, видов связи. Затем, для каждого SIP-профиля, создадим и назначим ему свою таблицу модификаторов. Каждая запись в таблице модификаторов, будет или отправлять вызов в нулевой план набора, где вызов будет уходить по одному из маршрутов или в другой план набора, где все вызовы будут сразу же терминироваться.
У нас есть нулевой план, с несколькими маршрутами:

• SS – спецслужбы
• Local – местная
• Zone – Mg – зоновая и междугородняя
• Mn – Междугородняя

Все вызовы улетают в транковую группу «SS7-Vimpelcom».

Рис. Eltex SMG. Параметры плана нумерации

Теперь добавим ещё один план нумерации «План #2».
Для этого перейдём в «Системные параметры» и увеличим значение «Количество активных планов нумерации» на один, у меня это будет три, так как было два плана нумерации.

Рис. Eltex SMG. Системные параметры

Применяем.
Теперь переходим в новый план нумерации, у меня это «NumberPlan#2»
затем добавляем префикс с маской (x.) который уходит в пустую транковую группу.

Рис.Eltex SMG. План нумерации

Таким образом, любой вызов попавший в этот план набора отобьется в SIP
вот так:

6.881720137 84.52.72.26 -> 194.154.91.66 SIP/SDP 1212 Request: INVITE sip:81033147756180@194.154.91.66:9955 | , with session description
6.912345534 194.154.91.66 -> 84.52.72.26 SIP 441 Status: 100 Trying |
6.957838076 194.154.91.66 -> 84.52.72.26 SIP 516 Status: 404 Not Found |
6.967055910 84.52.72.26 -> 194.154.91.66 SIP 703 Request: ACK sip:81033147756180@194.154.91.66:9955 |


То есть — «Not Found».

В CDR строка будет выглядить так:

;2017-07-07 13:20:59;0;2;unavailable trunk line;192.168.1.245;sip-user;Subscriber#001;747311110001;;0.0.0.0;;;81033147756180;;2017-07-07 13:20:59;2017-07-07 13:20:59;

С причиной q.931 равной 2 -No route to destination.
Теперь создадим таблицу модификаторов, которая разрешает только вызовы на спецслужбы, 8800 и местные вызовы по городу Воронеж. В конце добавим правило, которое запретит все остальные вызовы.

Имя модификатора для примера – «Line-SS7-local»

Добавляем модификаторы которые «ловят» вызовы по маске Б-номеров, затем нормализуют -номера в формат E.164, не изменяют план нумерации, вызов попадёт в «правильный» нулевой план нумерации.
Например, 8800:

Рис. Eltex SMG. Модификатор плана нумерации
Таким образом, создаём остальные правила.
В конце добавим правило, которое запрещает всё – создадим модификатор, который ловим Б-номер по wildcard (x.)

Рис. Eltex SMG. Модификатор плана нумерации

Правило «Deny All» запрещает МГ МН и международную связь, на вкладке «Модификация общая», мы меняем план нумерации на план, где у нас терминируются все вызовы, в нашем примере План нумерации «NumerPlan#2».
В итоге должно получиться вот так:

Рис. Eltex SMG. Таблица модификаторов

А теперь создадим PBX-профиль с именем «PBX_Profile#1-to-SS7-local» и для входящей связи и номера «CdPN» назначим созданный нами модификатор «Line-SS7-local».

Рис. Eltex SMG. PBX профили
Всё готово.
Теперь данный профиль нужно назначить SIP-абонентам для которых разрешена только местная связь.

Рис. Eltex SMG. Редактирование SIP-абонента
Таким образом, можно создавать любые наборы ограничений – чаще всего это виды связи: местная, зоновая, междугородняя и международная.

Автор: Игнат Кудрявцев

The post Разграничение видов связи на Eltex SMG2016 и SMG1016M first appeared on Unified Communications Expert.

Исходящая связь

Чтобы проиграть аудиофайл /var/lib/asterisk/sounds/ivr/razgovor_record в приложении Dial используем параметр A(имя_аудиофайла). После соединения указанный в скобках аудиофайл будет проигран.
Но нам необходимо управлять через базу данных, для исходящих вызовов, с каких внутренних номеров аудиофайл уведомления о записи разговора нужно проигрывать, а для каких не нужно.
Для этого добавим новый столбец в существующей таблице outbound.
Добавим этот новый столбец после столбца callerid с именем notification_enabled, значения в столбце могут принимать следующие значения:
1 – Проиграть аудиофайл уведомления
0 – Не проигрывать аудиофайл уведомления
Добавим столбец в notification_enabled таблицу outbound, далее приведён пример запроса в СУБД MySQL.

mysql> use astcdrdb;
mysql> ALTER TABLE `outbound` ADD `notification_enabled` INT( 1 ) NOT NULL DEFAULT '0' AFTER `callerid`;

Теперь таблица outbound будет выглядеть следующим образом:

mysql> select * from outbound where internal=650;
+-----+----------+-------------+----------------------+-------+
| id | internal | callerid | notification_enabled | Notes |
+-----+----------+-------------+----------------------+-------+
| 210 | 650 | 78121234567 | 0 | |
+-----+----------+-------------+----------------------+-------+
1 row in set (0.00 sec)

Добавим функцию, которая будет проверять значение столбца notification_enabled в файл func_odbc.conf.

[CHECK_NOTIF_OUT_ENABLE]
dsn=asterisk
readsql=SELECT notification_enabled FROM outbound where internal='${ARG1}'

В консоли Asterisk применим функцию:

aster*CLI> module reload func_odbc.so

В выводе консоли Asterisk увидим:

  == Registered custom function 'ODBC_CHECK_NOTIF_OUT_ENABLE'

Теперь модифицируем дайлплан, файл extensions.conf.
Чтобы проиграть аудиофайл /var/lib/asterisk/sounds/ivr/razgovor_record в приложении Dial используем параметр A(имя_аудиофайла). После соединения указанный в параметре аудиофайл будет проигран.
Начнём с контекста [mg-out]. Исходный вид:

exten => _9[78][123456780]XXXXXXXXX,2,Set(__CALLER=${CALLERID(ANI)})
exten => _9[78][123456780]XXXXXXXXX,3,Set(__CALLED=7${EXTEN:2})
exten => _9[78][123456780]XXXXXXXXX,4,Set(__UID=${UNIQUEID})
exten => _9[78][123456780]XXXXXXXXX,5,Dial(SIP/RTU/7${EXTEN:2},,tTM(startrec))

Модифицируем контекст, новые строки выделены жирным текстом:

exten => _9[78][123456780]XXXXXXXXX,2,Set(__CALLER=${CALLERID(ANI)})
exten => _9[78][123456780]XXXXXXXXX,3,Set(__CALLED=7${EXTEN:2})
exten => _9[78][123456780]XXXXXXXXX,4,Set(__UID=${UNIQUEID})
exten => _9[78][123456780]XXXXXXXXX,5,NoOp(${ODBC_CHECK_NOTIF_OUT_ENABLE(${CALLER})})
exten => _9[78][123456780]XXXXXXXXX,6,Set(NOTIFICATION=${IF($["${ODBC_CHECK_NOTIF_OUT_ENABLE(${CALLER})}" = "1"]?/var/lib/asterisk/sounds/ivr/razgovor_record)})
exten => _9[78][123456780]XXXXXXXXX,7,Dial(SIP/RTU/7${EXTEN:2},,tTM(startrec)A(${NOTIFICATION}))

Далее, перечитываем дайлплан командой из консоли Asterisk: dialplan reload.

При вызове, если notification_enabled=0, отладочный вывод в консоли Asterisk будет следующим:

   -- Executing [981116275136@mn:1] Set("SIP/650-00003bb2", "CALLERID(num)=78121234567") in new stack
    -- Executing [981116275136@mn:2] Set("SIP/650-00003bb2", "__CALLER=650") in new stack
    -- Executing [981116275136@mn:3] Set("SIP/650-00003bb2", "__CALLED=71116275136") in new stack
    -- Executing [981116275136@mn:4] Set("SIP/650-00003bb2", "__UID=1490019065.32064") in new stack
    -- Executing [981116275136@mn:5] NoOp("SIP/650-00003bb2", "0") in new stack
    -- Executing [981116275136@mn:6] Set("SIP/650-00003bb2", "NOTIFICATION=") in new stack
    -- Executing [981116275136@mn:7] Dial("SIP/650-00003bb2", "SIP/RTU/71116275136,,tTM(startrec)A()") in new stack

При вызове, если notification_enabled=1:

  == Using SIP RTP CoS mark 5
    -- Executing [981116275136@mn:1] Set("SIP/650-00003b70", "CALLERID(num)=78121234567") in new stack
    -- Executing [981116275136@mn:2] Set("SIP/650-00003b70", "__CALLER=650") in new stack
    -- Executing [981116275136@mn:3] Set("SIP/650-00003b70", "__CALLED=71116275136") in new stack
    -- Executing [981116275136@mn:4] Set("SIP/650-00003b70", "__UID=1490018964.31913") in new stack
    -- Executing [981116275136@mn:5] NoOp("SIP/650-00003b70", "1") in new stack
    -- Executing [981116275136@mn:6] Set("SIP/650-00003b70", "NOTIFICATION=/var/lib/asterisk/sounds/ivr/razgovor_record") in new stack
    -- Executing [981116275136@mn:7] Dial("SIP/650-00003b70", "SIP/RTU/71116275136,,tTM(startrec)A(/var/lib/asterisk/sounds/ivr/razgovor_record)") in new stack

Исходящая связь

В предыдущем материале посвященном Asterisk мы переводили входящую связь через БД, MySQL и запрашивали параметры входящего вызова из БД, существующие строки в дайлплане:

same => n,NoOp(GET FORWARD ring_timeout,forward_after_enable,forward_after_numer,timeout_ring_after ==  ${ODBC_GET_FORWARD_AFTER_HG(${EXTEN})})
same => n,Set(ARRAY(RING_TIMEOUT,FORWARD_AFTER_ENABLE,FORWARD_AFTER_NUMBER,TIMEOUT_RING_AFTER)=${ODBC_GET_FORWARD_AFTER_HG(${EXTEN})})

В данные строки нужно добавить получение ещё одного параметра notification_enabled из таблицы inbound, который будет указывать на то, нужно ли проигрывать уведомление или нет.
Добавим новый столбец запросом в mysql:

mysql> use astcdrdb;
mysql> ALTER TABLE `inbound` ADD `notification_enabled` INT( 1 ) NULL DEFAULT '0' AFTER `timeout_ring_after`

Модифицируем функцию в ODBC_GET_FORWARD_AFTER_HG в файле func_odbc.conf, то что добавлено выделено жирным шрифтом:

[GET_FORWARD_AFTER_HG]
dsn=asterisk
readsql=SELECT ring_timeout,forward_after_enable,forward_after_numer,timeout_ring_after, notification_enabled from inbound where did='${ARG1}'

Затем строки в extensions.conf:

same => n,NoOp(GET FORWARD ring_timeout,forward_after_enable,forward_after_numer,timeout_ring_after, notification_enabled ==  ${ODBC_GET_FORWARD_AFTER_HG(${EXTEN})})
same => n,Set(ARRAY(RING_TIMEOUT,FORWARD_AFTER_ENABLE,FORWARD_AFTER_NUMBER,TIMEOUT_RING_AFTER,NOTIFICATION_ENABLED)=${ODBC_GET_FORWARD_AFTER_HG(${EXTEN})})

Перечитаем файл с функциями odbc:

aster*CLI> module reload func_odbc.so
Module 'func_odbc.so' reloaded successfully.
    -- Reloading module 'func_odbc.so' (ODBC lookups)
  == Parsing '/etc/asterisk/func_odbc.conf': Found
…
  == Registered custom function 'ODBC_GET_FORWARD_AFTER_HG'
…

Далее, переходим в контекст [HG-NEW]. Закомментируем первую строку и добавляю NoOp, также две строки выделенные жирным цветом. Здесь проверяется разрешено ли уведомление – значение NOTIFICATION_ENABLED равно 1. Если 0, то переменная NOTIFICATION принимает значение skip, в опции приложения Playback из переменной NOTIFICATION добавляется данный ключ, который указывает что если канал не в ответном состоянии, то приложение Playback не будет проигрывать указанный файл /var/lib/asterisk/sounds/ivr/razgovor_record. Первой строкой мы закомментировали приложение Answer, которое переводит канал в ответное состояние Connected в самом начале контекста. Поэтому эта комбинация будет работать.

Получится вот так:

;exten => _X.,1, Answer
exten => _X.,1,NoOp
same => n,Set(_MONITOR_FILENAME=IN-${EXTEN}-${STRFTIME(${EPOCH},,%Y_%m_%d[%H_%M])}-${CALLERID(num)}-${EXTEN}-${UNIQUEID})
same => n, NoOp(!!!!CALLED=${CALLED})
same => n, Set(H1=${IF($["${m1}" != ""]?SIP/${m1})})
same => n, Set(H2=${IF($["${m2}" != ""]?&SIP/${m2})})
same => n, Set(H3=${IF($["${m3}" != ""]?&SIP/${m3})})
same => n, Set(H4=${IF($["${m4}" != ""]?&SIP/${m4})})
same => n, Set(H5=${IF($["${m5}" != ""]?&SIP/${m5})})
same => n, Set(H6=${IF($["${m6}" != ""]?&SIP/${m6})})
same => n, Set(H7=${IF($["${m7}" != ""]?&SIP/${m7})})
same => n, Set(H8=${IF($["${m8}" != ""]?&SIP/${m8})})
same => n, Set(H9=${IF($["${m9}" != ""]?&SIP/${m9})})
same => n, Set(H11=${IF($["${m11}" != ""]?&SIP/${m11})})
same => n, Set(H12=${IF($["${m12}" != ""]?&SIP/${m12})})
same => n, Set(H13=${IF($["${m13}" != ""]?&SIP/${m13})})
same => n, Set(H14=${IF($["${m14}" != ""]?&SIP/${m14})})
same => n, Set(H15=${IF($["${m15}" != ""]?&SIP/${m15})})

same => n,Set(NOTIFICATION=${IF($["${NOTIFICATION_ENABLED}" = "1"]?:skip)})
same => n,Playback(/var/lib/asterisk/sounds/ivr/razgovor_record,${NOTIFICATION})

same => n,Dial(${H1}${H2}${H3}${H4}${H5}${H6}${H7}${H8}${H9}${H10}${H11}${H12}${H13}${H14}${H15},${RING_TIMEOUT},TtrM(monext))
...

Если переменная NOTIFICATION принимает значение пусто(“”), то Playback посылает 200OK с SDP (Connect), переводит канал в ответное состояние и проигрывает файл /var/lib/asterisk/sounds/ivr/razgovor_record.
Таким образом аудиофайл будет воспроизводиться вне зависимости поддерживает ли операторское оборудование early media.
Ниже SIP-трейс обмена сообщениями:

Capturing on eth0
  2.329733 192.168.103.45 -> 192.168.126.210 SIP/SDP 1235 Request: INVITE sip:78121234567@192.168.126.210;user=phone, with session description
  2.332353 192.168.126.210 -> 192.168.103.45 SIP 631 Status: 100 Trying
  2.365530 192.168.126.210 -> 192.168.103.45 SIP/SDP 913 Status: 200 OK, with session description
  2.368216 192.168.103.45 -> 192.168.126.210 SIP 502 Request: ACK sip:78121234567@192.168.126.210:5060
<проигрывается уведомление, состояние ответа, тарификация вызова началась>
<Далее вызов на внутреннего абонента>
  6.840698 192.168.126.210 -> 192.168.85.148 SIP/SDP 955 Request: INVITE sip:350@192.168.85.148:64141;rinstance=6372aa4716dea7bf, with session description
  6.961023 192.168.85.148 -> 192.168.126.210 SIP 462 Status: 180 Ringing
 10.469290 192.168.85.148 -> 192.168.126.210 SIP/SDP 841 Status: 200 OK, with session description
 10.469761 192.168.126.210 -> 192.168.85.148 SIP 505 Request: ACK sip:350@192.168.85.148:64141;rinstance=6372aa4716dea7bf
 11.479193 192.168.85.148 -> 192.168.126.210 SIP 578 Request: BYE sip:78121234567@192.168.126.210:5060
 11.480282 192.168.126.210 -> 192.168.85.148 SIP 563 Status: 200 OK
 11.481937 192.168.126.210 -> 192.168.103.45 SIP 574 Request: BYE sip:78121234567@192.168.103.45:5063;user=phone
 11.484585 192.168.103.45 -> 192.168.126.210 SIP 503 Status: 200 OK

Если встречный оператор поддерживает режим early media или отправку вызывающей стороне аудио в голосовом канале, то cтроку с приложением Playback можно модифицировать вот так:

same => n,Set(NOTIFICATION=${IF($["${NOTIFICATION_ENABLED}" = "1"]?noanswer:skip)})

То есть, добавить ключ noanswer, вместо “”(пусто), тогда Playback будет проигрывать файл в предответном состоянии, то есть до состояния Connect:

same => n,Playback(/var/lib/asterisk/sounds/razgovor_zapis1,${NOTIFICATION})

В sip.conf нужно
Выставить в общих настройках(секция [general]) параметр

prematuremedia=no

SIP-трейсировка будет следующий:

0.000000 192.168.103.45 -> 192.168.126.210 SIP/SDP 1235 Request: INVITE sip:78121234567@192.168.126.210;user=phone, with session description
  0.000815 192.168.126.210 -> 192.168.103.45 SIP 631 Status: 100 Trying
  0.031701 192.168.126.210 -> 192.168.103.45 SIP/SDP 929 Status: 183 Session Progress, with session description
  0.031775 192.168.126.210 -> 192.168.103.45 RTP 214 PT=ITU-T G.711 PCMU, SSRC=0x6439ADF6, Seq=43650, Time=160, Mark
  0.032872 192.168.103.45 -> 192.168.126.210 RTCP 122 Sender Report   Source description
  0.032922 192.168.103.45 -> 192.168.126.210 SIP 640 Request: OPTIONS sip:78121234567@192.168.126.210;user=phone
  0.033428 192.168.126.210 -> 192.168.103.45 SIP 668 Status: 200 OK
  0.051935 192.168.126.210 -> 192.168.103.45 RTP 214 PT=ITU-T G.711 PCMU, SSRC=0x6439ADF6, Seq=43651, Time=320
  0.071893 192.168.126.210 -> 192.168.103.45 RTP 214 PT=ITU-T G.711 PCMU, SSRC=0x6439ADF6, Seq=43652, Time=480
  0.091958 192.168.126.210 -> 192.168.103.45 RTP 214 PT=ITU-T G.711 PCMU, SSRC=0x6439ADF6, Seq=43653, Time=640
<проговаривание аудиофайла>
…
  4.438201 192.168.126.210 -> 192.168.103.45 SIP 597 Status: 180 Ringing
<КПВ вызывающему абоненту>

Вариант с поддержкой early media будет выглядеть вот так:

;exten => _X.,1, Answer
exten => _X.,1, NoOp
same => n,Set(_MONITOR_FILENAME=IN-${EXTEN}-${STRFTIME(${EPOCH},,%Y_%m_%d[%H_%M])}-${CALLERID(num)}-${EXTEN}-${UNIQUEID})
same => n, NoOp(!!!!CALLED=${CALLED})
same => n, Set(H1=${IF($["${m1}" != ""]?SIP/${m1})})
same => n, Set(H2=${IF($["${m2}" != ""]?&SIP/${m2})})
same => n, Set(H3=${IF($["${m3}" != ""]?&SIP/${m3})})
same => n, Set(H4=${IF($["${m4}" != ""]?&SIP/${m4})})
same => n, Set(H5=${IF($["${m5}" != ""]?&SIP/${m5})})
same => n, Set(H6=${IF($["${m6}" != ""]?&SIP/${m6})})
same => n, Set(H7=${IF($["${m7}" != ""]?&SIP/${m7})})
same => n, Set(H8=${IF($["${m8}" != ""]?&SIP/${m8})})
same => n, Set(H9=${IF($["${m9}" != ""]?&SIP/${m9})})
same => n, Set(H11=${IF($["${m11}" != ""]?&SIP/${m11})})
same => n, Set(H12=${IF($["${m12}" != ""]?&SIP/${m12})})
same => n, Set(H13=${IF($["${m13}" != ""]?&SIP/${m13})})
same => n, Set(H14=${IF($["${m14}" != ""]?&SIP/${m14})})
same => n, Set(H15=${IF($["${m15}" != ""]?&SIP/${m15})})

same => n,Set(NOTIFICATION=${IF($["${NOTIFICATION_ENABLED}" = "1"]?noanswer:skip)})
same => n,Playback(/var/lib/asterisk/sounds/ivr/razgovor_record,${NOTIFICATION})
same => n,Dial(${H1}${H2}${H3}${H4}${H5}${H6}${H7}${H8}${H9}${H10}${H11}${H12}${H13}${H14}${H15},${RING_TIMEOUT},TtrM(monext))
same => n,GotoIf($["${FORWARD_AFTER_ENABLE}" != "1"]?end)
same => n,GotoIf($[${REGEX("@" ${FORWARD_AFTER_NUMBER})}]?nochangecid)
same => n,Set(CALLERID(num)=${IF($["${REGEX("^7812.......$" ${EXTEN})}"]?${EXTEN}:78120001122)})
same => n(nochangecid),Dial(${FORWARD_AFTER_NUMBER},${TIMEOUT_RING_AFTER},TtrM(monext))
same => n,Goto(CHECK_BUSY_FORWARD,${EXTEN},1)
same => n(end),Hangup

Старое оборудование, которое установлено у операторов связи оможет «криво» поддерживать или не поддерживать early media вовсе. Например, по SIP-дампу в RTP трафике в плеере wireshark уведомление на участке между АТС и оператором слышно, а у абоненента в сети ТфОП тишина. В таком случае нужно сообщение connect и следует использовать первый вариант.

Таким образом мы добавили воспроизведение аудиофайла, в частности уведомление о записи разговоара, которое всегда проигрывается только одной стороне — клиенту, а не обоим сторонам вызова. Причём включение и отключение уведомления регулируется путём установки параметра в базе данных MySQL. Поэтому сделать интерфейс для абонентов, где они самостоятельно устанавливать этот параметр не составит труда. Это также можно реализовать через служебные комбинации или старкоды.

The post Настройка уведомления о записи разговора для исходящих и входящих вызовов в Asterisk first appeared on Unified Communications Expert.