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.