Начиная с версии 2.5.0 (вышла в 2019 году) в pfSense появилась поддержка Telegram уведомлений о системных событиях. В этой статье мы пошагово рассмотрим настройку и узнаем, какого рода уведомления будут приходить в наш мессенджер.
Первым шагом нужно создать телеграм-бота от имени которого будут приходить уведомления pfSense.
В поиске Телеграм находим бота BotFather и создаём нашего нового бота с помощью команды /newbot, отвечая на вопросы вводим имя и username бота. Обращаю внимание что имя бота должно быть уникальным во всём Телеграмме:
Итак, теперь у нас есть API токен данного бота.
Конечно лучше создать приватный канал для сообщений, если вы не хотите чтобы кто угодно мог смотреть что происходит с вашим файрволом. Поэтому создаём приватный канал и добавляем нашего бота в качестве администратора с правом только на создание постов:
Далее вытащим необходимый нам Chat ID. Для этого откроем в браузере https://api.telegram.org/botTOKEN/getUpdates, где TOKEN - это API токен бота. Получим подобный вывод:
{"ok":true,"result":[{"update_id":XXXXXXXX,
"my_chat_member":{"chat":{"id":CHATIDNUMBER,"title":"habrpfchannel","type":"channel"},"from":
CHATIDNUMBER - это и есть нужное нам число. Вводим API Key и Chat ID на странице System > Advanced > Notifications, не забыв чекнуть Enable Telegram:
Проверяем нажав Test Telegram Settings, и увидя тестовое сообщение в канале жмём Save.
Виды уведомлений
Какого рода уведомления будут приходить:
- High Availability сообщения - переключение с MASTER'а на BACKUP ноду и наоборот, ошибки CARP интерфейсов, XMLRPC синхронизации конфигурации
- Различные сообщения при апгрейде системы - переустановка пакетов, важные замечания по изменениям в новой версии
- Системные сообщения о загрузке системы
- События гейтевеев - up/down, переключение в gateway groups, изменение latency и потери пакетов
- Dynamic DNS обновления
- Предупреждения об истечении срока действия сертификатов
- Ошибки сохранения и загрузки конфигурации, в т.ч. сообщения службы Auto Config Backup (бэкап в облако)
- Ошибки загрузки пакетного фильтра и правил QoS
- Ошибки PHP
Так же уведомления могут присылать и некоторые пакеты:
- ARPwatch - сообщения о новых MAC адресах, изменениях и flip-flop
- NUT - события вашего UPS
- Suricata IPS - уведомления об обновлении правил, MaxMind GeoIP и RiskIQ баз (опция "Rules, GeoIP and IQRisk update notifications"); сообщения о появлении новых категорий правил (опция "Send notifications when new rule categories appear")
На этом всё,- кроме Телеграм-уведомлений в pfSense 2.5 можно настроить получение сообщений через Pushover API, а в pfSense 2.6 появились Slack уведомления.