Приложение 3. Описание и расположение служебных файлов

Данное приложение содержит описание и расположение различных служебных файлов, которые могут использоваться при работе «1С:Предприятия».

Конфигурационный файл Web-сервиса для работы с удаленным хранилищем может иметь произвольное имя (расширение 1ccr обязательно), формат XML и содержит единственный узел с произвольным именем и атрибутом connectString ‑ в этом атрибуте указывается адрес сервера хранилища в схеме TCP.

Например, такой конфигурационный файл может иметь имя repository.1ccr и следующее содержание:

<?xml version="1.0" encoding="UTF-8"?>
<repository connectString="tcp://RepServ"/>

В данном случае в качестве произвольного имени узла выбрано имя repository, а адрес сервера хранилища конфигурации ‑ tcp://RepServ.

Файл с расширение mft является файлом-манифестом ‑ специальным файлом, описывающим шаблон конфигурации. Файл может иметь произвольное имя.

Файл располагается в каталоге установленного шаблона конфигурации.

Файл-манифест имеет произвольное имя и расширение mft. Внутренний формат файла-манифеста близок к формату ini-файла. Для поддержки нескольких языков файл-манифест использует кодировку UTF-8. В начале файла-манифеста указываются следующие параметры.

Поставщик решения. Совпадает с указанным в конфигурации.

Наименование решения. Совпадает с указанным в конфигурации.

Версия решения. Совпадает с указанной в конфигурации.

Версия «1С:Предприятия», с помощью которой создавался комплект поставки.

Следующие параметры относятся к частям решения и разделяются наименованиями секций. Наименования секций выбираются произвольно и заключаются в квадратные скобки.

Относительный путь к файлу конфигурации (cf), файлу обновления (cfu) или выгрузки базы данных (dt).

Наименование решения в каталоге решений. Параметров Catalog_<суффикс языка> в файле-манифесте может быть несколько. Суффикс определяет язык пользовательского интерфейса 1С:Предприятия 8 (например, ru для указания русского языка). Если суффикс языка не указан (имя параметра задано как Catalog), то значение этого параметра используется для всех пользовательских интерфейсов, кроме тех, для которых в данной секции указан параметр Catalog с нужным языковым суффиксом.

Рекомендуемый каталог создания информационной базы. Этот параметр используется при создании информационной базы из шаблона. Каталог представляет частичный путь. В качестве одной из частей каталог должен включать в себя каталог поставщика (во избежание совпадения имен каталогов у различных решений).

В каталоге шаблона конфигурации допускается наличие нескольких cfu-файлов.

Vendor=Фирма "1С"
Name=Управление Торговлей
Version=8.10.0.2
[Main]
Source=Main\1cv8.cf
Catalog_ru=Управление торговлей/Управление торговлей
Destination=1C\Trade
[Demo]
Source=Demo\1cv8.dt
Catalog_ru=Управление торговлей/Управление торговлей (Демо)
Destination=1C\DemoTrd

В данном приложении приводится описание формата файла описаний зарегистрированных информационных баз. Этот список используют все клиенты. По умолчанию файл имеет имя ibases.v8i.

Расположение файла:

● Для ОС Linux: ~\.1C\1cestart.

● Для ОС macOS: ~\.1C\1cestart.

● Для ОС Windows: %APPDATA%\1C\1CEStart\ локального компьютера.

Файл представляет собой текстовый документ в кодировке UTF-8 и состоит из секций. Каждая секция описывает одну информационную базу.

Файл состоит из секций описаний информационных баз.

Секция описания информационной базы:

[Наименование секции]
Connect=
ID=
OrderInList=
Folder=
OrderInTree=
External=
ClientConnectionSpeed=
App=
AppArch=
DefaultApp=
WA=
WSA=
Version=
DefaultVersion=
AdditionalParameters=
WebCommonInfoBaseURL=
HttpsCA=
HttpsCert=
HttpsCAFile=
HttpsCertFile=
HttpsCertSelect=
ShowInList=
MobilePublicKey=
WebCommonInfoBases=

Секция состоит из наименования секции и параметров.

Наименование и каждый параметр секции записываются в отдельной строке файла описаний.

Наименование секции совпадает с наименованием информационной базы и является обязательным параметром. Наименование заключается в квадратные скобки.

Параметр может редактироваться в окне свойств информационной базы.

Пример:

[Демонстрационная версия 8.2]

Внутренний идентификатор информационной базы. Формируется автоматически. Должен быть уникальным в рамках одного файла v8i.

Формирование идентификатора вручную не рекомендуется.

Пример:

ID=cf9f0d4b-b4a3-11d8-861e-0050baaa2f3f

Строка соединения с информационной базой. Может существовать несколько описаний информационных баз, которые имеют одинаковую строку запуска (но разное наименование). Это может потребоваться, когда необходимо запускать одну базу в нескольких режимах запуска (например, тонкий и толстый клиенты), не меняя свойства информационной базы.

Пример:

Файловый вариант указывается в виде:

Connect=File=<Путь>;

Клиент-серверный вариант указывается в виде:

Connect=Srvr=<ИмяСервера1СПредприятия>;Ref=<ИмяИнформационнойБазыНаСервере>;

Подключение через веб-сервер указывается в виде:

Connect=ws="http://web-server/resource/";

Наименование папки в дереве информационных баз.

Пример:

Folder=/Торговыебазы

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

Пример:

OrderInList=5

Порядок в ветви при представлении деревом.

Пример:

OrderInTree=16358

Указывает на вариант использования прокси-сервера для варианта ws-соединения.

● 0 ‑ прокси-сервер не используется;

● 1 ‑ автоматическое определение настроек прокси-сервера;

● 2 ‑ явное указание настроек прокси-сервера.

Если параметр UseProxy не указан, то используется автоматическое определение настроек прокси-сервера. Для файлового и клиент-серверного варианта не имеет смысла.

Пример:

UseProxy=1

Строка, содержащая адрес прокси-сервера (обязателен только в том случае, когда параметр UseProxy имеет значение 2).

Пример:

PSrv=192.168.0.1

Номер порта прокси-сервера (обязателен только в том случае, когда параметр UseProxy имеет значение 2).

Пример:

PPort=123

Имя пользователя прокси-сервера.

Пример:

PUser=userName

Зашифрованный пароль для прокси-сервера.

Пример:

PPasswd=XNKxbVEqnXUCwwk1Urovbo7bZFpG/Zpf6cQ10qVtzpk=

Скорость клиентского соединения (имеет смысл только для тонкого и веб-клиентов). Принимает значения:

● Normal ‑ обычная скорость соединения;

● Low ‑ низкая скорость соединения.

Если параметр не указан, то скорость клиентского соединения будет определяться значением флажка Низкая скорость соединения окна запуска (что эквивалентно значению Выбирать при запуске параметра Скорость соединения окна с параметрами запуска информационной базы, см. здесь).

Пример:

ClientConnectionSpeed=Low

Определяет вариант аутентификации пользователя. Принимает значения:

● 1 ‑ пытаться выполнить аутентификацию средствами ОС. Если выполнено неудачно, запрашивается логин/пароль.

● 0 ‑ всегда использовать аутентификацию с помощью логина/пароля.

Пример:

WA=1

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

● 1 ‑ пытаться выполнить аутентификацию на веб-сервере средствами ОС. Если выполнено неудачно, запрашивается логин/пароль.

● 0 ‑ всегда запрашивать логин/пароль.

Пример:

WSA=1

Определяет тип клиентского приложения:

● Auto ‑ автоматический выбор типа клиентского приложения;

● ThinClient ‑ тонкий клиент;

● ThickClient ‑ толстый клиент;

● WebClient ‑ веб-клиент.

Параметр может редактироваться в окне свойств информационной базы.

Пример:

App=Auto

Тип клиента, который определяется и помещается в данный файл программой запуска при автоматическом определении типа клиентского приложения (ключ /AppAutoCheckMode):

● ThinClient ‑ тонкий клиент;

● ThickClient ‑ толстый клиент.

Если значение параметра App равно Auto и параметр DefaultApp не указан, выполняется запуск тонкого клиента с параметром командной строки /AppAutoCheckMode.

Если параметр DefaultApp задан, то выполняется запуск указанного в нем клиента с указанием параметра /AppAutoCheckMode.

Пример:

DefaultApp=ThinClient

Версия «1С:Предприятия», которая должна использоваться для запуска информационной базы.

Параметр может редактироваться в окне свойств информационной базы.

Пример:

Version=8.3.24

Версия системы «1С:Предприятие», которая реально использовалась при последнем запуске данной информационной базы. Автоматически определяется и помещается в данный файл программой запуска, если выполняется запуск с параметром /AppAutoCheckVersion.

При последующих запусках будет использоваться именно эта версия, а не та, которая указана в параметре Version.

Пример:

DefaultVersion=8.3.24.100

Содержит дополнительные параметры запуска, которые могут быть введены в окне свойств информационной базы, в элементе Дополнительные параметры запуска.

Пример:

AdditionalParameters=/TechnicalSpecialistMode

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

Если при интерактивном запуске интерактивной программы запуска (1cv8s) обнаруживается, что список общих информационных баз, полученных с помощью Интернет-сервиса, не требует обновления, то описания всех информационных баз (вызов Web-сервиса WebCommonInfoBases.CheckInfoBases() вернул параметр InfoBaseChanged равный значению Ложь), которые получены из этого источника, остаются в списке до следующего запуска.

Если из файла 1cestart.cfg удалены параметры InternetService или WebCommonInfoBases, то из списка информационных баз будет удалена информация об информационных базах, полученных из удаленных источников.

Пример:

WebCommonInfoBaseURL=http://info-server/listservice

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

● None ‑ сертификаты удостоверяющих центров не используются, проверка серверного сертификата не осуществляется.

● File ‑ сертификаты удостоверяющих центров находятся в файле.

● Windows ‑ сертификаты удостоверяющих центров находятся в системном хранилище сертификатов ОС Windows.

● Linux ‑ сертификаты удостоверяющих центров находятся в каталоге сертификатов ОС Linux.

● macOS ‑ сертификаты удостоверяющих центров находятся в системном хранилище сертификатов ОС macOS.

Тип источника клиентского сертификата и его закрытого ключа. Может принимать следующие значения:

● None ‑ клиентский сертификат не используется;

● File ‑ клиентский сертификат находится в файле;

● Windows ‑ клиентский сертификат находится в системном хранилище сертификатов ОС Windows;

● Linux ‑ клиентский сертификат находится в каталоге сертификатов ОС Linux.

● macOS ‑ клиентский сертификат находится в системном хранилище сертификатов ОС macOS.

Путь к файлу, который содержит сертификаты удостоверяющих центров. Если параметр HttpsCA установлен в значение File, а данный параметр отсутствует или равен пустой строке, то считается, что параметр HttpsCA установлен в значение None.

Путь к файлу, который содержит клиентский сертификат и его закрытый ключ. Если параметр HttpsCert установлен в значение File, а данный параметр отсутствует или равен пустой строке, то считается, что параметр HttpsCert установлен в значение None.

Способ выбора клиентского сертификата ОС Windows, в случае если установлено более одного подходящего для данного соединения сертификата. Может принимать следующие значения:

● Recent ‑ использовать выбранный, если есть запомненный ‑ используется он, если нет ‑ открывается диалог выбора и выбранный сертификат запоминается для использования в дальнейшем;

● Choose ‑ всегда выбирать сертификат. Выбранный сертификат запоминается, и в дальнейшем может использоваться, если данный параметр будет установлен в значение Recent;

● Auto ‑ автоматически подбирать подходящий сертификат для данного соединения. Диалог выбора не открывается.

Определяет разрядность клиентского приложения, которое будет использоваться для работы с данной информационной базой. Значение разрядности совпадает с параметрами команды /AppArch командной строки запуска клиентского приложения (см. здесь).

Когда при подключении к информационной базе возникает ошибка, то администратор может в диалоге с ошибкой включить отображение гиперссылки Нужна помощь?. Для этого необходимо указать URL в данном свойстве. В качестве адреса рекомендуется задавать, например, список частых проблем (и их решений) при подключении, список контактов службы технической поддержки или какую-либо аналогичную информацию.

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

● Простой строкой.

● Форматированной строкой. В этом случае значением параметра должно быть сериализованное значение форматированной строки. Сериализацию необходимо выполнять методом СериализаторXDTO.XMLСтрока(ТекстДляДиалога). ТекстДляДиалога ‑ это переменная, которая содержит значение типа ФорматированнаяСтрока.

Следующий набора параметров применяется только в v8i-файлах, которые используются в собранном приложении мобильного клиента.

С помощью этого параметра можно указать, что информационная база будет находиться в главном списке информационных баз на мобильном устройстве. Параметр может принимать следующие значения:

● 1 ‑ информационная база находится в главном списке баз мобильного устройства.

● 0 ‑ информационная база не находится в главном списке баз мобильного устройства. Для доступа к этой базе необходимо воспользоваться специальным меню.

Значение по умолчанию 0.

Пример:

ShowInList=1

Хеш MD5 (в формате Base64) открытого ключа, который используется для проверки подписи конфигурации, которую пытаются использовать в мобильном клиенте. Значение хеша (в требуемом формате) доступно в диалоге конфигуратора Подпись мобильного клиента.

Пример:

MobilePublicKey=322B116E58FA1B7EC6961A8FE53389EE

Данный параметр содержит адрес Интернет-сервиса получения списка общих информационных баз. Информационная база из списка попадет в список мобильного клиента (на мобильном устройстве) в том случае, если для конфигурации из списка общих информационных баз значение параметра MobilePublicKey совпадает со значением этого параметра для какой-либо конфигурации, заданной на этапе сборки мобильного приложения.

Данный параметр для мобильного клиента аналогичен параметру InternetService файла 1cestart.cfg.

В случае мобильного клиента данный параметр может быть вложенным, т. е. список общих информационных баз, который возвращает Интернет-сервис, может содержать указание на другой Интернет-сервис.

Пример:

InternetService=http:\\server\addr

Данный параметр управляет необходимостью отображения диалога аутентификации пользователя.

Данный параметр отключает отображение флажка Использовать биометрию в диалоге аутентификации пользователя мобильного клиента.

Этот параметр управляет состоянием по умолчанию флажка Использовать биометрию в диалоге аутентификации пользователя мобильного клиента. Если в описании информационной базы используется параметр DisableUseBiometrics, то данный параметр не имеет смысла. Параметр может принимать следующие значения:

● 1 ‑ флажок Использовать биометрию включен.

● 0 ‑ флажок Использовать биометрию выключен.

Значение по умолчанию 1.

Данный параметр отключает отображение флажка Запомнить меня в диалоге аутентификации пользователя мобильного клиента.

Этот параметр управляет состоянием по умолчанию флажка Запомнить меня в диалоге аутентификации пользователя мобильного клиента. Если в описании информационной базы используется параметр DisableRememberMe, то данный параметр не имеет смысла. Параметр может принимать следующие значения:

● 1 ‑ флажок Запомнить меня включен.

● 0 ‑ флажок Запомнить меня выключен.

Значение по умолчанию 1.

Смотри также:

● Конфигурационный файл 1cestart.cfg (см. здесь).

● Интернет-сервис получения списка общих информационных баз (см. здесь).

Файл 1cescmn.cfg содержит общие настройки программ запуска (1cestart и 1cv8s). Файл располагается в каталоге, откуда выполняется установка системы в случае сетевого каталога расположения дистрибутивов (см. здесь).

Файл представляет собой текстовый документ в кодировке UTF-8 или UTF-16LE и содержит строки формата <Параметр>=<Значение>.

Описание файла эквивалентно описанию файла 1cestart.cfg (см. здесь) с тем исключением, что общий конфигурационный файл не может содержать строку с параметром CommonCfgLocation.

Пример:

CommonInfoBases=ibcommon.v8i
DistributiveLocation=\\server\v8dst

В данном примере задается имя файла со списком общих информационных баз (ibcommon.v8i), который должен располагаться в том же каталоге, что и файл с интерактивной программой запуска (1cestart). Также задается каталог расположения дистрибутивов версий системы: \\server\v8dst.

Файл 1cestart.cfg содержит настройки, которые используют программы запуска (1cestart и 1cv8s), клиентские приложения (1cv8 и 1cv8c) и внешнее соединение.

Расположение файла:

● Для ОС Linux: ~/.1C/1cestart.

● Для ОС macOS: ~/.1C/1cestart.

● Для ОС Windows:

● Установка «для компьютера»:

● %APPDATA%\1C\1CEStart ‑ для конкретного пользователя. Файл изменяется при выполнении настроек окна запуска (см. здесь).

● %ALLUSERSPROFILE%\1C\1CEStart ‑ для всех пользователей компьютера. Файл изменяется только во время установки системы «1С:Предприятие».

● Установка «для пользователя»:

● %APPDATA%\1C\1CEStart ‑ для конкретного пользователя. Файл изменяется при выполнении настроек окна запуска (см. здесь).

Файл представляет собой текстовый документ в кодировке UTF-16LE и содержит строки формата <Параметр>=<Значение>. Далее приведены описания параметров, которые могут содержаться в этом файле.

Пример:

DefaultVersion=8.2-8.2.16
DefaultVersion=8.3-8.3.24
CommonCfgLocation=\\Server\v8\1cescmn.cfg
CommonInfoBases=\\Server\common\common_dblist.v8i
InstalledLocation=C:\Program Files\1cv8
DistributiveLocation=\\server\dst1C\v8
ConfigurationTemplatesLocation=\\server\tmplts
ConfigurationTemplatesLocation=C:\Documents and Settings\User\Application Data\1C\1cv8\tmplts
InstallComponents=DESIGNERALLCLIENTS=1 THINCLIENT=1 WEBSERVEREXT=1 SERVER=1 CONFREPOSSERVER=0 CONVERTER77=1 SERVERCLIENT=1 LANGUAGES=RU
UseHwLicenses=0
AppAutoInstallLastVersion=0

Параметр AppAutoInstallLastVersion определяет необходимость автоматической установки новой версии «1С:Предприятия»:

● 0 ‑ выключить автоматическую установку новой версии;

● 1 ‑ включить автоматическую установку новой версии (значение по умолчанию).

Используется значение параметра из одного конфигурационного файла в соответствии со следующим приоритетом:

● локальный конфигурационный файл;

● локальный конфигурационный файл для всех пользователей;

● общий конфигурационный файл.

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

Параметры AutoUninstall определяет необходимость выполнять автоматическое удаление устаревших версий:

● 0 ‑ автоматическое удаление не выполняется.

● 1 ‑ автоматическое удаление выполняется (значение по умолчанию).

Используется значение параметра из одного конфигурационного файла в соответствии с убыванием приоритета:

● Общий конфигурационный файл.

● Локальный конфигурационный файл.

● Локальный конфигурационный файл для всех пользователей.

Параметр AutoUninstallVersionsAfter позволяет указать количество дней, по истечение которых (с момента установки версии) версия будет считаться устаревшей.

Значение по умолчанию: 90.

Используется значение параметра из одного конфигурационного файла в соответствии с убыванием приоритета:

● Общий конфигурационный файл.

● Локальный конфигурационный файл.

● Локальный конфигурационный файл для всех пользователей.

Параметр CommonCfgLocation указывает путь и имя общего конфигурационного файла. Допускается наличие нескольких строк с таким параметром.

Используются значения из всех конфигурационных файлов.

Параметр CommonInfoBases указывает путь и имя файла со списком общих информационных баз.

Используются значения из всех конфигурационных файлов.

Описание формата файла со списком информационных баз см. здесь.

Параметр ConfigurationTemplatesLocation указывает путь к каталогу шаблонов конфигураций. Может быть более одной записи.

Используются значения из всех конфигурационных файлов.

Параметр DefaultVersion определяет версию, используемую по умолчанию. Допускается наличие нескольких строк с таким параметром.

Разрядность запускаемого клиентского приложения может быть указана в данном параметре. Для разделения версии и разрядности клиентского приложения используется символ ";". Значение разрядности совпадает с параметрами команды /AppArch командной строки запуска клиентского приложения (см. здесь).

Используются значения из всех конфигурационных файлов.

Пример 1:

DefaultVersion=8.3-8.3.24.100

Данная строка означает, что при попытке запуска информационной базы с указанием версии 8.3 будет использоваться версия 8.3.24.100.

Пример 2:

DefaultVersion=8.2.15-8.2.15.315

Данная строка означает, что при попытке запуска информационной базы с версией 8.2.15 будет использоваться версия 8.2.15.315.

Пример 3:

DefaultVersion=8.3;x86_64_prt

Данная строка означает, что при попытке запуска любой информационной базы будет использовать клиентское приложение версии 8.3 с приоритетом использования 64-разрядной версии. Подробнее выбор разрядности запускаемого клиентского приложения см. здесь.

Параметр отключает проверку цифровой подписи программы установки клиентского приложения, которая получена через HTTP или из самораспаковывающегося архива прикладного решения (сформированного с помощью утилиты 1CEClientSetupMake):

● 1 ‑ проверка цифровой подписи отключена.

● 0 ‑ проверка цифровой подписи включена (значение по умолчанию).

Параметр DistributiveLocation содержит указание на каталог, в котором будет производиться поиск новой версии для автоматической установки.

Используются значения из всех конфигурационных файлов.

Поиск каталога с дистрибутивами новых версий будет также выполняться в каталоге, где расположен общий конфигурационный файл (1cescmn.cfg).

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

Используются значения из всех конфигурационных файлов.

В локальном конфигурационном файле и локальном конфигурационном файле для всех пользователей (1cestart.cfg) содержится перечень установленных компонент.

В общем конфигурационном файле (1cescmn.cfg) содержится перечень компонент, которые необходимо установить (формируется администратором системы).

Используется значение параметра InstallComponents из одного конфигурационного файла в соответствии со следующим приоритетом:

● локальный конфигурационный файл для всех пользователей;

● локальный конфигурационный файл;

● общий конфигурационный файл.

Параметр содержит строку компонентов с признаком необходимости установки, разделенных пробелом:

● 0 ‑ не устанавливать;

● 1 ‑ устанавливать.

Возможны следующие компоненты:

Пример:

LANGUAGES=RU,UK,BG

Пример параметра:

InstallComponents=DESIGNERALLCLIENTS=0 THINCLIENT=1 WEBSERVEREXT=0 SERVER=0 CONFREPOSSERVER=0 CONVERTER77=0 SERVERCLIENT=1 LANGUAGES=RU,EN

Параметр InstalledLocation содержит указание на каталог, в который выполнена установка «1С:Предприятие». По умолчанию это путь к корневому каталогу установки соответствующей операционной системы (см. здесь).

Используются значения из всех конфигурационных файлов в следующем порядке:

● из общего конфигурационного файла;

● из локального конфигурационного файла для всех пользователей;

● из локального конфигурационного файла.

Параметр InstallForUsers содержит значение, описывающее режим установки системы «1С:Предприятие», в зависимости от прав текущего пользователя:

● 0 ‑ режим установки определяется правами текущего пользователя. Значение по умолчанию.

● 1 ‑ выполнять установку «для компьютера».

● 2 ‑ выполнять установку «для текущего пользователя» с возможностью уточнить режим у пользователя.

● 3 ‑ выполнять установку «для текущего пользователя» без возможности уточнения режима у пользователя.

Смотри также:

● Определение режима установки системы (см. здесь).

Параметр InternetService позволяет указать URL интернет-сервиса, который предоставляет список общих информационных баз и дистрибутив клиентского приложения.

Вначале выполняется попытка получения необходимого файла (со списком общих информационных баз или дистрибутивом клиентского приложения) с помощью HTTP-запроса, если эта попытка оказалась неудачной ‑ выполняется попытка получения файла с помощью Web-сервиса.

При этом для HTTP-запроса полный URL сервиса формируется следующим образом: <Адрес из параметра InternetService>/<Имя сервиса>/<Имя метода>/?<Параметры метода>.

Для запроса с помощью Web-сервиса адрес описания (в формате WSDL) формируется следующим образом: <Адрес из параметра InternetService>/<Имя сервиса>/?wsdl.

Параметр UseHwLicenses управляет поиском ключа защиты (как локального, так и доступного по сети) при запуске «1С:Предприятия»:

● 1 ‑ поиск ключа защиты выполняется (значение по умолчанию);

● 0 ‑ поиск ключа защиты не выполняется.

Используется значение параметра из одного конфигурационного файла в соответствии со следующим приоритетом:

● локальный конфигурационный файл;

● локальный конфигурационный файл для всех пользователей;

● общий конфигурационный файл.

Данный параметр позволяет отключить поиск ключа защиты в тех случаях, когда получение клиентских лицензий реализовано с помощью расширения веб-сервера, сервера «1С:Предприятия» или в случае базовой версии.

Значение параметра может изменяться системой в следующих случаях:

● Если поиск ключа защиты включен, то при старте клиентского приложения выполняется анализ времени поиска ключа защиты. Если ключ защиты не был найден, запуск выполнен успешно и время поиска превысило 3 секунды, пользователю предлагается отключить поиск ключа защиты для ускорения последующих запусков. В случае согласия пользователя в файл 1cestart.cfg этого пользователя выполняется запись параметра UseHwLicenses=0.

● Если поиск ключа защиты отключен и при запуске обнаруживается, что лицензия не получена от сервера «1С:Предприятия» или расширения веб-сервера, то пользователю предлагается включить поиск ключа защиты. В случае согласия пользователя в файл 1cestart.cfg этого пользователя выполняется запись параметра UseHwLicenses=1 и выполняется перезапуск клиентского приложения.

Если осуществляется запуск внешнего соединения, то выполняется попытка анализа параметра из файла 1cestart.cfg, расположенного в профиле пользователя, от имени которого запускается внешнее соединение. Если у пользователя отсутствует профиль (например, пользователь LocalSystem в ОС Windows), то поиск ключа выполняется всегда.

Параметр WebCommonInfoBases позволяет указать URL интернет-сервиса, который предоставляет список общих информационных баз.

Вначале выполняется попытка получения списка общих информационных баз с помощью HTTP-запроса, если эта попытка оказалась неудачной ‑ выполняется попытка получения файла с помощью Web-сервиса.

При этом для HTTP-запроса полный URL сервиса формируется следующим образом: <Адрес из параметра WebCommonInfoBases>/<Имя сервиса>/<Имя метода>/?<Параметры метода>.

Для запроса с помощью Web-сервиса адрес описания (в формате WSDL) формируется следующим образом: <Адрес из параметра WebCommonInfoBases>/<Имя сервиса>/?wsdl.

Если указан и параметр InternetService и параметр WebCommonInfoBases, то вначале используется адрес, указанный в параметре WebCommonInfoBases, и в случае неудачи ‑ адрес, указанный в параметре InternetService.

Параметр WebDistributiveLocation позволяет указать URL интернет-сервиса, который предоставляет дистрибутив клиентского приложения.

Вначале выполняется попытка получения дистрибутива клиентского приложения с помощью HTTP-запроса, если эта попытка оказалась неудачной ‑ выполняется попытка получения файла с помощью Web-сервиса.

При этом для HTTP-запроса полный URL сервиса формируется следующим образом: <Адрес из параметра WebDistributiveLocation>/<Имя сервиса>/<Имя метода>/?<Параметры метода>.

Для запроса с помощью Web-сервиса адрес описания (в формате WSDL) формируется следующим образом: <Адрес из параметра WebDistributiveLocation>/<Имя сервиса>/?wsdl.

Если указан и параметр InternetService и параметр WebDistributiveLocation, то вначале используется адрес, указанный в параметре WebDistributiveLocation, и в случае неудачи ‑ адрес, указанный в параметре InternetService.

Файл расположен в каталоге данных каждого рабочего сервера, отмеченного как центральный.

Файл содержит реестр кластера и хранит следующую информацию:

● список информационных баз, зарегистрированных в данном кластере;

● список рабочих серверов, входящих в кластер;

● список рабочих процессов, входящих в кластер;

● список менеджеров кластера;

● список сервисов кластера;

● список администраторов кластера.

Пример:

C:\Program Files\1cv8\srvinfo\reg_1541\1CV8Clst.lst

Файл содержит список центральных серверов кластера в разрезе информационных баз, а также другую информацию, используемую клиентскими и серверными приложениями системы «1С:Предприятие».

Для надежной работы требуется, чтобы пользователи, от имени которых запускаются приложения системы «1С:Предприятие», имели права на создание, чтение и изменение данных в каталоге, где расположен данный файл. Если система «1С:Предприятие» используется на компьютере, работающим под управлением ОС Windows, разными пользователями, то рекомендуется предоставить всем пользователям, которые используют систему «1С:Предприятие» или группе USERS, полный доступ к каталогу расположения файла (указан далее), а пользователя СОЗДАТЕЛЬ-ВЛАДЕЛЕЦ (CREATOR OWNER) удалить из списка безопасности данного каталога.

Расположение файла:

● Для ОС Linux: ~/.1cv8/1C/1cv8.

● Для ОС macOS: ~/.1cv8/1C/1cv8.

● Для ОС Windows: %ALLUSERSPROFILE%\1C\1cv8.

Файл хранится на компьютере рабочего сервера, отмеченного как центральный, в каталоге служебных файлов кластера и содержит список кластеров, зарегистрированных на данном компьютере сервера «1С:Предприятия». Содержащиеся в нем данные необходимы для нормальной работы приложений, использующих данный сервер «1С:Предприятия».

Пример:

C:\Program Files\1cv8\srvinfo\1cv8wsrv.lst

Файл adminstall.cfg указывает на то, что установка системы программ «1С:Предприятие» выполнялась с использованием средств администрирования ОС Windows. Файл располагается в каталоге конфигурационных файлов системы «1С:Предприятие» и представляет собой текстовый документ в кодировке UTF-8.

В файле может располагаться единственная строка, определяющая вариант установки:

AdmInstall=<Mode>

Описывает режим установки:

● Logon ‑ установка выполнена с помощью logon-скрипта во время входа пользователя в домен.

● Restart ‑ установка выполнена с помощью групповых политик.

Ниже приведен пример скрипта установки, который может использоваться для установки системы «1С:Предприятие» с помощью административных средств ОС Windows (см. здесь).

Option Explicit
' Изменять интерфейс пользователя
Const msiUILevelNoChange = 0
' Использовать интерфейс пользователя, заданный по умолчанию
Const msiUILevelDefault = 1
' Не отображать интерфейс пользователя (молчаливая установка)
Const msiUILevelNone = 2
' Только индикатор прогресса и отображение ошибок
Const msiUILevelBasic = 3
' Интерфейс пользователя без диалоговых сообщений
Const msiUILevelReduced = 4
' Полный интерфейс пользователя
Const msiUILevelFull = 5
' Если используется с msiUILevelBasic, то отображается индикатор
' Прогресса без кнопки Cancel
Const msiUILevelHideCancel = 32
' Если используется с msiUILevelBasic, то отображается индикатор
' прогресса без отображения любых диалогов, в т. ч. и ошибок.
Const msiUILevelProgressOnly = 64
' Если используется с любым из перечисленных значений, инсталлятор
' выводит сообщение в конце установки о конечном результате.
Const msiUILevelEndDialog = 128
'***** Необходимо изменить на реальный каталог установки
Const DistrFolder="\\Server\1CDistr\"
Const shortcutName = "Запуск 1C Предприятия"
Dim shortcutTarget : shortcutTarget = DistrFolder & "1cestart.exe"
' Константы для определения действия
' требуется установка
Const requiredInstall = 1
' требуется удаление
Const requiredUninstall = 0
' Значение параметра ProductCode из файла setup.ini ...
'... для удаляемой версии
Const unInstallUID="{9173B91C-FF56-4F25-82D1-7F68244044CD}"
'... для устанавливаемой версии
Const InstallUID="{0BC98727-04AD-470F-9EEE-0162C543833F}"
' процедура установки или удаления указанной версии продукта
Sub installOrUninstall (ByVal productCode, ByVal msiPackage, ByVal mstTransform, ByVal requiredAction)
' productCode - Информация о коде продукта. Находится в файле
'  setup.ini, ключ ProductCode
' msiPackage - Установочный пакет 1CEnterprise
' mstTransform - файл языкового преобразования для инсталлятора
' requiredAction - требуемое действие requiredInstall или
'  requiredUninstall
' Переменная для формирования дополнительных
' параметров инсталлятору
    Dim cmdLine
    On Error Resume Next
    Dim installer, session
    Set installer = Nothing
    Set session = Nothing
    Set installer = Wscript.CreateObject("WindowsInstaller.Installer") : processError
    installer.UILevel = msiUILevelBasic 'msiUILevelNone 'или укажите другой вариант интерфейса пользователя
' проверка установки продукта
    Set session = installer.OpenProduct(productCode)
    If session Is Nothing AND requiredAction = requiredInstall Then
' продукт не установлен, и требуется его установка
   cmdLine = "TRANSFORMS=adminstallrelogon.mst;"
   If Not mstTransform Is Empty Then
' добавим указание инсталлятору разговаривать на указанном языке
    cmdLine = cmdLine & mstTransform
' можно дополнительно указать, какие компоненты нужно установить
    'cmdLine = cmdLine & " DESIGNERALLCLIENTS=1 THINCLIENT=1 WEBSERVEREXT=0 SERVER=0 CONFREPOSSERVER=0 CONVERTER77=0 SERVERCLIENT=1 LANGUAGES=RU"
   End If
' установим платформу
   Set session = installer.InstallProduct(msiPackage, cmdLine) : processError
' создадим ярлык на рабочем столе
   createShurtcut()
    ElseIf Not session Is Nothing AND requiredAction = requiredUninstall Then
' платформа уже установлена, и требуется ее удаление
' обьект session может быть только один!
   Set session = Nothing
'укажем, что нужно удалить с компьютера пользователя эту версию
   cmdLine = "REMOVE=ALL"
   ' удалим
   Set session = installer.InstallProduct(msiPackage, cmdLine) : processError
    End If
    Set session = Nothing
    Set installer = Nothing
End Sub
 
'обработка ошибок
Sub processError
    Dim msg
    If Err = 0 Then Exit Sub
    msg = Err.Source & " " & Hex(Err) & ": " & Err.Description
    Wscript.Echo msg
    Wscript.Quit 2
End Sub
'создание ярлыка
Sub createShurtcut
    Dim WshShell, oShellLink
    Set WshShell = WScript.CreateObject("WScript.Shell")
    Dim strDesktop : strDesktop = WshShell.SpecialFolders("Desktop")
    Set oShellLink = WshShell.CreateShortcut(strDesktop & "\" & shortcutName & ".lnk")
    oShellLink.TargetPath = shortcutTarget
    oShellLink.WindowStyle = 1
    oShellLink.Description = shortcutName
    oShellLink.Save
    Set oShellLink = Nothing
    Set WshShell = Nothing
End Sub
' удалим версию 260
installOrUninstall unInstallUID, DistrFolder + "8.2.9.260\setup\1CEnterprise 8.2.msi", "1049.mst", requiredUninstall
' установим версию 356
installOrUninstall InstallUID, DistrFolder + "8.2.9.356\setup\1CEnterprise 8.2.msi", "1049.mst", requiredInstall

Содержит соответствие имени пользователя и его (пользователя) рабочего каталога при работе агента конфигурирования.

Файл расположен в рабочем каталоге конфигуратора, работающего в режиме агента. Рабочий каталог задается с помощью команды /AgentBaseDir командной строки запуска конфигуратора в режиме агента.

Файл имеет следующую структуру:

{
    "usersInfo": [
   {
    "name": "имя_пользователя",
    "dir":  "имя_каталога"
   },
   …
    ]
}

В данном файле имя_пользователя ‑ это имя пользователя, работающего с агентом, а имя_каталога ‑ это имя служебного каталога данного пользователя. Если с агентом работает несколько пользователей ‑ в файле agentbasedir.json будет размещено несколько секций соответствия имени пользователя и каталога.

Смотри также:

● Работа конфигуратора в режиме агента (см. здесь).

● Параметры командной строки запуска в режиме агента (см. здесь).

Содержит список серверов «1С:Предприятия», зарегистрированных в утилите администрирования информационных баз в варианте клиент-сервер.

Расположен в каталоге %LOCALAPPDATA%\1C\1cv8.

Пример:

C:/Documents and Settings/User/Local Settings/Application Data/1C/1cv8/appsrvrs.lst
C:/Users/User/AppData/Local/1C/1cv8/appsrvrs.lst

В данных файлах содержатся сертификаты доверенных удостоверяющих центров. Эти сертификаты используются системой «1С:Предприятие» для проверки валидности сертификатов, которые предъявляются при установке защищенного соединения. Использование того или иного файла зависит от версии платформы «1С:Предприятие»:

● До версии 8.3.8 и режима совместимости Версия 8.3.7 и предыдущих ‑ используется только файл cacert.pem.

● С версии 8.3.8 и режима совместимости Версия 8.3.8, до версии 8.3.19 используется только механизм получения сертификатов удостоверяющих центров, который предоставляет используемая операционная система.

● Начиная с версии 8.3.20:

● В режиме совместимости Версия 8.3.8 и последующих ‑ используется файл cacertnx.pem, а затем механизм получения сертификатов удостоверяющих центров, который предоставляет используемая операционная система.

● В режиме совместимости с Версией 8.3.7 и предшествующих ‑ используется только файл cacert.pem.

Если необходимо обновить файл cacertnx.pem при обновлении платформы «1С:Предприятие», то можно поместить обновленный файл cacertnx.pem в состав одного из следующих дистрибутивов:

● Тонкий клиент (32- и 64-разрядная версия).

● Полный дистрибутив (клиент и сервер) (32- и 64-разрядная версия).

Новый файл должен располагаться на том же уровне («рядом»), что и MSI-файл дистрибутива. Во время установки новый файл (из устанавливаемого дистрибутива) заменит тот файл, который находится в комплекте поставки.

Файл cfgrepo.conf служит для настройки места положения и размера кеша версий при работе с хранилищем конфигураций.

Расположение файла настройки локального кеша:

● Для ОС Linux: ~/.1cv8/1C/1cv8/<Уникальный идентификатор информационной базы>/cfgrepo.

● Для ОС macOS: ~/.1cv8/1C/1cv8/<Уникальный идентификатор информационной базы>/cfgrepo.

● Для ОС Windows: %LOCALAPPDATA%\1C\1cv8\<Уникальный идентификатор информационной базы>\cfgrepo.

Расположение файла настройки глобального кеша: в каталоге хранилища конфигурации.

Параметры для файла глобальных настроек хранилища:

Указывает путь к каталогу, в котором располагается кеш версий, в терминах файловой системы того компьютера, на котором расположен каталог с хранилищем или установлен сервер хранилища. Другими словами, это локальный путь к глобальному кешу версий.

Указывает UNC-путь к каталогу, описывающему расположение глобального кеша версий. Путь, указанный в этом параметре, должен приводить в тот же каталог, что и путь, указанный в параметре cfgrepo.cache.path.

Данный параметр описывает максимальный размер кеша версий конфигурации.

Указывает минимальную длину пароля пользователя хранилища.

Указывает необходимость проверки сложности пароля пользователя хранилища:

● 0 ‑ не выполняется проверка сложности пароля пользователя хранилища.

● 1 ‑ выполняется проверка сложности пароля пользователя хранилища.

Параметры для файла локальных настроек хранилища:

Локальный кеш: указывает путь к каталогу, в котором располагается кеш версий.

Данный параметр описывает максимальный размер кеша версий конфигурации.

Файл ClientUpdate.cfg предназначен для настройки предварительной загрузки дистрибутива клиентского приложения при работе по протоколу HTTP.

Файл располагается в каталоге конфигурационных файлов системы «1С:Предприятие», и его наличие не является обязательным.

В ОС Windows регистр букв имени файл не принципиален, для ОС Linux и ОС macOS регистр символов принципиален: ClientUpdate.cfg. Файл состоит из пар «ключ=значение» в кодировке UTF-8. Наличие BOM не принципиально.

В файле допустимы следующие значения ключей:

Номер версии, для которой в данном файле указаны параметры обновления (дата обновления и пути к дистрибутивам). Версия указывается в стандартном виде: A.B.C.D.

Дата и время предполагаемого обновления версии на стороне кластера серверов. Клиентское приложение будет использовать это значение для планирования скачивания дистрибутива.

Значение указывается в каноническом формате YYYYMMDDHHMMSS, где:

● YYYY ‑ год;

● MM ‑ месяц;

● DD ‑ день;

● HH ‑ часы;

● MM ‑ минуты;

● SS ‑ секунды.

Значения данных ключей определяют расположение дистрибутива клиентского приложения выбранной операционной системы и разрядности. Параметры по поведению и содержанию аналогичны атрибутам pubdst32, pubdst64, pubdstmac64, pubdstlin32 и pubdstlin64 элемента point файла default.vrd (см. здесь).

Смотри также:

● Использование файла clientupdate.cfg (см. здесь).

Файл comcntrcfg.xml служит для указания внешнему соединению необходимости запуска в отладочном режиме.

Файл располагается в каталоге конфигурационных файлов системы «1С:Предприятие», и его наличие не является обязательным.

Если файл не найден, внешнее соединение открывается в обычном режиме.

Пример:

<config xmlns="http://v8.1c.ru/v8/comcntrcfg">
    <debugconfig debug="true" protocol="tcp" debuggerURL="tcp://localhost:1560"/>
</config>

Элемент debugconfig имеет атрибуты, которые описаны ниже.

Тип: Булево. Указывает необходимость запуска в отладочном режиме:

● debug="true" ‑ отладка включена;

● debug="false" ‑ отладка выключена.

debug="true"

Указывает, какой протокол отладки будет использоваться при работе с данной публикацией в том случае, если отладка разрешена:

● protocol="tcp" ‑ используется протокол TCP/IP (по умолчанию);

● protocol="http" ‑ используется протокол HTTP.

Указывает адрес отладчика, к которому нужно автоматически подключиться для отладки, где localhost указывает на поиск на локальном компьютере, «1560» ‑ номер сетевого порта. Если порт не указан, то будут проверяться все порты в диапазоне портов 1560–1591. Указание tcp:// эквивалентно tcp://localhost. Если адрес отладчика не указан, в процессе исполнения кода на встроенном языке отладка производиться не будет.

В случае использования протокола HTTP, адрес отладчика обязательно указывать с указанием порта, по которому будет выполняться взаимодействие: http://pc-name:1561.

Если протокол отладки, указанный с помощью атрибута protocol, не совпадает со схемой, указанной в атрибуте url, соединение с отладчиком не будет установлено и работа продолжится без возможности отладки.

Пример:

debuggerURL="http://pc-name:1561"

Файл conf.cfg определяет расположение каталога общих конфигурационных файлов, язык интерфейса системы по умолчанию и различное количество других параметров, определяющих поведение системы.

Расположение файла:

● Для ОС Linux:

● В каталоге conf каталога конкретной версии «1С:Предприятия» соответствующей разрядности.

● Каталог ~/.1cv8/1C/1cv8/conf (~ ‑ домашний каталог пользователя, от имени которого работает сервер «1С:Предприятия»).

● Для ОС macOS:

● Каталог conf установленной версии, например: /opt/1cv8/A.B.C.D/conf.

● Каталог ~/.1cv8/1C/1cv8/conf (~ ‑ домашний каталог пользователя, от имени которого работает сервер «1С:Предприятия»).

● Для ОС Windows:

● В каталоге bin\conf каталога конкретной версии «1С:Предприятия» соответствующей разрядности.

● В каталоге %LOCALAPPDATA%\1C\1cv8\conf. Используется платформой любой версии, разрядности и варианта установки.

● Установка «для компьютера»:

● 32-разрядная система в 64-разрядной ОС: %PROGRAMFILES(x86)%\1cv8\conf.

● В остальных случаях: %PROGRAMFILES%\1cv8\conf.

● Установка «для пользователя»:

● 32-разрядная система в 32-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8\conf.

● 32-разрядная система в 64-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8_x86\conf.

● 64-разрядная система в 64-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8_x64\conf.

Для некоторых параметров файл conf.cfg может размещаться, также, в каталоге информационной базы. В описании таких параметров об этом будет сказано дополнительно и явным образом. Файл представляет собой текстовый документ в кодировке UTF-8.

В данном разделе описываются параметры, которые могут быть заданы с помощью файла conf.cfg.

Параметр определяет каталог, в котором система будет выполнять поиск конфигурационных файлов (logcfg.xml, nethasp.ini и т. д.), в том случае, если они не найдены по стандартным путям поиска. Данный параметр имеет смысл, если файл расположен в каталоге conf конкретной версии.

По умолчанию значение параметра равно:

● Для ОС Linux: /opt/1cv8/conf.

● Для ОС macOS: /opt/1сv8/A.B.C.D.

● Для ОС Windows:

● Установка «для компьютера»:

● 32-разрядная система в 64-разрядной ОС: %PROGRAMFILES(x86)%\1cv8\conf.

● В остальных случаях: %PROGRAMFILES%\1cv8\conf.

● Установка «для пользователя»:

● 32-разрядная система в 32-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8\conf.

● 32-разрядная система в 64-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8_x86\conf.

● 64-разрядная система в 64-разрядной ОС: %LOCALAPPDATA%\Programs\1cv8_x64\conf.

Пример:

ConfLocation=C:\MySettings\v8\conf

Позволяет указать пути (или пути) по которым система «1С:Предприятие» будет искать библиотеку КриптоПРО CSP при работе под управлением ОС Linux или macOS. Если указываются несколько путей (по аналогии с переменной окружения PATH), то пути должны разделяться символом «;».

С помощью этого параметра указывается формат, в котором будет создаваться новая база данных в файловом варианте информационной базы.

Возможные значения: 8.2.14 и 8.3.8.

Значение параметра по умолчанию: 8.2.14.

Данный параметр управляет возможностью локального распознавания речи в клиентском приложении при использовании файлового варианта информационной базы:

● 1 ‑ запрет локального распознавания речи в файловой информационной базе, в т.ч. при работе через публикацию на веб-сервере.

● 0 ‑ поддерживается локальное распознавания речи в файловой информационной базе (в любом варианте использования).

Значение по умолчанию: 0.

Действующее значение параметра получается из файла conf.cfg, который может располагаться только в следующих каталога:

● Каталог информационной базы.

● Каталог, указанный в качестве значения параметра ConfLocation файла conf.cfg из каталога информационной базы. Применимо, если по указанному пути существует конфигурационный файл и в нем указан параметр.

В других файлах conf.cfg параметр не используется.

С помощью данного параметра предоставляется возможность отключить защиту от опасных действий для определенных информационных баз. Информационные базы определяются набором шаблонов (регулярных выражений), разделяемых символом «;». Если строка соединения с информационной базой будет удовлетворять какому-либо регулярному выражению, перечисленному в данном параметре, для такой информационной базы защита от опасных действий будет отключена.

При редактировании регулярных выражений следует использовать POSIX Basic Regular Expressions (https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap09.html#tag_09_03).

Данный параметр используется тем процессом, который фактически выполняет потенциально опасное действие:

● Загрузка внешних обработок/отчетов или расширений конфигураций ‑ только сервер (процесс rphost).

● Загрузка внешних компонент ‑ клиентское приложение или сервер (процесс rphost).

● Запуск внешнего приложения ‑ клиентское приложение или сервер (процесс rphost).

● Открытие табличного документа ‑ только клиентское приложение.

● Открытие URL с помощью элемента формы ПолеHTMLДокумента ‑ только клиентское приложение.

Пример:

DisableUnsafeActionProtection=test_.*;stage_.*;

Параметр управляет записью событий аудита прав доступа только для файлового варианта информационной базы:

● Параметр установлен в значение true ‑ в журнал регистрации выполняется запись событий аудита прав доступа.

● Параметр установлен в значение false ‑ в журнал регистрации не выполняется запись событий аудита прав доступа.

Значение параметра по умолчанию: false.

Действующее значение параметра получается из файла conf.cfg, который может располагаться только в следующих каталога:

● Каталог информационной базы.

● Каталог, указанный в качестве значения параметра ConfLocation файла conf.cfg из каталога информационной базы. Применимо, если по указанному пути существует конфигурационный файл и в нем указан параметр.

В других файлах conf.cfg параметр не используется.

Смотри также:

● События аудита прав доступа (см. здесь).

● Управление регистрацией событий аудита прав доступа в кластере серверов (см. здесь).

Управляет поиском циклических ссылок при выполнении кода на встроенном языке:

● Параметр установлен в значение true ‑ поиск циклических ссылок при выполнении кода на встроенном языке выполняется.

● Параметр установлен в значение false ‑ поиск циклических ссылок при выполнении кода на встроенном языке не выполняется.

Значение параметра по умолчанию: false.

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

Параметр может принимать следующие значения:

● D ‑ значение по умолчанию, при этом система функционирует следующим образом:

● система программного лицензирования платформы и конфигураций использует сервера, расположенные в России;

● при использовании команд меню Справка ‑ Информация в Интернете происходит обращение к российским ресурсам;

● поддерживается регистрация в системе взаимодействия;

● поддерживается использование специального сервиса фирмы «1С» для рассылки PUSH-уведомлений.

● A ‑ альтернативный список служебных ресурсов. При этом система функционирует следующим образом:

● система программного лицензирования платформы и конфигураций использует сервера, расположенные в Европе;

● при использовании команд меню Справка ‑ Информация в Интернете происходит обращение к европейским ресурсам;

● не поддерживается регистрация в системе взаимодействия;

● не поддерживается использование специального сервиса фирмы «1С» для рассылки PUSH-уведомлений.

Строка описания параметров вызова сервиса внешнего управления сеансами при работе с файловым вариантом информационной базы.

Если данный параметр содержит параметры вызова сервиса внешнего управления сеансами, то в конфигурационном файле должен быть явно указан параметр ExternalSessionManagementRequired. Этот параметр включает (значение параметра равно 1) или выключает (значение параметра равно 0) использование сервиса внешнего управления сеансами. Другими словами, сервис внешнего управления сеансами в файловой информационной базе управляется двумя параметрами: ExternalSessionManagementRequired и ExternalSessionManagementConnectionString.

Строка параметров Web-сервиса имеет следующий формат: «Параметр=Значение;». Строка параметров содержит обязательные (wsdl, ns, srvc, port) и необязательных (tout, wsver) параметры:

● wsdl ‑ URL для получения описания Web-сервиса в формате WSDL.

● ns ‑ пространство имен Web-сервиса.

● srvc ‑ имя Web-сервиса внешнего управления сеансами.

● port ‑ имя порта используемого Web-сервисом.

● tout ‑ максимальное время ожидания обращения к Web-сервису внешнего управления сеансами, в секундах. Значение по умолчанию ‑ 5 секунд.

● wsver ‑ номер версии используемого Web-сервиса внешнего управления сеансами. Допустимые значения: 1, 2, 3, 4. Значение по умолчанию равно 4.

Если в конфигурационном файле, расположенном в каталоге информационной базы, не указаны (один или оба) параметры ExternalSessionManagementRequired и ExternalSessionManagementConnectionString, то будет предпринята попытка определить значения этих параметров из других конфигурационных файлов. Действующим значением каждого параметра будет первое найденное значение в следующем порядке:

● Каталог конфигурационных файлов конкретной версии:

● ОС Linux: /opt/1cv8/arch/A.B.C.D/conf;

● ОС macOS: /opt/1cv8/A.B.C.D/conf;

● ОС Windows: %PROGRAMFILES%\1cv8\A.B.C.D\bin\conf.

● Каталог конфигурационных файлов корневого каталога установки:

● ОС Linux: /opt/1cv8/conf;

● ОС macOS: /opt/1cv8/conf;

● ОС Windows: %LOCALAPPDATA%\1C\1cv8\conf.

● Каталог, указанный в качестве значения параметра ConfLocation конфигурационного файла конкретной версии:

● ОС Linux: /opt/1cv8/arch/A.B.C.D/conf;

● ОС macOS: /opt/1cv8/A.B.C.D/conf;

● ОС Windows: %PROGRAMFILES%\1cv8\A.B.C.D\bin\conf.

Применимо, если по указанному пути существует конфигурационный файл и в нем указан параметр.

● Каталог информационной базы.

● Каталог, указанный в качестве значения параметра ConfLocation файла conf.cfg из каталога информационной базы. Применимо, если по указанному пути существует конфигурационный файл и в нем указан параметр.

Пример строки с описанием Web-сервиса:

wsdl=http://server/sm/ws/manager?wsdl;ns=http://www.sessioncontrol.org;srvc=ExternalSessionControl;port=ExternalSessionControlSoap;tout=10;wsver=4;

Управляет необходимостью использования сервиса внешнего управления сеансами в файловой информационной базе. Параметр может принимать следующие значения:

● 1 ‑ внешнее управление сеансами является обязательным. При ошибке вызова сервиса, создание нового сеанса запрещено.

● 0 ‑ внешнее управление сеансами не является обязательным. При ошибке вызова сервиса, начало нового сеанса разрешено. Значение по умолчанию.

Если данный параметр установлен в значение 1 (внешнее управление сеансами включено), то параметры вызова сервиса внешнего управления сеансами должна быть указана в параметре ExternalSessionManagementConnectionString. Другими словами, сервис внешнего управления сеансами в файловой информационной базе управляется двумя параметрами: ExternalSessionManagementRequired и ExternalSessionManagementConnectionString.

Алгоритм определения значений параметров ExternalSessionManagementConnectionString и ExternalSessionManagementRequired см. здесь.

Параметр управляет кодировкой, в которой будут записываться имена файлов в zip-архивах, сформированных с помощью системы «1С:Предприятие».

Если значение параметра установить в значение UTF8, то имена файлов, содержащие национальные символы, будут отображаться некорректно при помощи встроенного архиватора ОС Windows XP/2003/2008/7 и объекта ЧтениеZipФайла системы «1С:Предприятие» версии 8.3.6 и младше. При этом в ОС macOS такие имена файлов будут отображаться корректно.

Если значение параметра установить в значение OSEncodingWithUTF8, то имена файлов, содержащие национальные символы, будут отображаться некорректно при помощи встроенного архиватора ОС macOS, но в других случаях проблем не будет.

Возможные значения: UTF8, OSEncodingWithUTF8.

Значение по умолчанию: UTF8.

Указывает максимальную версию протокола TLS, которую будет использовать клиентское приложение системы «1С:Предприятие».

В зависимости от значения параметра, будут использовать следующие протоколы:

● Параметр установлен в значение true ‑ используется TLS не выше версии, определенной параметром. Также может использоваться и любая предыдущая версия протокола, если ее требует используемый веб-сервер).

● Параметр установлен в значение false (или любое значение, отличное от true) ‑ используемый протокол зависит только от настроек веб-сервера, с которым взаимодействует система «1С:Предприятие». Может быть использована любая версия протокола TLS, вплоть до версии 1.3.

Значение параметра по умолчанию: false.

Запрещено одновременное указание нескольких параметров ForceTLS*. При одновременном указании поведение не определено.

Определяет дополнительные параметры запуска виртуальной машины JAVA для работы полнотекстового поиска версии 2 (см. здесь). Значение данного свойства не должно содержать кавычек. Используется в конфигурационном файле на компьютере, где расположен кластер серверов «1С:Предприятия».

Если на компьютере используется Java версии 17 и выше, то для корректной работы 2-й версии полнотекстового поиска в данных необходимо выполнить некоторые дополнительные настройки данного параметра (подробнее см. здесь).

Данное свойство может быть использовано, например, для задания максимального размера оперативной памяти, которую использует JAVA-машина.

Пример:

#Минимальный размер кучи. Задаётся для полнотекстового поиска,
#чтобы реже срабатывала сборка мусора и выгружались внутренние кеши
FtsJavaOpts=-Xms2G

Пример:

#Максимальный размер кучи. Задаётся для того, чтобы установить
#новую границу потребления памяти
FtsJavaOpts=-Xmx8G

Пример:

#Режим вывода в консоль. Задаётся для расследования причин сбоя
#при запуске сервера полнотекстового поиска версии 2
FtsJavaOpts=-Dconsole=none #Ничего не выводить в консоль (по умолчанию)
FtsJavaOpts=-Dconsole=all #Выводить всё в консоль
FtsJavaOpts=-Dconsole=start|stop #Выводить только строку запуска и остановки сервера

При вызове функции ИнтернетПочта.Подключиться() система выполняет проверку сертификата почтового сервера (по умолчанию подключение выполняется c использованием защищенного соединения). Если для какого-то почтового сервера не требуется выполнять проверку сертификата этого сервера, то хост сервера следует указать в данном параметре.

Имена хостов, для которых не должна выполняться проверка сертификата сервера, указываются подряд, используя в качестве разделителя символ «;». Допустимо использовать символы подстановки: «*» ‑ любое произвольное количество символов, «?» ‑ один произвольный символ.

Управляет поведением системы для тех случаев, когда платформа не может однозначно проверить отзыв сертификата:

● Параметр установлен в значение true ‑ игнорировать ошибки, связанные с проверкой отзыва сертификата сервера.

● Параметр установлен в значение false ‑ не игнорировать ошибки, связанные с проверкой отзыва сертификата сервера.

Значение по умолчанию: true.

Установка данного параметра оказывает влияние в следующей ситуации: сервер предоставил сертификат, цепочка сертификатов корректна, но проверить отзыв предоставленного сертификата не представляется возможным. В этом случае система ведет себя следующим образом, в зависимости от значения параметра:

● Параметр установлен в значение true ‑ соединение будет установлено.

● Параметр установлен в значение false ‑ соединение установлено не будет, будет сформировано исключение.

Определяет путь к директории установки JAVA. В случае если данный параметр не задан, то путь до директории установки JAVA определяется в переменной окружения JAVA_HOME. Используется в конфигурационном файле на компьютере, где расположен кластер серверов «1С:Предприятия».

Если система эксплуатируется под управлением ОС Windows, параметр JavaHome не задан в файле conf.cfg и не указана переменная окружения JAVA_HOME, то для определения пути установки Java будет использовать системный реестр, куда информация заносится при установке JRE.

Параметр позволяет включить укороченные периоды проверки при работе с ЦЛ (см. здесь). В зависимости от значения параметра, используются следующие периоды проверки:

● Параметр установлен в значение true (укороченные периоды проверки):

● Проверка лицензии сервером ‑ каждые 60 секунд;

● Проверка лицензии клиентами ‑ каждые 30 секунд;

● Повторная проверка лицензии клиентами (при недоступности ЦЛ или после ввода данных клиента лицензирования) ‑ 15 секунд.

● Параметр установлен в значение false (обычные периоды проверки):

● Проверка лицензии сервером ‑ каждый 1 час;

● Проверка лицензии клиентами ‑ каждый 1 час;

● Повторная проверка лицензии клиентами (при недоступности ЦЛ или после ввода данных клиента лицензирования) ‑ 10 минут.

Значение параметра по умолчанию: false.

Параметры PublishDistributiveLocationLinux32, PublishDistributiveLocationLinux64, PublishDistributiveLocationLinuxDeb32, PublishDistributiveLocationLinuxDeb64, PublishDistributiveLocationLinuxRpm32, PublishDistributiveLocationLinuxRpm64, PublishDistributiveLocationMacOS64, PublishDistributiveLocationWindows32 и PublishDistributiveLocationWindows64 определяют расположение дистрибутива клиентского приложения выбранной операционной системы и разрядности. Параметры по поведению и содержанию аналогичны атрибутам pubdstlin32, pubdstlin64, pubdstlindeb32, pubdstlindeb64, pubdstlinrpm32, pubdstlinrpm64, pubdstmac64, pubdstwin32, pubdstwin64 элемента point файла default.vrd (см. здесь).

При подключении первого клиентского приложения к системе выполняется кеширование содержимого вышеуказанных параметров. Когда эти параметры изменяются в файле conf.cfg, то система «1С:Предприятие» обновляет кеш значений через 10 секунд после изменения. Под термином «система» понимается рабочий процесс в клиент-серверном варианте работы (при любом варианте подключения клиентских приложений) или модуль расширения веб-сервера (при файловом варианте работы с доступом через веб-сервер).

Определяет дополнительные параметры запуска виртуальной машины JAVA для работы оптимизированного механизма реструктуризации. Значение данного свойства не должно содержать кавычек. Используется в конфигурационном файле на компьютере, где расположен кластер серверов «1С:Предприятия».

Данное свойство может быть использовано, например, для задания максимального размера оперативной памяти, которую использует JAVA-машина.

Пример:

#Задание максимального размера доступной памяти для JAVA-процесса
RestructJavaOpts=-Xmx2048m

Пример:

#Запуск JAVA процессов с возможностью подключения отладчика
RestructJavaOpts=-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005

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

Если параметр не указан, то расположение файлов моделей зависит от варианта информационной базы и используемой операционной системы:

● Файловый вариант информационной базы:

● Для ОС Windows:

● Каталог %LOCALAPPDATA%\1C\1cv8\STT пользователя, под которым работает система.

● Каталог %ALLUSERSPROFILE%\1C\1cv8\STT данных для всех пользователей компьютера.

● Для ОС Linux: ~/.1cv8/1C/1cv8/STT.

● Для ОС macOS: ~/.1cv8/1C/1cv8/STT.

● Клиент-серверный вариант информационной базы: подкаталог STT каталога реестра кластера на каждом рабочем сервере. Управление настройкой размещения хранилища моделей для рабочего сервера кластера (см. здесь).

Модели не удаляются самостоятельно. Необходимо вручную отслеживать размер данного каталога и предпринимать меры по очистке, если размер файлов в каталоге превысит допустимый размер (допустимость размера определяется администратором индивидуально).

Смотри также:

● Распознавание речи (см. здесь).

Параметр определяет язык интерфейса системы. В качестве значения параметра могут быть указаны коды языков интерфейса (см. здесь) или значение System. Если указано значение языка, то будет использоваться именно этот язык. Если указано значение System, то язык интерфейса будет определяться локализацией операционной системы.

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

При использовании клиентского приложения, работающего под ОС Windows, следует учитывать следующую особенность: если файл conf.cfg с указанием языка интерфейса расположен в каталоге conf конкретной версии, то указанный язык интерфейса будет использован для конкретной версии, а если этот файл расположен в каталоге conf корневого каталога установки, то указанный язык интерфейса будет использован для всех установленных версий на данном компьютере.

Если в конфигурационном файле параметр SystemLanguage не указан, то будет использован механизм определения языка интерфейса с помощью файла *.res. Если файл с расширением *.res отсутствует, при запуске будет выбираться интерфейс, соответствующий региональным установкам операционной системы. Указание неизвестного или несуществующего кода языка интерфейса эквивалентно отсутствию такого файла.

Использовать язык интерфейса в соответствии с региональными установками операционной системы:

SystemLanguage=System

Использовать русский (RU) язык интерфейса:

SystemLanguage=RU

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

Параметр может принимать следующие значения:

● v1 ‑ обычный механизм реструктуризации. Единственный вариант реструктуризации в «1С:Предприятии» версии 8.3.10 и младше.

● v2 ‑ оптимизированный механизм реструктуризации. Работает только для клиент-серверного варианта работы информационной базы в том случае, если в качестве СУБД используется Microsoft SQL Server или PostgreSQL. Если планируется использование оптимизированного механизма реструктуризации совместно с СУБД Microsoft SQL Server, то сервер «1С:Предприятия» для соединения с СУБД должен использовать сетевой протокол TCP/IP (в терминах СУБД). Работа оптимизированного механизма реструктуризации не поддерживается в том случае, если сервер «1С:Предприятия» подключается к СУБД Microsoft SQL Server с использованием сетевых протоколов Разделяемая память или Именованные каналы.

Значение по умолчанию: v1.

Файл версий ConfigDumpInfo.xml хранит версии объектов, которые были в конфигурации в момент выгрузки. Файл располагается в каталоге, куда выполняется выгрузка конфигурации в файлы.

Файл версий является XML-файлом в кодировке UTF-8.

Корневой элемент ConfigDumpInfo имеет единственный подчиненный элемент ConfigVersions. Элементу ConfigVersions подчинены элементы Metadata. В файле версий находится столько элементов Metadata, сколько объектов находится в выгружаемой конфигурации, с «точки зрения» механизма выгрузки конфигурации в файлы. Для каждого элемента Metadata допускается наличие одного или нескольких вложенных элементов Metadata. Вложенные элементы описывают подчиненные объекты конфигурации, которые не могут существовать отдельно от родительского объекта. Типичным примером являются реквизиты объекта.

Элемент ConfigDumpInfo содержит следующие атрибуты:

Данный атрибут указывает, в каком формате выполнена выгрузка конфигурации, версии объектов которой указаны в данном файле.

Данный атрибут может принимать следующие значения:

● Plain ‑ плоский формат;

● Hierarchical ‑ иерархический формат (подробнее см. здесь).

Данный атрибут содержит номер версии формата выгрузки конфигурации в файлы.

Элемент ConfigVersions не содержит атрибутов.

Элемент Metadata содержит следующие атрибуты:

Атрибут содержит полное имя выгруженного объекта конфигурации.

Атрибут содержит внутренний идентификатор объекта конфигурации.

Атрибут содержит «версию» объекта конфигурации. По этому реквизиту выполняется проверка того, что объект конфигурации изменен и требует его повторная выгрузка.

Необходимо понимать, что значения, указанные в атрибутах id и configVersion, имеет смысл рассматривать как некоторые магические числа. Эти числа используются исключительно внутренними механизмами платформы и не предназначены для внешнего использования (и попыток воспроизведения из значений).

Смотри также:

● Выгрузка и загрузка конфигурации в файлы (см. здесь).

Файл debugcfg.xml предназначен для настройки дополнительного диапазона портов, используемого при отладке конфигураций.

Файл располагается в каталоге конфигурационных файлов системы «1С:Предприятие», и его наличие не является обязательным.

Файл используется только в том случае, если отладка выполняется по протоколу TCP/IP.

Если файл не найден, то для отладки используются порты из стандартного диапазона (1560:1591). Предметы отладки на сервере используют те же порты, что и процессы сервера: rmngr и rphost. Указания дополнительных диапазонов портов для предметов отладки на сервере не требуется.

Пример:

<config xmlns="http://v8.1c.ru/v8/debugcfg">
    <debugports range="1540:1550"/>
</config>

Элемент debugports имеет атрибуты, которые описаны ниже.

Тип: Строка. Содержит дополнительный диапазон портов, используемых при отладке.

Файл не используется, начиная с версии 8.3.26.

Данный файл служит для настройки параметров публикации прикладного решения на веб-сервере и находится в каталоге виртуального приложения.

Корневым элементом конфигурационного файла является <point>, который определяет настройки виртуального ресурса. Он может содержать по одному элементу <zones>, <ws>, <pool>, <debug>, <openid>, <openidconnect>, <exitURL>, <standardOData>, <analytics>, <progressiveWebApplication>, <authentication> и <mobileApps>. При этом в элементе <ws> допустимо несколько вложенных элементов <point>, а для элемента <zones> допустимо несколько вложенных элементов <zone>:

<point...>
    <ws...>
   <point>...</point>
    <zones>
     <zone>...</zone>
     <zone>...</zone>
       </zones>
   <point>...</point>
    </ws>
    <httpServices>
   <service>...<service/>
    </httpServices>
    <pool.../>
    <debug.../>
    <openid>
   <rely... />
   <provider>
    <lifetime>...</lifetime>
   </provider>
    </openid>
    <openidconnect.../>
    <exitURL>
   ...
    </exitURL>
    <standardOData.../>
    <analytics.../>
    <progressiveWebApplication.../>
    <authentication>
   <logonView>
    <method>...</method>
    <method>...</method>
   </logonView>
    </authentication>
    <mobileApps>
   <application>...</application>
   <application>...</application>
    </mobileApps>
</point>

Пример:

<?xml version="1.0" encoding="UTF-8"?>
<point xmlns=http://v8.1c.ru/8.2/virtual-resource-system xmlns:xs=http://www.w3.org/2001/XMLSchema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   base="/demo"
   ib="Srvr=&quot;tcp://Server&quot;;Ref=&quot;demo&quot;;"
   enable="false"
   allowexecutescheduledjobs="force"
    <ws>
   <point name="OperationalData" alias="OperData"/>
   <point name="AnalyticalData" alias="AnalytData"/>
    </ws>
    <httpServices>
   <service name="ПримерРаботы" enable="true"/>
    </httpServices>
    <pool size="50" maxAge="10" attempts="2"/>
    <debug enable="true" protocol="tcp" url="tcp://localhost"/>
    <zones>
   <zone value="8214" safe="true"/>
   <zone value="last" specify="true" />
    </zones>
</point>

Корневой элемент файла default.vrd может содержать следующие атрибуты:

Элемент base указывает на относительный путь (относительно корневого каталога сайта) к каталогу виртуального приложения.

Пример:

base="/demoMA"

Содержит строку подключения к информационной базе «1С:Предприятия». Следует помнить о том, что для файлового варианта и варианта клиент-сервер строки подключения выглядят по-разному.

Пример файловой базы:

ib="File=c:/bases/demo;"

Пример клиент-серверной базы:

ib="Srvr="tcp://myServer";Ref="mybase";"

В строке подключения можно указать логин и пароль пользователя. В этом случае подключение к информационной базе будет выполняться от имени указанного пользователя. В следующем примере подключение будет осуществляться от имени пользователя Продавец:

ib="Srvr="tcp://myServer";Ref="mybase";Usr=Продавец;Pwd=123;"

Однако если в командной строке запуска клиентского приложения указан логин и пароль, то подключение будет выполняться с параметрами, указанными в командной строке.

Отвечает за возможность работы с опубликованной информационной базой тонким и веб-клиентами. Если атрибут имеет значение true, работа с опубликованной информационной базой с помощью тонкого и веб-клиентов возможна, и в этом случае строка соединения будет выглядеть следующим образом (для примера в начале раздела):

http://host/demo

В противном случае (атрибут имеет значение false) работа с помощью тонкого клиента и веб-клиента невозможна.

Значение по умолчанию: true (работа с помощью тонкого клиента и веб-клиента разрешена).

Позволяет указать каталог временных файлов для работы расширения веб-сервера (wsisapi.dll, wsap22.dll, wsapch2.dll) или файлового варианта информационной базы. Если атрибут не задан, то:

● для файловой информационной базы используется подкаталог 1Cv8Tmp каталога, в котором расположен файл информационной базы.

● в остальных случаях используется каталог временных файлов пользователя, от имени которого выполняется запрос.

В том случае, если атрибут содержит указание на каталог, который используется в качестве каталога временных файлов для работы расширения веб-сервера, пользователь, от имени которого исполняется расширение веб-сервера, должен иметь полный доступ к этому каталогу и его содержимому.

Значение атрибута указывает полный URL файла с дистрибутивом клиентского приложения, который необходимо скачать и установить в случае несовпадения версий клиентского приложения и сервера. С помощью данного URL дистрибутив должен быть доступен извне компьютера, на котором этот дистрибутив расположен. Атрибуты содержат пути к дистрибутивам соответствующих клиентских приложений:

Если получение дистрибутива клиентского приложения будет выполняться с помощью HTTPS-соединения, то компьютер, получающий дистрибутив, будет выполнять проверку сертификата сервера, с которого выполняется получение дистрибутива, с помощью сертификатов корневых удостоверяющих центров, которые получаются из хранилища корневых сертификатов используемой операционной системы. При установке будут использоваться параметры установки, указанные в файле 1cestart.cfg (аналогично обычной установке клиентского приложения).

Дистрибутив клиентского приложения должен быть помещен в архив, кроме некоторых вариантов дистрибутива для ОС Linux, которые могут не упаковываться в архив:

● run-файл программы установки.

● rpm- или deb-файл установочного пакета, если вместе с дистрибутивом не требуется распространять национальные ресурсы (кроме русского и английского языков).

Вид архива: zip. Требования к архиву:

● Структура файлов в архиве:

● Для ОС Linux:

● Программа установки: файл программы установки тонкого клиента (run-файл) ‑ setup-thin-A.B.C.D-arch.run, где A.B.C.D ‑ полный номер версии системы «1С:Предприятие», arch ‑ используемая архитектура процессора.

● Пакетный менеджер: файл пакета с тонким клиентом соответствующего варианта (DEB или RPM) ‑ 1с-enteprise-A.B.С.D-thin-client_A.B.C-D.arch.ext, где A.B.C.D (A.B.С-D) ‑ полный номер версии системы «1С:Предприятие», arch ‑ используемая архитектура процессора, ext ‑ расширение, соответствующее пакетному менеджеру. Файл пакета может быть размещен или самостоятельно, или упакован в zip-архив с произвольным именем. В этом случае в архив также может быть размещен nls-файл для клиентского приложения. Внутри архива файлы должны в точности соответствовать требуемым именам.

● Для ОС macOS: файл .dmg.

● Для ОС Windows: без иерархии и каталогов, только файлы дистрибутива клиентского приложения.

● Особенности файлов дистрибутива:

● Дистрибутив для ОС macOS: все файлы с расширением .pkg должны быть подписаны цифровой подписью.

● Цифровые подписи файлов, входящих в состав дистрибутива, должны проходить проверку на компьютере, где будет выполняться установка.

● При использовании веб-сервера IIS может потребоваться указание MIME-типа для расширения .zip (подробнее см. здесь).

Пример:

pubdstwin32="http://www.myhost.ru/files/client-win-32.zip"
pubdstmac64="http://www.myhost.ru/files/client-mac-64.zip"
pubdstlin64="http://www.myhost.ru/files/setup-fhin-8.3.22.100-x86_64.run"
pubdstlindeb32="http://www.myhost.ru/files/1с-enteprise-8.3.22.100-thin-client_8.3.22-100.i386.deb"

В случае смены версии сервера, достаточно заменить файл с архивом клиентского приложения.

Атрибут управляет возможностью исполнения регламентных заданий расширением веб-сервера для файлового варианта информационной базы.

Атрибут может принимать следующие значения:

● off ‑ в этом случае расширение веб-сервера не будет выполнять регламентные задания. В этом случае выполнять регламентные задания будет клиентское приложение (если таковое существует), которое подключается к информационной базе напрямую, без использования веб-сервера.

● force ‑ в этом случае расширение веб-сервера будет выполнять регламентные задания.

Значение по умолчанию: не задано. В этом случае регламентные задания будет выполнять то приложение, с помощью которого будет осуществлено первое подключение к информационной базе.

Элемент содержит настройки публикации Web-сервисов, подчинен элементу <point>. Элемент <ws> может быть один или ни одного. Данный элемент может содержать произвольное количество элементов <point>.

В том случае, если для доступа к Web-сервису необходимо использовать JWT-аутентификацию, то необходимо создать элемент <accessTokenAuthentication> (подробнее см. здесь), подчиненный элементу <ws>. Наличие элемента <accessTokenAuthentication> разрешает JWT-аутентификацию.

Данный элемент может содержать следующие атрибуты.

Отвечает за возможность работы Web-сервисов в данной информационной базе. Если атрибут имеет значение true (или атрибут отсутствует), работа Web-сервисов возможна. В противном случае (атрибут имеет значение false) работа Web-сервисов невозможна.

Значение по умолчанию: true (работа Web-сервисов разрешена).

Отвечает за возможность использования Web-сервисов в данной информационной базе, которые опубликованы без явного указания разрешения использования (атрибут enable элемента point). Если атрибута имеет значение true, то все Web-сервисы, для которых явно не указано значение атрибута enable элемента point будут разрешены для использования. В противном случае использование таких Web-сервисов будет запрещено.

Значение по умолчанию: true (работа Web-сервисов разрешена).

Отвечает за возможность использования Web-сервисов из расширений.

Если атрибут установлен в значение true, то все Web-сервисы, которые находятся в подключенных расширениях, будут доступны для использования. Если атрибут установлен в значение false, то Web-сервисы из расширений не будут доступны для использования.

Значение по умолчанию: false (работа Web-сервисов расширений запрещена).

Элемент содержит описание публикуемого Web-сервиса. Элемент подчинен элементу <ws>. Элементов <point> может быть не менее одного. В этом списке также можно вручную указать параметры Web-сервисов из расширений.

Если Web-сервис явно не указан в файле default.vrd, и разрешено использование Web-сервисов прикладного решения, то обращение к такому Web-сервису возможно только по имени Web-сервиса (свойство Web-сервиса Имя). Обращение по синониму (alias) будет недоступно даже в том случае, если этот синоним указан в свойстве Web-сервиса Имя файла публикации. Для того чтобы обращение к Web-сервису было доступно и по имени, и по синониму (alias) ‑ нужно явно указать требуемый Web-сервис в файле default.vrd (включая синоним).

Данный элемент может содержать следующие атрибуты.

Имя публикуемого Web-сервиса. Обращение к сервису возможно как по ссылке, включающей имя Web-сервиса, так и по ссылке, включающей синоним Web-сервиса.

Для Web-сервиса, описанного строкой:

…
base="/demo"
…
<point name="OperationalData" alias="OperData"/>

Обращение возможно следующими способами:

http://host/demo/ws/OperationalData
http://host/demo/ws/OperData

Синоним публикуемого Web-сервиса. Обращение к сервису возможно как по ссылке, включающей имя Web-сервиса, так и по ссылке, включающей синоним Web-сервиса (если синоним указан в файле default.vrd).

Для Web-сервиса, который опубликован следующим образом:

…
base="/demo"
…
<point name="OperationalData" alias="OperData"/>

Обращение возможно следующими способами:

http://host/demo/ws/OperationalData
http://host/demo/ws/OperData

Признак разрешения или запрета использования конкретного Web-сервиса.

Значение по умолчанию: true (публикация разрешена).

Режим повторного использования сеансов:

● dontuse ‑ сеансы повторно не используются.

● use ‑ повторное использование сеансов определяется клиентом и регулируется параметрами HTTP-запроса к Web-сервису;

● autouse ‑ автоматическое повторное использование сеансов.

Значение по умолчанию: autouse.

Время бездействия сеанса, после которого он завершается принудительно (в секундах).

Значение по умолчанию: 20 (время жизни сеанса 20 секунд).

Элемент содержит настройки публикации HTTP-сервисов, подчинен элементу <point>. Элемент <httpServices> может быть один или ни одного. Данный элемент может содержать произвольное количество элементов <service>.

В том случае, если для доступа к HTTP-сервису необходимо использовать JWT-аутентификацию, то необходимо создать элемент <accessTokenAuthentication> (подробнее см. здесь), подчиненный элементу <httpServices>. Наличие элемента <accessTokenAuthentication> разрешает JWT-аутентификацию.

Данный элемент может содержать следующие атрибуты.

Если данный атрибут не задан или установлен в значение true, то все добавляемые в конфигурацию HTTP-сервисы будут автоматически доступны для использования, если это явно не запрещено с помощью элемента <service>.

Значение по умолчанию: true (работа HTTP-сервисов разрешена).

Отвечает за возможность использования HTTP-сервисов из расширений.

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

Значение по умолчанию: false (работа HTTP-сервисов расширений запрещена).

Элемент содержит описание публикуемого HTTP-сервиса. Элемент подчинен элементу <httpServices>. Элементов <service> может быть не менее одного. В этом списке также можно вручную указать параметры HTTP-сервисов из расширений.

Данный элемент может содержать следующие атрибуты.

Содержит имя HTTP-сервиса, как оно задано в конфигураторе. Для обращения к сервису данное имя не используется.

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

Признак разрешения или запрета использования конкретного HTTP-сервиса.

Значение по умолчанию: false (использование запрещено).

Режим повторного использования сеансов:

● dontuse ‑ сеансы повторно не используются.

● use ‑ повторное использование сеансов определяется клиентом и регулируется параметрами HTTP-запроса к HTTP-сервису;

● autouse ‑ автоматическое повторное использование сеансов.

Значение по умолчанию: autouse.

Время бездействия сеанса, после которого он завершается принудительно (в секундах).

Значение по умолчанию: 20 (время жизни сеанса 20 секунд).

Элемент содержит настройки пула соединений с информационной базой. Элемент <pool> может быть один или ни одного.

Данный элемент может содержать следующие атрибуты:

Размер пула ‑ максимальное количество соединений в пуле.

Значение по умолчанию равно 10 000.

Время жизни соединения в пуле ‑ максимальное время жизни соединения в пуле, в секундах. Если в течение указанного времени соединение не было востребовано, оно будет удалено из пула.

Значение по умолчанию равно 20 мин.

Максимальное количество попыток установки соединения с сервером «1С:Предприятия».

Значение по умолчанию равно 5.

Время ожидания установления соединения с сервером «1С:Предприятия», миллисекунды.

Значение по умолчанию равно 500 мс.

Время ожидания между попытками установления соединения с сервером «1С:Предприятия», миллисекунды.

Значение по умолчанию равно 500 мс.

Период проверки системы отслеживания разрыва соединений, миллисекунды. Подробное описание системы отслеживания разрыва соединений приведено в книге.

Значение по умолчанию 1 000 мс.

Максимальное значение 65 535 мс.

Время, в течение которого система отслеживания разрыва соединений ожидает хоты-бы одно сообщение со стороны отслеживаемого процесса, миллисекунды. Подробное описание системы отслеживания разрыва соединений приведено в книге.

Значение по умолчанию 5 000 мс.

Максимальное значение 2 147 483 647 мс.

Пример:

<pool size="50" maxAge="10" attempts="2" attemptTimeout="1" waitTimeout="1"/>

Указывает необходимость запуска в отладочном режиме:

● enable="true" ‑ отладка включена;

● enable="false" ‑ отладка выключена.

Указывает, какой протокол отладки будет использоваться при работе с данной публикацией в том случае, если отладка разрешена:

● protocol="tcp" ‑ используется протокол TCP/IP (по умолчанию);

● protocol="http" ‑ используется протокол HTTP.

Указывает адрес отладчика, к которому нужно автоматически подключиться для отладки, где localhost указывает на поиск на локальном компьютере, «1560» ‑ номер сетевого порта. Если порт не указан, то будут проверяться все порты в диапазоне портов 1560–1591. Указание tcp:// эквивалентно tcp://localhost. Если адрес отладчика не указан, в процессе исполнения кода на встроенном языке отладка производиться не будет.

В случае использования протокола HTTP, адрес отладчика обязательно указывать с указанием порта, по которому будет выполняться взаимодействие: http://pc-name:1561.

Если протокол отладки, указанный с помощью атрибута protocol, не совпадает со схемой, указанной в атрибуте url, соединение с отладчиком не будет установлено, и работа продолжится без возможности отладки.

Пример:

<debug enable="true" protocol="http" url="http://pc-name:1561"/>

Элемент <zones> подчинен элементу <point> и может быть один или ни одного. Элементу <zones> подчинен один или несколько элементов <zone>.

Данный элемент не содержит атрибутов.

Каждый элемент <zone> описывает один разделитель. Порядок следования элементов <zone> в элементе <zones> соответствует порядку следования разделителей в конфигураторе. При изменении порядка следования разделителей следует изменить файл default.vrd. Количество элементов <zone> не должно превышать количество разделителей. Если количество элементов будет больше, чем количество разделителей, то при подключении к информационной базе, опубликованной таким образом, будет вызвано исключение. Если количество элементов меньше количества разделителей, то для неуказанных разделителей значением будет являться значение по умолчанию для типа разделителя, а использование разделителя будет выключено.

Элемент <zone> может содержать следующие атрибуты.

Определяет возможность изменения значений объектов, связанных с механизмом разделения данных в том случае, если доступ к информационной базе осуществляется с помощью веб-клиента или тонкого клиента, подключенного через веб-сервер (безопасный режим разделения данных). Этот атрибут нужно использовать в том случае, когда нужна гарантия, что при доступе к информационной базе через Интернет будет невозможно получить доступ к другой области данных.

Значение по умолчанию: false (изменения разрешены).

Если значение атрибута равно true, то в сеансе, использующем данную публикацию информационной базы, запрещено:

● Выключать использование разделителя, если разделение не является условно выключенным.

● Изменять значение используемого разделителя, если разделение не является условно выключенным.

● Изменять объекты, которые управляют условным разделением:

● Указанные для самого разделителя;

● Указанные для объектов, входящих в состав разделителя.

Определяет необходимость присутствия значения данного разделителя в адресе публикуемой информационной базы.

Значение по умолчанию: false (разделитель не участвует в формировании адреса).

Предназначен для явного указания значения разделителя, который находится на этой позиции.

Неуказанное значение атрибута value совместно с атрибутом specify, установленным в значение false, интерпретируется как отсутствие значения разделителя (соответствует значению «-» в значении параметра Zn строки соединения).

Если для атрибута specify указано значение true и для атрибута value указано значение, то это значение (без учета регистра символов) должно быть явно указано в строке адреса информационной базы в соответствующей позиции. В противном случае при попытке доступа к информационной базе будет получена ошибка с кодом 404 (не удалось найти веб-страницу).

Символы, недопустимые в URL (RFC 1738, https://datatracker.ietf.org/doc/html/rfc1738.html), преобразуются в кодировку UTF-8 и кодируются в соответствии с разделом 2.2. URL Character Encoding Issues стандарта RFC 1738 (с помощью символа «%» и двух шестнадцатеричных символов).

Пример файла default.vrd:

<?xml version="1.0" encoding="UTF-8"?>
<point xmlns=http://v8.1c.ru/8.2/virtual-resource-system xmlns:xs=http://www.w3.org/2001/XMLSchema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   base="/test"
   ib="File=&quot;с:\base&quot;;">
    <ws enable="false"/>
    <zones>
   <zone value="8214" safe="true"/>
   <zone specify="true" />
   <zone />
   <zone specify="true" />
   <zone value="last" specify="true" />
    </zones>
</point>

В данном примере в прикладном решении определено 5 разделителей. Адрес информационной базы будет выглядеть следующим образом:

http://example.com/test/01/20101231235959/last

Что будет интерпретировано следующим образом:

● http://example.com/test ‑ адрес собственно информационной базы.

● Первый разделитель не должен быть указан в адресе (значение атрибута specify по умолчанию равно false), его значение равно 8214, и нельзя программно управлять данным разделителем (значение атрибута safe равно true). Остальными разделителями допустимо управлять программно, т. к. значение атрибута safe для элементов zone не задано, а значение по умолчанию (false) разрешает программное управление.

● Второй разделитель должен быть указан в адресе (значение атрибута specify равно true), и его значение равно 01.

● Третий разделитель отключен.

● Четвертый разделитель должен быть указан в адресе (значение атрибута specify равно true), и его значение равно 31-12-2010 23:59:59.

● Последний разделитель должен быть указан в адресе, и его значение должно быть только last.

Такой вариант указания разделителей может использоваться для тонкого клиента, работающего через веб-сервер, в веб-клиенте и для Web-сервисов.

В случае одновременного указания значений разделителей разными способами значения разделителей, которые будут использоваться в сеансе, определяются следующим образом:

● Если в файле default.vrd задан элемент <zones>, то значения разделителей, указанных в адресе информационной базы, имеют наивысший приоритет. При этом:

● Значения, указанные в параметре запуска (параметр Z), игнорируются.

● Значения, указанные в строке соединения с информационной базой, игнорируются (параметр Zn в атрибуте ib элемента <point>).

● Если в файле default.vrd не задан элемент <zones>, то:

● Выполняется попытка определить значения разделителей из параметра Z строки адреса.

● Если параметр не указан, то выполняется попытка использовать значения, указанные в строке соединения с информационной базой (параметр Zn в атрибуте ib элемента <point>).

● В общем случае приоритет мест указания значений разделителей следующий (приоритет уменьшается сверху вниз):

● Адрес информационной базы (если в файле default.vrd указан элемент <zones>).

● Командная строка запуска (параметр Z).

● Строка соединения информационной базы (параметр Zn в атрибуте ib элемента <point>).

Данный элемент описывает настройки, связанные с OpenID-аутентификацией. Элемент <openid> подчинен элементу <point> и может быть один или ни одного. Элементу <openid> подчинены элементы <rely> и <provider>. Подчиненные элементы могут быть или в единственном числе или отсутствовать.

Данный элемент не содержит атрибутов.

Элемент содержит адрес информационной базы, выступающей в роли OpenID-провайдера.

Указывает URL информационной базы «1С:Предприятия», выступающей в роли OpenID-провайдера. Информационная база должна быть опубликована особым образом.

Пример:

<rely url="https://myserver.org/users-ib/e1cib/oid2op"/>

Элемент указывает, что данная информационная база выступает в роли OpenID-провайдера. Данному элементу подчинен элемент <lifetime>, который может быть один или ни одного.

Пример:

<?xml version="1.0" encoding="UTF-8"?>
<point xmlns=http://v8.1c.ru/8.2/virtual-resource-system xmlns:xs=http://www.w3.org/2001/XMLSchema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   base="/demo"
   ib="Srvr=&quot;tcp://Server&quot;;Ref=&quot;demo&quot;;"
   enable="false">
    <openid>
   <provider/>
    </openid>
</point>

Элемент указывает время жизни признака аутентификационных данных в секундах. Если элемент не указан, то значением по умолчанию является 86 400 секунд (24 часа). Максимальное время жизни аутентификационных данных составляет 604 800 секунд (7 суток). При указании значения элемента lifetime более максимального значения, будет использовано максимальное значение.

Пример:

<?xml version="1.0" encoding="UTF-8"?>
<point xmlns=http://v8.1c.ru/8.2/virtual-resource-system xmlns:xs=http://www.w3.org/2001/XMLSchema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   base="/demo"
   ib="Srvr=&quot;tcp://Server&quot;;Ref=&quot;demo&quot;;"
   enable="false">
    <openid>
   <provider>
    <lifetime>432000</lifetime>
   </provider>
    </openid>
</point>

Элемент <returnto> подчинен элементу <provider> и может присутствовать неограниченное количество раз или вовсе отсутствовать.

<returnto>mysite\.org</returnto>
<returnto>.*\.1c\.ru</returnto>

Содержимое элемента представляет собой регулярное выражение, которое определяет маску разрешенных имен сайтов, на которые могут выполняться переадресации пользовательского веб-браузера (параметр запроса openid.return_to) после исполнения команды OpenID-провайдера. Элемент не используется в том случае, если к OpenID-провайдеру выполняет обращение тонкий клиент.

Если при публикации OpenID-провайдера не указан ни один элемент <returnto>, то любой запрос пользовательского веб-браузера к OpenID-провайдеру, который содержит параметр openid.return_to, будет завершаться ошибкой HTTP 400.

Данный элемент описывает настройки, связанные с аутентификацией по протоколу OpenID Connect. Применимо при использовании тонкого клиента, мобильного клиента и веб-клиента. Элемент <openidconnect> подчинен элементу <point> и может быть один или ни одного. Элементу <openidconnect> подчинены элементы <providers> и <allowStandardAuthentication>. Подчиненные элементы могут быть или в единственном числе или отсутствовать.

Данный элемент не содержит атрибутов.

<openidconnect>
    <providers><![CDATA[[
   <json-data>
   ]]]>
    </providers>
    <allowStandardAuthentication>true</allowStandardAuthentication>
</openidconnect>

Данный элемент содержит описание внешних OpenID-провайдеров, поддерживающих протокол авторизации OpenID Connect v1.0 (https://openid.net/connect/). Описание представляет собой массив объектов, каждый из которых описывает одного OpenID-провайдера. Массив представлен в виде JSON-сериализации.

Каждый провайдер описывается объектом со следующими свойствами:

● name ‑ идентификатор провайдера. Должен быть уникален в рамках массива. Если в массиве имеются несколько провайдеров с одинаковым идентификатором, то будет использован последний из массива.

● title ‑ текстовое представление провайдера. Будет отображаться на кнопке провайдера на странице аутентификации в том случае, если не задана картинка (image).

● image ‑ графическое представление провайдера. Будет отображаться на кнопке провайдера на странице аутентификации. Картинка указывается в виде data:image в формате Base64.

● discovery ‑ содержит URL провайдера, при обращении по которому можно получить все его настройки (discovery endpoint URL). Рекомендуется использовать провайдеры, которые поддерживают discovery endpoint.

● authenticationClaimName ‑ определяет, какое поле JSON-структуры (JSON Web Token, JWT) с результатами аутентификации должно использоваться в качестве идентификатора для сопоставления пользователя информационной базы и пользователя провайдера OpenID Connect. Если не указано ‑ используется поле с электронной почтой.

● authenticationUserPropertyName ‑ определяет, какое поле в настройках пользователя информационной базы используется для сравнения с идентификатором пользователя, который передается провайдером OpenID Connect. Допускается указанием следующих значений:

● name ‑ имя пользователя (свойство Имя объекта ПользовательИнформационнойБазы).

● OSUser ‑ имя пользователя операционной системы (свойство ПользовательОС объекта ПользовательИнформационнойБазы).

● email ‑ адрес электронной почты пользователя информационной базы (свойство АдресЭлектроннойПочты объекта ПользовательИнформационнойБазы).

● matchingKey ‑ в этом случае в качестве поля используется значение из свойства КлючиСопоставленияПользователя, а ключом поиска используется значение свойства name описания провайдера.

● endSessionEndpoint ‑ определяет URL, по которому будет выполнен переход при выполнении команды завершения сеанса аутентификации. К этому URL будет автоматически добавлен параметр id_token_hint, в который будет помещен токен, полученный во время аутентификации данного пользователя. Закрытие вкладки веб-браузера с запущенным приложением веб-клиента, равно как и завершение работы клиентского приложения, не приводят к завершению сеанса аутентификации. При работе в веб-клиенте, после завершения сеанса аутентификации, будет выполнен переход на стандартную страницу завершения сеанса.

● providerconfig ‑ описание настроек провайдера в виде JSON-структуры (если провайдер не поддерживает запрос получения настроек). Данные должны быть представлены в формате OpenID Provider Metadata (https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderMetadata).

● clientconfig ‑ клиентская конфигурация в виде JSON-структуры. Формат этой информации соответствует формату OAuth 2.0 Authorization Request (https://openid.net/specs/openid-connect-core-1_0.html#AuthRequest), к которой добавляется свойство authority, которое должно содержать URL провайдера аутентификации. Содержимое данного свойства зависит от используемого провайдера.

В зависимости от требуемого вида аутентификации, значение свойства response_type принимает следующие значения:

● code ‑ используется Authorization Code Flow. В этом случае свойство client_secret структуры clientconfig содержит информацию, которая выдается пользователю OpenID-провайдером при регистрации. Данное свойство удаляется из структуры clientconfig при отправке клиентскому приложению.

● id_token или id_token token ‑ используется Implicit Flow. В этом случае свойство client_secret структуры clientconfig не используется. Implicit Code Flow не рекомендуется использовать по соображениям безопасности. Используется для совместимости.

● Остальные комбинации не поддерживаются.

Свойство redirect_uri структуры clientconfig содержит URL, по которому выполняется переход в обработчик аутентификации того приложения, которое эту аутентификацию запрашивает. Как правило, этот URL будет выглядеть следующим образом: https://<IBhost>/<IBname>/authform.html, где:

● <IBhost> ‑ имя хоста, на котором опубликована информационная база.

● <IBname> ‑ имя опубликованной информационной базы (под «именем» понимается содержимое поля Имя диалога публикации информационной базы или атрибут point.base файла публикации). Необходимо помнить, что текст в поле <IBName> должен посимвольно совпадать с именем информационной базы (включая регистр символов написания).

● {zones} ‑ данный шаблон следует указывать только в том случае, когда разделители передаются как часть адреса информационной базы (в теле URL). В этом случае разделители описываются в секции <zones> файла default.vrd. Если значения разделителей передаются с помощью параметра строки запуска клиентского приложения Z, то шаблон {zones} не следует указывать в URL, который будет использоваться для переадресации. Значения разделителей из строки запуска будут автоматически использованы по назначению. Если шаблон присутствует в значении свойства redirect_uri, а разделители не передаются через URL (или отсутствует секция <zones>), то шаблон будет заменен на пустую строку.

Другими словами, если для доступа к базе используется URL вида: https://example.com/test-db/val1/val2 (используется 2 разделителя), то адрес для переадресации следует указывать таким образом: https://example.com/test-db/{zones}/authform.html. Если же для доступа к базе используется URL вида: https://example.com/test-db?Z=val1,val2, то адрес для переадресации следует указывать таким образом: https://example.com/test-db/authform.html.

● dialect ‑ определяет протокол, который будет использоваться для взаимодействия с провайдером. Если указано значение ru-esia, то для взаимодействия с провайдером будет использоваться протокол Единой системы идентификации и аутентификации (ЕСИА, https://minsvyaz.ru/ru/activity/directions/13/). Если данный атрибут не указан или его значение отличается от ru-esia, то для взаимодействия с провайдером будет использован протокол OpenID Connect v1.0.

● crypto ‑ содержит структуру, описывающую модуль криптографии, который используется для подписи запросов. Подписывать отправляемые запросы необходимо в том случае, если для взаимодействия с провайдером используется протокол ЕСИА (свойство dialect равно значению ru-esia). Структура содержит следующие свойства:

● module_name ‑ имя модуля криптографии;

● module_path ‑ путь к модулю криптографии;

● module_type ‑ тип модуля криптографии;

● cert_thumbprint ‑ отпечаток сертификата, который будет использоваться для подписи запросов. По отпечатку будет выполнен поиск сертификата. Сертификат должен быть предварительно размещен в хранилище личных сертификатов.

Поля структуры, расположенной в свойстве crypto, аналогичны параметрам конструктора объекта МенеджерКриптографии.

Пример указания провайдеров:

<openidconnect>
    <providers>
   <![CDATA[[
   {
    "name": "google",
    "title": "Google",
    "discovery": "https://accounts.google.com/.well-known/openid-configuration",
    "authenticationClaimName": "email",
    "clientconfig": {
     "authority": "https://accounts.google.com/",
     "client_id": "<идентификатор клиента>",
     "redirect_uri": "https://<hostname>/openidc/authform.html",
     "response_type": "id_token token",
     "scope": "openid email",
     "filterProtocolClaims": true,
     "loadUserInfo": false
    }
   },
   {
    "name": "googleII",
    "title": "Google 2",
    "providerconfig": {
     "issuer": "https://accounts.google.com",
     "authorization_endpoint": "https://accounts.google.com/o/oauth2/v2/auth",
     "token_endpoint": "https://www.googleapis.com/oauth2/v4/token",
     "response_types_supported": ["code","token"],
     "scopes_supported": ["openid","email","profile"]
    },
    "clientconfig": {
     "authority": "https://accounts.google.com/",
     "client_id": "<идентификатор клиента>",
     "redirect_uri": "https://<hostname>/openidc/authform.html",
     "response_type": "id_token token",
     "scope": "openid email"
    }
   },
   {
    "name": "googleIII",
    "title": "Google 3",
    "providerconfig": {
     "issuer": "https://accounts.google.com",
     "authorization_endpoint": "https://accounts.google.com/o/oauth2/v2/auth",
     "token_endpoint": "https://www.googleapis.com/oauth2/v4/token",
     "response_types_supported": ["code","token"],
     "scopes_supported": ["openid","email","profile"]
    },
    "clientconfig": {
     "authority": "https://accounts.google.com/",
     "client_id": "<идентификатор клиента>",
     "client_secret": "<секрет клиента>",
     "redirect_uri": "https://<hostname>/openidc/authform.html",
     "response_type": "code",
     "scope": "openid email"
    }
   },
   {
    "name": "microsoft",
    "title": "Microsoft",
    "authenticationUserPropertyName" : "OSUser",
    "image": "data:image/png;base64,………",
    "discovery": "https://login.microsoftonline.com/<идентификатор клиента>/.well-known/openid-configuration",
    "clientconfig": {
     "authority": "https://login.microsoftonline.com/<идентификатор клиента>/",
     "client_id": "<идентификатор клиента>",
     "redirect_uri": "https://<hostname>/openidc/authform.html",
     "response_type": "id_token token",
     "scope": "openid email"
    }
   },
   {
    "name": "googleIV",
    "title": "GOOGLE.COM",
    "discovery": "https://accounts.google.com/.well-known/openid-configuration",
    "authenticationClaimName": "email",
    "authenticationUserPropertyName": "matchingKey",
    "clientconfig": {
     "authority": "https://accounts.google.com",
     "client_id":"<идентификатор клиента>",
     "client_secret" : "<секрет клиента>",
     "redirect_uri": "https://<hostname>/openidc/authform.html",
     "response_type": "token id_token",
     "scope": "openid email",
     "filterProtocolClaims": true,
     "loadUserInfo": false
    }
        },
   {
    "name": "esia",
    "title": "ЕСИА",
    "authenticationClaimName": "value",
    "authenticationUserPropertyName": "name",
    "dialect": "ru-esia",
    "crypto": {
     "module_path": "",
     "module_name": "Crypto-Pro GOST R 34.10-2012 Cryptographic Service Provider",
     "module_type": "80",
     "cert_thumbprint": "<отпечаток сертификата>"
    },
    "providerconfig": {
     "authorization_endpoint": "https://<hostname>/aas/oauth2/v2/ac",
     "token_endpoint": "https://<hostname>/aas/oauth2/v3/te",
        "userinfo_endpoint": "https://<hostname>/rs/prns/"
    },
    "clientconfig": {
     "authority": "https://<hostname>/aas/oauth2/v2/ac",
     "client_id": "<идентификатор клиента>",
     "redirect_uri": "https://<hostname>/openidc/authform.html",
     "scope": "openid email",
     "response_type": "code",
     "access_type": "offline",
     "client_certificate_hash": "E11E4A7D6391E5FE58395D5EF935784215FB932174DC58FB873131D7B9F6C62F"
    }
   }
   ]]]>
    </providers>
    <allowStandardAuthentication>true</allowStandardAuthentication>
</openidconnect>

В примере провайдера googleIV продемонстрировано, как необходимо указывать поле из коллекции КлючиСопоставленияПользователя. В этом примере:

● В качестве поля токена, которое содержит идентификатор пользователя для сопоставления, выступает поле email. Это указано в выражении authenticationClaimName": "email".

● Выражение "authenticationUserPropertyName": "matchingKey" указывает, что система должна «перебрать» всех пользователей информационной базы, получить у каждого пользователя структуру КлючиСопоставленияПользователя, а в этой структуре получить поле с идентификатором, указанным в поле name описания провайдера. В нашем примере это значение googleIV. Значение, полученное по этому ключу у пользователя, будет сравниваться со значением поля email токена.

Кластер серверов "1С:Предприятия" или расширение веб-сервера (для файлового варианта информационной базы) выполняет запросы к провайдеру OpenID Connect для выполнения следующих операций:

● Получение криптографических ключей для проверки подписи токена аутентификации.

● Для обмена значения свойства code на токен аутентификации (в случае Authorization code flow).

В связи с этим, компьютеру, на котором работает рабочий сервер кластера серверов "1С:Предприятие", необходимо предоставить разрешение на обращение по URL, которые размещены в свойствах discovery, jwks_uri, token_endpoint и, при необходимости, к end_session_endpoint.

Адреса, по которым будет выполняться обращение, можно получить в описании соответствующего провайдера OpenID Connect (см. пример и описание структуры параметров выше). Если секция providerconfig не заполнена, то необходимо выполнить обращение по URL, указанному в настройке discovery, и из ответа сервера получить значения jwks_uri, token_endpoint и end_session_endpoint.

Платформа «1С:Предприятие» поддерживает работу с разными версиями ЕСИА (Единой Системы Идентификации и Аутентификации). Разделение версий происходит по значениям, указанных в свойствах providerconfig.authorization_endpoint, clientconfig.authority, providerconfig.token_endpoint описания провайдера ЕСИА:

● Версия ЕСИА 2.90 и последующие:

● Конечная точка получения кода авторизации: https://<hostname>/aas/oauth2/v2/ac.

● Конечная точка получения токена доступа: https://<hostname>/aas/oauth2/v3/te.

● Предыдущие версии ЕСИА:

● Конечная точка получения кода авторизации: https://<hostname>/aas/oauth2/ac.

● Конечная точка получения токена доступа: https://<hostname>/aas/oauth2/te.

Версия используемого протокола определяется по URL, который указан в конечной точке получения кода авторизации. Однако, если в этой конечной точке «указана» версия 2.90 или последующая, а в конечной точке получения токена доступа ‑ предыдущая версия, то выполнить аутентификацию с помощью ЕСИА будет невозможно.

При использовании протокола ЕСИА 2.90 и последующих версий, в описание клиентской конфигурации добавляется свойство client_certificate_hash. Однако, данное свойство не является обязательным. Если оно не задано, то платформа автоматически выполнит вычисление данного значения и добавит его в запрос к ЕСИА (при необходимости). Если свойство указано в файле default.vrd ‑ автоматического вычисления не выполняется и используется значение из файла. Для самостоятельного вычисления значения хеша следует использовать утилиту http://esia.gosuslugi.ru/public/calc_cert_hash_unix.zip. Архив включает в себя краткое описание использования. Утилиту имеет смысл использовать в том случае, если разработчики ЕСИА изменили алгоритм расчета хеша и используемая платформа не включает это изменение.

К использованию рекомендуется ЕСИА версии 2.90 и последующие версии. Возможность использования предыдущих версий может быть отключена в любой момент и без предупреждения (на стороне провайдера ЕСИА).

Элемент управляет отображением на форме аутентификации гиперссылки для перехода к форме аутентификации «1С:Предприятия». Если этот элемент установлен в значение false, то на форме аутентификации (при попытке входа в веб-клиент) не будет доступна возможность открыть форму аутентификации «1С:Предприятие». Управление возможностью использования аутентификации «1С:Предприятие» (для конкретного пользователя) доступно только в свойствах конкретного пользователя (см. здесь).

Элемент может принимать следующие значения:

● true ‑ предоставляется возможность открыть форму аутентификация «1С:Предприятия». Значение по умолчанию.

● false ‑ не представляется возможным открыть форму аутентификации «1С:Предприятия».

Аутентификация с помощью провайдера OpenID Connect доступна только в том случае, если параметры одного или нескольких провайдеров указаны в файле default.vrd. При попытке использовать клиентское приложение (тонкий клиент, мобильный клиент или веб-клиент) для доступа к информационной базе, выполняются следующие действия:

● Если в командной строке клиентского приложения явно указан провайдер, то выполняется переход в соответствии с параметрами, указанными в файле default.vrd для этого провайдера.

● В противном случае платформа формирует форму запуска (в зависимости от клиентского приложения), на которой размещены все настроенные (в файле default.vrd) провайдеры OpenID Connect. В зависимости от настроек, на этой странице может располагаться кнопка доступа с помощью стандартной аутентификации системы «1С:Предприятие».

● После выбора провайдера, пользователь перенаправляется на страницу аутентификации выбранного провайдера. На этой странице пользователь аутентифицируется у выбранного провайдера любым доступным (для данного провайдера) способом.

● Затем провайдер перенаправляет пользователя на специальную страницу системы «1С:Предприятие», передавая в качестве «параметра» JSON-структуру (JSON Web Token, JWT) с результатами аутентификации. Адрес этой страницы указывается в свойстве redirect_uri структуры clientconfig элемента provider.

● С помощью результатов аутентификации, переданных провайдером, платформа получает от провайдера ключевой параметр для идентификации пользователя. По умолчанию этим параметром является адрес электронной почты пользователя, но с помощью файла default.vrd параметр может быть переопределен (поле authenticationClaimName).

● Полученный ключевой параметр используется для поиска пользователя в информационной базе «1С:Предприятия». По умолчанию используется свойство Имя. Поле поиска может быть переопределено с помощью файла default.vrd (поле authenticationUserPropertyName).

● После этого аутентификация считается успешно завершенной и приложение продолжает запускаться.

При неуспешной аутентификации на провайдере, действия провайдера не определены.

Позволяет указать, по какому адресу (URL) будет выполнен переход после завершения работы веб-клиента.

Пример:

<?xml version="1.0" encoding="UTF-8"?>
<point xmlns=http://v8.1c.ru/8.2/virtual-resource-system xmlns:xs=http://www.w3.org/2001/XMLSchema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   base="/demo"
   ib="Srvr=&quot;tcp://Server&quot;;Ref=&quot;demo&quot;;"
   enable="false">
    <exitURL>http://www.1c.ru</exitURL>
</point>

Элемент управляет доступностью стандартного интерфейса OData для публикуемой информационной базы. Элемент подчинен корневому элементу <point>. Элемент <standardOData> может быть один или ни одного. Если элемент отсутствует в файле default.vrd ‑ стандартный интерфейс OData не доступен для опубликованного прикладного решения.

Данный элемент может содержать следующие атрибуты.

Атрибут управляет доступностью стандартного интерфейса OData через указанную публикацию. Атрибут может принимать следующие значения:

● true ‑ через текущую публикацию возможна работа с данными с помощью стандартного интерфейса OData;

● false ‑ через текущую публикацию работа с данными с помощью стандартного интерфейса OData не доступна.

Режим повторного использования сеансов при использовании стандартного интерфейса OData:

● dontuse ‑ сеансы повторно не используются.

● use ‑ повторное использование сеансов определяется клиентом и регулируется параметрами HTTP-запроса к Web-сервису;

● autouse ‑ автоматическое повторное использование сеансов.

Значение по умолчанию: dontuse (повторное использование сеансов запрещено).

Время бездействия сеанса, после которого он завершается принудительно (в секундах).

Значение по умолчанию: 20 (время жизни сеанса 20 секунд).

Управляет интеграцией системы «1С:Предприятие» с сервером системы «1С:Аналитика». В число параметров входит набор параметров, управляющий параметрами пула сеансов, которые использует система аналитики для взаимодействия с кластером серверов «1С:Предприятие». Данный элемент может содержать следующие атрибуты.

Включает или выключает интеграцию. Атрибут может принимать следующие значения:

● true ‑ через текущую публикацию возможна работа с сервером системы «1С:Аналитика». Является значением по умолчанию.

● false ‑ через текущую публикацию работа с сервером системы «1С:Аналитика» не доступна.

Время бездействия сеанса, после которого он завершается принудительно (в секундах).

Значение по умолчанию: 20 (время жизни сеанса 20 секунд).

Максимальное количество сеансов, которые могут быть созданы в пуле сеансов.

Значение по умолчанию: 500.

Время ожидания появления свободного сеанса после заполнения пула сеансов (в секундах). Если за это время система не сможет создать новый сеанс, клиент получит сообщение об ошибке.

Значение по умолчанию: 5 (ожидание свободного сеанса выполняется 5 секунд).

Позволяет указать название прогрессивного веб-приложения системы «1С:Предприятие» для данной публикации веб-клиента. Данный элемент может содержать следующие атрибуты.

Указывает имя прогрессивного веб-приложения.

Данный элемент описывает настройки, связанные с JWT-аутентификацией. Элемент <accessTokenAuthentication> подчинен элементам <point>, <ws> и <httpServices> и может быть один или ни одного. Элементу <accessTokenAuthentication> подчинены элемент <issuers>. Каждый подчиненный элемент может быть в единственном числе.

Если элемент подчинен элементу <point>, то это разрешает использование аутентификации по JWT для доступа к информационной базе. Если элемент подчинен элементу <ws> или <httpServices>, то это разрешает использование аутентификации по JWT для (соответственно) Web-сервисов и HTTP-сервисов.

Данный элемент не содержит атрибутов.

Для организации JWT-аутентификации в информационную базу можно использовать фрагмент файла default.vrd следующего вида:

<point xmlns="http://v8.1c.ru/8.2/virtual-resource-system" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    base="/InfoBase"
    ib="File=&quot;C:\InfoBase&quot;;">
    <accessTokenAuthentication>
   <accessTokenRecepientName>InfoBaseJWT</accessTokenRecepientName>
   <issuers>
    <issuer
     name="limitedAccess"
     authenticationClaimName="sub"
     authenticationUserPropertyName="name"
     keyInformation="EgH23sF8nL3xEGT2kEmAgxWyaKWvcf3p"
    />
   </issuers>
    </accessTokenAuthentication>
</point>

В данном примере нужно понимать, что токен, с которым будет выполняться аутентификация в данную информационную базу, должен иметь полезную нагрузку aud, которая установлена в значение InfoBaseJWT. Получить доступ к этой информационной базе можно будет только в том случае, когда значение полезной нагрузки iss предъявленного токена также будет равно limitedAccess.

Данный элемент не содержит атрибутов. Данный элемент имеет значение, которое является идентификатором получателя для проверки того, что предъявленный токен предназначен для предъявления данному сервису. Для этого значение элемента сравнивается со значением претензии aud полезной нагрузки предъявленного токена. Если значение не указано, то идентификатором получателя будет выступать имя Интернет-сервиса или публикации.

<point …>
    <accessTokenAuthentication>
   <accessTokenRecepientName>infoBase<accessTokenRecepientName>
   …
    </accessTokenAuthentication>
…
</point>
<ws …>
    <accessTokenAuthentication>
   <accessTokenRecepientName>soapSrv1<accessTokenRecepientName>
   …
    </accessTokenAuthentication>
…
</ws>

Данный элемент подчинен элементу <accessTokenAuthentication> и описывает список приложений, которые могут обращаться к данной публикации с использованием JWT-аутентификации. Элементу <issuers> подчинены элемент <issuer>. Подчиненных элементов может быть один или несколько.

Данный элемент подчинен элементу <issuers> и описывает приложение, которое может получить доступ к данной публикации. Данный элемент может содержать следующие атрибуты:

Содержит имя приложения, которое может получить доступ к данной публикации. Значение в данном атрибуте сравнивается со значением претензии iss предъявленного токена доступа.

Определяет имя претензии предъявленного токена доступа, которое содержит имя, по которому «1С:Предприятие» должно аутентифицировать предъявителя JWT. Если данный атрибут не указан, то используется претензия sub.

Определяет свойство пользователя системы «1С:Предприятие», по которому будет выполняться поиск при предъявлении JWT. Другими словами, из JWT извлекается значение претензии с именем, которое указано в атрибуте authenticationClaimName, а затем это значение используется для поиска пользователя системы «1С:Предприятие» по свойству, которое указано в данном атрибуте. Допускается использование следующих значений данного атрибута:

● name ‑ для поиска используется свойство Имя.

● OSUser ‑ для поиска используется свойство ПользовательОС.

● email ‑ для поиска используется свойство АдресЭлектроннойПочты.

● matchingKey ‑ в этом случае в качестве поля используется значение из свойства КлючиСопоставленияПользователя, а в качестве ключа поиска используется значение свойства name описания приложения.

Если атрибут не указан, то поиск пользователя выполняется по имени (значение атрибута ‑ name, имя поля для поиска ‑ Имя).

Содержит сертификат (в формате PEM), который будет использоваться для проверки подписи JWT. В случае алгоритмов HS256, HS384 или HS512 ‑ это симметричный ключ шифрования, в остальных случаях ‑ это открытый ключ.

Рассмотрим пример, приведенный в начале раздела (см. здесь):

<accessTokenAuthentication>
    <accessTokenRecepientName>InfoBaseJWT</accessTokenRecepientName>
    <issuers>
   <issuer
    name="limitedAccess"
    authenticationClaimName="sub"
    authenticationUserPropertyName="name"
    keyInformation="EgH23sF8nL3xEGT2kEmAgxWyaKWvcf3p"
   />
    </issuers>
</accessTokenAuthentication>

В этом случае для получения доступа к информационной базы, доступ к которой ограничен параметрами, указанными в примере, будет нужно использовать JWT-токен следующего вида:

{
    "alg": "HS256",
    "typ": "JWT"
}
{
    "exp": 1709936634,
    "aud": "InfoBaseJWT",
    "sub": "ФедоровБМ",
    "nbf": 1709733034,
    "iat": 1709733034,
    "iss": "limitedAccess"
}

В токене следует обратить внимание на следующие особенности:

● Используется симметричный алгоритм хеширования HS256 (претензия заголовка alg). Это означает, что в файле default.vrd, в поле point/accessTokenAuthentication/issuers/issue/keyInformation будет размещаться симметричный ключ хеширования. Алгоритм хеширования HS256 использован только в качестве примера. Для реального использования следует оценивать угрозы решаемой задачи. В системах, доступ к которым выполняется из-за периметра безопасности организации, следует рекомендуется использование асимметричных алгоритмов, например RS256. Если доступ организуется изнутри защищенного периметра, то можно рассмотреть использование и симметричных алгоритмов.

● Доступ выполняется к информационной базе, которая называется InfoBaseJWT (претензия полезной нагрузки aud). В файле default.vrd это имя определено элементом point/accessTokenAuthentication/accessTokenRecepientName.

● Чтобы получить доступ к информационной базы, в токене должен быть указан один из эмитентов (претензия полезной нагрузки iss), которые указаны в разделе point/accessTokenAuthentication/issuers. Каждый эмитент определяется значением атрибута name элемента issuer. В примере доступ будет предоставлен в том случае, если претензия iss имеет значение limitedAccess.

Элемент содержит настройки отображения дополнительных видов аутентификации в диалоге аутентификации (при попытке получения доступа к информационной базы), подчинен элементу <point>. Элемент <authentication> может быть один или ни одного. Данный элемент должен содержать один элемент <logonView>.

С помощью данного элемента можно выполнять настройку диалог аутентификации пользователя:

● Разрешать или запрещать сохранение параметров аутентификации пользователя на локальном компьютере.

● Определять, как долго будет использовать запомненная аутентификация. После того, как запомненная аутентификация станет устаревшей ‑ пользователю потребуется заново выполнить аутентификацию.

● Указывать способ аутентификации по умолчанию.

● Настраивать порядок следования различных типов аутентификации в нижней части диалога.

Данный элемент может содержать следующие атрибуты.

Пример элемента:

<authentication allowSaveForReauthentication="true" savedAuthenticationParametersLifeTime="60">
    <logonView saveForReauthenticationByDefault="false">
   <method type="standard" visible="true"/>
   <method type="qr" visible="false"/>
   <method type="openid" visible="true"/>
   <method type="openidconnect" visible="true"/>
   <method type="email" visible="true"/>
    </logonView>
</authentication>

Если порядок следования видов аутентификации не настроен, то в диалоге аутентификации используется следующий порядок следования видов аутентификации (если они настроены для публикации):

● Стандартная аутентификация.

● Аутентификация через электронную почту.

● Аутентификация OpenID.

● Аутентификация OpenID Connect.

Элемент содержит описание порядка следования видов аутентификации в нижней части диалога аутентификации. Порядок следования видов аутентификации определяется порядком следования элементов <method>, описывающих отдельный вид аутентификации.

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

● Аутентификация OpenID Connect, если она настроена для информационной базы.

● Аутентификация OpenID, если она настроена для информационной базы.

● Аутентификация системы «1С:Предприятие».

Данный элемент может содержать следующие атрибуты.

Элемент описывает вид аутентификации, который будет отображаться в диалоге аутентификации информационной базы.

Данный элемент может содержать следующие атрибуты:

Элемент служит для указания размещения мобильных приложений, подчинен элементу <point>. Элемент <mobileApps> может быть один или ни одного. Данный элемент может содержать один или несколько элементов <application>.

Данный элемент описывает местонахождение мобильных приложений, с помощью которых можно выполнять аутентификацию по QR-коду.

Элемент мобильное приложение, которое может использоваться для аутентификации по QR-коду.

Данный элемент может содержать следующие атрибуты:

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

Файл располагается в каталоге конфигурационных файлов системы «1С:Предприятие», и его наличие не является обязательным.

● Для ОС Linux:

● При наличии файла ‑ настройки берутся из файла.

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

● Для ОС macOS:

● При наличии файла ‑ настройки берутся из файла.

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

● Для ОС Windows:

● При наличии файла ‑ настройки берутся из файла.

● При отсутствии файла ‑ настройки берутся из настроек Microsoft Internet Explorer. Не поддерживается использование сценария автоматической настройки.

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

● тонкий клиент ‑ 1CV8C;

● Web-сервис ‑ 1C + Enterprise/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-аутентификации:

● true ‑ NTLM-аутентификация включена;

● false ‑ выключена.

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

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

ПараметрыПроксиПротокола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="proxyUser"

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

password="proxyPassword"

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

● true ‑ не использовать;

● false ‑ использовать.

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

Для того чтобы запретить использовать прокси для адресов, которые воспринимаются как локальные, используется следующий параметр:

bypassOnLocal="true"

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

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

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

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

bypassOnAddresses="127.0.0.1 *.master"

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

Файл location.cfg служит для указания каталога, который хранит файлы настроек пользователя и расположения файла программной лицензии. Для указания расположения каталога служит параметр location.

Путь к каталогу.

Например:

location=C:\Users\UserName\AppData\Roaming\1C\1cv82

Файл logcfg.xml служит для настройки параметров технологического журнала и механизма генерации дампов памяти при аварийном завершении работы системы «1С:Предприятие». Файл располагается в каталоге конфигурационных файлов системы «1С:Предприятие», и его наличие не является обязательным. Если файл не найден, то технологический журнал имеет следующие настройки по умолчанию:

● Технологический журнал (элемент <log>) ‑ выключен.

● Технологический журнал по умолчанию (элемент <defaultlog>):

● Формирование ‑ включено.

● Время жизни ‑ 24 часа.

● Уровень формирования событий <system> для всех компонентов системы определен как Error.

● Сохраняется в каталоги:

● ОС Linux: ~/.1cv8/logs.

● ОС Windows: %LOCALAPPDATA%\1C\1cv8\logs.

● Дампы аварийного завершения (актуально только для ОС Windows):

● Сохраняются минимальные дампы аварийного завершения работы системы (type="1").

● Дампы сохраняются в каталог %LOCALAPPDATA%\1C\1cv8\dumps.

Пример:

<config xmlns="http://v8.1c.ru/v8/tech-log">
    <log location="c:\v8\logs" history="1">
   <event>
       <eq property="name" value="conn"/>
   </event>
    </log>
    <dump location="c:\v8\dumps" create="1" type="2"/>
</config>

Данный конфигурационный файл указывает на следующее:

● в технологическом журнале регистрируются все события установки и разрыва клиентского соединения с сервером;

● файлы технологического журнала располагаются в каталоге C:\v8\logs;

● файлы технологического журнала хранятся в течение одного часа;

● файлы дампа помещаются в каталог C:\v8\dumps;

● файлы дампа содержат всю доступную информацию (содержимое всей памяти процесса).

При описании какого-либо атрибута элемента будет использовать мнемоническое написание вида element.attribute, что означает атрибут attribute элемента element. Выражение element1/element2/element3 будет означать элемент element3, который подчинен элементу element2, который, в свою очередь, подчинен элементу element1. Также возможна комбинация мнемонических написаний: config/log.location.

Корневым элементом конфигурационного файла является элемент <config>, который определяет настройки технологического журнала. Этот элемент может содержать различные вложенные элементы, отвечающие за использование различных возможностей технологического журнала:

<config…>
    <log…>…</log>
    <log…>…</log>
    <log…>…</log>
    <dump … />
    <leaks>…</leaks>
    <mem/>
    <ftextupd …/>
    <query …/>
    <plansql/>
    <dbmslocks/>
    <inputbystring …/>
    <scriptcircrefs/>
    <sessiondatacontext>
    <system … />
    <system … />
    <system … />
    <defaultlog … />
</config>

Эти элементы отвечают за следующее:

● Элемент <log> определяет каталог технологического журнала и его состав (см. здесь). Может быть один или несколько.

● Элемент <dump> определяет каталог для записи дампов аварийного завершения (см. здесь). Может быть один или ни одного.

● Элемент <leaks> устанавливает отслеживание утечек памяти (см. здесь), которые могут быть вызваны ошибками в коде конфигурации. Отслеживание утечек памяти несколько снижает производительность. Может быть один или ни одного.

● Элемент <mem> предназначен для учета используемой памяти (см. здесь). Может быть один или ни одного.

● Элемент <plansql> предназначен для управления сбором планов запроса, формируемых при работе различных СУБД (см. здесь). Собственно планы запросов содержатся в свойстве <planSQLText> событий, связанных с СУБД. Может быть один или ни одного.

● Элемент <dbmslocks> предназначен для управления сбором информации о блокировках СУБД (см. здесь). Может быть один или ни одного.

● Элемент <ftextupd> предназначен для управления сбором информации о процессах обновления индекса полнотекстового поиска (см. здесь). Может быть один или ни одного.

● Элемент <query> управляет помещением в технологический журнал информации о полях, содержащих NULL при исполнении запроса к внешнему источнику данных, но для которых такое значение не допускается (см. здесь). Может быть один или ни одного.

● Элемент <inputbystring> предназначен для управления сбором информации об использовании механизма ввода по строке. Может быть один или ни одного.

● Элемент <scriptcircrefs> управляет работой механизма отслеживания информации о циклических ссылках во время выполнения встроенного языка (см. здесь). Может быть один или ни одного.

● Элемент <sessiondatacontext> предназначен для управления выводом списка операций изменения данных сеанса и их контекстов. Может быть один или ни одного.

● Элемент <defaultlog> определяет каталог и время жизни технологического журнала по умолчанию (см. здесь). Может быть один или ни одного.

● Элемент <system> определяет настройки формирования системных событий (см. здесь). Может быть один, несколько или ни одного.

Элементы можно разделить на несколько групп:

1. Элементы, которые управляют формированием того или иного события. К таким элементам относятся <dump>, <leaks>, <mem>, <plansql>, <ftextupd>, <system>, <query>, <scriptcircrefs>, <inputbystring>. При этом, если в файле настройки технологического журнала не указан нужный элемент, то соответствующее событие не формируется системой. Другими словами, если, например, учет используемой памяти не включен элементом <mem>, то наличие отбора по событию MEM никак не повлияет на наполнение технологического журнала, т. к. событие просто не формируется.

2. Элементы, которые задают отбор для уже сформированных данных технологического журнала. К таким элементам относятся <event> и <property>. С помощью этих элементов можно «обрабатывать» те события, которые сформированы системой. С помощью этих элементов можно только уменьшить количество данных, записываемых в файлы технологического журнала.

3. Элементы, которые управляют расположением файлов с данными (технологический журнал и дампы). К таким элементам можно отнести <log>, <defaultlog>, <dump>.

Элемент <log> определяет каталог технологического журнала и условия отбора, по которым в технологический журнал помещаются сформированные события.

Атрибуты элемента:

В элемент <log> могут быть вложены элементы <event> и <property>, состав которых определяет условие записи в журнал каждого события и условия записи каждого свойства события. Если элемент <log> не содержит ни одного элемента <event>, то никакие события в журнал записываться не будут.

Описание файлов технологического журнала (их хранение, формат, структура и т. д.) более подробно см. здесь.

Последовательность элементов <event> определяет условие, при выполнении которого событие будет помещено в журнал. В журнал помещаются только такие события, которые удовлетворяют условию. Иначе говоря, если условие, определяемое последовательностью элементов <event>, принимает значение Истина, то событие будет записано в журнал. Событие включается в журнал, если оно удовлетворяет всем условиям внутри хотя бы одного из элементов <event>. То есть условия внутри <event> объединяются «по И», а элементы <event> объединяются «по ИЛИ».

Условия задаются элементами:

● eq ‑ равно;

● ne ‑ не равно;

● gt ‑ больше;

● ge ‑ больше или равно;

● lt ‑ меньше;

● le ‑ меньше или равно;

● like ‑ соответствие маске.

Каждый из этих элементов, кроме элемента like, определяет простое сравнение значения параметра события (имя которого задается атрибутом property) со значением атрибута value.

Пример:

<event>
    <eq property="name" value="proc"/>
</event>

В данном случае в технологическом журнале будут регистрироваться события, относящиеся к группе с именем PROC.

Доступны следующие имена событий:

Также следует заметить, что события из групп PROC, SCOM, EXCP, CONN и ADMIN возникают относительно редко и содержат небольшое количество информации, в то время как регистрация событий из групп SDBL, DB2, DBMSSQL, DBPOSTGRS, DBORACLE может приводить к значительному росту объема технологического журнала.

Элемент like определяет, соответствует ли свойство события технологического журнала некоторой маске. Маска представляет собой последовательность символов, некоторые из которых означают сами себя, а некоторые являются шаблонами и служат для описания группы символов.

Например, элемент <like property="SDBL" value="%reference%"/> означает проверку значения свойства SDBL события технологического журнала на соответствие маске %reference%.

К шаблонам относятся:

● % ‑ 0 или более произвольных символов.

● _ ‑ 1 произвольный символ.

● [...] ‑ один из перечисленных символов, причем [...] может содержать произвольные символы, а также диапазоны вида с-С, где с ‑ начальный символ диапазона, С ‑ конечный символ диапазона.

● [^...] ‑ один любой символ, кроме перечисленных в скобках [].

● \ ‑ префиксный символ. Игнорируется и означает, что следующий за ним символ ‑ это просто символ, означающий сам себя (а не шаблон).

● Все другие символы ‑ это простые символы, которые означают сами себя. При сравнении простых символов регистры букв не различаются.

Примеры шаблонов:

● шаблон ‑ строка с конкретным текстом. В этом случае сравнение like не отличается от сравнения eq. Регистры букв не различаются.

● %reference% ‑ строка, содержащая контекст reference в произвольном месте. Регистры букв не различаются.

● reference% ‑ строка, содержащая контекст reference в начале. Регистры букв не различаются.

● %reference ‑ строка, содержащая контекст reference в конце. Регистры букв не различаются.

● %[a-z] ‑ строка с маленькой английской буквой от a до z в конце.

● %[^a-z]% ‑ строка, содержащая хотя бы один символ, отличающийся от маленькой английской буквы.

Пример:

<log location="c:\logs" history="1">
    <event>
   <eq property="name" value="proc"/>
    </event>
    <event>
   <eq property="name" value="scom"/>
    </event>
    <event>
   <eq property="name" value="conn"/>
    </event>
    <event>
   <eq property="name" value="excp"/>
    </event>
    <event>
   <eq property="name" value="dbmssql"/>
    </event>
</log>

В данном примере указывается, что в технологическом журнале будут регистрироваться события, относящиеся к группам PROC, SCOM, CONN, EXCP и DBMSSQL.

Элемент <property> определяет условия попадания в журнал значения свойства события, имя которого является значением атрибута name при условии, что само событие попадает в технологический журнал. Условия задаются вложенными элементами <event> по таким же правилам, что и для событий.

Если элемент <property> с определенным именем отсутствует, то соответствующее свойство не пишется. Если элемент <property> не содержит вложенных элементов <event>, то определяемое им свойство пишется для всех событий, попадающих в журнал, в которых оно присутствует. Если элемент <property> содержит вложенные элементы <event>, то свойство будет записано только для событий, удовлетворяющих условию (если само событие в журнал записывается и событие имеет данное свойство).

Элемент <property name="all"> </property> включает записи в журнал всех свойств событий.

Приведенный ниже элемент <log> определяет запись в журнал событий: процесса, серверного контекста, соединения, исключений и исполнение операторов SQL. Причем текст оператора SQL будет помещен в журнал, только если он исполнялся более секунды. Журнал располагается в каталоге C:\logs и хранится 1 час.

Пример:

<log location="c:\logs" history="1">
    <event>
    <eq property="name" value="proc"/>
    </event>
    <event>
    <eq property="name" value="scom"/>
    </event>
    <event>
   <eq property="name" value="conn"/>
    </event>
    <event>
   <eq property="name" value="excp"/>
    </event>
    <event>
        <eq property="name" value="dbmssql"/>
    </event>
    <property name="sql">
   <event>
    <eq property="name" value="mssql"/>
    <gt property="duration" value="10000"/>
   </event>
    </property>
</log>

Каждое событие имеет набор свойств. Каждое свойство имеет имя. Возможно присутствие в событии нескольких свойств с одинаковыми именами. Имена свойств могут использоваться для фильтрации событий и свойств. Большие и малые буквы при сравнении имен не различаются. Пустое условие в элементе <property> будет означать, что свойство будет выводиться при любом условии.

Далее перечислены основные свойства событий, которые могут потребоваться для настройки конфигурационного файла или просмотра технологического журнала:

Используя свойства элемента <property>, в технологический журнал можно записывать контекст исполнения. Контекст исполнения может быть двух видов: контекст встроенного языка и интерфейсный контекст. Контекст встроенного языка представляет собой список операторов встроенного языка и содержит в себе:

● название модуля;

● номер строки модуля;

● текстовое представление элемента списка вызова встроенного языка соответствующей строки модуля.

Интерфейсный контекст включает в себя:

● полное имя формы;

● тип активного элемента формы;

● имя активного элемента формы;

● имя кнопки командной панели (если она была нажата);

● действие, выполняемое элементом формы;

Например, контекст встроенного языка в файле технологического журнала может иметь следующий вид:

Документ.ПриходнаяНакладная:23:Движения.УчетНоменклатуры.Записать();
МодульПриложения:18:ПроверитьПодключениеОбработчикаОжидания(Истина);
МодульПриложения:230:ЕслинпПолучитьЗначениеПоУмолчанию(глТекущийПользователь,"ИспользоватьНапоминания")
ОбщийМодуль.нпНастройкиПользователей:481:Выборка=Запрос.Выполнить().Выбрать();

Интерфейсный контекст в файле технологического журнала может иметь такой вид:

{Документ.Документ1.ФормаСписка}/{ТабличноеПоле:
ДокументСписок}/{ОбновлениеОтображения}
{Документ.Документ1.Форма.ФормаДокумента}/{КоманднаяПанель:
ОсновныеДействияФормы}/{ОсновныеДействияФормыОК}
{Документ.Документ1.Форма.ФормаДокумента}/{Кнопка:
Кнопка1}/{Нажатие}

Чтобы включить запись контекста, нужно среди фильтров свойств записать элемент <property name="Сontext"> или элемент <property name="all">.

Если нужно записывать события SDBL (SDBL-запросы) и DBMSSQL (операторы SQL к СУБД MS SQL Server) с контекстом исполнения, то содержимое файла настройки технологического журнала будет выглядеть следующим образом:

<config xmlns="http://v8.1c.ru/v8/tech-log">
    <log location="c:\v8\logs" history="1">
   <event>
    <eq property="name" value="sdbl"/>
   </event>
   <event>
    <eq property="name" value="dbmssql"/>
   </event>
   <property name="context">
   </property>
    </log>
</config>

Чтобы записывать события SDBL (SDBL-запросы) и DBMSSQL (операторы SQL к СУБД MS SQL Server) без контекста исполнения, файл настройки технологического журнала нужно заполнить следующим образом:

<config xmlns="http://v8.1c.ru/v8/tech-log">
    <log location="c:\v8\logs" history="1">
   <event>
    <eq property="name" value="sdbl"/>
   </event>
   <event>
    <eq property="name" value="dbmssql"/>
   </event>
    </log>
</config>

Чтобы записывать события SDBL (SDBL-запросы) и DBMSSQL (операторы SQL к СУБД MS SQL Server) без контекста исполнения, но со всеми другими свойствами, файл настроек должен содержать:

<config xmlns="http://v8.1c.ru/v8/tech-log">
    <log location="c:\v8\logs" history="1">
   <event>
    <eq property="name" value="sdbl"/>
   </event>
   <event>
    <eq property="name" value="dbmssql"/>
   </event>
   <property name="context">
    <event>
     <eq property="name" value=""/>
    <event>
   </property>
   <property name="all">
   </property>
    </log>
</config>

Для того чтобы записывать события SDBL (SDBL-запросы) с контекстом исполнения и DBMSSQL (операторы SQL к СУБД MS SQL Server) без контекста исполнения, содержимое файла настройки должно иметь следующий вид:

<config xmlns="http://v8.1c.ru/v8/tech-log">
    <log location="c:\v8\logs" history="1">
   <event>
    <eq property="name" value="sdbl "/>
   </event>
   <event>
    <eq property="name" value="dbmssql"/>
   </event>
   <property name="context">
    <event>
     <eq property="name" value="sdbl"/>
    </event>
   </property>
    </log>
</config>

Наличие элемента <property name="Context"> означает, что для записываемых в журнал событий при выполнении условий, указанных в данном элементе, будет записана информация о контексте. После этого в каждое событие технологического журнала будет добавлена информация о контексте исполнения в текущем процессе, а после события будет добавлено мгновенное событие, несущее информацию о контексте исполнения клиентского процесса.

В технологический журнал могут быть записаны сообщения об исключительных ситуациях, связанных с менеджером блокировок. Для этого файл конфигурации должен иметь примерно следующий вид:

<config xmlns="http://v8.1c.ru/v8/tech-log">
    <log location="c:\v8\logs" history="7">
   <event>
    <eq property="name" value="excp"/>
   </event>
   <event>
    <eq property="name" value="tlock"/>
    <gt property="duration" value="100000"/>
   </event>
   <property name="all"/>
   <property name="context">
    <event>
     <eq property="name" value=""/>
    </event>
   </property>
    </log>
    <dump location="c:\v8\dumps" create="1" type="2"/>
</config>

В приведенном примере будут регистрироваться все исключительные ситуации, связанные с блокировками (в частности, DEADLOCK ‑ взаимные блокировки соединений и TIMEOUT ‑ истечение предопределенного времени, при этом в обоих случаях в текст сообщения об исключительной ситуации включается номер соединения, которое вызвало эту исключительную ситуацию), и ожидания, превысившие 10 секунд. При этом будет записана информация по всем свойствам, кроме Context.

Каждое событие технологического журнала относится к тому или иному уровню:

Свойство Func может принимать следующие значения: