Shkerka.ruзаметки админа
Asterisk и IP-АТС

Блокировка номера в Asterisk при неверном вводе кода направления

Опубликовано: Обновлено: 4 мин чтенияАвтор: Редакция Shkerka.ru

Дорогие направления на офисной АТС обычно закрывают PIN-кодом. Разбираем диалплан, который считает неверные вводы кода и после пятой ошибки блокирует абоненту выход на межгород, сообщает об этом звонящему и пишет администратору.

Задача

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

  • после набора номера на платное направление станция просит ввести PIN;
  • неверные попытки считаются для каждого абонента отдельно;
  • после пятой ошибки номер теряет доступ к платным направлениям;
  • при следующих попытках абонент слышит, что заблокирован и куда обратиться;
  • администратор получает письмо.

Почему без правки конфигов

Классическое решение — shell-скрипт, который считает ошибки в текстовом файле и при превышении комментирует абонента в sip.conf, после чего перезагружает Asterisk. Работает, но хрупко: одновременные звонки могут повредить файл, абонент полностью теряет связь, включая внутренние звонки, а перезагрузка затрагивает всю станцию.

Удобнее хранить всё во встроенной базе Asterisk — AstDB. Функции DB(), DB_EXISTS() и DB_DELETE() доступны прямо из диалплана, данные сохраняются между перезапусками, а блокировка касается только того направления, которое мы защищаем.

PIN-коды абонентов

Каждому абоненту задайте свой PIN в консоли Asterisk:

asterisk -rx "database put pin 101 4821"
asterisk -rx "database put pin 102 9173"

Посмотреть список можно командой database show pin. Если нужен один общий код на всех, замените в диалплане ${DB(pin/${CALLER})} на константу.

Диалплан

Внутренний контекст отправляет звонки на 8 и 810 в отдельный контекст проверки:

[office]
exten => _1XX,1,Dial(PJSIP/${EXTEN},20,tT)
 same => n,Hangup()
exten => _8XXXXXXXXXX,1,Goto(intercity,${EXTEN},1)
exten => _810X.,1,Goto(intercity,${EXTEN},1)

[intercity]
exten => _X.,1,Set(CALLER=${CALLERID(num)})
 same => n,Set(CHANNEL(language)=ru)
 ; номер уже заблокирован
 same => n,GotoIf(${DB_EXISTS(blocked/${CALLER})}?blocked)
 ; запрашиваем PIN: 4 цифры, 2 попытки, 10 секунд
 same => n,Answer()
 same => n,Read(PIN,pin/enter-code,4,,2,10)
 same => n,GotoIf($["${PIN}" = "${DB(pin/${CALLER})}"]?ok)

 ; неверный PIN: увеличиваем счётчик
 same => n,Set(FAILS=0)
 same => n,GotoIf(${DB_EXISTS(pinfail/${CALLER})}?getfails:count)
 same => n(getfails),Set(FAILS=${DB_RESULT})
 same => n(count),Set(FAILS=$[${FAILS} + 1])
 same => n,Set(DB(pinfail/${CALLER})=${FAILS})
 same => n,GotoIf($[${FAILS} >= 5]?lock)
 same => n,Playback(pin/wrong-code)
 same => n,Hangup()

 ; пятая ошибка: блокируем и сообщаем администратору
 same => n(lock),Set(DB(blocked/${CALLER})=1)
 same => n,System(echo "PBX: nomer ${CALLER} zablokirovan posle ${FAILS} oshibok PIN" | mail -s "PBX blokirovka ${CALLER}" admin@example.com)
 same => n(blocked),Playback(pin/account-blocked)
 same => n,Playback(pin/contact-support)
 same => n,Hangup()

 ; верный PIN: сбрасываем счётчик и звоним
 same => n(ok),NoOp(${DB_DELETE(pinfail/${CALLER})})
 same => n,Dial(PJSIP/${EXTEN}@provider,90)
 same => n,Hangup()

Разберём ключевые места.

  • DB_EXISTS() возвращает 1 или 0 и одновременно кладёт найденное значение в переменную DB_RESULT. Поэтому счётчик читается отдельной строкой после проверки — так порядок вычислений гарантированно правильный.
  • Read() с параметрами 4,,2,10 ждёт четыре цифры, даёт две попытки услышать подсказку и десять секунд на ввод.
  • DB_DELETE() — функция чтения, которая удаляет ключ. Её вызывают внутри NoOp, чтобы не создавать лишних переменных.
  • Верный PIN обнуляет счётчик: пять ошибок должны идти подряд, а не накапливаться месяцами.

Если абонент вводит PIN в той же строке, что и номер, например *1234 перед номером, отделите код срезом ${EXTEN:1:4}, а номер — ${EXTEN:5}. Но отдельный запрос через Read() удобнее: код не виден в CDR и логах.

Звуковые подсказки

Нужны четыре фразы в /var/lib/asterisk/sounds/ru/pin/:

Файл Текст
enter-code Введите код доступа к междугородной связи
wrong-code Код неверный
account-blocked Код введён неверно более пяти раз, выход на межгород заблокирован
contact-support Для разблокировки обратитесь в техническую поддержку

Формат — 8 кГц, моно, 16 бит, WAV или GSM.

Письмо администратору

Команда mail из пакета mailutils или bsd-mailx отправляет письмо через локальный почтовый агент. На сервере без настроенной почты поставьте лёгкий relay, например msmtp-mta, и укажите в его конфиге внешний SMTP-сервер. Проверить отправку можно из консоли сервера ещё до тестового звонка:

echo test | mail -s "PBX test" admin@example.com

Вместо письма можно отправлять сообщение в мессенджер через curl к API бота — строка System() для этого почти не изменится.

Управление блокировками

# кто заблокирован
asterisk -rx "database show blocked"
# текущие счётчики ошибок
asterisk -rx "database show pinfail"
# разблокировать абонента 101
asterisk -rx "database del blocked 101"
asterisk -rx "database del pinfail 101"

Изменения вступают в силу сразу, перечитывать диалплан не нужно.

На что обратить внимание

  • Номер звонящего. CALLERID(num) абонент в некоторых телефонах может подменить. Надёжнее брать имя endpoint: ${CHANNEL(endpoint)} для каналов PJSIP.
  • Старые конфигурации. Если у вас ещё Dial(SIP/...) и sip.conf, учтите, что chan_sip удалён в Asterisk 21; переход на PJSIP описан в статье о базовой настройке Asterisk.
  • Внешняя защита. PIN спасает от злоупотреблений внутри офиса. От атак из интернета нужны длинные SIP-пароли, ACL по IP, fail2ban на журнал безопасности Asterisk и лимиты на стороне оператора.

Другие сценарии обработки вызовов собраны в разделе Asterisk.

Частые вопросы

Где Asterisk хранит счётчик ошибок?

Во встроенной базе AstDB. Она переживает перезапуск Asterisk, а значения можно смотреть и менять командами database show, database put и database del в консоли.

Как разблокировать абонента?

Удалите ключи блокировки и счётчика: database del blocked 101 и database del pinfail 101. Перезагружать конфигурацию или Asterisk не нужно.

Чем этот способ лучше правки sip.conf скриптом?

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

Защищает ли PIN-код от взлома АТС?

Только от злоупотреблений изнутри. От подбора SIP-паролей снаружи нужны длинные пароли, ограничение регистрации по IP, fail2ban или встроенные ACL и закрытые лишние порты.