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

Использование прокси

В ряде сценариев может потребоваться отправка запросов от Webim к внешним сервисам через прокси-сервер.

Прокси используются для следующих случаев:

  • запросы в каналы (MAX, Telegram, Viber и др.);

  • отправка пуш-уведомлений (hpk — Huawei, apns — iOS, fcm — Android).

Настройки прокси могут указываться двумя способами:

  1. Глобальная конфигурация — задаётся в редакторе настроек аккаунта (proxies), применяется ко всем поддерживаемым каналам и сервисам, если у них нет индивидуальных настроек.

  2. Индивидуальная конфигурация — задаётся на уровне конкретного канала через Панель управления.

Поддерживаемые типы прокси

Webim поддерживает только HTTP-прокси. Использование других типов (например, SOCKS-прокси) не предусмотрено.

N.B.

Если в вашей инфраструктуре используется нестандартный прокси, убедитесь, что он поддерживает HTTP-протокол.

Каналы с поддержкой прокси

На момент версии Webim 10.7, использование прокси доступно только для следующих каналов:

  • LINE

  • Telegram

  • Viber

Для остальных каналов (например, WhatsApp1, VK и др.) прокси не применяется. Даже если в настройках задан глобальный прокси — запросы будут отправляться напрямую.

Настройка прокси на уровне канала

Чтобы задать прокси для конкретного канала:

  1. Перейдите в раздел Каналы общения в интерфейсе РМО.

    Настройки каналов общения
    Настройки каналов общения

  2. Нажмите Добавить или выберите нужный канал и нажмите Редактировать.

    Добавление или редактирование канала
    Добавление или редактирование канала

  3. В нижней части формы включите опцию Использовать прокси, заполните поля и нажмите Сохранить.

    Включение прокси
    Включение прокси

Описание полей:

Параметр Описание
Адрес IP-адрес или доменное имя прокси-сервера.
Порт Порт, используемый для подключения.
Пользователь Имя пользователя (если прокси требует аутентификацию).
Пароль Пароль пользователя (если прокси требует аутентификацию).

В форме канала Telegram также может быть поле URL прокси для вебхука (webhook_proxy_url).

При редактировании уже сохранённого канала Адрес прокси, Пароль и (для Telegram) URL прокси для вебхука отображаются частично скрытыми. Чтобы изменить поле, введите новое значение целиком. Незаполненные поля не маскируются. Подробнее о виде маски см. в разделе Каналы общения.

После сохранения настроек канал будет использовать указанный прокси. Если прокси не включён на уровне канала, будет использоваться глобальная конфигурация.

Глобальная настройка прокси

Глобальная конфигурация указывается в account config в блоке proxies и применяется ко всем поддерживаемым каналам и сервисам (пуши, каналы), если у них нет индивидуальной настройки.

Пример блока в редакторе настроек аккаунта:

{
  "channels": {
    "host": "127.0.0.1",
    "port": "3128",
    "user": "user1",
    "password": "12345"
  },
  "fcm": {
    "host": "127.0.0.1",
    "port": "3128",
    "user": "user1",
    "password": "12345"
  },
  "apns": {
    "host": "127.0.0.1",
    "port": "3128",
    "user": "user1",
    "password": "12345"
  },
  "hpk": {
    "host": "127.0.0.1",
    "port": "3128",
    "user": "user1",
    "password": "12345"
  }
}

N.B.

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

Использование прокси в Webim позволяет адаптировать систему под особенности корпоративной инфраструктуры и повысить безопасность соединений.

Перед настройкой убедитесь, что:

  • нужный канал поддерживает работу через прокси;

  • выбранный прокси работает по протоколу HTTP.

  1. WhatsApp принадлежит корпорации Meta, деятельность которой признана экстремистской и запрещена в РФ. ↩