Блокировка номера в Asterisk при неверном вводе кода направления
Дорогие направления на офисной АТС обычно закрывают 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 и закрытые лишние порты.