Wiki [3.x] product:settings:system

Общая информация о системе

anonymous@undisclosed.example.com (Anonymous) — Mon, 20 Oct 2025 14:06:35 +0000

Общая информация о системе

Архитектура системы

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

В качестве системы управления базой данных (БД) на сервере может использоваться MS SQL Server или PostgreSQL.

Рис. 1.1. – Логическое представление системы

Рис. 1.2. – Физическое представление системы

Общие требования

Для установки и корректной работы системы ADVANTA необходимо иметь:

сервер приложения с постоянным IP адресом, где будет установлено ПО;
доступ к серверу приложения со всех рабочих станций по порту, на котором планируется открыть доступ в систему;
сервер электронной почты (SMTP-сервер), доступный с сервера приложения;
персональный адрес электронной почты для каждого пользователя системы;
обращение к Cистеме должно выполняться по протоколу HTTPS.

Поддерживаемые Операционные системы

Для клиентского рабочего места

Любые ОС персональных ПК и мобильных устройств, в которых могут быть запущены последние версии современных браузеров - Chrome, Яндекс.Браузер, Edge, Firefox, Safari

Для работы с кросс-платформенной версией системы ADVANTA 4.00 в настоящее время обеспечивается поддержка только браузеров, построенных на базе «движка» Chromium: Chrome, Яндекс.Браузер, Edge

Для сервера баз данных

MS Windows Server
Любые версии ОС Linux, поддерживающие развертывание СУБД PostgreSQL или MS SQL Server

Для сервера приложений

MS Windows Server
ОС Linux (в beta-версии сервера приложений ADVANTA 4.0). После завершения перевода системы ADVANTA на кроссплатформенную реализацию, будет обеспечена работа сервера приложений на ОС Linux - в дистрибутивах Astra Linux Server или других дистрибутивах на основе семейства Debian.

В последующем, список официально поддерживаемых дистрибутивов ОС Linux для развертывания сервера приложений ADVANTA будет расширяться.

Руководство по настройке интеграции с Active Directory

anonymous@undisclosed.example.com (Anonymous) — Tue, 09 Dec 2025 08:06:52 +0000

Руководство по настройке интеграции с Active Directory

Текущая инструкция актуальна для версии ADVANTA 3.20 и выше.

Инструкция по настройке Active Directory для ADVANTA 3.19 и более ранних версий продукта.

О том, как изменить настройки после обновления системы с 3.19 на 3.20 см. на странице описания обновления 3.20.

Один домен

Общая информация

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

Интеграционное решение ориентировано на компоненты Active Directory:

Служба федерации Active Directory (AD FS).
Служба каталогов Active Directory; доступ к ней осуществляется по LDAP.

Службы федерации Active Directory используются для аутентификации пользователей. AD FS позволяет использовать технологию единого входа (SSO). В нашем случае важно, что AD FS использует Встроенную Аутентификацию Windows, что позволяет входить в систему без ввода логина и пароля (требует настройки в IE и Firefox). Если пользователи будут использовать AD FS только находясь в домене, то не обязательно делать эту службу доступной во внешнюю сеть.

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

Важно!

Чтобы использовать интеграцию с Active Directory, обращение к системе Адванта должно выполняться по протоколу https.

Установка службы федерации Active Directory (в домене клиента, AD FS)

Важно!

Сервер со службой федерации Active Directory (AD FS) должен находиться в домене на сервере клиента. При этом можно установить службу на сервер с контроллером домена (AD), однако служба технической поддержки компании Microsoft не рекомендует производить подобные установки: службы AD и ADFS должны быть размещены на различных хостах (ВМ). При этом сервер IIS может находиться как на сервере (клиента) внутри доменной сети, так и на внешнем хостинге.

Windows Server 2008R2

Установите IIS – инструкция по установке.
Запустите файл установки службы федерации Active Directory 2.0. Скачать можете здесь.
Откроется мастер установки AD FS 2.0 → «Далее».
На шаге «Лицензионное соглашение» поставить чек-бокс «Я принимаю условия лицензионного соглашения» → «Далее».
На шаге «Роль сервера» выберите роль «Сервер федерации» → «Далее».
На шаге «Установка необходимого программного обеспечения» мастер установки автоматически проверит наличие необходимых для службы федерации компонентов. → «Далее».
После завершения работы мастера поставьте чек-бокс «Когда мастер закроется, запустить оснастку управления AD FS 2.0» для дальнейшей настройки службы. → «Готово».

Windows Server 2019

Откройте «Диспетчер серверов».
Управление → Добавить роли и компоненты
На шаге «Перед началом работы» (если такой появится) → «Далее».
На шаге «Тип установки» выберите «Установка ролей и компонентов» → «Далее».
На шаге «Выбор сервера» выберите сервер, на котором будет установлена служба федерации Active Directory → «Далее».
На шаге «Роли сервера» поставьте чек-бокс напротив роли «Службы федерации Active Directory».
Мастер добавления ролей и компонентов предложит добавить компоненты, необходимые для Службы федерации Active Directory. → «Добавить компоненты» → «Далее»
Шаг «Компоненты» остаётся без изменений → «Далее».
На шаге «Службы федерации Active Directory (AD FS)» → «Далее».
В промежуточном шаге «Службы ролей» должен быть активен чек-бокс «Служба федерации» → «Далее».
В промежуточном шаге «Службы ролей» ничего не меняйте → «Далее».
На шаге «Подтверждение» → «Установить».
После установки необходимых компонентов закройте мастер установки.

Начальная настройка AD FS

Этап 1. В диспетчере служб IIS

Установите сертификат в Доверенные корневые центры сертификации через сервер ADFS или на сервере IIS.

Если IIS установлен, то сделать это можно так:

Запустите Диспетчер служб IIS.
Выберите локальный сервер.
На начальной странице локального сервера → меню «Сертификаты сервера».
На странице «Сертификаты сервера»:
1. добавьте сертификат:
  - либо заверенный, купленный у вендора,
  - либо созданный в центре сертификации AD CS (если эта служба установлена).
    Использовать самозаверенный сертификат не рекомендуется.
    Для каждого пользователя, который заходит через AD будет предупреждение в браузере. Во многих браузерах чтобы продолжить работу с таким сертификатом, надо проделать определенные действия, например, добавить сайт в исключения, что многим пользователям будет не под силу.
2. В поле «Понятное имя сертификата» впишите имя, например: ADFS_Certificate
3. В разделе «Выбрать хранилище сертификата для нового сертификата:» → «Личный».
4. Закройте Диспетчер служб IIS.

Этап 2. Настройка на сервере

Windows Server 2008R2: После установки AD FS 2.0 оснастка управления должна была запуститься автоматически.
Если этого не произошло, запустите оснастку вручную: Пуск → Все программы → Администрирование → Управление AD FS 2.0.

Windows Server 2019: В диспетчере серверов нажмите на значок уведомлений (флаг с восклицательным знаком в треугольнике) → в окне «Конфигурация после развертывания» клик на «Запустить оснастку управления AD FS».

В открывшейся оснастке → «Мастер настройки сервера федерации AD FS».
На шаге «Добро пожаловать!» включите чек-бокс «Создать службу федерации» → «Далее».
На шаге «Выберите тип развертывания» → «Изолированный сервер федерации» → «Далее».
На шаге «Имя службы федерации» можно выбрать SSL-сертификат для веб-сайта.
Т.к. ранее при настройках создавался только один сертификат (ADFS_Certificate), он подставится по умолчанию, без права выбора сертификатов.
Если сертификатов больше, выберите нужный.
→ «Далее».
На шаге «Сводка» мастер настройки покажет, какие параметры будут настроены для служб AD FS. → «Далее» → «Закрыть»
Если оснастка AD FS закрылась, запустите её заново.
В оснастке управления AD FS клик по ссылке «Обязательно: добавьте доверенную проверяющую сторону» → «Запустить».
На шаге «Выберите источник данных» включите чек-бокс «Ввод данных о проверяющей стороне вручную» → «Далее».
На шаге «Укажите отображаемое имя», в поле «Отображаемое имя:» введите имя для проверяющей стороны (например: advanta), и, при необходимости, любые примечания. → «Далее».
На шаге «Выберите профиль» установите значение напротив пункта «Профиль AD FS». → «Далее».
На шаге «Настройте сертификат» можно указать дополнительный сертификат шифрования маркера, если это необходимо. → «Далее».
На шаге «Настройте URL-адрес»:
- включите чек-бокс «Включить поддержку пассивного протокола WS-Federation»,
- в поле «URL-адрес пассивного протокола WS-Federation проверяющей стороны» введите адрес страницы ADFS_Login.aspx в вашей системе (например: https://your.system.ru/streamline/ADFS_Login.aspx).
  → «Далее».
На шаге «Настройте идентификаторы» в поле «Идентификатор отношения доверия проверяющей стороны:» введите адрес вашей системы (например: https://your.system.ru/streamline). → «Далее».
На шаге «Выберите правила авторизации выдачи» → «Разрешить доступ к этой проверяющей стороне всем пользователям».
Или, после настройки мастера, настройте конкретных пользователей. → «Далее».
На шаге «Готовность для добавления отношения доверия» можете проверить все настройки и нажмите «Далее».
На шаге «Готово» включите чек-бокс «Открыть диалоговое окно «Изменение правил утверждений» для этого отношения доверия проверяющей стороны после закрытия мастера» → «Закрыть».
Откроется окно «Изменение правил утверждений для advanta (отображаемое имя, которое вы ввели ранее)».
1. На вкладке «Правило Преобразования выдачи» → «Добавить правило…».
2. В мастере добавления правила преобразования утверждения:
  1. на шаге «Выберите тип правила», выберите шаблон правила утверждения: «Отправка утверждений с помощью настраиваемого правила». → «Далее».
  2. на шаге «Настройте правило утверждения»:
    - в поле «Имя правила утверждения:» введите имя: sid;
    - В поле «Настраиваемое правило:» введите правило: c:[Type == "http://schemas.microsoft.com/ws/2008/06/identity/claims/primarysid"]=>issue(claim = c); (копировать вместе со знаком ;)
    - → «Готово».
После этого снова появится окно «Изменение правил утверждений для advanta» → «ОК».

Настройка службы каталогов Active Directory на сервере с установленной Адвантой (сервер IIS)

Прежде чем приступать к настройкам, проверьте наличие/добавьте на сервер приложения файл ADFS_Login.aspx в корень приложения.

Службы каталогов AD должны быть доступны для сервера IIS по LDAP. Для системы «Адванта» настройка службы выполняется в конфигурационных файлах, находящимися в папке с веб-контентом системы.

Настройки интеграции со службой AD FS

Только для Windows Server 2008R2

На сервере службы федерации в IIS перейти к сайту AD FS: Сайты –> Default Web Site –> AD FS → ls . Данный пункт актуален только для старых версий AD FS, начиная с версии службы федерации 3.0 в Windows Server 2012, IIS на сервер со службой федерации устанавливать необходимости нет.
На странице сайта раздел «Проверка подлинности» → включить компонент «Проверка подлинности Windows».
Перейти в дополнительные параметры данного компонента → в настройке «Расширенная защита» установить «Выключена».

для настройки ADFS нужно указать два параметра в client.config в секции <appSettings>:

<add key="AdfsRealm" value="https://system.a2test.local/streamline" />	Где `a2test` – название домена вашей инсталляции ADVANTA. Идентификатор проверяющей стороны, берется из оснастки ADFS «Отношение доверия/Отношение доверия проверяющей стороны/Идентификатор проверяющей стороны»
<add key="AdfsIssuer" value="https://adfs.a2test.local" />	Где `a2test` – название домена вашей инсталляции ADVANTA. Адрес сервиса ADFS

Также есть три дополнительных параметра:

AdfsShowPII – режим отображения персональной пользовательской информации в сообщениях об ошибках подключения к AD FS
```
<add key="AdfsShowPII" value="false" />
```
- значение по умолчанию (или если параметр не указан) false – информация, позволяющая идентифицировать пользователя, будет скрыта в сообщениях об ошибках
- при установке значения в true – в сообщении об ошибке подключения будут отображаться идентификационные данные. Используется при отладке и поиске проблем подключения к AD FS. В режиме промышленной эксплуатации системы параметр должен быть удален или установлен в значение false!
AdfsMode – режим проверки сертификата
```
<add key="AdfsMode" value="Default" />
```
- по умолчанию значение (или если параметр не указан) Default – строгий режим, который проверяет всю цепочку сертификатов.
- можно задать значение Thumbprint – данный режим применяется, если сертификат самозаверенный. Этот режим проверяет только даты и отпечаток сертификата.
Thumbprint – если в параметре AdfsMode указано значение Thumbprint, в этом случае необходимо указать отпечаток сертификата: оснастка AD FS → Сертификаты (Service communications) → CN=ServerADFS.your.domain.local → Состав → Отпечаток.) При этом обязательно надо указать дополнительный параметр:
```
 <add key="AdfsThumbprint" value="0cafe3b7025e9cfe48f83f5dcdff36122c6fcbb6" /> 
```

Внимание!

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

Настройка LDAP в файле client.config

В главном разделе <configuration> после закрывающего тега </configSections> добавить следующее:

<ldapService ldapPath="LDAP://адрес сервера с AD/" baseDN="база поиска объектов в AD">
  <authenticationTypes>
     <add authenticationType="Secure" />
     <add authenticationType="Signing" />
     <add authenticationType="Sealing" />
   </authenticationTypes>
</ldapService>

ldapPath – адрес службы. Значение по умолчанию (LDAP://) можно использовать, когда сервер приложения находится в домене. Иначе нужно указать действительный адрес службы и порт, если порт отличается от стандартного (389). Например: LDAP://ad.domain.local/
baseDN – базовый DN каталога пользователей.
- Если не указан, то используется дефолтный DN, который определен в самой службе каталогов. Лучше указывать действительный DN. Например:
```
DC=domain,DC=local
```
authenticationTypes – типы аутентификации.
Влияют на защищенность (шифрование и подпись) передаваемых данных.
По умолчанию: Secure, Signing, Sealing.
Если в службе каталогов настроен SSL (требует установки Certification Authority), то нужно указать значение SecureSocketsLayer в authenticationTypes.

В раздел <configSections> добавить тег:

<section name="ldapService" type="Config.LDAPConfigurationSection, smcorelib" />

Если подключение через LDAPS, то при настройке выгрузки через LDAPS необходимо указать протокол LDAP с портом 636. Секция authenticationTypes в client.config должна выглядеть следующим образом:

<ldapService ldapPath="LDAP://адрес сервера с AD:636/" baseDN="база поиска объектов в AD">
<authenticationTypes>
      <add authenticationType="SecureSocketsLayer" />
</authenticationTypes>

Безопасность

Службы федерации и приложение не обмениваются напрямую, только через браузер. Пользователь вводит логин и пароль для доступа к веб-сервисам AD FS, а приложение никогда не получает эти данные. Вместо логина и пароля приложение получает от AD FS утверждения, а именно доменный sid пользователя. Передача утверждений происходит с использованием шифрования. Также утверждения подписываются в AD FS, используя SAML. Доверие приложения к сервису утверждений основано на подписи, которая проверяется по отпечатку сертификата.

Важно использовать заверенный сертификат для веб-сервисов AD FS (этот сертификат устанавливается в IIS). Это не тот сертификат, который используется для подписи и шифрования утверждений.

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

Настройка рабочих станций

Установить сертификат в Доверительные корневые центры сертификации.
Добавить систему в надежные сайты (Свойства браузера → Безопасность → Надежные сайты → Сайты → Добавить сайт https://имя системы в сертификате безопасности → Закрыть).

Настройка интеграции с AD в системе (AD FS)

После выполнения всех настроек, описанных выше, активируйте синхронизацию с AD в системе ADVANTA.

Для этого под учетными данными администратора системы:

перейти в пункт меню «Администрирование» → «Общие настройки» → «Настойки Active Directory»;
в портлете «Настройки связи с Active Directory (с использованием службы ADFS)» установить чек-бокс в «Разрешить проверку учетных данных в Active Directory (с использованием службы ADFS)».

Далее, чтобы в систему можно было заходить под доменными учетными данными пользователей, нужно загрузить этих пользователей из AD. Здесь два варианта:

Загрузка новых пользователей из AD в систему, в настройках Active Directory, после активации синхронизации, появится кнопка «Загрузить из Active Directory». С помощью этой кнопки можно загрузить всех необходимых пользователей в систему. В этом случае в системе создаются новые пользователи с привязкой к доменной учетной записи.
Привязка уже существующего пользователя системы к AD. Для этого, под учетными данными администратора системы, нужно перейти в пункт меню «Команда в лицах» - «Список». Выбрать необходимого пользователя из списка и перейти в карточку редактирования этого пользователя, нажав левой кнопкой мыши по ссылке данного пользователя. В портлете «Учетная запись Active Directory» необходимо нажать кнопку-ссылку «Задать», где можно будет выбрать необходимую доменную учетную запись для привязки пользователя.

Если сервер с системой не включен в домен, при нажатии кнопки «Загрузить из Active Directory» возникнет ошибка подключения к Active Directory. В этом случае необходимо нажать кнопку «учетная запись» и ввести в появившемся окне логин и пароль доменного пользователя. Логин должен вводиться в формате domain\user или user@domain.local.

Если в последующем возникнет потребность протокол авторизации поменять с AD FS на NTLM, необходимо после внесения изменений произвести перезагрузку сервера приложения ADVATNA, чтобы изменения вступили в силу.

Мультидоменность (NTLM)

ВНИМАНИЕ!

Использование зарезервированных символов XML в конфигурационном файле запрещено (& «<'>).

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

Мультидоменность работает по протоколу NTLM.

Настройки на сервере IIS

1. Для авторизации на сервере через AD необходимо установить службу «Windows – проверка подлинности» (Windows Authentication).

Windows Server 2008 R2:

Открыть диспетчер сервера.
Перейти в пункт «Роли».
На вкладке «Службы ролей» нажать на кнопку «Добавить службы ролей».
В пункте «Безопасность» включить пункт «Windows - проверка подлинности».
Нажать «Далее».
«Установить».

Windows Server 2019:

Открыть диспетчер серверов.
«Управление» → «Добавить роли и компоненты».
На шаге «Перед началом работы» нажать «Далее».
На шаге «Тип установки» выбрать «Установка ролей или компонентов» и нажать «Далее».
На шаге «Выбор сервера» выбрать текущий сервер.
Перейти в пункт «Роль веб-сервера(IIS)» → «Службы ролей».
В пункте «Безопасность» включить пункт «проверка подлинности Windows».
Нажать «Далее», затем «Установить».

После установки службы «Windows - проверка подлинности» выполните полный перезапуск сервера с IIS После выполнения перезапуска откройте Диспетчер служб IIS:

Перейти в раздел «Сайты» → Default Web Site (сайт с установленной системой).
Затем перейти в подраздел «Проверка подлинности» (в области просмотра возможностей).
Включить компонент «Проверка подлинности Windows».
Включить компонент «Анонимная проверка подлинности».
Все остальные компоненты выключить, если они включены.

2. Настройка client.config:

добавляем теги в <configuration><configSections>:

<section name="ldapService" type="Config.LDAPConfigurationSection, smcorelib"/>
<section name="adDomains" type="Config.ADDomainsConfiguration, smcorelib"/>

добавляем тег в корень после тега <configSections>:

<adDomains>
  <domains>
    <add name="Имя домена" login="Логин пользователя" password="Пароль" ldappath="LDAP://Адрес LDAP(127.0.0.1:389)" />
  </domains>
</adDomains>

где:

значение «Имя домена» – любое понятное имя домена, которое будет использоваться в дереве при загрузке пользователей из каталога;
значение «Логин пользователя» – логин любого пользователя того домена, от куда будет производиться загрузка пользователей;
значение «Пароль» – пароль пользователя, логин которого использовался в значении «Логин пользователя» (выше);
значение »LDAP://Адрес LDAP« – адрес службы LDAP (например: LDAP://192.168.0.200:389 или LDAP://domain.local:389).

Для добавления нескольких доменов нужно добавить соответствующее количество строк, начинающихся с тега «add name…».

Ссылка на пример файла Client.config с настройками интеграции под NTLM

Настройка рабочих станций

Добавить систему в раздел Местная интрасеть (Свойства браузера → Безопасность → Местная интрасеть → Сайты → Добавить сайт с адресом системы → Закрыть).

Настройка интеграции с AD в системе (NTLM)

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

перейти в пункт меню «Администрирование» → «Общие настройки» → «Настойки Active Directory»;
в портлете «Настройки связи с Active Directory (с использованием NTLM)» поставить чек-бокс напротив «Разрешить проверку учетных данных в Active Directory (с использованием NTLM)» .

Далее, чтобы пользователи могли заходить в систему под своими доменными учетными записями, их нужно загрузить в систему из AD. Здесь два варианта:

Загрузка новых пользователей из AD в систему, в настройках Active Directory, после активации синхронизации, появится кнопка «Загрузить из Active Directory». С помощью этой кнопки можно загрузить всех необходимых пользователей в систему. В этом случае в системе создаются новые пользователи с привязкой к доменной учетной записи.
Привязка уже существующего пользователя системы к AD. Для этого, под учетными данными администратора системы, нужно перейти в пункт меню «Команда в лицах» - «Список». Выбрать необходимого пользователя из списка и перейти в карточку редактирования этого пользователя, нажав левой кнопкой мыши по ссылке данного пользователя. В портлете «Учетная запись Active Directory» необходимо нажать кнопку-ссылку «Задать», где можно будет выбрать необходимую доменную учетную запись для привязки пользователя.

Настройки авторизации

anonymous@undisclosed.example.com (Anonymous) — Thu, 19 Sep 2024 08:44:36 +0000

Настройки авторизации

Начиная с версии системы 3.29 в панели Администрирования в «Общих настройках» появилась возможность настройки авторизации.

При переходе в настройку «Авторизация» открывается новое окно с возможностями настройки. Чтобы изменить настройки, необходимо нажать соответствующую кнопку.

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

Опция «Активировать для новых учетных записей режим запрета авторизации под локальными логином и паролем» включает или отключает по умолчанию для всех новых учетных записей режим авторизации под локальными логином и паролем.

Значение этой настройки копируется в соответствующий параметр новой учетной записи пользователя по умолчанию, портлет «Мои настройки», параметр «Запрещать авторизацию пользователя под локальной учетной записью».

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

При активации опции «Отображать форму окна входа для локальных учетных записей» на окне авторизации будут отображаться поля:

«Имя пользователя»;
«Пароль»;
чекбокс «Запомнить меня»;
функция «Забыли пароль».

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

Также при активации данной опции должна отображаться настройка «Самостоятельная регистрация в системе».

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

Настройка работы системы

anonymous@undisclosed.example.com (Anonymous) — Fri, 17 Oct 2025 08:36:18 +0000

Настройка работы системы

Работа системы на нестандартном порту

По умолчанию система использует 80 порт при работе по протоколу HTTP и 443 по защищенному протоколу HTTPS. В случае необходимости изменения стандартных портов требуется произвести соответствующие изменения с узлом, содержащим приложение streamline:

Перейдите на узел, содержащий каталог streamline (по умолчанию Default Web Site).
В области «Действие» (Actions) нажмите на кнопку «Привязки» (Bindings) (Рисунок 4.1).
Откроется окно с привязками сайта, чтобы изменить стандартный порт веб-узла, выделите его и нажмите на кнопку «Изменить» (Edit) (Рисунок 4.1).

Рисунок 4.1. – Окно настроек привязок сайта
В открывшемся окне «Изменение привязки сайта» (Edit Site Bindings) (Рисунок 4.2), вы можете изменить порт.

Рисунок 4.2. – Окно настройки выбранной привязки

Изменение максимального размера прикрепляемого файла

Ограничение на размер прикрепляемого файла задается в файле httpRuntime.Release.config.
Значение maxRequestLength, размер задается в килобайтах

<?xml version="1.0" encoding="utf-8"?>
<httpRuntime maxRequestLength="102400" requestValidationMode="4.0" requestValidationType="streamline.classes.CustomRequestValidator" />

Изменение максимального размера в системе до версии 3.03.2166.х

Ограничение на размер прикрепляемого файла задается в файле _Web.config_.
Если в качестве сервера приложения используется IIS 6 (ОС Win2003), то для изменения максимального размера прикрепляемого в систему файла укажите значение параметра maxRequestLength. Размер задается в килобайтах. Если в качестве сервера приложения используется IIS 7 (ОС Win2008), то помимо указания значения maxRequestLength добавьте в секцию <system.webServer> текст:

<security>
&nbsp;&nbsp; <requestFiltering>
&nbsp;&nbsp; &nbsp; &nbsp;<requestLimits maxAllowedContentLength="_250000000_" />
&nbsp;&nbsp; </requestFiltering>
</security>

Делегирование прав администратора при наличии только одной лицензии администратора

Зайти в систему под текущим администратором
В профиле администратора убрать флажок «Администратор»

Выполнить скрипт на базе данных системы:

UPDATE DBO.Security_Principals
SET IsAdmin ='True'
WHERE Username = 'admin'

Username – логин пользователя, которому назначаются права администратора

Подготовка пользовательских станций

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

Для интегратора под версии системы 1.7.9.0 и выше: Установить .NET Framework 3.5 SP1. Файл библиотеки можно найти в поставляемом вместе с Адвантой дистрибутиве, или скачать с сайта Microsoft.
При использовании MS Project 2003¹⁾: Установить набор пакета обновлений KB908002.
- extensibilityMSM.msi;
- lockbackRegKey.msi;
- office2003-kb907417sfxcab-ENU.exe.
Установить интегратор – пакет MSProjectAddin или MSProjectAddin64 (для 64-х битных версий MS Project).
Добавить идентификатор плагина MS Project в конфигурационный файл Системы client.config, чтобы при фильтрации внешних приложений был разрешен вход в Систему. Пример:
```
<add key="AllowedExternalApplicationClientIds" value="MSProjectPlugin" />
```
Перезагрузить компьютер.

Настройка MS Project 2003, 2007 – если при загрузке Project'a не появилось панели «Адванта» («А2» для старой версии интегратора) то:

Зайти в меню «Вид».
Выбрать подменю «Панель инструментов» и отметить галочкой пункт «Адванта» («А2» для старой версии интегратора).

Настройка MS Project 2010 – если при загрузке Project'a не появилось вкладки «Надстройки» с панелью «Адванта» («А2» для старой версии интегратора) на ней то:

Зайти в меню «Файл».
Выбрать пункт «Параметры».
Выбрать пункт «Надстройки».
Проверить что значение «Streamline Connection Addin» находится в активных надстройках, если нет, то добавить его.

Руководство по настройке интеграции с Active Directory

Текущая инструкция актуальна для версии ADVANTA 3.20 и выше.

Инструкция по настройке Active Directory для ADVANTA 3.19 и более ранних версий продукта.

О том, как изменить настройки после обновления системы с 3.19 на 3.20 см. на странице описания обновления 3.20.

Один домен

Общая информация

Интеграционное решение ориентировано на компоненты Active Directory:

Служба федерации Active Directory (AD FS).
Служба каталогов Active Directory; доступ к ней осуществляется по LDAP.

Важно!

Чтобы использовать интеграцию с Active Directory, обращение к системе Адванта должно выполняться по протоколу https.

Установка службы федерации Active Directory (в домене клиента, AD FS)

Важно!

Windows Server 2008R2

Установите IIS – инструкция по установке.
Запустите файл установки службы федерации Active Directory 2.0. Скачать можете здесь.
Откроется мастер установки AD FS 2.0 → «Далее».
На шаге «Лицензионное соглашение» поставить чек-бокс «Я принимаю условия лицензионного соглашения» → «Далее».
На шаге «Роль сервера» выберите роль «Сервер федерации» → «Далее».
На шаге «Установка необходимого программного обеспечения» мастер установки автоматически проверит наличие необходимых для службы федерации компонентов. → «Далее».
После завершения работы мастера поставьте чек-бокс «Когда мастер закроется, запустить оснастку управления AD FS 2.0» для дальнейшей настройки службы. → «Готово».

Windows Server 2019

Откройте «Диспетчер серверов».
Управление → Добавить роли и компоненты
На шаге «Перед началом работы» (если такой появится) → «Далее».
На шаге «Тип установки» выберите «Установка ролей и компонентов» → «Далее».
На шаге «Выбор сервера» выберите сервер, на котором будет установлена служба федерации Active Directory → «Далее».
На шаге «Роли сервера» поставьте чек-бокс напротив роли «Службы федерации Active Directory».
Мастер добавления ролей и компонентов предложит добавить компоненты, необходимые для Службы федерации Active Directory. → «Добавить компоненты» → «Далее»
Шаг «Компоненты» остаётся без изменений → «Далее».
На шаге «Службы федерации Active Directory (AD FS)» → «Далее».
В промежуточном шаге «Службы ролей» должен быть активен чек-бокс «Служба федерации» → «Далее».
В промежуточном шаге «Службы ролей» ничего не меняйте → «Далее».
На шаге «Подтверждение» → «Установить».
После установки необходимых компонентов закройте мастер установки.

Начальная настройка AD FS

Этап 1. В диспетчере служб IIS

Установите сертификат в Доверенные корневые центры сертификации через сервер ADFS или на сервере IIS.

Если IIS установлен, то сделать это можно так:

Запустите Диспетчер служб IIS.
Выберите локальный сервер.
На начальной странице локального сервера → меню «Сертификаты сервера».
На странице «Сертификаты сервера»:
1. добавьте сертификат:
  - либо заверенный, купленный у вендора,
  - либо созданный в центре сертификации AD CS (если эта служба установлена).
    Использовать самозаверенный сертификат не рекомендуется.
    Для каждого пользователя, который заходит через AD будет предупреждение в браузере. Во многих браузерах чтобы продолжить работу с таким сертификатом, надо проделать определенные действия, например, добавить сайт в исключения, что многим пользователям будет не под силу.
2. В поле «Понятное имя сертификата» впишите имя, например: ADFS_Certificate
3. В разделе «Выбрать хранилище сертификата для нового сертификата:» → «Личный».
4. Закройте Диспетчер служб IIS.

Этап 2. Настройка на сервере

В открывшейся оснастке → «Мастер настройки сервера федерации AD FS».
На шаге «Добро пожаловать!» включите чек-бокс «Создать службу федерации» → «Далее».
На шаге «Выберите тип развертывания» → «Изолированный сервер федерации» → «Далее».
На шаге «Имя службы федерации» можно выбрать SSL-сертификат для веб-сайта.
Т.к. ранее при настройках создавался только один сертификат (ADFS_Certificate), он подставится по умолчанию, без права выбора сертификатов.
Если сертификатов больше, выберите нужный.
→ «Далее».
На шаге «Сводка» мастер настройки покажет, какие параметры будут настроены для служб AD FS. → «Далее» → «Закрыть»
Если оснастка AD FS закрылась, запустите её заново.
В оснастке управления AD FS клик по ссылке «Обязательно: добавьте доверенную проверяющую сторону» → «Запустить».
На шаге «Выберите источник данных» включите чек-бокс «Ввод данных о проверяющей стороне вручную» → «Далее».
На шаге «Укажите отображаемое имя», в поле «Отображаемое имя:» введите имя для проверяющей стороны (например: advanta), и, при необходимости, любые примечания. → «Далее».
На шаге «Выберите профиль» установите значение напротив пункта «Профиль AD FS». → «Далее».
На шаге «Настройте сертификат» можно указать дополнительный сертификат шифрования маркера, если это необходимо. → «Далее».
На шаге «Настройте URL-адрес»:
- включите чек-бокс «Включить поддержку пассивного протокола WS-Federation»,
- в поле «URL-адрес пассивного протокола WS-Federation проверяющей стороны» введите адрес страницы ADFS_Login.aspx в вашей системе (например: https://your.system.ru/streamline/ADFS_Login.aspx).
  → «Далее».
На шаге «Настройте идентификаторы» в поле «Идентификатор отношения доверия проверяющей стороны:» введите адрес вашей системы (например: https://your.system.ru/streamline). → «Далее».
На шаге «Выберите правила авторизации выдачи» → «Разрешить доступ к этой проверяющей стороне всем пользователям».
Или, после настройки мастера, настройте конкретных пользователей. → «Далее».
На шаге «Готовность для добавления отношения доверия» можете проверить все настройки и нажмите «Далее».
На шаге «Готово» включите чек-бокс «Открыть диалоговое окно «Изменение правил утверждений» для этого отношения доверия проверяющей стороны после закрытия мастера» → «Закрыть».
Откроется окно «Изменение правил утверждений для advanta (отображаемое имя, которое вы ввели ранее)».
1. На вкладке «Правило Преобразования выдачи» → «Добавить правило…».
2. В мастере добавления правила преобразования утверждения:
  1. на шаге «Выберите тип правила», выберите шаблон правила утверждения: «Отправка утверждений с помощью настраиваемого правила». → «Далее».
  2. на шаге «Настройте правило утверждения»:
    - в поле «Имя правила утверждения:» введите имя: sid;
    - В поле «Настраиваемое правило:» введите правило: c:[Type == "http://schemas.microsoft.com/ws/2008/06/identity/claims/primarysid"]=>issue(claim = c); (копировать вместе со знаком ;)
    - → «Готово».
После этого снова появится окно «Изменение правил утверждений для advanta» → «ОК».

Настройка службы каталогов Active Directory на сервере с установленной Адвантой (сервер IIS)

Настройки интеграции со службой AD FS

Только для Windows Server 2008R2

На сервере службы федерации в IIS перейти к сайту AD FS: Сайты –> Default Web Site –> AD FS → ls . Данный пункт актуален только для старых версий AD FS, начиная с версии службы федерации 3.0 в Windows Server 2012, IIS на сервер со службой федерации устанавливать необходимости нет.
На странице сайта раздел «Проверка подлинности» → включить компонент «Проверка подлинности Windows».
Перейти в дополнительные параметры данного компонента → в настройке «Расширенная защита» установить «Выключена».

для настройки ADFS нужно указать два параметра в client.config в секции <appSettings>:

<add key="AdfsRealm" value="https://system.a2test.local/streamline" />	Где `a2test` – название домена вашей инсталляции ADVANTA. Идентификатор проверяющей стороны, берется из оснастки ADFS «Отношение доверия/Отношение доверия проверяющей стороны/Идентификатор проверяющей стороны»
<add key="AdfsIssuer" value="https://adfs.a2test.local" />	Где `a2test` – название домена вашей инсталляции ADVANTA. Адрес сервиса ADFS

Также есть три дополнительных параметра:

AdfsShowPII – режим отображения персональной пользовательской информации в сообщениях об ошибках подключения к AD FS
```
<add key="AdfsShowPII" value="false" />
```
- значение по умолчанию (или если параметр не указан) false – информация, позволяющая идентифицировать пользователя, будет скрыта в сообщениях об ошибках
- при установке значения в true – в сообщении об ошибке подключения будут отображаться идентификационные данные. Используется при отладке и поиске проблем подключения к AD FS. В режиме промышленной эксплуатации системы параметр должен быть удален или установлен в значение false!
AdfsMode – режим проверки сертификата
```
<add key="AdfsMode" value="Default" />
```
- по умолчанию значение (или если параметр не указан) Default – строгий режим, который проверяет всю цепочку сертификатов.
- можно задать значение Thumbprint – данный режим применяется, если сертификат самозаверенный. Этот режим проверяет только даты и отпечаток сертификата.
Thumbprint – если в параметре AdfsMode указано значение Thumbprint, в этом случае необходимо указать отпечаток сертификата: оснастка AD FS → Сертификаты (Service communications) → CN=ServerADFS.your.domain.local → Состав → Отпечаток.) При этом обязательно надо указать дополнительный параметр:
```
 <add key="AdfsThumbprint" value="0cafe3b7025e9cfe48f83f5dcdff36122c6fcbb6" /> 
```

Внимание!

Настройка LDAP в файле client.config

В главном разделе <configuration> после закрывающего тега </configSections> добавить следующее:

<ldapService ldapPath="LDAP://адрес сервера с AD/" baseDN="база поиска объектов в AD">
  <authenticationTypes>
     <add authenticationType="Secure" />
     <add authenticationType="Signing" />
     <add authenticationType="Sealing" />
   </authenticationTypes>
</ldapService>

ldapPath – адрес службы. Значение по умолчанию (LDAP://) можно использовать, когда сервер приложения находится в домене. Иначе нужно указать действительный адрес службы и порт, если порт отличается от стандартного (389). Например: LDAP://ad.domain.local/
baseDN – базовый DN каталога пользователей.
- Если не указан, то используется дефолтный DN, который определен в самой службе каталогов. Лучше указывать действительный DN. Например:
```
DC=domain,DC=local
```
authenticationTypes – типы аутентификации.
Влияют на защищенность (шифрование и подпись) передаваемых данных.
По умолчанию: Secure, Signing, Sealing.
Если в службе каталогов настроен SSL (требует установки Certification Authority), то нужно указать значение SecureSocketsLayer в authenticationTypes.

В раздел <configSections> добавить тег:

<section name="ldapService" type="Config.LDAPConfigurationSection, smcorelib" />

<ldapService ldapPath="LDAP://адрес сервера с AD:636/" baseDN="база поиска объектов в AD">
<authenticationTypes>
      <add authenticationType="SecureSocketsLayer" />
</authenticationTypes>

Безопасность

Настройка рабочих станций

Установить сертификат в Доверительные корневые центры сертификации.
Добавить систему в надежные сайты (Свойства браузера → Безопасность → Надежные сайты → Сайты → Добавить сайт https://имя системы в сертификате безопасности → Закрыть).

Настройка интеграции с AD в системе (AD FS)

После выполнения всех настроек, описанных выше, активируйте синхронизацию с AD в системе ADVANTA.

Для этого под учетными данными администратора системы:

перейти в пункт меню «Администрирование» → «Общие настройки» → «Настойки Active Directory»;
в портлете «Настройки связи с Active Directory (с использованием службы ADFS)» установить чек-бокс в «Разрешить проверку учетных данных в Active Directory (с использованием службы ADFS)».

Загрузка новых пользователей из AD в систему, в настройках Active Directory, после активации синхронизации, появится кнопка «Загрузить из Active Directory». С помощью этой кнопки можно загрузить всех необходимых пользователей в систему. В этом случае в системе создаются новые пользователи с привязкой к доменной учетной записи.
Привязка уже существующего пользователя системы к AD. Для этого, под учетными данными администратора системы, нужно перейти в пункт меню «Команда в лицах» - «Список». Выбрать необходимого пользователя из списка и перейти в карточку редактирования этого пользователя, нажав левой кнопкой мыши по ссылке данного пользователя. В портлете «Учетная запись Active Directory» необходимо нажать кнопку-ссылку «Задать», где можно будет выбрать необходимую доменную учетную запись для привязки пользователя.

Мультидоменность (NTLM)

ВНИМАНИЕ!

Использование зарезервированных символов XML в конфигурационном файле запрещено (& «<'>).

Мультидоменность работает по протоколу NTLM.

Настройки на сервере IIS

Windows Server 2008 R2:

Открыть диспетчер сервера.
Перейти в пункт «Роли».
На вкладке «Службы ролей» нажать на кнопку «Добавить службы ролей».
В пункте «Безопасность» включить пункт «Windows - проверка подлинности».
Нажать «Далее».
«Установить».

Windows Server 2019:

Открыть диспетчер серверов.
«Управление» → «Добавить роли и компоненты».
На шаге «Перед началом работы» нажать «Далее».
На шаге «Тип установки» выбрать «Установка ролей или компонентов» и нажать «Далее».
На шаге «Выбор сервера» выбрать текущий сервер.
Перейти в пункт «Роль веб-сервера(IIS)» → «Службы ролей».
В пункте «Безопасность» включить пункт «проверка подлинности Windows».
Нажать «Далее», затем «Установить».

Перейти в раздел «Сайты» → Default Web Site (сайт с установленной системой).
Затем перейти в подраздел «Проверка подлинности» (в области просмотра возможностей).
Включить компонент «Проверка подлинности Windows».
Включить компонент «Анонимная проверка подлинности».
Все остальные компоненты выключить, если они включены.

2. Настройка client.config:

добавляем теги в <configuration><configSections>:

<section name="ldapService" type="Config.LDAPConfigurationSection, smcorelib"/>
<section name="adDomains" type="Config.ADDomainsConfiguration, smcorelib"/>

добавляем тег в корень после тега <configSections>:

<adDomains>
  <domains>
    <add name="Имя домена" login="Логин пользователя" password="Пароль" ldappath="LDAP://Адрес LDAP(127.0.0.1:389)" />
  </domains>
</adDomains>

где:

значение «Имя домена» – любое понятное имя домена, которое будет использоваться в дереве при загрузке пользователей из каталога;
значение «Логин пользователя» – логин любого пользователя того домена, от куда будет производиться загрузка пользователей;
значение «Пароль» – пароль пользователя, логин которого использовался в значении «Логин пользователя» (выше);
значение »LDAP://Адрес LDAP« – адрес службы LDAP (например: LDAP://192.168.0.200:389 или LDAP://domain.local:389).

Ссылка на пример файла Client.config с настройками интеграции под NTLM

Настройка рабочих станций

Настройка интеграции с AD в системе (NTLM)

перейти в пункт меню «Администрирование» → «Общие настройки» → «Настойки Active Directory»;
в портлете «Настройки связи с Active Directory (с использованием NTLM)» поставить чек-бокс напротив «Разрешить проверку учетных данных в Active Directory (с использованием NTLM)» .

Загрузка новых пользователей из AD в систему, в настройках Active Directory, после активации синхронизации, появится кнопка «Загрузить из Active Directory». С помощью этой кнопки можно загрузить всех необходимых пользователей в систему. В этом случае в системе создаются новые пользователи с привязкой к доменной учетной записи.
Привязка уже существующего пользователя системы к AD. Для этого, под учетными данными администратора системы, нужно перейти в пункт меню «Команда в лицах» - «Список». Выбрать необходимого пользователя из списка и перейти в карточку редактирования этого пользователя, нажав левой кнопкой мыши по ссылке данного пользователя. В портлете «Учетная запись Active Directory» необходимо нажать кнопку-ссылку «Задать», где можно будет выбрать необходимую доменную учетную запись для привязки пользователя.

Настройка интеграции с Google Calendar

Подробный алгоритм - здесь

Для настройки интеграции необходимы:

Учетная запись в Google.
Для этой учетной записи должен быть доступен сервис Google Search Console и Консоль разработчика Google.
Приложение ADVANTA на https веб-сервере с актуальным заверенным сертификатом SSL.
Привязанный рабочий SSL-сертификат к домену, на котором настраивается интеграция ADVANTA и Google Calendar API.
Открытый 443 порт для входящего и исходящего трафика. Либо сделать перенаправление порта на 443 порт сервера, на котором установлена ADVANTA.

В качестве примера настройки укажем домен веб-сервера https://a2nta.ru, адрес приложения https://a2nta.ru/012345.

Интерфейс сервисов Google Search Console и Консоль разработчика Google постоянно изменяется. Приведенные ниже скриншоты укажут вам направление настройки.

Подключение домена

Заверьте домен на сервисе Google Search Console, для этого:

добавьте новый ресурс → «Ресурс с префиксом в URL» → укажите ресурс с протоколом https в адресе;

Рисунок 1 – Добавить ресурс в Search Console
действуйте согласно рекомендациям (Рисунок 2).

Рисунок 2 – Подтверждение прав

Скачанный файл нужно загрузить в корень сайта, т.е чтобы он стал доступен для Google по адресу https://a2nta.ru/google6e61a8a115f815ba.html.
В случае успешной проверки → «Подтвердить».
Домен появится в списке, если права успешно подтверждены.
При возникновении ошибок выдаются соответствующие сообщения. После устранения ошибок переходите к следующему шагу.

Рисунок 3 – Сообщение о подтверждении прав

Если сервис Google Search Console не смог найти файл robots.txt в указанном домене, то в его корневой каталог следует добавить файл с именем robots.txt и содержимым, приведенным ниже.

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

User-agent: *
Disallow: /

User-agent: Yandex
Allow: /$
Disallow: /
User-agent: Mail.Ru
Allow: /$
Disallow: /
User-agent: StackRambler
Allow: /$
Disallow: /
User-agent: Googlebot
Allow: /$
Disallow: /
User-agent: googlebot-image
Allow: /$
Disallow: /
User-agent: googlebot-mobile
Allow: /$
Disallow: /
User-agent: Aport
Allow: /$
Disallow: /
User-agent: msnbot
Allow: /$
Disallow: /
User-agent: psbot
Allow: /$
Disallow: /
User-agent: yahoo-slurp
Allow: /$
Disallow: /

Создание и настройка API проекта

Перейдите в Консоль разработчика Google и создайте новый проект (Рисунок 4).
Введите название, которое будет отображаться только в консоли разработчика.

Рисунок 4 – Кнопка «Создать проект»
С главной страницы перейдите к библиотеке API.

Рисунок 5 – Создание нового проекта
Найдите Google Calendar API, перейдите на страницу и нажмите «Включить».

Рисунок 6 – Кнопка перехода к библиотеке API
Перейдите в панель управления и проверьте список включённых для проекта API.

Рисунок 7 – Список включённых API на панели управления
Настройте информацию о проекте.
- Перейдите «Учётные данные» → «Создать учётные данные» → «Идентификатор клиента OAuth».

Рисунок 8 – Создать идентификатор клиента OAuth
После выполнения предыдущего пункта появится вкладка OAuth consent screen:

в ней заполните обязательные поля в первом окне;

второе окно можно пропустить;
добавьте адреса пользователей, календарь которых нужно синхронизировать, в третьем окне.
После этого снова повторите действия «Перейдите «Учётные данные» → «Создать учётные данные» → «Идентификатор клиента OAuth»».
В открывшемся окне выберите «Desktop app».

Рисунок 9 – Выбор типа приложения
Указав тип, вы получите реквизиты сертификата.

Рисунок 10 – Идентификатор

Настройка сервера push-сообщений

Настройка нужна, чтобы Google отправлял push-сообщения на сервер в случае изменения, создания или удаления мероприятия в Google Calendar.

Для этого настройте домен и подпишите пользователя в системе ADVANTA на канал рассылки push-сообщений.

Перейдите в «Учётные данные» → «Подтверждение прав на домен» и нажмите «Добавить домен»
Укажите домен без протокола https:// и нажмите «Добавить домен».

Рисунок 11 – Ввод имени домена

Если при добавлении домена возникла ошибка, значит у используемой учетной записи Google нет доступа к указанному домену, либо домен неверно заверен в сервисе Google Search Console.

После выполнения всех пунктов можно переходить к настройке интеграции с Google Calendar в разделе «Администрирование».

Настройка доступа к MS Office Web Apps Server

Информацию об установке MS Office Web Apps Server вы можете найти на ресурсах Microsoft, например, здесь.

Внимание!

Для интеграции с MS Office Web Apps, в соответствии с лицензионной политикой компании Microsoft, должно быть приобретено/арендовано требуемое количество лицензий.

Необходимые для развертывания этого решения типы лицензий указаны на соответствующем ресурсе компании Microsoft.

При неверно настроенной точке доступа к Office Web Apps Server у документов в системе не отображаются иконки просмотра документа в web-интерфейсе. Сообщений об ошибках при этом не возникает.

Для сервиса обработки изображений MS Office Web Apps требуется установить компонент Net.Pipe.
Подробные шаги по установке Net.Pipe.

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

Для возможности прикрепеления ссылок в Системе по нестандартным протоколам необходимо в client.config добавить следующую запись в секцию appSettings:

 <appSettings>
   <add key="CustomSchemes" value="ims;landocs"/> 
</appSettings>

где значения «ims» и «landocs» являются примерами нестандартных протоколов.

Отключение преобразования некоторых символов в HTML-мнемонику

Начиная с версии 3.24, появилась возможность указывать символы, которые не будут автоматически преобразовываться в их html-представление при сохранении значения реквизита.
Для этого в секцию <appSettings> файла client.config необходимо добавить параметр:

<add key="AntiXSSExceptionSymbols" value="LessThan;GreaterThan;NoBreakSpace;Ampersand"/>

В значении value через точку с запятой можно перечислить от 1 до 4-х параметров, соответствующих символам:

Параметр	Символ	HTML-мнемоника
LessThan	`<`	`<`
GreaterThan	`>`	`>`
NoBreakSpace	`(неразрывный пробел)`	` `
Ampersand	`&`	`&`

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

Для преобразования уже сохраненных в БД значений HTML-мнемоник требуется на странице /Pages/Utils/RestoreData.aspx нажать кнопку Fix AntiXSSExceptionSymbols. Это действие необходимо сделать один раз после изменения значения параметра AntiXSSExceptionSymbols в файле client.config.

Запускать процедуру преобразования желательно в нерабочее время, так как операция долгая и ресурсоемкая на БД больших размеров. Перед запуском этой операции обязательно сделать бэкап БД.

¹⁾

Для корректной работы интегратора с MS Project 2003, необходимо перед установкой интегратора установить пакет обновлений KB908002. Данный пакет обновлений Вы можете найти в архиве с дистрибутивами интегратора для версий MS Project 2003.

Резервное хранение удаленных файлов

anonymous@undisclosed.example.com (Anonymous) — Tue, 28 Oct 2025 11:40:33 +0000

Резервное хранение удаленных файлов

настройка

Начиная с версии системы 3.29 для Администратора стало доступно управление резервным хранением удаленных файлов. В разделе Администрирование → на странице «Общие настройки» → в группе «Настройки» добавлен пункт «Удаление файлов».

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

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

В таблице отражается информация по удаленным файлам:

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

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

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

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

за все время;
последние 10 удаленных файлов;
за сегодня;
за прошедшие сутки;
за неделю;
за две недели;
за месяц;
за год;
за указываемый диапазон дат.

При удалении Администратором файла из таблицы удаленных файлов, это отобразится в Ленте событий .

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

Дистрибутивы

anonymous@undisclosed.example.com (Anonymous) — Wed, 10 Dec 2025 09:51:59 +0000

Дистрибутивы

Интегратор с MS Project

Надстройка позволяет импортировать и экспортировать данные из ADVANTA в локальный MS Project.

Для импорта в Advanta файла MS Project с большим количеством строк (от 1000) необходимо не менее 20 Гб свободной ОЗУ на SQL сервере. Чем количество строк будет больше - тем больший пул свободной ОЗУ может потребоваться для выполнения операции импорта.

Документация по работе с модулем интеграции размещена здесь: Совместная работа с MS Project

Для версии 4.00 и выше

MS Project 2013/2016 (x86/32-битный)	Скачать интегратор для MS Project (х86). Для версий Системы 4.00+
MS Project 2013/2016 (x64/64-битный)	Скачать интегратор для MS Project (х64). Для версий Системы 4.00+

Данная версия надстройки будет работать на сборке системы ADVANTA 4.00 и выше.

Для версии 3.29 и выше

Версия MS Project	Ссылка на скачивание
MS Project 2013/2016 (x86/32-битный)	Скачать интегратор для MS Project (х86). Для версий Системы 3.29+
MS Project 2013/2016 (x64/64-битный)	Скачать интегратор для MS Project (х64). Для версий Системы 3.29+

Данная версия надстройки будет работать на сборке системы ADVANTA 3.29.5268.28401 и выше.

Проверьте, что по адресу [домен системы]/components/services/msProjectExchange.asmx в списке доступных методов API присутствует LoginWithASPNETSessionId

Для версии 3.24 и выше

Версия MS Project	Ссылка на скачивание
MS Project 2010*/2013/2016 (x86/32-битный)	Скачать интегратор для MS Project (х86). Для версий Системы 3.24+
MS Project 2010*/2013/2016 (x64/64-битный)	Скачать интегратор для MS Project (х64). Для версий Системы 3.24+

Данная версия будет работать на сборке системы ADNANTA 3.24.4577.26268 и выше.

Для версии 3.09 и выше

Версия MS Project	Ссылка на скачивание
MS Project 2010*/2013/2016 (x86/32-битный)	Скачать интегратор для MS Project 2013,2016 (х86). Для версий системы 3.09+
MS Project 2010*/2013/2016 (x64/64-битный)	Скачать интегратор для MS Project 2013,2016 (х64). Для версий системы 3.09+

Интегратор для MS Project 2010 может работать нестабильно.

Для версии 3.04 -- 3.07

Версия MS Project	Ссылка на скачивание
MS Project 2010/2013/2016 (x86/32-битный)	Скачать интегратор для MS Project 2013,2016 (х86). Для версий системы 3.04 -- 3.07
MS Project 2010/2013/2016 (x64/64-битный)	Скачать интегратор для MS Project 2013,2016 (х64). Для версий системы 3.04 -- 3.07

Битность (разрядность) модуля интеграции привязана к битности ПО MS Project, а не к операционной системе. Например, в большинстве случаев у пользователей установлена Windows x64 (64-битная), а MS Project x86 (32-битный), поэтому нужно устанавливать x86/32-битный модуль интеграции. Модуль интеграции совместим только с MS Project 2010/2013/2016. Версии 2003 и 2007 не поддерживаются.

Интегратор не работает через прокси-соединение.

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

Для корректной работы модуля интеграции также нужно настроить работу систему через https: протокол, либо, если используется http: протокол – понизить уровень безопасности:

Перевод системы на использование протокола https://.
Для этого нужно на веб-сервере перейти в конфигурационный файл client.config (путь: C:\inetpub\wwwroot\streamline), изменить в строке <add key=«WebPath» value=«http:<адрес системы>/streamline» /> адрес системы на https:<адрес системы>/streamline и сохранить изменения. Если в файле client.config, в указанном пути изначально не было указано имя приложения (например в указанной строке стоит такое значение «http:<адрес системы>»), то указывать его в измененном значении также не нужно (оставить https:<адрес системы>).
Далее открыть Диспетчер служб IIS, создать само-заверенный сертификат, но лучше верифицированный, после выбрать сайт c системой, в меню справа добавить в привязках тип https, в поле hostname прописать адрес системы (<адрес системы>) c добавлением сертификата и сохранить. Далее необходимо из привязок IIS (bindings) убрать обращение по протоколу http и работать с системой только по протоколу https.
После этого нужно будет перезапустить пул с приложением и проверить решение.
Обходное решение - понизить уровень безопасности. Для этого в конфигурационном файле httpCookies.config, который находится в корне папки с приложением системы на сервере (путь по умолчанию C:\inetpub\wwwroot\streamline), нужно в теге <httpCookies requireSSL=«true»/> изменить значение на «false», сохранить изменения в файле и перезапустить приложение системы (пул с приложением, или весь IIS целиком).

Архивные версии интегратора

Версия ADVANTA	Версия MS Project	Ссылка на скачивание
для версий 2.3.5.9 – 3.03.хххх:	MS Project 2010/2013 (x86/32-битный)	msprojectaddin2359x86.zip
для версий 2.3.5.9 – 3.03.хххх:	MS Project 2010/2013 (x64/64-битный)	msprojectaddin2359x64.zip
для версий 1.8.2.2 – 2.1.1.3:	MS Project 2003 (x86/32-битный)	1822_msp2003_x86.zip
	MS Project 2003 (x64/64-битный)	1822_msp2003_x64.zip
	MS Project 2007/2010 (x86/32-битный)	1822_msp2007_x86.zip
	MS Project 2007/2010 (x64/64-битный)	1822_msp2007_x64.zip
для версий 1.7.9.0 – 1.8.2.0:	MS Project 2003 (x86/32-битный)	1790_msp2003_x86.zip
	MS Project 2003 (x64/64-битный)	1790_msp2003_x64.zip
	MS Project 2007/2010 (x86/32-битный)	1790_msp2007_x86.zip
	MS Project 2007/2010 (x64/64-битный)	1790_msp2007_x64.zip
до версии 1.7.8.7 включительно:	MS Project 2003 (x86/32-битный)	1701_msp2003_x86.zip
до версии 1.7.8.7 включительно:	MS Project 2007/2010 (x86/32-битный)	1701_msp2007_x86.zip

Интегратор для старых версий Адванты (до 1.7.8.7 включительно) поддерживает работу только с 32-х битными (x86) версиями MS Project.

Установка

Установить библиотеку .NET Framework 4.7.2.
Установить интегратор – пакет MSProjectAddin или MSProjectAddin64 (для 64-х битных версий MS Project).
Важно – при установке Вам будет предложено установить модуль интеграции «для всех» или «только для меня» (текущего пользователя) – если будет выбран второй вариант, то модуль интеграции будет доступен только тому пользователю, который устанавливал модуль интеграции. Обычно это Администратор. Поэтому рекомендуем выбирать значение «для всех».
Перезагрузить компьютер.

Настройка MS Project 2010

Если при загрузке Project'a не появилось вкладки «Надстройки» с панелью «Адванта»¹⁾ на ней то:

зайти в меню «Файл» → «Параметры» → «Надстройки»;
проверить что значение Streamline Connection Addin находится в активных надстройках; если нет, то добавить его.

Сервис для обеспечения работы таймера

Утилита для запуска сервиса – скачать

Установка

Скопировать содержимое архива в папку C:\SL_Files\Scheduler\
Запустить командную строку от имени администратора.
Запустить из командной стройки файл C:\SL_Files\Scheduler\a2schr.exe с ключом -i.

Интервал срабатывания таймера

Таймер по умолчанию срабатывает раз в 600 секунд.

Если нужно установить другой интервал срабатывания таймера, запускайте программу из командной стройки c ключем -t
C:\SL_Files\Scheduler\a2schr.exe -i -t N, где N - период срабатывания в секундах.

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

Для корректной работы всех компонентов системы, необходимо, чтобы сервис таймера подключался к системе по тому же внешнему адресу, по которому к системе подключаются пользователи. Для этого нужно в настройках Bindings (привязки, в настройках IIS) сайта указать тот внешний адрес системы, но без указания протокола и названия приложения. Например, если система открывается по адресу https://a2nta.ru/streamline, то в настройках привязки нужно указать лишь a2nta.ru .

Проверка работоспособности таймера

На сервере должна быть включена служба «Advanta Scheduler»
Системный лог таймера хранится в txt файле C:\SL_Files\Scheduler\a2shcr.txt. При возникновении ошибок, они отображаются в нём.
Просмотреть журнал сработки таймера в разделе Администрирование

¹⁾

«А2» для старой версии интегратора

Механизм выноса сервиса расчета Excel-отчетов на ...

anonymous@undisclosed.example.com (Anonymous) — Tue, 26 Nov 2024 12:40:33 +0000

Механизм выноса сервиса расчета Excel-отчетов на отдельную машину (для ОС Linux)

Инструкция по выносу сервиса расчета Excel-отчетов на отдельную машину для ОС Linux.

Инструкция для ОС Windows находится на отдельной странице.

Как установить сервис и запускать его в автоматическом режиме

Сборка сервиса пересчета Excel-отчетов

Опубликовать проект SL.Spreadsheet.WcfService, используя Release.

После этого в папке Publish\SpreadsheetService (полный путь ~\SL.Spreadsheet.WcfService\Publish) опубликуется сервис пересчета.

Настройка сервиса пересчета

В файле appsettings.json:

Изменить ApplicationId на идентификатор приложения.
Задать IPAddress и Port в разделе Endpoint.

Запуск сервиса пересчета

Запустить сервис пересчета, запустив файл SL.Spreadsheet.WcfService.exe из папки Publish\SpreadsheetService.

Настройка приложения ADVANTA

Для настройки приложения ADVANTA на работу с удаленным сервисом пересчета Excel-отчетов в client.config в appSettings необходимо добавить следующие ключи:

<add key="WorkbookHandler" value="Remote" />

По умолчанию:

значение Local - встроенный режим;
значение Remote - удаленный режим.

<add key="WorkbookHandlerEndpoint" value="net.tcp://{адрес:порт}/WorkbookHandlerService" /> .

Значение {адрес:порт} сервиса пересчета - путь должен выглядеть следующим образом: net.tcp:⁄⁄127.0.0.1:9090/WorkbookHandlerService.

Логирование в сервисе пересчета Excel-отчетов

Для включения Serilog в сервисе пересчета в appsettings.json в разделе ProfilerLogSettings необходимо добавить:

ProfilerLogEnable: true,
IsSyncToSeqProfilerLog: true,
SeqUrlProfilerLog: http://localhost:5341

Также поддерживаются другие ключи: ProfilerLogPath, ProfilerAllLogsSizeLimitMegaBytes, IsWriteToProfilerLogAllRequests, ProfilerLogExclusions.

Чтобы включить трасировку wcf, нужно изменить значение CoreWCF в разделе Logging:LogLevel. Пример:

CoreWCF: Trace

Механизм выноса сервиса расчета Excel-отчетов на ...

anonymous@undisclosed.example.com (Anonymous) — Mon, 22 Dec 2025 07:31:59 +0000

Механизм выноса сервиса расчета Excel-отчетов на отдельную машину (для ОС Windows)

Инструкция по выносу сервиса расчета Excel-отчетов на отдельную машину для ОС Windows.

Инструкция для ОС Linux находится на отдельной странице.

Как установить сервис и запускать его в автоматическом режиме

Активация WAS для взаимодействия с сервисом

Активация WAS для взаимодействия с сервисом с помощью протоколов отличных от http (net.tcp, net.pipe и др.):

1. Установить компоненты Windows (Программы и компоненты):

.Net Framework 3.5 → Активация WCF не по HTTP;
Дополнительные службы .Net Framework 4.5 → Службы WCF → Активация по HTTP, Активация по TCP, Активация по именованным каналам.

2. Добавить привязки net.tcp, net.pipe в веб-сайт IIS, где будет размещаться сервис.

Размещение сервиса пересчета Excel-отчетов

Скопировать папку с сервисом «SpreadsheetService» (например, в inetpub\wwwroot).
Создать отдельный пул в IIS для сервиса, обязательно в Integrated Mode («встроенный» в русской версии Windows).
Создать приложение в IIS, где задать имя и путь к сервису из пункта 1, выбрать пул из пункта 2.
В дополнительных параметрах приложения указать активные протоколы: http, net.tcp, net.pipe.

Запуск сервиса пересчета

Запустить сервис пересчета, запустив файл SL.Spreadsheet.WcfService.exe из папки Publish\SpreadsheetService.

Настройка приложения ADVANTA

Настройка приложения ADVANTA на работу с удаленным сервисом пересчета Excel-отчетов:

1. В client.config в appSettings добавить:

<add key="WorkbookHandler" value="Remote" />

По умолчанию:

значение Local - встроенный режим;
значение Remote - удаленный режим.

2. В serviceModelClient.config раскомментировать endpoint с протоколом, который требуется использовать:

если приложение и сервис расположены на одном сервере, то рекомендуется использовать netNamedPipeBinding;
если на разных серверах, то netTcpBinding.

Исправить значение address на адрес к развернутому сервису - путь должен выглядеть так: net.pipe:⁄⁄{адрес к сервису}/WorkbookHandlerService.svc.

Логирование в сервисе пересчета Excel-отчетов

Для включения Serilog в сервисе пересчета в Web.config сервиса в секцию appSettings необходимо добавить:

<add key="ProfilerLogEnable" value="true"/>
      <add key="ProfilerLogPath" value="C:\inetpub\wwwroot\SpreadsheetService\logs"/>
      <add key="ProfilerAllLogsSizeLimitMegaBytes" value="500"/>

В папке с логами C:\inetpub\wwwroot\SpreadsheetService\logs должна быть подпапка ProfilerLog, иначе ничего записываться не будет.

Также поддерживаются другие ключи: ProfilerLogPath, ProfilerAllLogsSizeLimitMegaBytes, IsWriteToProfilerLogAllRequests, ProfilerLogExclusions.

Можно добавить секцию log4net в Web.config сервиса:

<configSections>
                     <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net"/>
             </configSections>

Можно добавить секцию log4net в configuration:

 <log4net>
                    <appender name="RollingFileAppender" type="log4net.Appender.RollingFileAppender">
                            <file value="C:\inetpub\wwwroot\SpreadsheetService\logs\log4net\log.txt"/>
                            <appendToFile value="true"/>
                            <rollingStyle value="Size"/>
                            <maxSizeRollBackups value="10"/>
                            <maximumFileSize value="50MB"/>
                            <staticLogFileName value="true"/>
                            <layout type="log4net.Layout.PatternLayout">
                                  <conversionPattern value="%date [%thread] %-5level %logger [%property{NDC}] - %message%newline"/>
                           </layout>
                   </appender>
                   <root>
                          <level value="ALL"/>
                          <appender-ref ref="RollingFileAppender"/>
                   </root>
            </log4net>

Также можно настроить трассировку в wcf. Пример настройки:

<system.diagnostics>
    <sources>
      <source name="System.ServiceModel" switchValue="Information, ActivityTracing" propagateActivity="true">
        <listeners>
          <add name="xml" />
        </listeners>
      </source>
      <source name="System.ServiceModel.MessageLogging">
        <listeners>
          <add name="xml" />
        </listeners>
      </source>
    </sources>
    <sharedListeners>
      <add name="xml" type="System.Diagnostics.XmlWriterTraceListener" initializeData="Log.svclog" />
    </sharedListeners>
</system.diagnostics>

Пример Web.config с настроенным логированием:

Механизм выноса сервиса расчета Excel-отчетов на ...

anonymous@undisclosed.example.com (Anonymous) — Mon, 25 Nov 2024 07:33:25 +0000

Механизм выноса сервиса расчета Excel-отчетов на отдельную машину

Настройка интеграции с Google Calendar

anonymous@undisclosed.example.com (Anonymous) — Tue, 11 Jan 2022 13:50:49 +0000

Настройка интеграции с Google Calendar

Подробный алгоритм - здесь

Для настройки интеграции необходимы:

Учетная запись в Google.
Для этой учетной записи должен быть доступен сервис Google Search Console и Консоль разработчика Google.
Приложение ADVANTA на https веб-сервере с актуальным заверенным сертификатом SSL.
Привязанный рабочий SSL-сертификат к домену, на котором настраивается интеграция ADVANTA и Google Calendar API.
Открытый 443 порт для входящего и исходящего трафика. Либо сделать перенаправление порта на 443 порт сервера, на котором установлена ADVANTA.

В качестве примера настройки укажем домен веб-сервера https://a2nta.ru, адрес приложения https://a2nta.ru/012345.

Подключение домена

Заверьте домен на сервисе Google Search Console, для этого:

добавьте новый ресурс → «Ресурс с префиксом в URL» → укажите ресурс с протоколом https в адресе;

Рисунок 1 – Добавить ресурс в Search Console
действуйте согласно рекомендациям (Рисунок 2).

Рисунок 2 – Подтверждение прав

Скачанный файл нужно загрузить в корень сайта, т.е чтобы он стал доступен для Google по адресу https://a2nta.ru/google6e61a8a115f815ba.html.
В случае успешной проверки → «Подтвердить».
Домен появится в списке, если права успешно подтверждены.
При возникновении ошибок выдаются соответствующие сообщения. После устранения ошибок переходите к следующему шагу.

Рисунок 3 – Сообщение о подтверждении прав

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

User-agent: *
Disallow: /

User-agent: Yandex
Allow: /$
Disallow: /
User-agent: Mail.Ru
Allow: /$
Disallow: /
User-agent: StackRambler
Allow: /$
Disallow: /
User-agent: Googlebot
Allow: /$
Disallow: /
User-agent: googlebot-image
Allow: /$
Disallow: /
User-agent: googlebot-mobile
Allow: /$
Disallow: /
User-agent: Aport
Allow: /$
Disallow: /
User-agent: msnbot
Allow: /$
Disallow: /
User-agent: psbot
Allow: /$
Disallow: /
User-agent: yahoo-slurp
Allow: /$
Disallow: /

Создание и настройка API проекта

Перейдите в Консоль разработчика Google и создайте новый проект (Рисунок 4).
Введите название, которое будет отображаться только в консоли разработчика.

Рисунок 4 – Кнопка «Создать проект»
С главной страницы перейдите к библиотеке API.

Рисунок 5 – Создание нового проекта
Найдите Google Calendar API, перейдите на страницу и нажмите «Включить».

Рисунок 6 – Кнопка перехода к библиотеке API
Перейдите в панель управления и проверьте список включённых для проекта API.

Рисунок 7 – Список включённых API на панели управления
Настройте информацию о проекте.
- Перейдите «Учётные данные» → «Создать учётные данные» → «Идентификатор клиента OAuth».

Рисунок 8 – Создать идентификатор клиента OAuth
После выполнения предыдущего пункта появится вкладка OAuth consent screen:

в ней заполните обязательные поля в первом окне;

второе окно можно пропустить;
добавьте адреса пользователей, календарь которых нужно синхронизировать, в третьем окне.
После этого снова повторите действия «Перейдите «Учётные данные» → «Создать учётные данные» → «Идентификатор клиента OAuth»».
В открывшемся окне выберите «Desktop app».

Рисунок 9 – Выбор типа приложения
Указав тип, вы получите реквизиты сертификата.

Рисунок 10 – Идентификатор

Настройка сервера push-сообщений

Для этого настройте домен и подпишите пользователя в системе ADVANTA на канал рассылки push-сообщений.

Перейдите в «Учётные данные» → «Подтверждение прав на домен» и нажмите «Добавить домен»
Укажите домен без протокола https:// и нажмите «Добавить домен».

Рисунок 11 – Ввод имени домена

Варианты конфигураций для инфраструктуры ADVANTA с ...

anonymous@undisclosed.example.com (Anonymous) — Mon, 12 May 2025 11:52:05 +0000

Варианты конфигураций для инфраструктуры ADVANTA с учетом нагрузки

Сайзинг является ограничением для применения той или иной архитектуры.

Можно использовать архитектуру расширенного уровня на сайзинге базовой конфигурации, но нельзя использовать архитектуру базовой на сайзинге расширенной конфигурации.

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

Архитектура ADVANTA зависит от требований:

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

Архитектура инфраструктуры также зависит от загруженности одного или нескольких модулей Системы. Например, если в Системе строится большое количество отчетов, то можно вынести сервис генерации XLS-отчётов на отдельный сервер.

Компоненты Системы ADVANTA

Компонент	Описание
Приложение	Основное приложение и конфигурационные файлы Системы ADVANTA
База данных приложения	Основная база данных для приложения ADVANTA
База данных OLAP-кубов	База данных для хранения показателей OLAP-кубов - может использоваться основная БД приложения или отдельная, при необходимости можно распределить нагрузку между серверами БД
База данных интеграционной шины обмена событиями	База данных, хранящая события Системы для обмена с модулем Цифровой помощник (Триггеры). Может использоваться основная БД приложения или отдельная, при необходимости распределить нагрузку между серверами БД
Отчеты	Сервис (модуль) расчёта данных для отчетов типа «Электронная таблица» (на базе XLS-шаблонов). Обычно использует сервер основного приложения, но при необходимости может быть размещен на отдельном сервере
Документы	Хранение документов, размещенных в Системе ADVANTA
Приложение Цифровой помощник (модуль Триггеров)	Модуль, который общается с основной Системой по интеграционной шине и запускает выполнение запрограммированных сценариев по событию, по действию пользователя или по расписанию
База данных модуля Триггеров	БД для работы модуля Триггеров и хранения его внутренних данных

Модель OSI

Модель OSI актуальна для всех архитектурных решений.

Сетевое взаимодействие

Стандартные порты взаимодействия с Cистемой:

Описание источника	Описание назначения	Протокол	Порт назначения	Описание
Сервер приложения	Подсеть и/или подсети в которых расположены конечные пользователи	TCP	443	Связь с локальными пользователями через корпоративную сеть передачи данных
Сервер приложения	Внешние пользователи сети Интернет	TCP	443	Связь с внешними пользователями через глобальную сеть Интернет
Сервер приложения	Системы, с которыми есть интеграция приложения ADVANTA (API метод)	TCP	443	Связь приложения ADVANTA и сторонних приложений
Сервер приложения	Системные администраторы	TCP	3389	Подключение системных администраторов к серверу по RDP
Сервер приложения	LDAP	TCP	389, 636, 3268, 3269	Разрешить приложению доступ к LDAP
Сервер приложения	SMTP-сервер	TCP	25	Разрешить приложению доступ к SMTP-серверу
Сервер баз данных	Сервер СУБД PostgreSQL	TCP	5432	Разрешить входящие соединения для сервера DB
Сервер баз данных	Системные администраторы	TCP	22	Разрешить системным администраторам подключаться к серверу по SSH

Структурная схема взаимодействия с другими системами:

Конфигурации архитектуры инфраструктуры

Базовый уровень (Минимальная конфигурация)

Для компаний:

до 50 одновременно работающих пользователей;
до 50 активных проектов (каждый по 3000-5000 вложенных объектов);
стандартные отчеты (до 1000 строк);
нет специальных требований к архитектуре;
базовые меры информационной безопасности.

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

Рекомендуемый процессор на хостах виртуализации Intel Xeon Platinum 8360H, либо аналог с базовой тактовой частотой не ниже 3.0 GHz и архитектурой х86.

Сервер	Назначение	Операционная система	CPU (Количество ядер)	RAM (Gb)	Storage¹⁾ (Gb)	Disk IO
Сервер Приложений	Приложение ADVANTA Приложение Триггеров Отчеты	Linux/Windows 2012 и старше	8	32	128	3000+ IOPS
Сервер Базы данных	Базы данных ADVANTA Триггеров Документов²⁾		8	32	256	12000+ IOPS

Стандартный уровень (Масштабируемая конфигурация)

Для компаний:

до 200 одновременно работающих пользователей;
до 200 активных проектов (каждый по 5000-7000 вложенных объектов);
расширенные отчеты (до 10 000 строк);
частичная оптимизация архитектуры;
соответствие базовым стандартам ИБ.

Архитектура предполагает вынесение высоконагруженных модулей на отдельные северы. На схеме ниже представлен пример вынесения модуля отчетов на отдельный сервер. Но такое решение можно применить к любому модулю, описанному выше в компонентах Системы.

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

Сервер	Назначение	Операционная система	CPU (Количество ядер)	RAM (Gb)	Storage (Gb)	Disk IO
Сервер Приложений	Приложение ADVANTA Приложение Триггеров	Linux / Windows 2012 и старше	16	96	128	3000+ IOPS
Сервер Базы данных	Базы данных ADVANTA Триггеров Документов	Linux	16	64	256	12000+ IOPS
Сервер отчетов	Вычисление данных по отчётам	Linux / Windows 2012 и старше	6	16	128	3000+ IOPS

Расширенный уровень (Корпоративная конфигурация)

Для компаний:

до 1000 одновременно работающих пользователей;
до 500 активных проектов (каждый по 8000-10000 вложенных объектов);
комплексные аналитические отчёты (до 10000 строк);
оптимизированная архитектура;
соответствие базовым стандартам ИБ.

Архитектура предполагает вынесение всех компонентов Системы на отдельные северы.

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

Сервер	Назначение	Операционная система	CPU (Количество ядер)	RAM (Gb)	Storage (Gb)	Disk IO
Сервер Приложений	Приложение ADVANTA	Linux/Windows 2012 и старше	16	128+	256	3000+ IOPS
Сервер Баз данных	Базы данных ADVANTA Триггеров	Linux	16	96+	512+	12000+ IOPS
Сервер отчетов	Вычисление данных по отчетам	Linux/Windows 2012 и старше	8	16+	128	3000+ IOPS
Сервер триггеров	Приложение Триггеров	Linux/Windows 2012 и старше	8	16+	128	3000+ IOPS
Сервер документов	Размещение пользовательских документов	Linux/Windows 2012 и старше	4	8	512+	3000+ IOPS

Высоконагруженный уровень (Максимальная масштабируемость)

Для компаний:

более 1000 одновременно работающих пользователей;
более 500 проектов (каждый по 10000-15000 вложенных объектов);
использование Big Data и сложных аналитических отчетов;
высокодоступная распределенная архитектура (микросегментация, геораспределение, отказоустойчивость, катастрофоустойчивость, кластеризация);
высокий уровень ИБ.

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

¹⁾

Размер дискового хранилища зависит от количества данных в Системе. Указан примерный размер.

²⁾

Документы могут быть размещены на отдельном сервере и подключены к Системе ADVANTA в качестве дополнительного диска или через SMB.

Установка и настройка системы под Linux

anonymous@undisclosed.example.com (Anonymous) — Wed, 08 Oct 2025 07:36:01 +0000

Установка и настройка системы под Linux

Инструкция для размещения ADVANTA на сервере с ОС Linux и СУБД PostgreSQL

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

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

Данная инструкция предполагает установку на OC Astra Linux.

Подготовка сервера базы данных

Если у вас для системы ADVANTA используется БД MS SQL, развернутая на отдельном сервере под управлением ОС Windows, то инструкцию по подготовке сервера базы данных можно найти здесь.

Если же у вас для системы ADVANTA база данных будет развертываться под ОС Linux, то используется БД PostgreSQL. Перед началом настройки БД PostgreSQL необходимо включить сетевые репозитории и выполнить установку пакетов:

deb cdrom:[OS Astra Linux 1.7.2 1.7_x86-64 DVD ]/ 1.7_x86-64 contrib main non-free
deb https://download.astralinux.ru/astra/stable/1.7_x86-64/repository-main/ 1.7_x86-64 main contrib non-free
deb https://download.astralinux.ru/astra/stable/1.7_x86-64/repository-update/ 1.7_x86-64 main contrib non-free
deb https://download.astralinux.ru/astra/stable/1.7_x86-64/repository-base/ 1.7_x86-64 main contrib non-free
deb https://download.astralinux.ru/astra/stable/1.7_x86-64/repository-extended/ 1.7_x86-64 main contrib non-free
deb https://download.astralinux.ru/astra/stable/1.7_x86-64/repository-extended/ 1.7_x86-64 astra-ce

apt update
apt install postgresql-14

Далее необходимо выполнить первичную настройку СУБД PostgreSQL:

1. Выполнить вход в сессию служебного пользователя postgres:

su - postgres

Работая в сессии служебного пользователя postgres установить пароль администратора СУБД:

psql -c "alter user postgres with password '<указать_пароль>'"

Вместо текста <пароль> указать устанавливаемый пароль;
Пароль заключается в одинарные кавычки;
Вся команда заключается в двойные кавычки.

Завершить работу в сессии служебного пользователя postgres:

exit

2. Наcтроить удаленный доступ к СУБД, для чего в конфигурационном файле /etc/postgresql/14/main/postgresql.conf скорректировать параметр listen_addresses:

listen_addresses = '<указать_ip>'

3. В файле /etc/postgresql/14/main/pg_hba.conf добавить строку:

host    all             all             <указать_подсеть>            scram-sha-256

4. Добавить разрешающее правило файрволла для порта 5432:

ufw allow 5432/tcp

5. Перезагрузить службу postgresql:

systemctl restart postgresql

Далее необходимо создать пустую БД:

su - postgres
psql
CREATE DATABASE "a2nta_db"
WITH
OWNER = postgres
ENCODING = 'UTF8'
LC_COLLATE = 'ru_RU.UTF-8'
LC_CTYPE = 'ru_RU.UTF-8'
TABLESPACE = pg_default
CONNECTION LIMIT = -1;
 
ALTER DATABASE "a2nta_db" SET search_path TO "$user", public, dbo;
 
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
 
GRANT TEMPORARY, CONNECT ON DATABASE a2nta_db TO PUBLIC;
 
GRANT ALL ON DATABASE a2nta_db TO postgres WITH GRANT OPTION;

После создания базы данных необходимо выполнить восстановление предоставленного в дистрибутиве дампа базы данных в новую созданную БД a2nta_db.

В данный момент по умолчанию дамп БД предоставляется только для MS SQL. Дамп БД для PostgreSQL предоставляется по запросу.

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

Подготовка сервера приложения

Необходимые пакеты ОС

Для работы сервера приложений ADVANTA необходимо установить в операционной системе следующие стандартные пакеты (из репозитория ОС):

curl gnupg2 ca-certificates lsb-release debian-archive-keyring wget apt-transport-https

Веб-сервер/Прокси (последняя стабильная версия из репозитория ОС или от вендора):

nginx

Среды .Net (варианты установки):

wget http://archive.ubuntu.com/ubuntu/pool/main/libx/libxkbfile/libxkbfile1_1.1.0-1_amd64.deb
apt install ./libxkbfile1_1.1.0-1_amd64.deb
apt install ca-certificates
wget -O - https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | tee /etc/apt/trusted.gpg.d/microsoft.asc.gpg > /dev/null
wget https://packages.microsoft.com/config/debian/10/prod.list -O /etc/apt/sources.list.d/microsoft-prod.list
apt update
apt install dotnet-sdk-6.0

Установка среды .Net также может быть выполнена из официальных репозиториев дистрибутива.

Далее необходимо включить сетевые репозитории и выполнить установку пакетов (операции выполняются под учетной записью администратора сервера):

deb cdrom:[OS Astra Linux 1.7.0 1.7_x86-64 DVD ]/ 1.7_x86-64 contrib main non-free
deb https://dl.astralinux.ru/astra/stable/1.7_x86-64/repository-main/     1.7_x86-64 main contrib non-free
deb https://dl.astralinux.ru/astra/stable/1.7_x86-64/repository-update/   1.7_x86-64 main contrib non-free
deb https://dl.astralinux.ru/astra/stable/1.7_x86-64/repository-base/     1.7_x86-64 main contrib non-free
deb https://dl.astralinux.ru/astra/stable/1.7_x86-64/repository-extended/ 1.7_x86-64 main contrib non-free astra-ce backports

apt update
apt install curl
apt install gnupg2
apt install apt-transport-https
apt install nginx
apt install cifs-utils
apt install libldap2-dev
 
apt install libldap-common
 
apt install libldap-2.4-2

В случае, если документы Системы лежат на SMB шаре, отредактировать файл /etc/fstab, добавив в него строку подключения/монтирования:

//192.168.X.X/documents/a2nta /mnt/documents/a2nta cifs guest 0 0

Опционально, можно установить базовые шрифты от MS (для использования в отчетах типа «Электронная таблица») и обновить кэш шрифтов сервера:

apt install ttf-mscorefonts-installer
fc-cache -f -v

Опционально. Для использования авторизации в системе ADVANTA через службу Active Directory необходимо установить библиотеку

apt install libldap2-dev libldap-common libldap-2.4-2

Приведен пример с анонимным подключением. Строка подключения может отличаться в зависимости от политик безопасности организации.

Выполнить настройку https и локального сертификата:

dotnet dev-certs https
dotnet dev-certs https --trust

Настройка системных файлов

1. Загрузить и распаковать файлы приложения ADVANTA на сервер.

2. Создать файл конфигурации приложения (образцы находятся по пути: <версия приложения>/SL/config/). Созданный файл конфигурации разместить в основном каталоге приложения: /opt/advanta-app/Advanta/client.config. Пример созданного файла конфигурации client.config:

<?xml version="1.0"?>
<configuration>
  <configSections>
    <section name="unity" type="Microsoft.Practices.Unity.Configuration.UnityConfigurationSection, Microsoft.Practices.Unity.Configuration" />
    <!--<section name="ldapService" type="Config.LDAPConfigurationSection, smcorelib"/>
    <section name="adDomains" type="Config.ADDomainsConfiguration, smcorelib"/>
    <section name="openIdConnect" type="Config.OpenIdConnectConfigurationSection, smcorelib"/>
    <section name="hashiCorpVault" type="Config.HashiCorpVaultConfigurationSection, smcorelib"/>-->
  </configSections>

Теги:

  <connectionStrings>
    <add name="db" providerName="Npgsql" connectionString="User ID=postgres;Password=P@ssw0rd;Host=192.168.16.46;MaxPoolSize=1000;Port=5432;Database=chd-perf-test;EF Template Database=chd-perf-test;Pooling=false" />
    <add name="dbCubes" providerName="Npgsql" connectionString="User ID=postgres;Password=P@ssw0rd;Host=192.168.16.46;MaxPoolSize=1000;Port=5432;Database=chd-perf-test;EF Template Database=chd-perf-test;Pooling=false" />
    <add name="busDb" providerName="Npgsql" connectionString="User ID=postgres;Password=P@ssw0rd;Host=192.168.16.46;MaxPoolSize=1000;Port=5432;Database=chd-perf-test;EF Template Database=chd-perf-test;Pooling=false" />
  </connectionStrings>

Значения:

connectionString – строка подключения к базе данных;
User – пользователь для базы данных;
Password – пароль пользователя.

Теги:

  <appSettings>
    <add key="WebPath" value="https://192.168.16.250:5000" />
    <add key="TimeZone" value="+5" />
    <add key="autologin" value="false" />
    <add key="FilesRootPath" value="C:\SL_Files" />
    <add key="BusTransportType" value="PostgreSql" />
    <add key="NegotiationByEmailTimeout" value="120" />
    <add key="ApplicationId" value="81c341c9da40" />
    <add key="EnableSwagger" value="1" />
    <add key="EnableTestODataEndPoint" value="1" />
    <!--
    <add key="AllowedUrlRedirects" value="https://www.wikipedia.org;https://www.deepl.com/translator" />
    -->
    <!--
    <add key="DocumentsArchiveLifeTimeHours" value="168" />    
    <add key="MaxTotalFileSize" value="2097152000" />
    <add key="MaxFileCount" value="500" />
    <add key="MaxDocumentsArchivingActionCount" value="3" />
    <add key="MaxFullPathLength" value="150" />
    <add key="MinFolderNameLength" value="3" />
    <add key="MinRootFolderNameLength" value="30" />  
 
    <add key="DocumentsArchivingService" value="Remote" />
    -->
    <!--
    <add key="DocumentsArchivingService" value="Local" />
    <add key="Bus_DocumentsArchivingCommandsQueue:NumberOfWorkers" value="1"/>
    <add key="Bus_DocumentsArchivingCommandsQueue:MaxParallelism" value="3"/>
    <add key="ProfilerLogEnable" value="true"/>
    <add key="IsWriteToProfilerLogAllRequests" value="true"/>
    <add key="ProfilerAllLogsSizeLimitMegaBytes" value="10"/>
    <add key="CompressionLevel" value="Optimal|Fastest|NoCompression"/>
    <add key="TemporaryArchiveFlat" value="Memory|FileSystem"/>
    <add key="PathToTemporaryArchiveFlat" value="C:\Temp"/>
    -->
  </appSettings>

Параметр value – это ссылка, которая отображается в уведомлениях из системы, рассылаемых на почтовые ящики.

Внимание!

Для системы ADVANTA необходимо настроить маршрутизацию таким образом, чтобы сервер мог подключиться к самому себе по внешнему адресу.

Пример: внешний адрес сервера 192.168.1.62:5000, сервер IIS должен корректно заходить по этому адресу. В файле конфигурации системы ADVANTA client.config необходимо указать корректный путь в параметре WebPath. Для приведенного выше примера:

<add key="WebPath" value="https://192.168.1.62:5000" />

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

Теги:

  <!--<ldapService ldapPath="LDAP://" baseDN="">
    <authenticationTypes>
      <add authenticationType="Secure" />
      <add authenticationType="Signing" />
      <add authenticationType="Sealing" />
    </authenticationTypes>
  </ldapService>
 
  <adDomains>
    <domains>
      <add name="DOMAIN_NAME" login="login" password="password" ldappath="LDAP://DC=domain_name,DC=local"/>
    </domains>
  </adDomains>
  <openIdConnect>
    <providers>
      <add caption="caption" clientId="clientId" metadataURL="metadataURL" authenticationType="authenticationType" enabled="false"/>
    </providers>
  </openIdConnect>-->
  <unity xmlns="http://schemas.microsoft.com/practices/2010/unity">
    <container>
      <register type="System.IO.DirectoryInfo, mscorlib" mapTo="System.IO.DirectoryInfo, mscorlib" name="searchIndexPath">
        <constructor>
                <param name="path" value="/var/advanta-app/search" />
            </constructor>
      </register>
      <register type="Lucene.Net.Store.Directory, Lucene.Net" mapTo="Lucene.Net.Store.SimpleFSDirectory, Lucene.Net">
        <constructor>
              <param name="path" dependencyName="searchIndexPath" />
            </constructor>
      </register>
      <register type="SL.Storage.IFileStorageProvider, smcorelib" mapTo="SL.Storage.LocalFileStorageProvider, smcorelib">
        <constructor>
          <param name="documentsFolder" value="/var/advanta-app/documents" type="string"></param>
        </constructor>
      </register>
      <register type="SmartSuite.Data.Persistence.StorageProviderFactory, SmartSuite.Data" mapTo="SmartSuite.PostgreSQL.PgStorageProviderFactory, SL.PostgreSQL" />
      <register type="SL.App.ServerObjects.IServerObjectsProvider, SL.App.ServerObjects" mapTo="SL.App.ServerObjects.PostgreSQL.ServerObjectsProvider, SL.PostgreSQL" />
      <register type="P2M.Cubes.Data.IDirectoryDataManager, smcorelib" mapTo="SL.PostgreSQL.Data.DirectoryDataManager, SL.PostgreSQL" />
      <register type="P2M.Cubes.Data.IPivotDataManager, smcorelib" mapTo="SL.PostgreSQL.Data.PivotDataManager, SL.PostgreSQL" />
      <!--<register type="SL.Storage.IFileStorageProvider, smcorelib" mapTo="SL.Storage.SqlFileStorageProvider, smcorelib">
        <constructor>
          <param name="connectionStringName" value="db" type="string">
          </param>
        </constructor>
      </register>-->
 
      <!--<register type="SL.Storage.IFileStorageProvider, smcorelib" mapTo="SL.Storage.LocalFileStorageProvider, smcorelib">
        <constructor>
          <param name="documentsFolder" type="string" value="/var/advanta-app/documents" />
        </constructor>
      </register>-->
      <register type="Advanta.Files.IFileStorageProvider, Advanta.Infrastructure"
                mapTo="SL.Storage.LocalFileStorageProvider, smcorelib">
        <constructor>
          <param name="documentsFolder" type="string" value="/var/advanta-app/documents" />
        </constructor>
      </register>
 
    </container>
  </unity>
  <!--
  <hashiCorpVault address="" roleId="" secretId="">
    <containers>
      <add id="dbPasswords" version="V1" mountPoint="kv-v1" path="dbPasswords"/>
      <add id="adDomainPasswords" version="V2" mountPoint="kv-v2" path="adDomainPasswords"/>
    </containers>
  </hashiCorpVault>
  -->
</configuration>

3. В файле <версия приложения>/Advanta/appsettings.json необходимо указать URL, по которому будет открываться приложение. Пример листинга конфигурационного файла appsettings.json:

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=(localdb)\\mssqllocaldb;Database=aspnet-Advanta-53bc9b9d-9d6a-45d4-8429-2a2761773502;Trusted_Connection=True;MultipleActiveResultSets=true"
  },
  "Logging": {
    "LogLevel": {
      "Default": "Debug",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "ASPNETCORE_ENVIRONMENT": "Development",

  "Kestrel": {
    "Endpoints": {
      "Http": {
        "Url": "https://192.168.16.250:5000"
      },
    }
  },

  "AllowedHosts": "*",
    "appSettings": {
        "AppName": "streamline",
        "FirstUserMail": "support@advanta-group.ru",
        "support": "bug@advanta-group.ru",
        "statistics": "statistics@advanta-group.ru",
        "ConfigurationSettingsFile": "_Resources\\Config\\ConfigFiles\\ConfigurationSettings.xml",
        "Security_PagesConfig": "_Resources\\Config\\ConfigFiles\\SecuritySettings.xml",
        "PortletsConfig_File": "_Resources\\Config\\PortletEngine\\EngineConfig.xml",
        "Projects_StatusFile": "_Resources\\Config\\P2M\\Projects\\ProjectStatuses.xml",
        "Projects_PriorityFile": "_Resources\\Config\\P2M\\Projects\\ProjectPriority.xml",
        "errorMode": "debug",
        "ValidationSettings:UnobtrusiveValidationMode": "None",
        "SoapServicesAspNetCompatibility" :  "false"
    },
    "FormOptions": {
        "ValueCountLimit": "2048"
    }
}

Рекомендуется при разворачивании Системы использовать протокол https, вместо http, т.к. протокол http считается устаревшим.

Раздел Системы с диаграммой Ганта доступен только при работе Системы через https.

Информация о переводе Системы с протокола http на использование протокола https находится на отдельной странице.

Выбор языка интерфейса системы

На данный момент доступно два языка на выбор:

русский (по-умолчанию);
английский.

Для выбора языка, отличного от русского, нужно:

Открыть на редактирование файл globalization.config.

Найти строку:

<globalization culture="ru-RU" uiCulture="ru-Ru" fileEncoding="windows-1251" requestEncoding="utf-8" responseEncoding="utf-8" />

Изменить в ней значение параметра uiCulture на en , если нужен английский язык интерфейса.

Для возврата к русскому языку нужно установить значение ru-Ru.

Получение лицензии

Необходимо получить у менеджера ADVANTA архив GetLicenseInfo и распаковать его на сервере.
Сгенерировать файл запроса лицензии:
```
dotnet Advanta.GetLicenseInfo.dll
```
Сгенерированный файл _sl.dat отправить менеджеру ADVANTA.
Получить от менеджера ADVANTA файл лицензии sl.lic и скопировать его в /opt/advanta-app/Advanta/.
Запускать приложение в папке /opt/advanta-app/Advanta/ командой:
```
dotnet Advanta.dll
```

Убедиться в работоспособности приложения

Выполнить настройку службы ADVANTA:

1. Создать файл службы /etc/systemd/system/Advanta.service. Пример файла службы Advanta.service:

[Unit]
Description=Advanta Service

[Service]
# will set the Current Working Directory (CWD). Worker service will have issues without this setting
WorkingDirectory=/opt/advanta-app/Advanta
# systemd will run this executable to start the service
# if /usr/bin/dotnet doesn't work, use `which dotnet` to find correct dotnet executable path
ExecStart=/usr/bin/dotnet /opt/advanta-app/Advanta/Advanta.dll
# to query logs using journalctl, set a logical name here
SyslogIdentifier=AdvantaService

# Use your username to keep things simple.
# If you pick a different user, make sure dotnet and all permissions are set correctly to run the app
# To update permissions, use 'chown yourusername -R /srv/HelloWorld' to take ownership of the folder and files,
# Use 'chmod +x /srv/HelloWorld/HelloWorld' to allow execution of the executable file
User=root
# ensure the service restarts after crashing
Restart=always
# amount of time to wait before restarting the service
RestartSec=5
# This environment variable is necessary when dotnet isn't loaded for the  pecified user.
# To figure out this value, run 'env | grep DOTNET_ROOT' when dotnet has been loaded into your shell.
Environment=DOTNET_ROOT=/usr/share/dotnet

[Install]
WantedBy=multi-user.target

systemctl daemon-reload

Путь к исполняемому файлу /usr/bin/dotnet может отличаться в зависимости от дистрибутива.

2. Добавить созданную службу в автозапуск:

systemctl enable advanta

После выполнения всех настроек и проверки корректного включения и работы приложения ADVANTA, необходимо выполнить:

dotnet /opt/advanta-app/Updates/Bin/Advanta.Migration/Advanta.Migration.dll /opt/advanta-app/Advanta/client.config

Сервис для обеспечения работы таймера

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

Установка и настройка системы под Windows

anonymous@undisclosed.example.com (Anonymous) — Wed, 08 Oct 2025 07:36:34 +0000

Установка и настройка системы под Windows

Инструкция для размещения ADVANTA на сервере с ОС Windows и СУБД MS SQL Server

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

Для начала работы создайте на сервере приложения папку SL_Files и распакуйте туда содержимое архива (инсталляционного диска), чтобы путь к содержанию папки был: C:\SL_Files

На 64х-разрядных операционных системах следует использовать 64х-разрядный IIS (Internet Information Services) и 64х-разрядный .NET Framework.

Подготовка сервера базы данных

Для настройки сервера баз данных необходимо запустить SQL Server Managment Studio и выполнить следующие действия.

В окне «Обозреватель объектов» (Object Explorer) правой кнопкой мышки кликнуть на «Базы данных» (Database) → «Восстановить базу данных» (Restore Database).

Рисунок 3.1 – Параметры разворачивания бэкапа в MS SQL Server 2008 R2
1. В разделе «Общие» (General):
  - В поле «В базу данных» (To database) ввести название создаваемой из бэкапа базы данных – streamline.
  - В разделе «Источник для восстановления» (Source for restore) выбрать «Устройство» (From device: ).
  - Выбрать бэкап из папки C:\SL_Files\DB_Backup\.
  - В окне «Восстанавливаемые резервные наборы данных» (Select the backup sets to restore) выбрать последнюю версию бэкапа (отметить галочкой).
2. В разделе «Параметры» (Options) (или «Файлы» (Files) для MS SQL Server 2016), в окне «Восстановить файлы базы данных как» (Restore the database files as:) в колонке «Восстановить как» (Restore as) нужно переписать названия для файлов данных и лога БД – для файла данных ввести название streamline.mdf, для файла лога streamline_log.lgf.
  - Нажать на «ОК».
    
    Рисунок 3.2 – Параметры разворачивания бэкапа в MS SQL Server 2008 R2
Создать учетную запись «advanta»:
- В окне «Обозреватель объектов» (Object Explorer) раскрыть «Безопасность» (Security), нажать правой кнопкой мышки на «Имена входа» (Logins)и выбрать «Создать имя входа» (New Login).
- В разделе «Общие» (General):
  - В поле «Имя входа» (Login name) ввести advanta.
  - Выставить опцию «Проверка подлинности SQL Server» (SQL Server authentication).
  - Убрать опцию «Требовать использование политики паролей» (Enforce password policy).
  - Ввести пароль учетной записи (введенный пароль затем понадобится указать на сервере приложения для доступа к базе данных).
  - Выставить используемый язык «Язык по умолчанию» (Default language) выбрав в выпадающем меню «Русский» (Russian).
- Нажать «ОК».
Открыть созданную учетную запись. Перейти на страницу «Сопоставление пользователей» (User Mapping):
- В окне «Пользователи, сопоставленные с этим именем входа» (User mapped to this login) в столбце «Схема» (Map) установить галочку напротив базы streamline.
- В окне «Членство в роли базы данных для: streamline» (Database role membership for: streamline) выставить права db_owner.
  ВНИМАНИЕ!
  Схема базы данных должна оставаться dbo! В противном случае структура базы данных нарушается и последующее обновление системы будет невозможно.
  db_owner – это права доступа пользователя на таблицу в базе данных, а не схема!
- Нажать «ОК».
Включить функцию интеграции со средой CLR, для чего выполнить следующие действия:
- в окне Обозреватель объектов (Object Explorer) нажать правой кнопкой мыши на базе данных streamline и выбрать пункт «Создать запрос» (New Query);
- выполнить следующий скрипт (на инсталляционном диске файл с текстом скрипта – sp_configure.sql расположен в папке SL_Files\DB_Backup\):
```
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'clr enabled', 1;
GO
RECONFIGURE;
GO
```

Выполнить скрипт исключения ошибок взаимоблокировки транзакций (на инсталляционном диске файл с текстом скрипта – READ_COMMITTED_SNAPSHOT.sql расположен в папке SL_Files\DB_Backup\):

SELECT is_read_committed_snapshot_on FROM
sys.databases WHERE name= DB_NAME();
GO
 
DECLARE @cmd nvarchar(200)
SET @cmd = 'ALTER DATABASE ' + DB_NAME() + ' SET SINGLE_USER WITH ROLLBACK IMMEDIATE;';
EXEC(@cmd);
GO
 
DECLARE @cmd nvarchar(200)
SET @cmd = 'ALTER DATABASE ' + DB_NAME() + ' SET READ_COMMITTED_SNAPSHOT ON;';
EXEC(@cmd);
GO
 
DECLARE @cmd nvarchar(200)
SET @cmd = 'ALTER DATABASE ' + DB_NAME() + ' SET MULTI_USER;';
EXEC(@cmd);
GO
 
SELECT is_read_committed_snapshot_on FROM
sys.databases WHERE name= DB_NAME();

Выполнить скрипт отключения опции принудительной работы по HTTPS:
```
UPDATE Core_Settings SET VALUE = 'False' WHERE Name = 'USE.SSL'
```
Скрипт работает только на SQL Server 2008 SP3 c версией 10.50.6000 и выше.

Если у вас SQL Server 2017 и выше, выполнить скрипт для корректной работы OLAP-кубов:

USE [название базы];
GO
 
DECLARE @clrName nvarchar(4000);
DECLARE @asmBin varbinary(MAX);
 
SELECT @clrName = clr_name FROM sys.assemblies WHERE name = 'StringUtilities'
SELECT @asmBin = content FROM sys.assembly_files WHERE name = 'StringUtilities'
 
DECLARE @hash varbinary(64);
 
SELECT @hash = HASHBYTES('SHA2_512', @asmBin);
 
EXEC sys.sp_add_trusted_assembly @hash = @hash, @description = @clrName;

Выполнять скрипт из-под учётной записи с предопределенной ролью сервера sysadmin или с разрешением CONTROL SERVER.

Проверьте параметры MS SQL Server, чтобы были разрешены удалённые подключения для учётных записей SQL.

Если вы хотите работать с БД PostgreSQL, то для настройки БД перейдите на страницу Настройка базы данных PostgreSQL.

Подготовка сервера приложения

Перед проведением работ на сервере приложения в каталоге C:\Inetpub\wwwroot необходимо создать папку streamline и содержимое C:\SL_Files\Context_bkp поместить в созданную папку. Выполнение настройки сервера приложения состоит из нескольких процедур:

Установка обязательных компонентов на с сервер с IIS.
Настройка Internet Information Services (IIS).
Редактирование системных файлов.
Получение лицензии.
Установка компонентов системы.

Рассмотрим эти процедуры более подробно.

Установка обязательных компонентов на с сервер с IIS

В мастере настройки дополнительных ролей и компонентов нужно включить роль *«Разработка приложений»*, после чего включить следующие пункты:

ASP;
ASP .NET 3.5;
ASP .NET 4.5.

Рисунок 3.3 – Настройка ролей и компонентов сервера с IIS

Настройка Internet Information Services

Открыть «Диспетчер служб IIS» (Internet Information Services (IIS) Manager). Далее в разделе «Узлы» (Sites) раскрыть «Веб-узел по умолчанию» (Default web site) и нажать правой кнопкой мыши на папке streamline.
В раскрывшемся меню нажать «Преобразовать в приложение» (Convert to application).
В появившемся окне нажать «Ок».
Перейти к разделу «Пулы приложений» (Application pools):
- открыть «Основные настройки» (Basic Settings) пула приложений, содержащего приложение «streamline» и выполнить следующие действия:
  - в пункте «Версии среды .NET Framework» (.NET Framework version) выбрать значение .NET Framework 4.0.30319 ;
  - в пункте «Режим управляемого конвейера» (Managed Pipeline Mode) выбрать режим «Встроенный» (Integrated);
- открыть «Дополнительные настройки» (Advanced Settings) пула приложений, содержащего приложение streamline и изменить параметр «Загрузить профиль пользователя» (Load User Profile) на «True».
Добавление типа MIME (для Windows Server 2008 R2)
- в Диспетчере IIS перейти на веб сайт, в котором находится приложение streamline
- в просмотре возможностей перейдите в «типы MIME», в случае отсутствия расширения .woff:
  - добавьте новый тип: ◦в поле «Расширение файла» введите .woff
  - в поле «Тип MIME» введите font/x-woff.

Настройка системных файлов

Редактирование файла client.config:

Тег
```
 <add name="db" providerName="System.Data.SqlClient" connectionString="Data Source=DB_servername;Initial Catalog=streamline;User=advanta;Password=Type_your_password;Max Pool Size=500" /> 
```
Начиная с версии 3.18 нужно внести правки ещё в два тега:
```
<add name="busDb" providerName="System.Data.SqlClient" connectionString="Data Source=DB_servername;Initial Catalog=streamline;User=advanta;Password=Type_your_password;Max Pool Size=500" />
```
```
<add name="dbCubes" providerName="System.Data.SqlClient" connectionString="Data Source=DB_servername;Initial Catalog=streamline;User=advanta;Password=Type_your_password;Max Pool Size=500" /> 
```
Значения:
- connectionString – строка подключения к базе данных.
- Data Source – название сервера базы данных
- Initial Catalog – название базы данных
- User – пользователь для базы данных
- Password – пароль пользователя
- sqlServerCacheDb – имя строки подключения для базы данных распределенного кэша.
- signalRDb – имя строка подключения к базе с которой работает SignalR (пуш-уведомления).
Тег
```
 <add key="WebPath" value="https://servername/streamline"/>
```
параметр value – это ссылка, которая отображается в уведомлениях из системы, рассылаемых на почтовые ящики. Вместо слова servername впишите адрес вашего сервера.
Внимание!
Для системы Адванта, начиная с версии 3.04 необходимо настроить маршрутизацию таким образом, чтобы сервер мог подключиться к самому себе по внешнему адресу. Данное требование связано с изменениями в работе таймера, экспорте диаграммы Ганта и интеграцией с Office 365.
Пример: внешний адрес сервера client.a2nta.ru, сервер IIS должен корректно заходить по этому адресу. В файле конфигурации системы Адванта client.config необходимо указать корректный путь в параметре WebPath. Для приведенного выше примера:
<add key="WebPath" value="https://client.a2nta.ru" />

Для этого нужно в настройках Bindings (привязки, в настройках IIS) сайта указать тот внешний адрес системы, но без указания протокола и названия приложения. Например, если система открывается по адресу https://a2nta.ru/streamline, то в настройках привязки нужно указать лишь a2nta.ru .
В теге
```
<register name="searchIndexDirectoryPath" type="System.IO.DirectoryInfo, mscorlib">
  <constructor>
    <param name="path" value="C:\documents\search" />
  </constructor>
</register>
```
в параметре value прописывается путь к поисковому индексу системы на диске. Например C:\SL_Files\Doc_Files\search.

Рекомендуется поисковый индекс хранить на скоростной и не нагруженной другими задачами дисковой системе, например, на отдельном SSD-диске сервера.
В теге
```
<param name="documentsFolder" value="C:\documents\streamline" type="string"></param>
```
в параметре value прописывается путь к документам на диске. Например C:\SL_Files\Doc_Files\streamline.

Документы хранятся в созданной вами папке, куда вы скопировали дистрибутив: C:\SL_Files\Doc_Files\streamline. Скопируйте содержимое папки с документами в вашу папку (или оставьте документы там, где они сейчас) и пропишите путь до хранения документов.
В теге
```
<add key="TimeZone" value="+5" />
```
в параметре value укажите часовой пояс, который должен отображаться в системе.
В разделе <appSettings> в теге
```
<add key="CubeCommandTimeout" value="30" />
```
в параметре value можно указать ограничение времени ожидания выполнения команд в подключении к OLAP-кубу (в секундах). Если параметр не указан в файле client.config, то он устанавливается в значение по умолчанию - 60 секунд.

После внесения изменений перенесите файл client.config в корневую папку системы (по умолчанию c:\inetpub\wwwroot\streamline)

Раздел Системы с диаграммой Ганта доступен только при работе Системы через https.

Выбор языка интерфейса системы

На данный момент доступно два языка на выбор:

Русский (по-умолчанию);
Английский (добавлен в версии 3.04.2348.32888-3ed5179).

Для выбора языка, отличного от русского, нужно:

Открыть на редактирование файл globalization.config.
Для версии системы, меньше 3.03.2166.х, настройка языка в файле web.config.

Найти строку:

<globalization culture="ru-RU" uiCulture="ru-Ru" fileEncoding="windows-1251" requestEncoding="utf-8" responseEncoding="utf-8" />

Изменить в ней значение параметра uiCulture на en, если нужен английский язык интерфейса.

Для возврата к русскому языку нужно установить значение ru-Ru.

Установка библиотек для работы с Microsoft SQL Server

На сервер приложений нужно установить следующие библиотеки: Microsoft® System CLR Types for Microsoft® SQL Server® 2019.

Все вышеперечисленные компоненты можно найти на инсталляционном диске с системой в папке <..Tools\SQL_Library\>

Получение лицензии

Запустить файл C:\SL_Files\License\SL.Protect.ClientInfo.ехе
Выслать созданный файл sl.dat специалисту сервиса технической поддержки компании «Адванта-Груп».
Полученный в ответ файл sl.lic поместить в папку C:\Inetpub\wwwroot\streamline.

Внимание!

Лицензия привязывается к процессору, жестким дискам и операционной системе. При изменении количества ядер, размера\количества логических дисков, версии операционной системы необходимо генерировать новый _sl.dat и новую лицензию. Вышлите файл sl.dat с новой конфигурацией специалисту сервиса технической поддержки компании «Адванта-Груп».

Сервис для обеспечения работы таймера

Утилита для запуска сервиса – скачать

Установка

Скопировать содержимое архива в папку C:\SL_Files\Scheduler\
Запустить командную строку от имени администратора.
Запустить из командной стройки файл C:\SL_Files\Scheduler\a2schr.exe с ключом -i.

Интервал срабатывания таймера

Таймер по умолчанию срабатывает раз в 600 секунд.

Проверка работоспособности таймера

На сервере должна быть включена служба «Advanta Scheduler»
Системный лог таймера хранится в txt файле C:\SL_Files\Scheduler\a2shcr.txt. При возникновении ошибок, они отображаются в нём.
Просмотреть журнал сработки таймера в разделе Администрирование

Настройка сервиса для массового скачивания ...

anonymous@undisclosed.example.com (Anonymous) — Fri, 15 Aug 2025 13:12:44 +0000

Настройка сервиса для массового скачивания документов единым архивом

Начиная с версии системы 3.23 появилась возможность скачивания сразу нескольких документов из Объектов единым архивом.

Инструкция по развертыванию сервиса архивации

Требования к программному обеспечению

1. Для запуска сервиса архивации на сервере необходимо:

установить .Net 6.0;
для учетной записи, из-под которой запускается сервис архивации, необходимо настроить соответствующие права на папку, в которой будут писаться/удаляться файлы.

2. Необходимо установить архиватор 7-Zip для корректной распаковки скачанных архивов с документами. Чтобы скачанные архивы по умолчанию открывались через данную программу, необходимо убедиться, что файлы с расширением .zip ассоциированы с данным архиватором.

Развертывание в качестве внешнего (удаленного) сервиса

Распаковать дистрибутив системы ADVANTA на отдельном сервере
Перейти внутри каталога с распакованным дистрибутивом в папку DocumentsArchivingService.
В подпапке Config настроить конфигурационный файл client.config сервиса архивации (см. ниже) и, при желании, выполнить настройки ведения логов в файле log4net.config.
Из командной строки установить SL.DocumentsArchiving.Service.exe (содержится в папке DocumentsArchivingService) по команде install, после чего запустить его по команде run.

Настройка конфигурации внешнего сервиса

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

Пример настройки файла конфигурации внешнего сервиса архивации

<?xml version="1.0"?>
<configuration>
  <configSections>
    <section name="unity" type="Microsoft.Practices.Unity.Configuration.UnityConfigurationSection, Microsoft.Practices.Unity.Configuration"/>
  </configSections>
 
  <connectionStrings>
    <add name="db" providerName="System.Data.SqlClient" connectionString="Server={server};Database={database};User Id={user};Password={password}; Max Pool Size = 4000"/>
    <add name="busDb" providerName="System.Data.SqlClient" connectionString="Server={server};Database={database};User Id={user};Password={password}; Max Pool Size = 4000"/>
  </connectionStrings>
 
  <appSettings>
    <add key="BusTransportType" value="SqlServer"/>
    <add key="Bus_DocumentsArchivingCommandsQueue:NumberOfWorkers" value="1"/>
    <add key="Bus_DocumentsArchivingCommandsQueue:MaxParallelism" value="3"/>
    <add key="ProfilerLogEnable" value="true"/>
    <add key="IsWriteToProfilerLogAllRequests" value="true"/>
    <add key="ProfilerAllLogsSizeLimitMegaBytes" value="10"/>
    <add key="CompressionLevel" value="Optimal"/>
    <add key="TemporaryArchiveFlat" value="FileSystem"/>
    <add key="PathToTemporaryArchiveFlat" value="C:\Temp"/>
  </appSettings>
 
  <unity xmlns="http://schemas.microsoft.com/practices/2010/unity">
    <container>
      <register type="Advanta.Files.IFileStorageProvider, Advanta.Infrastructure" 
			    mapTo="SL.Storage.SqlFileStorageProvider, SL.DocumentsArchiving.Service">
        <constructor>
          <param name="connectionStringName" value="db" type="string"></param>
        </constructor>
      </register>
    <!--
      <register type="Advanta.Files.IFileStorageProvider, Advanta.Infrastructure" 
			    mapTo="SL.Storage.LocalFileStorageProvider, SL.DocumentsArchiving.Service">
        <constructor>
          <param name="documentsFolder" type="string" value="C:\LocalFileStorage" />
        </constructor>
      </register>
      -->
    </container>
  </unity>
</configuration>

Обязательные настройки отмечены -звездочкой (*)

<configSections> (*) - не изменяется
<connectionStrings> (*) - настройка параметров подключения сервиса к базе данных системы ADVANTA
- <add name=«db» providerName=«System.Data.SqlClient» connectionString=«{DbConnectionString}» /> (*)
  - name - тип подключения, возможные значения: db
  - providerName - указание провайдера для подключения, возможные значения: System.Data.SqlClient
  - connectionString - заменить значение {DbConnectionString} на корректную строку подключения к базе данных
- <add name=«busDb» providerName=«System.Data.SqlClient» connectionString=«{DbConnectionString}» />
  - name - тип подключения, возможные значения: busDb - имя строки подключения для шины данных
  - providerName - указание провайдера для подключения, возможные значения: System.Data.SqlClient
  - connectiongString - заменить значение {DbConnectionString} на корректную строку подключения к базе данных
<appSettings> (*) - основные настройки приложения типа ключ-значение <add key=«{Key}» value=«{Value}» /> - один параметр определяет одну настройку. Описание значений ключей:
- BusTransportType - тип транспорта для шины данных, возможные значения (если в конфиге нет параметра, используется значение SqlServer):
  - SqlServer - шина данных работает через SQL Server (требует указания в разделе <connectionStrings> выше строки подключения с именем busDb)
  - InMemory - шина данных работает через память
- Bus_DocumentsArchivingCommandsQueue:NumberOfWorkers - количество обработчиков событий сервиса архивации документов, значение по умолчанию 1
- Bus_DocumentsArchivingCommandsQueue:MaxParallelism - максимальный параллелизм обработчиков событий сервиса архивации документов, значение по умолчанию 3
- ProfilerLogEnable (*) - запущена ли запись событий сервиса архивации документов профайлером (true или false)
- IsWriteToProfilerLogAllRequests (*) - следует ли записывать все события сервиса архивации документов профайлером (true или false)
- ProfilerAllLogsSizeLimitMegaBytes (*) - суммарный лимит (в МБ) журналов профайлера
- CompressionLevel - степень сжатия архивов сервисом архивации документов (значение по умолчанию Optimal):
  - Optimal - максимальное сжатие
  - Fastest - максимальная скорость архивации
  - NoCompression - без сжатия
- TemporaryArchiveFlat - место временного размещения скачанных архивируемых файлов - только для DocumentsArchivingService=Local (значение по умолчанию Memory):
  - Memory - оперативная память
  - FileSystem - файловая система
- PathToTemporaryArchiveFlat - путь к папке для временного размещения скачанных архивируемых файлов - работает и обязателен только для варианта TemporaryArchiveFlat = FileSystem
<unity> - настройки DI-контейнера. Надо выбрать только 1 из вариантов, а второй закомментировать (как в примере выше):
- <register>…первый блок …</register> - при разрешении зависимости в SL.Storage.SqlFileStorageProvider (файлы хранятся в БД)
- <register>…второй блок …</register> - при разрешении зависимости в SL.Storage.LocalFileStorageProvider (файлы хранятся на диске, значение value параметра documentsFolder должно содержать имя папки с файлами)

Настройка логирования работы внешнего сервиса архивации

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

Пример содержания файла log4net.config:

<?xml version="1.0" encoding="utf-8" ?>
<log4net>
    <root>
      <level value="ALL"/>
      <appender-ref ref="appender"/>
    </root>
    <appender name="appender" type="log4net.Appender.RollingFileAppender">
      <file value="archsvc.log"/>
      <appendToFile value="true"/>
      <rollingStyle value="Size"/>
      <maxSizeRollBackups value="3"/>
      <maximumFileSize value="3MB"/>
      <staticLogFileName value="true"/>
      <layout type="log4net.Layout.PatternLayout">
	    <conversionPattern value="%d %-5p %m%n"/>
      </layout>
    </appender>
</log4net>

Подробнее о значениях параметров файла настройки см. в официальной документации Log4net - https://logging.apache.org/log4net/manual/configuration/appenders/rollingfileappender.html

Развертывание в качестве локального сервиса

Для использования локального сервиса архивации (встроенного в Cистему), устанавливать отдельно его не нужно, но необходимо настраивать параметры сервиса в конфигурационном файле client.config самой Системы (см. ниже).

Рекомендуется разворачивать сервис архивации файлов только удаленно, т.е. на отдельном сервере, отличном от сервера, где установлена Система ADVANTA.

Принципы настройки сервиса архивирования файлов

Для настройки сервиса для массового скачивания документов единым архивом необходимо:

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

2. Скорректировать раздел appSettings в конфигурационном файле client.config сервера приложения ADVANTA, добавив параметры для настройки взаимодействия с Сервисом массового скачивания документов:

При использовании сервиса архивации на отдельном сервере

<appSettings>
 
    <!-- текущие настройки Системы -->
 
    <!-- Пример настройки Системы для архивации файлов на отдельном сервере -->
 
    <add key="DocumentsArchivingService" value="Remote" />
 
    <add key="DocumentsArchiveLifeTimeHours" value="168" />	
    <add key="MaxTotalFileSize" value="2097152000" />
    <add key="MaxFileCount" value="500" />
    <add key="MaxDocumentsArchivingActionCount" value="3" />
    <add key="MaxFullPathLength" value="150" />
    <add key="MinFolderNameLength" value="3" />
    <add key="MinRootFolderNameLength" value="30" />  
 
</appSettings>

При использовании локального сервиса архивации необходимо настроить дополнительные параметры, кроме указанных выше

<appSettings>
 
    <!-- текущие настройки Системы -->
 
    <!-- Пример настройки Системы для архивации файлов на одном сервере с приложением ADVANTA -->
 
    <add key="DocumentsArchivingService" value="Local" />
 
    <!-- Параметры, по аналогии с примером выше для использования удаленного сервиса архивации -->
 
    <!-- Дополнительные параметры при выборе локального сервиса архивации файлов -->
 
    <add key="Bus_DocumentsArchivingCommandsQueue:NumberOfWorkers" value="1"/>
    <add key="Bus_DocumentsArchivingCommandsQueue:MaxParallelism" value="3"/>
    <add key="ProfilerLogEnable" value="true"/>
    <add key="IsWriteToProfilerLogAllRequests" value="true"/>
    <add key="ProfilerAllLogsSizeLimitMegaBytes" value="10"/>
    <add key="CompressionLevel" value="Optimal"/>
    <add key="TemporaryArchiveFlat" value="Memory"/>
    <add key="PathToTemporaryArchiveFlat" value="C:\Temp"/>  
 
</appSettings>

Где:

DocumentsArchivingService - ключ активации функционала, указывающий на расположение сервиса архивации документов:
- Remote - используется удалённый сервис архивации документов
- Local - используется встроенный в Систему сервис архивации документов
- Если этот ключ отсутствует в конфиге, то сервис архивации документов недоступен, в интерфейсе просмотра документов по проектам не будет чекбоксов для выбора файлов для массового скачивания.
DocumentsArchiveLifeTimeHours - время жизни архивов документов (в часах), значение по умолчанию 168
MaxTotalFileSize - максимальный суммарный размер файлов (в байтах) для архивирования документов. Если в конфиге нет параметра, используется значение 2097152000
MaxFileCount - максимальное количество файлов для архивирования документов. Если в конфиге нет параметра, используется значение 500
MaxDocumentsArchivingActionCount - максимальное количество одновременно выполняемых задач архивирования документов. Если в конфиге нет параметра, используется значение 3
MaxFullPathLength - максимальная длина полного пути в архиве (символов), значение по умолчанию 200
MinFolderNameLength - минимальная допустимая при сокращении длина названия папок архива (кроме корневой), значение по умолчанию 6
MinRootFolderNameLength - минимальная допустимая при сокращении длина названия корневой папки, значение по умолчанию 30

Параметры, доступные в файле client.config основного приложения ADVANTA только для варианта, когда DocumentsArchivingService = Local:

Bus_DocumentsArchivingCommandsQueue:NumberOfWorkers - количество обработчиков событий сервиса архивации документов, значение по умолчанию 1
Bus_DocumentsArchivingCommandsQueue:MaxParallelism - максимальный параллелизм обработчиков событий сервиса архивации документов, значение по умолчанию 3
ProfilerLogEnable - запущена ли запись событий сервиса архивации документов профайлером (true или false)
IsWriteToProfilerLogAllRequests - следует ли записывать все события сервиса архивации документов профайлером (true или false)
ProfilerAllLogsSizeLimitMegaBytes - суммарный лимит (в МБ) журналов профайлера
CompressionLevel - степень сжатия архивов сервисом архивации документов (значение по умолчанию Optimal):
- Optimal - максимальное сжатие
- Fastest - максимальная скорость архивации
- NoCompression - без сжатия
TemporaryArchiveFlat - место временного размещения скачанных архивируемых файлов - только для DocumentsArchivingService=Local (значение по умолчанию Memory):
- Memory - оперативная память
- FileSystem - файловая система
PathToTemporaryArchiveFlat - путь к папке для временного размещения скачанных архивируемых файлов - только для варианта TemporaryArchiveFlat = FileSystem

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

Если ключ активации функционала не указан, то возможности массового скачивания нет, даже если право «Скачивание нескольких документов» явно разрешено.

Подробнее об отслеживании хода процесса скачивания документов единым архивом на странице «Фоновые процессы».

Настройка авторизации через Open ID Connect

anonymous@undisclosed.example.com (Anonymous) — Mon, 09 Sep 2024 07:03:51 +0000

Настройка авторизации через Open ID Connect

Настройка конфигурационного файла

Начиная с версии системы 3.29 в настройках конфигурационного файла системы client.config появился раздел, в котором в виде массива можно указать перечень внешних сервисов аутентификации по протоколу OpenIdConnect.

Перечень провайдеров авторизации через OpenIdConnect задается в файле client.config в разделе <openIdConnect>:

 /* Массив */
 
...
<openIdConnect>
  <providers>
    <add caption="Имя кнопки входа с названием провайдера" clientId="advanta"
    metadataURL="https://ssotest.yourcompany.ru/.well-known/openid-configuration"
    authenticationType="OIDC1" enabled="true" scope="openid profile"
    clientSecret="Секретный код провайдера" responseType="code" claimType="user_id" />
    <add ... /> /* Описание второго провайдера */
  <providers/>
</openIdConnect>
...

Параметр	Описание
caption	Обязательный параметр Название провайдера авторизации для отображения кнопки с этим именем
metadataURL	Обязательный параметр URL-адрес удаленного сервера с метаданными
authenticationType	Обязательный параметр Идентификатор провайдера авторизации, под этим именем данный провайдер OpenIdConnect будет отображаться в профиле пользователя, а также использоваться в API методах. Можно использовать любой удобный
clientId	Обязательный параметр Идентификатор клиента (приложения), выбирается согласно правилам именования сервисов для аутентификации в OpenIdConnect
enabled	Обязательный параметр Включение/отключение провайдера, возможные значения: true и false
scope	Указываются запрашиваемые скоупы. Если параметр не задан, то используется только скоуп `openid` Может быть несколько
clientSecret	Обязательный параметр Указывается секрет приложения
responseType	Необязательный параметр. Тип ответа, по умолчанию `id_token`. Возможные значения: `code`, `code id_token`, `code id_token token`, `code token`, `id_token`, `id_token token`, `token`
claimType	Тип утверждения, используемый для получения идентификатора пользователя на сервере авторизации. Будет использоваться для связки пользователя системы с пользователем OpenIdConnect
disableSignatureValidation	Необязательный параметр Отключает валидацию токена. Если параметр не задан, то значение false и валидация включена
jwksFilePath	Опциональный параметр Файл, который содержит ключи валидации в формате JSON. Формат аналогичен странице `jwks_uri`. Если параметр не задан, то ключи берутся только с адреса `jwks_uri` Можно использовать, если по какой-то причине провайдер OpenIdConnect не предоставляет ключи валидации Пример использования: `jwksFilePath` = ″C:\inetpub\wwwroot\a2key\jwksFile.txt″

В client.config также необходимо добавить индикацию, что необходимо использовать интеграцию с OpenIdConnect. Для этого опционально в разделе <configSections> предусмотреть размещение секции ″<section name= ″openIdConnect″ type=″Config.OpenIdConnectConfigurationSection,smcorelib″/>″. При отсутствии данной секции, использование OpenIdConnect невозможно.

Вход в систему

Настройка авторизации через Open ID Connect производится Администратором системы, в том числе привязка профилей пользователей ADVANTA к провайдерам авторизации.

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

Подробная информация о входе в систему через провайдер аутентификации на странице Авторизация по протоколу Open ID Connect.

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

в портлете с сервисами авторизации в настройках пользователя удалить привязку к сервису;
использовать метод API DeleteLinksWithOpenIdConnect. Подробнее о методах API на странице Описание методов API.

Настройка связки учетных записей

После настройки в файле client.config сервисов авторизации, они станут отображаться в виде портлета в настройках пользователя, после портлета «Мои настройки». В данном портлете есть возможность указывать/удалять идентификатор сервиса авторизации (создавать/удалять привязку к сервису).

Также создать привязку пользователя к сервису авторизаций можно используя метод API LinkUserToOpenIdConnect .

В портлете указана информация:

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

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

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

Пример настройки авторизации через Open ID Connect

В примере представлена настройка конфигурационного файла системы client.config для авторизации через провайдера Blitz IDP.

...
<configSections>
    ...
    <section name="openIdConnect" type="Config.OpenIdConnectConfigurationSection, smcorelib"/>
</configSections>
 
...
 
<openIdConnect>
    <providers>
      <add caption="Blitz IDP" clientId="Advanta"
      metadataURL="https://blitz.domain.ru/blitz/oauth/.well-known/openid-configuration"
      authenticationType="blitz" enabled="true" scope="openid" clientSecret="00000000"
      responseType="code" claimType="user_id" />
 
      <add caption="SSO" clientId="a2nta"
      metadataURL="https://blitz.domain2.ru/blitz/oauth/.well-known/11"
      authenticationType="blitz2" enabled="true" scope="profile" clientSecret="11111111"
      responseType="code" claimType="user_id" />
...
    </providers>
</openIdConnect>
 
...

Администратор может настроить авторизацию через любого провайдера OpenIdConnect.

Логирование событий входа

При удачном/неудачном входе пользователем в систему через OpenIdConnect Администратор может видеть соответствующие события в Ленте событий.

Перевод Системы с протокола http на протокол https

anonymous@undisclosed.example.com (Anonymous) — Fri, 10 Jan 2025 10:02:58 +0000

Перевод Системы с протокола http на протокол https

Если при разворачивании Системы ADVANTA использовался устаревший протокол http, рекомендуется перевести Систему на использование протокола https, т.к. раздел Системы с диаграммой Ганта доступен только при работе Системы через https.

Для перевода Системы на использование протокола https:

1. На веб-сервере перейти в конфигурационный файл client.config (путь: C:\inetpub\wwwroot\streamline).

2. В строке

<add key="WebPath" value="http://<адрес системы>/streamline"/>

заменить адрес Системы на https:⁄⁄<адрес системы>⁄streamline, изменения сохранить.

Если в файле client.config, в указанном пути изначально не было указано имя приложения (например, в указанной строке стоит значение «http:⁄⁄<адрес системы>»), то указывать имя приложения в измененном значении также не нужно (оставить https:⁄⁄<адрес системы>).

3. Далее необходимо открыть диспетчер служб IIS (Internet Information Services) и подключить верифицированный сертификат (либо создать самозаверенный).

4. После нужно выбрать сайт c Системой, в меню справа добавить в привязках тип https. В поле hostname прописать адрес Системы (<адрес системы>) c добавлением сертификата, сохранить.

5. Из привязок IIS (bindings) убрать обращение по протоколу http и работать с Системой только по протоколу https.

После перенастройки необходимо перезапустить пул с приложением и проверить решение.

Подробная информация об установке и настройке Системы находится на страницах:

Информационная безопасность. ...

anonymous@undisclosed.example.com (Anonymous) — Fri, 13 Mar 2026 06:33:55 +0000

Информационная безопасность. Руководство для администратора

Обеспечение безопасности данных

Хранение информации и доступ к ней

Вся информация, кроме документов, хранится в одной базе данных. Документы хранятся в специальной папке на сервере приложения (C:\SL_Files\Doc_Files). Для обеспечения безопасного доступа рекомендуется создать пользователя в Active Directory, от имени которого будет запускаться пул IIS, и который будет иметь доступ к папке с документами.

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

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

Учетные записи пользователей

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

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

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

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

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

Также настраивается число попыток ввода пароля, при превышении которого пользователь будет заблокирован. Список заблокированных пользователей находится в разделе Администрирование → Управление безопасностью → Безопасность.

Учетная запись Администратора

Рекомендуется формировать в Системе две учетные записи для Администратора:

С лицензией Администратор.
Она привязана на общую почту администраторов (к примеру, support@mail.company). При увольнении Администратора Системы очень просто сменить (восстановить) пароль через почту другому администратору и продолжать пользоваться этой учетной записью для необходимых настроек.
С обычной лицензией (исполнитель\руководитель), если таковая необходима.
При увольнении Администратора эта учетная запись может быть закрыта в обычном порядке. Таким образом, полномочия Администратора могут быть переданы другому пользователю при необходимости.

Для управления доступом пользователям в Системе рекомендуется выделить отдельную пользовательскую учетную запись, которая не будет иметь все права администратора (доступно с версии Системы 3.24 и позднее). Как правило, это важно для крупных компаний, так как часто задачи управления доступом пользователей выполняет сотрудник, который не должен иметь полных прав ко всем данным системы и к изменениям настроек.

Рекомендуется использовать учетную запись с типом «Администратор», только для настройки системы или реализации интеграций, так как для пользователей с таким типом учетной записи отключены проверки на наличие прав доступа и могут нарушаться требования по обеспечению консистентности данных. Также при просмотре данных через интерфейс или при формировании отчетов у пользователя с типом учемной записи «Администратор» отключается проверка прав на объекты иерархического дерева и справочники, что с одной стороны может давать ускорение в получении данных, но с другой - может нарушать соблюдение требований настроенных процессов при изменении данных.

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

Передача данных по сети

Для предотвращения перехвата информации при ее передаче по сетям общего пользования (например, Интернет) необходимо использовать протокол HTTPS с длиной ключа не менее 128 бит.

В целях безопасности все остальные порты можно блокировать.

Доставка уведомлений по электронной почте

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

Работа в VPN

Сервер системы ADVANTA может быть установлен внутри сети компании (например, в локальной сети офиса). При этом пользователи удаленных сетей (локальные сети в офисах других городов) могут совершенно прозрачно обращаться к серверу через VPN (Virtual Private Network) по адресу (IP или имени), указанному администратором.

Мониторинг пользователей

Список событий в Системе

Все существующие типы событий по действиям пользователей в конкретном экземпляре системы расположены на странице https://адрес_приложения/api/businessevents.

Список событий может быть выгружен в json-файл.

Системный протокол

Системный протокол — важная часть безопасности системы.

В системном протоколе отражаются события, которые:

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

Список отображаемых действий пользователей:

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

Список можно отфильтровать:

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

Системный протокол располагается в системе по следующему пути: Администрирование → Управление безопасностью → Системный протокол.

События системного протокола можно выгрузить в *.xls.

Подробнее — по ссылке.

Лог авторизаций

Лог авторизаций в системе доступен по следующему пути: Администрирование → Управление безопасностью → Безопасность, портлет «Лог авторизаций».

В этот лог записываются следующие данные: время авторизации в формате ДД.ММ.ГГГГ ЧЧ:ММ:СС; имя пользователя в Системе; IP адрес.

Также в системе записываются неудачные попытки авторизации.

Отчёт по правам пользователей

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

Права пользователя располагаются в системе по следующему пути: зайдите на карточку пользователя → меню три точки → «Права пользователя».

Подробнее - по ссылке.

Отчет по правам пользователей на уровне объектов

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

Отчет по правам конкретного объекта располагается в системе по следующему пути: зайдите в объект, доступ к которому вы хотите проверить → меню “три точки” → «Права доступа» → в портлете «Роли безопасности проекта» → «отчёт по правам».

Подробнее - по ссылке.

События электронной почты

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

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

В портлете «Ошибки при отправке сообщений» также доступна фильтрация по временному периоду и пользователям. Фильтрация становится доступна при появлении соответствующих событий.

Обслуживание системы

Создание резервной копии данных системы

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

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

Базы данных streamline (подробнее см. справка Microsoft, подраздел «Как создать резервную копию базы данных (среда SQL Server Management Studio)», ссылка на статью).
Документов системы (путём копирования папки с документами системы, например, на внешний носитель и или сетевой каталог для хранения резервных копий.
Путь до папки указывается в разделе <constructor>, имя параметра documentsFolder, в файле client.config, расположенном в папке веб-контента системы).
Веб-контента системы (путём копирования папки C:\Inetpub\wwwroot\streamline, например, на внешний носитель и или сетевой каталог для хранения резервных копий).

Тестовая среда

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

Требования к аппаратному обеспечению сервера ...

anonymous@undisclosed.example.com (Anonymous) — Mon, 23 Mar 2026 12:08:48 +0000

Требования к аппаратному обеспечению сервера приложения и сервера базы данных (PostgreSQL)

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

Требования при установке на 2 сервера

Минимальные аппаратные требования к серверам

Сервер приложений
Процессор	4 ядра (8 логических потоков), частота – 2 ГГц и больше
Оперативная память	4 Гб и больше
Свободное дисковое пространство	50 Гб (зависит от размера хранимых в системе документов)
Пропускная способность сетевого интерфейса	1 Гбит/с
Сервер баз данных
Тип накопителя	SSD - min IOPS: read 12000, write 4000 (в режиме randrw)
Процессор	4 ядра (8 логических потоков), частота – 2 ГГц и больше
Оперативная память	8 Гб и больше
Свободное дисковое пространство	300 Гб и больше
Пропускная способность сетевого интерфейса	1 Гбит/с

Сервер приложений
Процессор	4 ядра (8 логических потоков), частота – 3-3,5 ГГц и больше
Оперативная память	32 Гб и больше
Свободное дисковое пространство	128 Гб (зависит от размера хранимых в системе документов)
Пропускная способность сетевого интерфейса	1 Гбит/с
Сервер баз данных
Тип накопителя	SSD - min IOPS: read 20000, write 8000 (в режиме randrw)
Процессор	4 ядра (8 логических потоков), частота – 3-3,5 ГГц и больше
Оперативная память	32 Гб и больше
Свободное дисковое пространство	300 Гб и больше
Пропускная способность сетевого интерфейса	1 Гбит/с

Требования при установке на 1 сервер

Минимальные аппаратные требования к серверу

Процессор	4 ядра (8 логических потоков), частота – 3,5 ГГц и больше
Оперативная память	12 ГБ и больше
HDD для IIS и документов	50 ГБ (зависит от размера хранимых в системе документов)
SSD для СУБД	300 ГБ и больше, min IOPS: read 12000, write 4000 (в режиме randrw)
Требования к сети	Стабильный канал связи от 10 Мб/сек

Процессор	8 ядер (16 логических потоков), частота – 3,5 ГГц и больше
Оперативная память	64 ГБ и больше
HDD для IIS и документов	128 ГБ (зависит от размера хранимых в системе документов)
SSD для СУБД	300 ГБ и больше, min IOPS: read 20000, write 8000 (в режиме randrw)
Требования к сети	Стабильный канал связи от 100 Мб/сек

Требования к программному обеспечению сервера приложения и сервера базы данных

Система может быть установлена как на одном сервере, так и разнесена на два. Некоторые ошибки при работе системы могут быть вызваны устаревшей версией установленного программного обеспечения, поэтому рекомендуем поддерживать всё требуемое для работы системы ПО в актуальном состоянии.

Система может работать на виртуальных машинах Hyper-V и VMware.

Веб-сервер

MS Windows Server 2019 и выше, со всеми последними обновлениями.
Возможна работа также на ОС MS Windows Server 2008. Но в Win2008 не поддерживаются вебсокеты ⇒ в ADVANTA не будут работать push-уведомления пользователей.
MS .Net Framework 4.8. (для версий Адванта, начиная с 3.19.xxxx включительно), MS .Net Framework 4.6.1 (начиная с версии Адванты 3.10.хххх), MS .Net Framework 4.5 (для версий Адванты до 3.09.хххх включительно).
Visual C++ Redistributable x64 и x86 – требуется установить обе версии: 64-разрядную и 32-разрядную, актуальные версии здесь
Дополнительно необходимо установить Visual C++ Redistributable 2012 x64 и x86 – также, как и в предыдущем пункте, требуется установить обе версии: 64-разрядную и 32-разрядную. Дистрибутивы актуальных сборок библиотек версии 2012 можно найти здесь
MS Internet Information Services (IIS) При установке IIS, на шаге «Службы ролей» в пункте «Разработка приложений» выбрать:
- ASP;
- ASP.NET 3.5;
- ASP.NET 4.5 (или SP/NET 4.0);
- Расширения ISAPI;
- Расширяемость .NET 3.5;
- Расширяемость .NET 4.5 (или 4.0);
- Фильтры ISAPI.

Рекомендуемая кодировка на IIS сервере – Windows-1251.

После установки ADVANTA на сервер НЕ меняйте кодировку и/или язык ОС веб-сервера.
Кодировка участвует в формирования хэша содержимого файлов.

СУБД

PostgreSQL 14 PostgreSQL может запускаться на Windows Server и на Linux.
Все вышеперечисленные компоненты можно найти на инсталляционном диске с системой в папке <..Tools\>

Пользователь БД, под которым система ADVANTA подключается к серверу баз данных, должен иметь роль OWNER на базу/схему данных или следующие права на выделенную базу/схему данных и все ее таблицы (где применимо):

SELECT
INSERT
UPDATE
DELETE
TRUNCATE
REFERENCES
TRIGGER
CREATE
CONNECT
TEMPORARY
EXECUTE
USAGE

Почтовый сервер

Не обязательно
SMTP сервер с поддержкой STARTTLS – для рассылки уведомлений на e-mail'ы пользователей из системы.

Схемы лицензирования ПО MS определяются индивидуально.

Требования к пользовательской станции

К компьютеру, с которого планируется работа в системе, предъявляются следующие требования:

Операционная система MS Windows 7 и более поздние версии / Linux / macOS;
Браузер Google Chrome, Mozilla Firefox, Safari или Яндекс.Браузер последних версий.
Браузер Internet Explorer любых версий не поддерживается¹⁾. Мы не рекомендуем пользоваться им.
В IE нет полноценной поддержки работы вертикального скроллинга в диаграмме Ганта, поддержки работы с шириной колонок типовых отчетов, могут также некорректно отображаться и другие инструменты управления в интерфейсе.

Не гарантируется работа всех функций при масштабе окна браузера, отличного от 100%.

Для активного использования отчёта "Электронная таблица" и диаграммы Ганта минимальные требования к пользовательской станции²⁾:

процессор Intel Core i3-9100F (наиболее близкий аналог – AMD Ryzen 5 2600);
Тактовая частота процессора должна быть не менее 3,4 ГГц.
от 8 Гб оперативной памяти.
Рекомендуемый объём ОЗУ – 16 Гб.

Требования к скорости соединения

Пропускная способность сети между клиентом и сервером приложений должна составлять:

для номинальной работы клиентской части – 1 Мбит/c;
рекомендуемая пропускная способность – 10 Мбит/c или выше.

Требования для работы с электронно-цифровой подписью

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

ПО платное, ознакомиться с ценами можно на сайте компании КриптоПро.

Для корректной работы электронно-цифровой подписи необходимо:

Установить «Крипто ПРО» на компьютер пользователя, которому необходима ЭЦП. Скачать программу можно здесь.
Установить плагин для создания и проверки электронной подписи на web-страницах на компьютер пользователя. Скачать плагин можно здесь.
Выдать сертификат. Получить сертификат можно здесь.

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

Установка корневого сертификата

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

Введите в строке поиска Windows «mmc» и нажмите ввод.
В открывшейся консоли перейдите «Файл» → «Добавить или удалить оснастку».
В группе «Доступные оснастки» выберите «Сертификаты» и нажмите «Добавить».
В открывшемся окне выберите «Учётная запись компьютера» → Далее → «Локальным компьютером» → Готово.
В дереве консоли нажмите правой кнопкой на «Сертификаты» → «Все задачи» → «Импорт».
В Мастере импорта сертификатов укажите путь к расположению сертификата → Далее → «Поместить все сертификаты в следующее хранилище» → Готово.

Установка личного сертификата

Откройте КриптоПро CSP, на вкладке «Сервис» нажмите «Установить личный сертификат…».
В открывшемся окне «Мастер установки личного сертификата» укажите путь к сертификату.
На следующем шаге укажите контейнер закрытого ключа, который соответствует выбранному сертификату.
Далее выберите хранилище – «Личное», куда будет установлен сертификат, отметьте пункт «Установить сертификат (цепочку сертификатов) в контейнер» → Готово.
После этого может появиться сообщение с вопросом о замене существующего сертификата новым, нажмите «Да».
Проверить корректность работы плагина.
В профиле пользователя активировать опцию «Использовать ЭП в согласованиях».

¹⁾

начиная с версии ADVANTA 3.19

²⁾

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

Требования к аппаратному обеспечению сервера ...

anonymous@undisclosed.example.com (Anonymous) — Mon, 23 Mar 2026 12:09:31 +0000

Требования к аппаратному обеспечению сервера приложения и сервера базы данных (MS SQL Server)

Для версий системы 1.8.2.2 и выше.

Требования при установке на 2 сервера

Минимальные аппаратные требования к серверам

Сервер приложений
Процессор	4 ядра (8 логических потоков), частота – 2 ГГц и больше
Оперативная память	4 Гб и больше
Свободное дисковое пространство	50 Гб (зависит от размера хранимых в системе документов)
Пропускная способность сетевого интерфейса	1 Гбит/с
Сервер баз данных
Тип накопителя	SSD - min IOPS: read 12000, write 4000 (в режиме randrw)
Процессор	4 ядра (8 логических потоков), частота – 2 ГГц и больше
Оперативная память	8 Гб и больше
Свободное дисковое пространство	300 Гб и больше
Пропускная способность сетевого интерфейса	1 Гбит/с

Сервер приложений
Процессор	4 ядра (8 логических потоков), частота – 3-3,5 ГГц и больше
Оперативная память	32 Гб и больше
Свободное дисковое пространство	128 Гб (зависит от размера хранимых в системе документов)
Пропускная способность сетевого интерфейса	1 Гбит/с
Сервер баз данных
Тип накопителя	SSD - min IOPS: read 20000, write 8000 (в режиме randrw)
Процессор	4 ядра (8 логических потоков), частота – 3-3,5 ГГц и больше
Оперативная память	32 Гб и больше
Свободное дисковое пространство	300 Гб и больше
Пропускная способность сетевого интерфейса	1 Гбит/с

Требования при установке на 1 сервер

Минимальные аппаратные требования к серверу

Процессор	4 ядра (8 логических потоков), частота – 3,5 ГГц и больше
Оперативная память	12 ГБ и больше
HDD для IIS и документов	50 ГБ (зависит от размера хранимых в системе документов)
SSD для SQL	300 ГБ и больше, min IOPS: read 12000, write 4000 (в режиме randrw)
Требования к сети	Стабильный канал связи от 10 Мб/сек

Процессор	8 ядер (16 логических потоков), частота – 3,5 ГГц и больше
Оперативная память	64 ГБ и больше
HDD для IIS и документов	128 ГБ (зависит от размера хранимых в системе документов)
SSD для SQL	300 ГБ и больше, min IOPS: read 20000, write 8000 (в режиме randrw)
Требования к сети	Стабильный канал связи от 100 Мб/сек

Требования к программному обеспечению сервера приложения и сервера базы данных

Система может работать на виртуальных машинах Hyper-V и VMware.

Веб-сервер

MS Windows Server 2019 и выше, со всеми последними обновлениями.
Возможна работа также на ОС MS Windows Server 2008. Но в Win2008 не поддерживаются вебсокеты ⇒ в ADVANTA не будут работать push-уведомления пользователей.
MS .Net Framework 4.7.2 (для версий Адванта, начиная с 3.19.xxxx включительно), MS .Net Framework 4.6.1 (начиная с версии Адванты 3.10.хххх), MS .Net Framework 4.5 (для версий Адванты до 3.09.хххх включительно).
Visual C++ Redistributable x64 и x86 (актуальную версию библиотек) – необходимо установить 64-разрядную и 32-разрядную сборки, их можно найти здесь
Дополнительно необходимо установить Visual C++ Redistributable 2012 x64 и x86 – также, как и в предыдущем пункте, требуется установить обе версии: 64-разрядную и 32-разрядную. Дистрибутивы актуальных сборок библиотек версии 2012 можно найти здесь
MS Internet Information Services (IIS) При установке IIS, на шаге «Службы ролей» в пункте «Разработка приложений» выбрать:
- ASP;
- ASP.NET 3.5;
- ASP.NET 4.5 (или SP/NET 4.0);
- Расширения ISAPI;
- Расширяемость .NET 3.5;
- Расширяемость .NET 4.5 (или 4.0);
- Фильтры ISAPI.
Библиотека Microsoft® System CLR Types for Microsoft® SQL Server® 2019.

Рекомендуемая кодировка на IIS сервере – Windows-1251.

SQL-сервер

MS Windows Server 2019 и выше, со всеми последними обновлениями
Microsoft® SQL Server 2019 со всеми последними обновлениями в редакции Standard, Enterprise.
Использование Microsoft® SQL Server в редакции Express не гарантирует стабильную работу Cистемы ADVANTA из-за существенных ограничений в данной версии ПО.

Все вышеперечисленные компоненты можно найти на инсталляционном диске с системой в папке <..Tools\>

Почтовый сервер

Схемы лицензирования ПО MS определяются индивидуально.

Требования к пользовательской станции

К компьютеру, с которого планируется работа в системе, предъявляются следующие требования:

Операционная система MS Windows 7 (и более поздние версии) или операционная система на базе ядра Linux, поддерживающая работу перечисленных ниже браузеров;
Браузер Google Chrome, Mozilla Firefox, Safari или Яндекс.Браузер последних версий.

Браузер Internet Explorer любых версий не поддерживается ¹⁾. Мы не рекомендуем пользоваться им.
В IE нет полноценной поддержки работы вертикального скроллинга в диаграмме Ганта, поддержки работы с шириной колонок типовых отчетов, могут также некорректно отображаться и другие инструменты управления в интерфейсе.

Не гарантируется работа всех функций при масштабе окна браузера, отличного от 100%.

процессор Intel Core i3-9100F (наиболее близкий аналог – AMD Ryzen 5 2600);
Тактовая частота процессора должна быть не менее 3,4 ГГц.
от 8 Гб оперативной памяти.
Рекомендуемый объём ОЗУ – 16 Гб.

Требования к скорости соединения

Пропускная способность сети между клиентом и сервером приложений должна составлять:

для номинальной работы клиентской части – 1 Мбит/c;
рекомендуемая пропускная способность – 10 Мбит/c или выше.

Требования для работы с электронно-цифровой подписью

ПО платное, ознакомиться с ценами можно на сайте компании КриптоПро.

Для корректной работы электронно-цифровой подписи необходимо:

Установить «Крипто ПРО» на компьютер пользователя, которому необходима ЭЦП. Скачать программу можно здесь.
Установить плагин для создания и проверки электронной подписи на web-страницах на компьютер пользователя. Скачать плагин можно здесь.
Выдать сертификат. Получить сертификат можно здесь.

Установка корневого сертификата

Введите в строке поиска Windows «mmc» и нажмите ввод.
В открывшейся консоли перейдите «Файл» → «Добавить или удалить оснастку».
В группе «Доступные оснастки» выберите «Сертификаты» и нажмите «Добавить».
В открывшемся окне выберите «Учётная запись компьютера» → Далее → «Локальным компьютером» → Готово.
В дереве консоли нажмите правой кнопкой на «Сертификаты» → «Все задачи» → «Импорт».
В Мастере импорта сертификатов укажите путь к расположению сертификата → Далее → «Поместить все сертификаты в следующее хранилище» → Готово.

Установка личного сертификата

Откройте КриптоПро CSP, на вкладке «Сервис» нажмите «Установить личный сертификат…».
В открывшемся окне «Мастер установки личного сертификата» укажите путь к сертификату.
На следующем шаге укажите контейнер закрытого ключа, который соответствует выбранному сертификату.
Далее выберите хранилище – «Личное», куда будет установлен сертификат, отметьте пункт «Установить сертификат (цепочку сертификатов) в контейнер» → Готово.
После этого может появиться сообщение с вопросом о замене существующего сертификата новым, нажмите «Да».
Проверить корректность работы плагина.
В профиле пользователя активировать опцию «Использовать ЭП в согласованиях».

¹⁾

начиная с версии ADVANTA 3.19

²⁾

Настройки таймера

anonymous@undisclosed.example.com (Anonymous) — Thu, 06 Nov 2025 13:08:14 +0000

Настройки таймера

Утилита для запуска сервиса – скачать

Установка

Скопировать содержимое архива в папку C:\SL_Files\Scheduler\
Запустить командную строку от имени администратора.
Запустить из командной стройки файл C:\SL_Files\Scheduler\a2schr.exe с ключом -i.

Интервал срабатывания таймера

Таймер по умолчанию срабатывает раз в 600 секунд.

Проверка работоспособности таймера

На сервере должна быть включена служба «Advanta Scheduler»
Системный лог таймера хранится в txt файле C:\SL_Files\Scheduler\a2shcr.txt. При возникновении ошибок, они отображаются в нём.
Просмотреть журнал сработки таймера в разделе Администрирование

Обновление системы

anonymous@undisclosed.example.com (Anonymous) — Tue, 21 Apr 2026 08:56:15 +0000

Обновление системы

Получение пакета обновления

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

Как получить пакет обновления:

связаться со специалистом технической поддержки и запросить пакет обновления на e-mail;

ИЛИ

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

Проведение обновления

Система обновляется с помощью модуля обновления.

Проверьте конфигурацию и компоненты сервера

Язык локализации операционной системы Русский - на других языках модуль обновления может работать некорректно.
Версия PowerShell на сервере (команда $host.Version) должна быть не ниже 4-й на Windows Server 2019. Если ниже – обновите PowerShell.
Microsoft .NET Framework 4.6.1 (можно скачать по ссылке)
Microsoft .NET Framework 4.7.2
Необходимо начиная с версии ADVANTA 3.19.
(Можно скачать по ссылке.)
Visual C++ Redistributable 2012 x64 (можно скачать по ссылке)
Протокол WebSocket.
Необходимо начиная с версии ADVANTA 3.18
Команда в Poweshell для установки: Install-WindowsFeature -name Web-WebSockets

Сделайте бэкап

Сделать резервную копию базы данных (делается стандартными средствами, встроенными в SQL Server Management Studio).
Резервная копия веб-контента создается автоматически и помещается в папку C:\SL_Files\Backup\<название приложения системы (по умолчанию Streamline)>\context_bkp\.
Если используются сторонние скрипты, создать архив файлов каталога C:\Inetpub\wwwroot\<название приложения системы (по умолчанию Streamline)>\_Resources\Config\ThirdPartyScripts. Сохранить вне папки приложения системы (папка будет очищена при обновлении).

Запустите модуль обновления

Скачать модуль обновления по предоставленной ссылке (ссылка предоставляется в сформированной дискуссии по обновлению).
Сохранить и распаковать архив с обновлением в папку C:\SL_Files\Updates.
Запустить на сервере с системой PowerShell с правами администратора.
Выполнить команду для разрешения выполнения скриптов в PowerSell: Set-ExecutionPolicy Unrestricted
Перейти в распакованную папку с обновлением. Команда: cd C:\SL_Files\Updates\<номер версии предоставленного обновления>\Updates
Запустить скрипт: .\deploy.ps1
Высветится список всех установленных систем на сервере.
Выбрать обновляемую систему → Ok
Модуль обновления остановит пул приложения обновляемой системы, выполнит обновление и запустит обратно пул приложения системы.

Модуль обновления формирует лог в папке C:\SL_Files\Logs

Если используются сторонние скрипты:

Восстановить содержимое каталога «_Resources\Config\ThirdPartyScripts» в папке приложения системы C:\Inetpub\wwwroot\<название приложения системы (по умолчанию Streamline)>\_Resources\Config\ThirdPartyScripts из ранее созданного архива (см. шаг «Сделайте бэкап»).
Загрузить скрипты в ADVANTA. Для этого в панели управления открыть страницу: Администрирование → Общие настройки → Настройка сторонних скриптов. Нажать кнопку «Перечитать» (подробнее в wiki).
Проверить каждый используемый сторонний скрипт. Для этого откройте страницу, где используется скрипт, и проверьте его работоспособность.

Если процедура обновления до определенной версии имеет какие-то особенности, то это описывается в прилагаемой к пакету обновления инструкции.

Обновление лицензии

Необходимость в обновлении лицензии может возникнуть в следующих случаях:

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

Чтобы получить новую лицензию, сделайте запрос в техническую поддержку компании «Адванта-Груп».

Если конфигурации сервера были изменены:

запустите файл C:\SL_Files\License\SL.Protect.ClientInfo.ехе;
вышлите созданный файл _sl.dat специалисту сервиса технической поддержки компании «Адванта-Груп»;
полученный в ответ файл sl.lic поместить в папку C:\Inetpub\wwwroot\streamline;
перезапустите IIS.

Настройка прокси-сервера

Если вы используете прокси для подключения к ADVANTA, то должен быть настроен одинаковый протокол подключения (http или https) и для Адванты, и для прокси-сервера.

Начиная с версии 3.18 необходимо внести дополнительные настройки в прокси-сервере:

Например, для nginx необходимо добавить три строки:

proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";

Настройка хранения строк подключения в Hashicorp Vault

anonymous@undisclosed.example.com (Anonymous) — Tue, 19 Nov 2024 10:23:14 +0000

Настройка хранения строк подключения в Hashicorp Vault

Начиная с версии системы 3.30, чтобы повысить безопасность хранения секретов (паролей, токенов/маркеров-доступа, API-ключей, закрытых криптографических ключей и т.п.) можно настроить подключение системы ADVANTA к СУБД или сервису Active Directory через сервис хранения секретов HashiCorp Vault.

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

Для этого в настройках конфигурационного файла системы client.config необходимо:

Добавить раздел с указанием использования сервиса хранения секретов.
Добавить раздел с перечнем ключей, получаемых из сервиса хранения секретов для строк соединения с СУБД.
Добавить раздел для получения секрета для сервисов Active Directory (если используется).
После получения секретов, добавить алгоритм замены паролей - выполняется получение всех секретов и их перечень интерпретируется как набор именованных ключей, после чего, выполняется подстановка значений найденных ключей на их значение.

Изменения в конфигурационном файле

Необходимые изменения в конфигурационном файле client.config для запуска системы через получение паролей из сервиса хранения секретов HashiCorp Vault:

В разделе <configSections> добавить обработку наличия секции <section name= ″hashiCorpVault″ type=″Config.HashiCorpVaultConfigurationSection, SL.App.Config″/>, которая будет использоваться как индикатор необходимости использовать Hashicorp Vault.
В разделе <configuration> добавить проверку и обработку секций: <hashiCorpVault address=″″ roleId=″″ secretId=″″ version=″″ mountPoint=″″ path=″″/>.

Секция hashiCorpVault содержит обязательные атрибуты:

address – адрес сервера Vault, обязательный;
roleId – идентификатор (GUID) роли, обязательный;
secretId – идентификатор (GUID) секрета, обязательный;
version – обязательный параметр, версия контейнера. Возможные варианты: V1, V2.
mountPoint – обязательный параметр, точка монтирования контейнера секретов;
path - обязательный параметр, путь к секретам.

Примеры фрагментов из конфигурационного файла

В конфигурационном файле client.config выполняется поиск ключей вида {$key$} и замена их на значения keyValue, полученные из Vault.

При наличии в секции <configuration> секции <hashiCorpVault address=″″ roleId=″″ secretId=″″ version=″″ mountPoint=″″ path=″″/>, пароли будут считаны из хранилища секретов как названия ключей и их значений (пары key, keyValue), для последующей замены.

Названия ключей в хранилище секретов должны соответствовать всем {$key$} в заменяемых фрагментах.

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

настройки приложения - секция <appSettings>, атрибут value;
настройки Active Directory - секция <adDomains>/<domains>, атрибуты: login, password, ldappath;
настройки openIdConnect - секция <openIdConnect>/<providers>, атрибут clientSecret.

Пример фрагмента из client.config:

<configuration>
  <hashiCorpVault address="https://vault.yourcompany.ru:8200" roleId="roleId" secretId="secretId" version="V2" mountPoint="kv-v2" path="dbPasswords"/>
………….  
</configuration>
 
…………..
  <connectionStrings>
	<add name="db" providerName="System.Data.SqlClient" connectionString="Server=localhost;Database=b-stable;User ID=SL_APP;Password={$db$};Pooling=true;Max Pool Size=4000; TrustServerCertificate=True" />
	<add name="dbCubes" providerName="System.Data.SqlClient" connectionString="Server=localhost;Database=b-stable;User ID={$busDB$};Password={$dbCubes$};Pooling=true;Max Pool Size=4000; TrustServerCertificate=True" />
  </connectionStrings>

В примере для двух connectionString name=″db″ и ″dbCubes″, размещены ключи: {$db$}, {$busDB$}, {$dbCubes$} - они будут заменены на их значения из хранилища секретов.