← На главную

Настройка интеграции Сервера взаимодействия (СВ) 1С с Telegram-ботом часто вызывает затруднения из-за строгих требований API Telegram к безопасности. Давайте разберем по шагам, как правильно организовать эту связку, учитывая, что ваш сервер находится внутри локальной сети.

Понимание архитектуры взаимодействия

Прежде всего, важно осознать ключевое ограничение: Telegram требует, чтобы вебхуки (Webhooks) работали исключительно по протоколу HTTPS. Кроме того, Telegram поддерживает только ограниченный список портов: 443, 80, 88 и 8443. Если ваш Сервер взаимодействия работает внутри локальной сети по обычному HTTP, внешние серверы Telegram просто не смогут к нему подключиться.

Самым надежным и профессиональным решением является использование обратного прокси-сервера (Reverse Proxy), например, Nginx. Эта схема позволяет «выставить» наружу защищенный HTTPS-интерфейс, который внутри сети будет прозрачно перенаправляться на ваш Сервер взаимодействия.

Пошаговый план реализации

1. Подготовка внешнего контура: Вам необходимо иметь доменное имя, которое указывает на ваш внешний IP-адрес. На этом домене должен быть установлен валидный SSL-сертификат (например, через Let's Encrypt).
2. Настройка Nginx: Настройте Nginx так, чтобы он принимал входящие HTTPS-запросы от Telegram. Nginx будет выполнять «SSL Termination» (завершение SSL-сессии), расшифровывая запрос, и пересылать его дальше внутри сети уже по обычному HTTP.
3. Проброс портов: На вашем роутере (например, MikroTik) настройте правило проброса (NAT), чтобы входящие запросы на порт 8443 (или 443) транслировались на внутренний IP-адрес сервера с Nginx.
4. Настройка Сервера взаимодействия: В конфигурационном файле integration.yml необходимо правильно указать параметр public-url.

Конфигурация интеграции

В файле integration.yml параметр public-url должен содержать ваш внешний публичный адрес, например: https://your-domain.com:8443. Это критически важно, так как СВ использует этот адрес для отправки команды setWebhook в API Telegram. Если сервер Telegram получит внутренний IP-адрес (например, 172.20.10.10), он не сможет отправить ответные обновления, так как этот адрес недоступен из глобальной сети.

Почему не нужно настраивать SSL внутри 1С СВ?

Многие пытаются настроить SSL-сертификаты непосредственно внутри Java-окружения, где работает Сервер взаимодействия. Это сложный путь, который часто приводит к ошибкам. Использование Nginx перед СВ позволяет:

• Легко обновлять сертификаты через автоматические инструменты (например, certbot).
• Обеспечить высокий уровень безопасности, так как СВ остается изолированным внутри локальной сети.
• Избежать проблем с совместимостью библиотек Java и форматов сертификатов.

Диагностика возможных проблем

Если после настройки вы не видите активности, проанализируйте следующие моменты:

• Проверка прохождения трафика: Убедитесь, что запрос от Telegram доходит до вашего Nginx. Проверьте access.log и error.log на Nginx.
• Заголовки запроса: Убедитесь, что при проксировании передаются правильные заголовки Host, X-Real-IP и X-Forwarded-For. Сервер взаимодействия должен видеть оригинальный запрос, а не запрос от самого прокси-сервера.
• Цепочка NAT: Проверьте правила на MikroTik. Убедитесь, что трафик корректно проходит через шлюз и возвращается обратно (Hairpin NAT, если это применимо в вашей топологии).

Таким образом, ключ к успеху — это разделение ответственности: внешнюю безопасность и работу с SSL берет на себя Nginx, а внутреннюю бизнес-логику интеграции — Сервер взаимодействия. Соблюдая эту архитектуру, вы сможете запустить бота без лишних сложностей с Java-сертификатами.