Справочный материал

inetcfg.xml

Описан файл inetcfg.xml для настройки прокси по умолчанию в BAS, его приоритет в Windows и Linux и атрибуты InternetProxy для авторизации и исключений адресов.

Матовый лист конфигурации управляет сетевыми маршрутами: основной поток проходит через защищённый прокси-узел, а локальные адреса обходят его напрямую.

Файл inetcfg.xml позволяет задавать настройки прокси по умолчанию и имеет более высокий приоритет, чем настройки прокси по умолчанию в ОС Windows или параметры, указанные в переменных среды в ОС Linux.

Файл размещается в каталоге файлов конфигурации системы; его наличие не является обязательным.

  • Для ОС Windows:

    • при наличии файла настройки берутся из файла;
    • при отсутствии файла настройки берутся из настроек Microsoft Internet Explorer. Использование сценария автоматической настройки не поддерживается.
  • Для ОС Linux:

    • при наличии файла настройки берутся из файла;
    • при отсутствии файла выполняется попытка получить настройки из переменных среды http_proxy, https_proxy, ftp_proxy, ftps_proxy (в соответствии с используемым протоколом). Если эти переменные среды не заданы, выполняется попытка получить настройки прокси из переменной среды all_proxy. Если в переменных среды указаны некорректные параметры, они будут проигнорированы.

При настройке прокси можно использовать информацию User-Agent из HTTP-запроса:

  • тонкий клиент — 1CV8C;
  • Веб-сервис — BAS/8.3;
  • веб-клиент — этот параметр формирует веб-браузер.

Пример:

<InternetProxy
    protocols="http=10.1.0.8:8080 10.1.0.9:8080"
    user="proxyUser"
    password="proxyPassword"
    bypassOnLocal="true"
    bypassOnAddresses="127.0.0.1 *.master"
/>

Корневой элемент InternetProxy, задающий настройки прокси по умолчанию, имеет описанную ниже структуру атрибутов.

Атрибут ntlm является необязательным.

Тип: Boolean/Булево. Признак использования механизма NTLM-аутентификации:

  • true — NTLM-аутентификация включена;
  • false — выключена.

По умолчанию NTLM-аутентификация включена.

Атрибут protocols является необязательным.

Тип: String/Строка. Задаёт имя и порт хоста для протоколов. Имеет следующий формат:

ПараметрыПроксиПротокола1 ПараметрыПроксиПротокола2 …ПараметрыПроксиПротоколаN
ПараметрыПроксиПротокола:=[Протокол"="]хост":"порт

Список параметров прокси-протоколов разделяется пробелами. Каждый параметр состоит из необязательного имени протокола, символа «=», имени хоста и порта прокси-сервера, разделённых двоеточием. Если имя протокола не указано, параметры прокси используются для всех протоколов, для которых они не указаны явно. Протоколы могут иметь следующие имена:

  • HTTP,
  • HTTPS,
  • FTP.

Регистр символов имеет значение, другие имена протоколов не поддерживаются. Например:

protocols="http=10.1.0.8:8080 10.1.0.9:8080"

Где:

  • для протокола HTTP определены параметры прокси: хост — 10.1.0.8, порт — 8080;
  • для других протоколов (HTTPS, FTP): хост — 10.1.0.9, порт — 8080.

Атрибут user является необязательным.

Тип: String/Строка. Имя пользователя для авторизации на прокси-сервере. Например:

user="proxyUser"

Атрибут password является необязательным.

Тип: String/Строка. Пароль пользователя для авторизации на прокси-сервере. Пример:

password="proxyPassword"

Атрибут bypassOnLocal является необязательным.

Тип: Boolean/Булево. Признак использования прокси-сервера для локальных адресов:

  • true — не использовать;
  • false — использовать.

Локальность адреса определяется наличием точки в DNS-имени адреса, то есть все IP-адреса не являются локальными. Поэтому фактически локальный адрес может быть не распознан как локальный.

Например, <пользователь>.<домен> является локальным адресом в Windows XP, но не распознаётся как локальный. Чтобы запретить использовать прокси для адресов, воспринимаемых как локальные, используется следующий параметр:

bypassOnLocal="true"

Для всех остальных адресов следует использовать параметр bypassOnAddresses.

Атрибут bypassOnAddresses является необязательным.

Тип: String/Строка. Список адресов, для которых прокси не используется. Имеет следующий формат:

хост1 хост2 … хостN

Имена хостов разделяются пробелами. Имя хоста может содержать специальные символы маски: * — любое количество символов, ? — любой символ. Например, чтобы не использовать прокси для всех хостов домена, следует применить *.<имя домена>, например:

bypassOnAddresses="127.0.0.1 *.master"

В примере прокси не используется для адреса 127.0.0.1 (localhost) и для всех адресов домена master.

Записаться по телефону