Секция [accountSystem]

Настройки первичной ресурсной системы.

Имя настройки

Обязательность наличия

Описание

type

Да

Тип ресурсной системы.

В текущей версии поддерживаются только значения: «FreeIPA», «AD», «SambaAD»

name

Нет

Имя ресурсной системы, которое используется внутри JMS. Применяется для идентификации ресурсной системы, например, при аутентификации пользователя.

По умолчанию – значение параметра «type».

Примечание. Если в конфигурационном файле опущен параметр «name», то при аутентификации пользователя в качестве префикса (доменной части имени) следует указывать значение, заданное в параметре «type». Например, если type=FreeIPA, то в качестве логина пользователя admin следует указать «FreeIPA\admin».

Если же параметр «name» указан явно (например «DirectoryAlias»), то в качестве доменной части имени пользователя следует указать это значение, например «DirectoryAlias\admin»

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

·          для AD и SambaAD: netbios-имени домена. Например для домена aladdin.local и пользователя admin допускается ввести значение aladdin\admin

·          для FreeIPA: полное (FQDN) имя домена. Например для домена astratest.local и пользователя admin допускается ввести значение astratest.local\admin

description

Нет

Описание ресурсной системы, которое используется внутри JMS.

По умолчанию – «».

serverAddress

Да

Адрес (адреса) сервера (серверов) ресурсной системы.

Для отказоустойчивости можно указать несколько адресов контроллеров домена, разделенные «;»

Например: serverAddress=dc1.fqdn1.com;dc2.fqdn1.com

serverPort

Да

Порт сервера ресурсной системы. При использовании Samba AD или AD c SSL порт сервера по умолчанию – 636, без SSL – 389. Для FreeIPA – 389.

useSsl

Нет

Определяет, будет ли использоваться SSL при подключении к ресурсной системе. На данный момент актуально только для Samba AD и AD. Подробнее см. в разделе «Настройка SSL для доступа к ресурсной системе», с. 65.

По умолчанию – «false».

container

Да

Контейнер, который будет считаться корневым для ресурсной системы.

userName

Да

Имя пользователя, от имени которого сервер JMS осуществляет доступ к ресурсной системе.

Для FreeIPA необходимо задавать полное Distinguished Name (DN) пользователя, например

userName=uid=admin,cn=users,cn=accounts,dc=aladdin,dc=local

Для AD и Samba AD необходимо задавать имя с префиксом в виде netBIOSName домена.

Например для домена “fqdn5.com” и пользователя “Administrator” следует указать userName=FQDN5\Administrator

password

Да

Пароль пользователя.

disabledContainers

Нет

Список имён контейнеров ресурсной системы разделённых запятыми, которые должны быть проигнорированы JMS. Актуально для Samba AD.

По умолчанию – «».

Пример – «Program Data,System,Application».

mapping

Нет

Определяет, будет ли использоваться маппинг идентификаторов для контейнеров в РС (true\false). Актуально только при использовании FreeIPA.

По умолчанию – «true».

attributes

Нет

Наименования регистрируемых атрибутов РС, перечисленные через запятую (к примеру, «sn,ou,givenName»).

Для регистрации всех поддерживаемых атрибутов РС следует указать «*»

По умолчанию – «*»

workstationAttributes

Нет

Наименования регистрируемых атрибутов рабочих станций ресурсной системы, перечисленные через запятую (к примеру, «sn,ou,givenName»).

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

По умолчанию – «*».

referralChasing

 

Нет

Настройка взаимодействия с ресурсными системами (LDAP и т.п.).

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

По умолчанию – «true».

keytabpath

Нет

Путь к keytab файлу для Kerberos-аутентификации.

Секция [database]

Настройки базы данных JMS.

Имя настройки

Обязательность наличия

Описание

type

Да

Тип СУБД.

Поддерживаемые значения:

·   PostgreSQL

·   MSSQL

·   JatobaSQL

serverAddress

Да

Адрес сервера БД

serverPort

Да

Порт сервера БД

databaseName

Да

Имя создаваемой БД

databaseLogin

Да

Имя пользователя, которое будет использоваться сервером JMS для доступа с создаваемой БД

databasePassword

Да

Пароль пользователя

encryptDatabaseConnection

Нет

Указывает, необходимо ли использовать защищенное SSL-соединение для подключения сервера JMS к БД.

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

Примечание. Для СУБД PostgreSQL и MSSQL значение false не означает, что будет использоваться незащищенное соединение: в этом случае SSL-подключение будет устанавливаться, если того требуют настройки СУБД. Значение true делает установку безопасного подключения обязательным.

serverLogin

Нет

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

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

serverPassword

Нет

Пароль пользователя для мастера развертывания. Не используется в режиме развертывания без наличия административных прав на СУБД.

encryptServerConnection

Нет

Указывает, необходимо ли использовать защищенное SSL-соединение при развертывании.

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

isCivic

Нет

Флаг, отвечающий за режим работы с КН SF/ГОСТ (по умолчанию “true”, т.е. гражданский режим)

Секция [licenses]

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

Имя настройки

Обязательность наличия

Описание

path

Да

Имя файла лицензии, включая полный путь к нему.

Например. /opt/licenses/EAP.lic

Секция [primaryUser]

Параметры создания первичного пользователя JMS.

Имя настройки

Обязательность наличия

Описание

accountName

Да

Имя аккаунта пользователя в первичной ресурсной системе.

На основе этого аккаунта в JMS будет создан первый пользователь с административными правами.

Секция [service]

Настройки сервиса JMS.

Имя настройки

Обязательность наличия

Описание

execPath

Да

Путь до исполняемого файла сервера JMS.

integrationManagerUrls

Нет

Адреса Admin WebAPI: административного API.

Можно задать несколько адресов через «;». Для возможности использования API извне, один из адресов должен содержать внешний URL, либо с IP сервера, либо с его доменным именем.

Например, «http://localhost:8120;http://192.168.2.202:8120», если машина с сервером JMS имеет IP 192.168.2.202.

Значение по умолчанию: http://*:8120

controlManagerUrls

Нет

Адреса Control WebAPI, используемого агентом сервера.

Можно задать несколько адресов через «;».

Значение по умолчанию: http://localhost:8119

authenticationManagerUrls

Нет

Адреса для Auth WebAPI: общей точки аутентификации для других API.

Можно задать несколько адресов через «;».

Значение по умолчанию: http://*:8121

clientManagerUrls

Нет

Адреса для Client WebAPI: клиентского API.

Можно задать несколько адресов через «;».

Значение по умолчанию: http://*:8122

autoStart

Нет

Отвечает за включение/отключение автостарта сервиса сервера JMS. Например, при перезагрузке системы.

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

culture

Нет

Язык, который будет использован при инициализации. Это же значение будет установлено в настройку «Culture» секции «Engine» файла конфигурации сервера JMS.

Допустимые значения: «en», «ru».

Значение по умолчанию: «ru».

Секция [sts]

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

Имя настройки

Обязательность наличия

Описание

certificateThumbprint

Да

Отпечаток, по которому будет производиться поиск сертификата для подписи JWT токенов. Поиск производится в хранилище CurrentUser\My.

Примечание. Если сертификат не используется (не зарегистрирован в ОС, см. раздел 5.1, с. 17), то параметр следует указать с пустым значением:

certificateThumbprint=

Секции [userProperty]

Секции userProperty (их может быть несколько) являются опциональными и позволяют задать набор дополнительных редактируемых атрибутов пользователей JMS.

Имя каждой секции должно содержать уникальный код атрибута и задаваться в формате [userProperty:<код_атрибута>]. Например, чтобы добавить атрибут с кодом jmsCustom1, нужно добавить в файл следующую секцию:

[userProperty:jmsCustom1]
 
description=Custom Property #1
 
type=string
 
default=Default string value
 
minLength=0
 
maxLength=99

Имя настройки

Обязательность наличия

Описание

accountSystem

Нет

Имя ресурсной системы, в которую необходимо добавить атрибут.

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

description

Нет

Описание атрибута.

При отсутствии значения в качестве описания используется код атрибута.

type

Нет

Тип атрибута.

Допустимые значения:

·   string  (значение по умолчанию)

·   number

default

Нет

Начальное значение атрибута

minLength

Нет

Минимальная количество символов в значении атрибута.

Для типа number ограничивает количество цифр в значении.

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

maxLength

Нет

Максимальное количество символов в значении атрибута.

Для типа number ограничивает количество цифр в значении.

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

Секции [wsProperty]

Секции wsProperty (их может быть несколько) являются опциональными и позволяют задать набор дополнительных редактируемых атрибутов рабочих станций JMS.

Имя каждой секции должно содержать уникальный код атрибута и задаваться в формате [wsProperty:<код_атрибута>]. Например, чтобы добавить атрибут с кодом jmsCustom1, нужно добавить в файл следующую секцию:

[wsProperty:jmsCustom1]
 
description=Custom Property #1
 
type=string
 
default=Default string value
 
minLength=0
 
maxLength=99

Имя настройки

Обязательность наличия

Описание

accountSystem

Нет

Имя ресурсной системы, в которую необходимо добавить атрибут.

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

description

Нет

Описание атрибута.

При отсутствии значения в качестве описания используется код атрибута.

type

Нет

Тип атрибута.

Допустимые значения:

·   string  (значение по умолчанию)

·   number

default

Нет

Начальное значение атрибута

minLength

Нет

Минимальная количество символов в значении атрибута.

Для типа number ограничивает количество цифр в значении.

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

maxLength

Нет

Максимальное количество символов в значении атрибута.

Для типа number ограничивает количество цифр в значении.

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