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

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

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

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

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

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

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

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

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

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

N.B.

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

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

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

• LINE

• Telegram

• Viber

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

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

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

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

   

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

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

   

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

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

   

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

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

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

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

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

Глобальная конфигурация указывается в аккаунт-конфиге в блоке 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.