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

Принцип действия следующий. В системе мониторинга (Zabbix. Dude, Siem и тп) настраивается электронная почта, на которую отправляются сообщения в случае возникновения определенных заданных событий. Например перестал идти ping до сервера. В роли почтового клиента, который опрашивает почтовый сервис каждую минуту выступает скрипт на виртуальной машине Linux. Скрипт пересылает сообщение в Telegram-бота по его токену на его id или id группы.

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

 

Telegram-бот.

Активируем и настроим собственного Telegram-бота.

Предварительно в смартфоне IT-отдела установлен, настроен и работает мессенджер Telegram.

Скачиваем и устанавливаем клиент Telegram на рабочий ПК Windows администратора. Активируем, входим в него.

Находим через поиск BotFather.

BotFather – это официальный «главный бот» в Telegram, который служит инструментом администратора для создания и управления другими ботами. Он выдает API Token (уникальный ключ) для подключения бота к коду, меняет имя, описание, аватар и команды бота, позволяет удалять ботов и тп.

Подробнее про ботов можно почитать тут.

 

Нажимаем кнопку START.

или отправляем команду

 

В ответ придет список команд.

 

Создаем нового бота. Вводим команду:

Вводим любое логически понятное название бота.

 

Вводим имя бота. (то, как к нему будет обращаться приложение)

В ответ придет TOKEN, например:

Сохраняем его в текстовый файл.

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

 

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

Запрос успешно обработан, бот работает и токен правильный.

На данный момент у бота нет новых событий, о которых можно было бы сообщить.

 

Переходим в нашего созданного бота по ссылке из сообщения BotFather.

 

Нажимаем START.

 

Пишем в бот-чат любое сообщение и еще раз проверяем вывод в браузере.

В выводе находим id чата.

Сохраняем его в текстовый файл.

 

Проверяем отправку из браузера в чат по id. Вставляем в конце команды id и текст сообщения.

В бота придет отправленное сообщение Hello.

 

Не обязательное действие – бота можно настроить.

Команда просмотра ботов в BotFather.

Если кликнуть на бота, откроется меню настроек.

 

Электронная почта пересылки.

Создаем электронную почту yandex, которая будет пересылать сообщения из систем мониторинга в Telegram-бота. Скрипт рассчитан для почты yandex.

Например:

 

Создаем пароль приложения в почте.

Например:

 

Разрешаем доступ к почтовому ящику для сторонних программ.

Яндекс почта >> Настройки >> Все настройки >> Почтовые программы

 

Электронная почта мониторинга.

Эта почта уже существует и присылает сообщения из систем мониторинга. Если её нет – создаем и указываем в системах мониторинга (zabbix, dude, siem и тп).

Например:

 

Пересыльщик почты.

Использован скрипт email-to-telegram-bot с github.

Скрипт работает из Linux. Следовательно, необходимо создать виртуальную машину и установить на нее Linux  (например, Ubuntu), затем настроить скрипт.

 

Создание ВМ.

Минимальны системные требования.

CPU: 2 ядра.

ОЗУ динамическая: мин. 2Гб, макс 4Гб.

Системный диск: 100Гб, динамический.

Размер диска 100Гб это сильный перебор, но уже стандарт в основном для любых ВМ. Сообщения не хранятся локально, скрипт работает через IMAP.

​

Установка Ubuntu.

Использован Ubuntu Server 22 без графического интерфейса.

В процессе мастера установки отмечаем установку ssh-сервера, ip-адрес по DHCP. Всё остальное без изменений. Далее >> Далее >> Готово.

После установки подключаемся по ssh любым удобным клиентом на ip-адрес сервера.

 

Подготавливаем сервер.

Входим с правами root

(пароль)

 

Обновляем список пакетов.

 

Устанавливаем интерпретатор Python 3 и менеджер пакетов pip.

 

Библиотека, необходимая для работы.

 

В дополнение можно установить библиотеку requests для Python, которая упрощает HTTP-запросы.

В оригинальном скрипте нет requests но если планируется доработка, то лучше сразу установить.

 

Настройка скрипта.

Скачиваем проект.

 

Переходим в папку.

 

Редактируем конфигурацию скрипта.

 

Настраиваем скрипт под свои почты и токен.

YANDEX_EMAIL – почта по пересылке писем.

TARGET_EMAIL – почта в системах мониторинга (откуда приходят оповещения).

Скрипт фильтрует входящие письма по email источника.

 

Далее находим строку и указываем в ней свой чат id.

Сохраняем, закрываем.

 

Просмотр выполнения скрипта в терминале.

Если появляются ошибки – устраняем.

Процесс завершится если закрыть терминал. Чтоб процесс выполнения скрипта продолжался постоянно, нужно создать службу, которая будет за этим процессом следить. Альтернативный вариант – запускать скрипт по расписанию cron.

 

Вариант со службой.

Создаем сервис.

 

Вставляем конфиг.

 

Активируем.

Перечитываем все .service файлы с диска, чтоб systemd узнал про новую службу yandexbot.service.

 

Включаем автозапуск при старте системы.

 

Запускаем сервис.

 

Это эквивалентно запуску python3 YandexBot.py в ssh-терминала, но запускается в фоне и под контролем systemd.

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

 

Проверка статуса.

 

Должно быть.

 

Проверка.

Создаем событие на сетевом оборудовании, которое под наблюдением системы мониторинга. Событие приходит на email resender@yandex.ru.

 

Через 1мин событие приходит в телеграм-бот.

 

Группа в Telegram.

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

Создаем группу в основном профиле Telegram.

 

Указываем понятное название.

 

Добавляем в эту группу созданного ранее бота и админов.

 

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

 

Пишем любое сообщение в группе.

 

Находим id чата группы через запрос из браузера.

id чата группы обычно с минусом.

Меняем id в скрипте.

 

Сохраняем.

 

Проверяем.

Создаем событие. Оповещение приходит в группу.

Группа может в итоге стать супергруппой по разным причинам и её id изменится. Оповещение перестанет работать. В этом случае нужно найти новый id супергруппы, который обычно начинается с -100 и заменить id в скрипте.

 

Масштабирование.

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

​