Перейти к содержанию

Безопасность исходящих HTTP(S)-запросов

В Webim 10.8 появилась возможность централизованно задать требования к безопасности исходящих HTTP(S)-запросов. Это помогает защитить интеграции с внешними сервисами, выполнить требования ИБ и исключить использование незащищённого HTTP или устаревших версий TLS.

Где настраивать

Откройте Редактор настроек аккаунта (account config) и добавьте параметр outgoing_http_request_settings.
После изменения параметров не забудьте нажать Flush для применения.

N.B.

Если у вас нет доступа к редактору настроек аккаунта, обратитесь к вашему аккаунт-менеджеру Webim.

Рекомендуемая базовая настройка

Требуем только защищённый транспорт (https://). Без дополнительных полей автоматически используется TLS и включена проверка сертификата сервера.

{
  "outgoing_http_request_settings": {
    "require_secure_transport": true
  }
}

Когда это нужно

  • Подключаете внешние API/CRM/веб‑хуки и хотите гарантировать соединение только по HTTPS.

  • В компании действует политика безопасности, требующая современных протоколов (TLS 1.2+).

  • В интеграции появляются ошибки, связанные с устаревшим TLS у партнёра — настройка помогает быстро проверить и зафиксировать минимальную версию.

N.B.

Настройка влияет только на исходящие HTTP(S)-запросы со стороны Webim. Входящие подключения клиентов сюда не относятся.

Если соединение падает с CERTIFICATE_VERIFY_FAILED, дело в том, что удалённый сертификат не входит в доверенные на сервере Webim. Типичный случай — канал MAX и сертификаты Минцифры РФ. Добавьте УЦ по статье Исходящие соединения.

Более гибкая настройка

Если необходимо явно зафиксировать минимальную версию TLS или таймаут, используйте расширенный пример:

{
  "outgoing_http_request_settings": {
    "require_secure_transport": true,
    "min_ssl_version": "TLSv1_3",
    "timeout": 15
  }
}

Для большинства сценариев достаточно включить require_secure_transport: true — это запретит http:// и обеспечит использование TLS. При особых требованиях можно дополнительно указать минимальную/максимальную версию TLS и таймауты. Если остаются вопросы по настройке или интеграция ведёт себя необычно после изменения параметров, обратитесь к аккаунт-менеджеру или в техническую поддержку Webim.