Page History

Info

title	Информация

Файлы для indeed AM Server расположены: indeed AM 7\Indeed Access Manager Server\<Номер версии>\

IndeedAM.Server-x64.ru-ru.msi - Пакет для установки Indeed Access Managerrprise Server.
/Misc/AM.KeyGen.exe - Утилита для генерации ключей шифрования.
/Misc/AccessControlInitialConfig/EA.Server.AccessControlInitialConfig.exe - Утилита первичной конфигурации.
/Misc/AccessControlInitialConfig/EA.Server.AccessControlInitialConfig.exe.config - Файл для настройки утилиты конфигурации.
/Misc/AM.Config.Encryptor/EA.Config.Encryptor.exe - Утилита для шифрования конфигурационного файла.
/Misc/AM.Config.Encryptor/EA.Config.Encryptor.exe/encryptConfigs.bat - Скрипт для шифрования всех секций конфигурационного файла.
/Misc/AM.Config.Encryptor/EA.Config.Encryptor.exe/decryptConfigs.bat - Скрипт для расшифровки всех секций конфигурационного файла.

Установка

Выполнить установку Indeed AM Server через запуск инсталлятора IndeedAM.Server-x64.ru-ru.msi.
Scroll Pagebreak

Добавить привязку https в настройках Default Web Site в IIS Manager.

Info

title	Информация

Indeed Access Manager Server является Web приложением, которое работает на базе IIS, в процессе установки для него по умолчанию включается обязательно требование SSL в настройках, что в свою очередь требует включенной привязки https.

Если вы не намерены использовать протокол https, необходимо отключить требование SSL в настройках IIS для easerver и в конфигурационном файле сервера (C:\inetpub\wwwroot\easerver\Web.config) изменить значение параметра "requireHttps" на "false".

Запустите IIS Manager и раскройте пункт Сайты (Sites).
Выберите сайт Default Web Site и нажмите Привязки (Bindings) в разделе Действия (Actions).
Нажмите Добавить (Add):
1. Тип (Type) - https.
2. Порт (Port) - 443.
3. Выберите SSL-сертификат (SSL Certificate).
Сохраните привязку.

Настройка с помощью мастера конфигурации

Note

title	Информация

Мастер конфигурации по умолчанию запускается автоматически после установки Indeed AM Server, если запуск не был отключен пользователем.

Для запуска мастера вручную откройте файл: C:\Program Files\Indeed EA\Wizard\EA.Server.Wizard.exe

Info

title	Информация

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

На шаге "Перед началом работы" нажмите “Далее”.
На шаге "Восстановление настроек" нажмите “Далее”.
На шаге "Каталог пользователей" укажите следующие параметры:
1. Имя домена (FQDN) - Укажите полное имя домена, например: domain.local.
2. Сервисная учетная запись - Укажите сервисную учетную запись, обладающую правами доступа к пользовательскому каталогу. Нажмите кнопку "Изменить" и укажите требуемые данные учетной записи.
3. LDAP путь к каталогу - Укажите путь к каталогу с пользователями. Нажмите кнопку "Выбрать" и выберете требуемый контейнер или домен целиком.
На шаге "Хранилище данных" выберете тип хранилища Microsoft SQL.
Строка подключения к базе данных - Нажмите "Изменить", чтобы задать данные для подключения к базе данных, которая будет использоваться в качестве хранилища данных Indeed AM.
1. Server name - Имя сервера БД.
2. Выберете способ аутентификации SQL "Use SQL Server Authentication" и укажите данные сервисного пользователя, с полными правами для базы данных.
3. В пункте "Select or enter a database name" выберете или укажите базу данных, которая будет использоваться в качестве хранилища Indeed AM.
4. После выполнения настройки нажмите "Test Connection". При корректной конфигурации отобразиться окно с "Test connection succeeded".
5. Нажмите "Ок" во всех окнах.

Шаг "Ключ шифрования". Выберете алгоритм шифрования, нажмите "Сгенерировать" и нажмите "Далее".

Note

title	Информация

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

На шаге "Журнальный сервер" укажите следующие данные:

Info

title	Информация

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

Адрес журнального сервера - URL для подключения к серверу в формате http(s)://полное_dns_имя_сервера/ils/ , например: http://logserver.demo.local/ils/
Сертификат - Выберете сертификат для настройки двухстороннего TLS соединения.
Журналируемое поле объекта каталога - Укажите формат в котором будет осуществляться логирование имени пользователя.
Журналируемое поле компьютера - Укажите формат в котором будет осуществляться логирование поля "Компьютер".
Info
title Информация
Для логирования в формате DNS потребуется дополнительная настройка

Шаг "Сессионный секрет". Сгенерируйте секрет для подписи токена, для этого нажмите "Сгенерировать". После генерации нажмите "Далее".

Шаг "Шифрование файла". Вы можете выполнить шифрование настроек конфигурационного файла.

Note

title	Информация

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

Шаг "Подтверждение". Убедитесь в корректности указанных данных и нажмите "Применить".

Note

title	Информация

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

Шаг "Результаты". Осуществляется проверка настроек и тестирование подключения к Indeed AM Server.

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

Note

title	Информация

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

На шаге "Администратор системы" задайте учетную запись администратора Indeed. Указанной учетной записи будут выданы первичные права администратора системы.

Info

title	Информация

Для настройки администратора требуется установленный Indeed AM Windows Password, так как при выдаче первичных прав указанному пользователю, осуществляется аутентификация на сервере Indeed AM

На шаге "Результаты" отображается статус настройки конфигурационного файла и статус настройки администратора системы.

Ручная настройка системы

Редактирование конфигурационного файла

Info

title	Информация

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

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

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

Note

title	Информация

Если в пароле для сервисных пользователей используются следующие символы: &, ", ;, <, пробел , то пароль следуют указывать так:

Символ амперсанд (&) - При указании пароля для пользователя из AD или SQL символ требуется заменить на: & Пример(AD\SQL): password="Q1q2E3e4&"\Password=Q1q2E3e4&;

Символ двойные кавычки (") - При указании пароля для пользователя из AD или SQL символ требуется заменить на: " Для пользователя из SQL дополнительно требуется указать пароль в одинарных кавычках. Пример(AD\SQL): password="Q1q2E3e4""\Password='Q1q2E3e4"';

Символ точка с запятой (;) - При указании пароля для пользователя из AD не требуется дополнительных действий, для пользователя из SQL требуется указать пароль в одинарных кавычках. Пример(AD\SQL): password="Q1q2E3e4;"\Password='Q1q2E3e4;';

Символ “меньше” (<) - При указании пароля для пользователя из AD или SQL символ требуется заменить на: < Пример(AD\SQL): password="Q1q2E3e4<"\Password=Q1q2E3e4<;

Символ “Пробел” - При указании пароля для пользователя из AD не требуется дополнительных действий, для пользователя из SQL требуется указать пароль в одинарных кавычках. Пример(AD\SQL): password="Q1q2E3e4 "\Password='Q1q2E3e4 ';

Символ "Одинарной кавычки" (') - При указании пароля для пользователя из AD не требуется дополнительных действий, для пользователя из SQL требуется указать пароль в " , символ кавычки указать в обычном виде . Пример(AD\SQL): password="Q1q2E3e4'"\Password="Q1q2E3e4'";

Откройте конфигурационный файл сервера Web.config (C:\inetpub\wwwroot\easerver\Web.config).
Добавить секретный ключ для подписи токена для параметра "secretKey" тега "logonSettings" . Параметр "secretKey" используется для создания токена пользователя в формате "jwt".
Code Block
language xml
title Пример
<logonSettings secretKey="67d7e6caec61d61239dc0b05f86063ed899931b581fa1ed8140d7843b320fe02"/>

Задать каталог пользователя системы, для этого необходимо отредактировать параметры в теге adUserCatalogProvider:

id - произвольный уникальный идентификатор каталога.
serverName - имя домена Active Directory, в котором находится каталог.
containerPath - путь к контейнеру в виде Distinguished Name или весь домен, если для хранения пользователей используется весь домен.
userName - имя сервисной учетной записи для подключения к каталогу пользователей.
password - пароль сервисной учетной записи каталога пользователей в AD.

Code Block

language	xml
title	Пример

<adUserCatalogProviders> 
	<adUserCatalogProvider id="UserId" serverName="indeed-id.local" containerPath="DC=demo,DC=local" userName="IndeedCatalogUser" 	password="Q1q2E3e4"/> 
</adUserCatalogProviders>

Указать корневой идентификатор провайдера работы с каталогом, необходимо отредактировать атрибут rootUserCatalogProviderId в теге userCatalogProviderSettings.
1. rootUserCatalogProviderId - задать значение, которое уже было задано в тэге adUserCatalogProvider в атрибуте id.
Code Block
language xml
title Пример
<userCatalogProviderSettings rootUserCatalogProviderId="UserId">

Задать хранилище данных системы. Для хранилища данных в SQL Server редактируем тег dbContextSettings и создаем тег mssqlDbContext с параметрами id и connectionString.

rootDbContextId - задать произвольно уникальное значение идентификатора хранилища.
id - задать значение, которое уже было задано в тэге rootDbContextId.
Добавить параметр connectionString, со встроенными параметрами:
- Data Source - Задает экземпляр сервера. Это свойство является обязательным для всех соединений. Допустимые значения — сетевое имя или IP-адрес сервера, local или localhost для локальных соединений.
- Initial Catalog - Определяет имя базы данных.
- User Id - Имя пользователя для подключения к базе данных.
- Password - Пароль пользователя для подключения к базе данных.

Code Block

language	xml
title	Пример

<dbContextSettings rootDbContextId="mssql"> <mssqlDbContexts> <mssqlDbContext id="mssql" connectionString="Data Source=EASERVER\EASERVER;Initial Catalog=AM_Server_7;User Id=Admin-DB;Password=Q1q2E3e4;"/> </mssqlDbContexts> </dbContextSettings>

Задать ключ шифрования данных системы. Редактируем параметры в теге encryptionSettings.
1. cryptoAlgName - указать использованный алгоритм шифрования.
2. cryptoKey - значения ключа, сгенерированного утилитой.
3. certificateThumbprint - Thumbprint сертификата, которым зашифрован ключ (чтобы не учитывать - нужно удалить атрибут).
Code Block
language xml
title Пример
<encryptionSettings cryptoAlgName="Aes" cryptoKey="90ce7dbc3ff94a7867abc6672c23cce2c3717d38af42f04293130cb68a34ecc2"/>

Задать администратора системы. Редактируем параметр userId тега accessControlAdminSettings.

userId - идентификатор пользователя в формате: “<Идентификатор каталога><нижнее подчеркивание><GUID Администратора Системы>”.

Note

title	Примечание

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

При использовании нескольких пользовательских контейнеров для <Идентификатор каталога> указывается id контейнера в котором находится администратор системы.

Code Block

language	xml
title	Пример

<accessControlAdminSettings userId="UserId_84e9ccd9-73a2-43c7-abc6-604a16902037"/>

Info

title	Информация

Получить GUID можно с помощью команды PowerShell. Предварительно необходимо установить компонент Remote Server Administration Tools:

Code Block

language	powershell
title	Пример

Get-ADUser YouUserName -Properties * | Select ObjectGUID

Задаем url для подключения к лог серверу. Редактируем тег logServer.

URL - url для подключения к log серверу в формате http(s)://имя сервера/ils/api.
Note
title Примечание
Если используется несколько серверов, указываем адрес балансировщика нагрузки.
CertificateThumbprint - если закрытый ключ в реестре, а сертификат в хранилище компьютера.
CertificateFilePath - если ключевая пара в pfx.
CertificateFilePassword - пароль от pfx.

Code Block

language	xml
title	Пример

<logServer Url="http://log.indeed-id.local/ils/api/" CertificateThumbprint="" CertificateFilePath="" CertificateFilePassword=""/>

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

Note

title	Информация

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

Открыть для редактирования файл AM.Server.AccessControlInitialConfig.exe.config.
Редактировать атрибут key - параметр value необходимо поставить в значение true, если для авторизации мы хотим использовать Windows Token.
Если сервер находится не в домене, есть вариант использовать один из следующих провайдеров: windows password, emailOTP, smsOTP. Для этого value должно быть в положении false.
Code Block
language xml
<appSettings> <add key="eaServerUrl" value="http://192.168.1.2/easerver/"/> <add key="isWindowsAuth" value="true"/> </appSettings>
Запустить на доменной машине утилиту AM.Server.AccessControlInitialConfig.exe под пользователем, которого необходимо сделать администратором системы и который прописан в качестве администратора в тэге accessControlAdminSettings.

Настройка нескольких пользовательских каталогов

Note

title	Информация

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

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

Info

title	Информация

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

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

Code Block

language	xml
title	Пример

<userCatalogProviderSettings rootUserCatalogProviderId="user">
    <userCatalogProviders>
      <sqlUserCatalogProviders></sqlUserCatalogProviders>
      <adUserCatalogProviders>
        <adUserCatalogProvider id="Ad1" serverName="demo.local" containerPath="OU=Indeed_Users,DC=demo,DC=local" userName="demo\ind-user" password="Q1q2E3e4" />
        <adUserCatalogProvider id="Ad2" serverName="demo.local" containerPath="OU=inDomainUsers,DC=demo,DC=local" userName="demo\ind-user" password="Q1q2E3e4" />
        <adUserCatalogProvider id="Ad3" serverName="inforest.demo.local" containerPath="OU=UsersInForest,DC=inforest,DC=demo,DC=local" userName="inforest\cataloguser1" password="Q1q2E3e4" />
        <adUserCatalogProvider id="Ad4" serverName="newforest.local" containerPath="OU=Usersoutforest,DC=newforest,DC=local" userName="newforest\cataloguser2" password="Q1q2E3e4" />
	  </adUserCatalogProviders>
    </userCatalogProviders>

2. Добавьте внутри тега orUserCatalogProviders тег orUserCatalogProvider с параметром id.

Note

title	Информация

Значение параметра id должно соответствовать значению заданному в параметре rootUserCatalogProviderId

3. Добавьте внутри тега orUserCatalogProvider тег userCatalogProviders. Внутри тега userCatalogProviders добавьте теги userCatalogProvider с параметром id, в котором указывается идентификатор пользовательского контейнера и ignoreExceptions со значением true, данный параметр игнорирует ошибку подключения к каталогу, если данный каталог не доступен.

Note

title	Информация

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

Code Block

language	xml
title	Пример

<orUserCatalogProviders>
    <orUserCatalogProvider id="user">
       <userCatalogProviders>
          <userCatalogProvider id="Ad1" ignoreExceptions="true" />
          <userCatalogProvider id="Ad2" ignoreExceptions="true" />
          <userCatalogProvider id="Ad3" ignoreExceptions="true" />
          <userCatalogProvider id="Ad4" ignoreExceptions="true" />
       </userCatalogProviders>
    </orUserCatalogProvider>
</orUserCatalogProviders>

Пример структуры файла

Code Block

language	yml
title	Пример

<accessControlAdminSettings userId="UserId_891f2b6c-9a55-4e1a-b69b-b4d6418f4c4c"/>
  <logonSettings secretKey="*****"/>
  <userCatalogProviderSettings rootUserCatalogProviderId="user">
  	<userCatalogProviders>
  		<sqlUserCatalogProviders>
  		</sqlUserCatalogProviders>
  		<adUserCatalogProviders>
  			<adUserCatalogProvider id="UserId" serverName="new.loc" containerPath="DC=new,DC=loc" 
				userName="indeed-users" password="Q1q2E3e4" />
			<adUserCatalogProvider id="UserId1" serverName="test.new.loc" containerPath="DC=test,DC=loc" 
				userName="indeed-users" password="Q1q2E3e4" />
  		</adUserCatalogProviders>
  	</userCatalogProviders>
  	<combineRules>
  		<orUserCatalogProviders>
			<orUserCatalogProvider id="user">
			   <userCatalogProviders>
				  <userCatalogProvider id="UserId" ignoreExceptions="true" />
				  <userCatalogProvider id="UserId1" ignoreExceptions="true" />
			   </userCatalogProviders>
			</orUserCatalogProvider>
  		</orUserCatalogProviders>
  		<andUserCatalogProviders>
  		</andUserCatalogProviders>
  	</combineRules>
  </userCatalogProviderSettings>

Шифрование/Расшифрование конфигурационного файла

Запустите командную строку от имени "Администратора".

В командной строке перейдите в папку с утилитой для шифрования.

Note

title	Информация

Утилита шифрует секции: logServer, logonSettings, userCatalogProviderSettings, encryptionSettings, dbContextSettings. Рекомендуется зашифровать все секции.

Шифрование/Расшифрование отдельных секций.
Для шифрования отдельной секции необходимо выполнить команду вида: EA.Config.Encryptor /encrypt "Путь к конфигурационному файлу сервера" "Имя секции"
Code Block
language bash
title Пример
EA.Config.Encryptor /encrypt "C:\inetpub\wwwroot\easerver\Web.config" "logServer"
Для расшифровки отдельной секции необходимо выполнить команду вида: EA.Config.Encryptor /decrypt "Путь к конфигурационному файлу сервера" "Имя секции"
Code Block
language bash
title Пример
EA.Config.Encryptor /decrypt "C:\inetpub\wwwroot\easerver\Web.config" "logServer"
Шифрование/Расшифрование всех секций.
Для шифрования всех секций необходимо запустить скрипт encryptConfigs.bat.
Для расшифровки всех секций необходимо выполнить скрипт decryptConfigs.bat

Backtotop

Divbox

class	rightFloat

Table of Contents

Page tree

Versions Compared

Old Version 27

New Version Current

Key

Установка

Настройка с помощью мастера конфигурации

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

Ручная настройка системы

Редактирование конфигурационного файла

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

Настройка нескольких пользовательских каталогов

Пример структуры файла

Шифрование/Расшифрование конфигурационного файла