Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Indeed AM User Console - это Web-приложение, которое работает на базе IIS. В данном модуле пользователь может осуществлять управление своими аутентификаторами.
Info | ||
---|---|---|
| ||
Файлы для indeed AM User Console расположены: indeed AM <номер версии>|Indeed AM User Console|<номер версии>. IndeedAM.UserConsole-<номер версии>.x64.ru-ru.msi — пакет для установки Indeed AM User Console. |
Info | ||
---|---|---|
| ||
Путь к User Console в браузере: http(s)://<днс_сервера>/am/uc |
Установка
- Выполнить установку Indeed AM User Console через запуск соответствующего пакета.
Note title Информация Опциональная настройка. Генерация сертификата необходима при аутентификации в Indeed AM User Console с использованием Indeed AM Identity Provider.
Данный сертификат не предназначен для организации SSL соединения.
Если данный сертификат был сгенерирован ранее, то необходимо убрать флажок.
По завершении установки будет предложено сгенерировать новый IDP сертификат. Если флажок будет выставлен, то сгенерируется и установится в хранилище сертификатов (Local Machine -> Personal) новый самоподписанный сертификат. Сертификат используется для шифрования данных, передаваемых между сервером аутентификации и клиентским приложением.
Добавить привязку https в настройках Default Web Site в IIS Manager.
Info title Информация User Console является Web приложением, которое работает на базе IIS, в процессе установки для него по умолчанию включается обязательно требование SSL в настройках, что в свою очередь требует включенной привязки https.
Если вы не намерены использовать протокол https, необходимо отключить требование SSL в настройках IIS для User Console.
Также в этом случае необходимо в конфигурационном файле UC (C:\inetpub\wwwroot\am\uc\Web.config) изменить значение параметра requireSSL на false:Code Block language xml title Пример <httpCookies httpOnlyCookies="true" requireSSL="false" />
- Запустите IIS Manager и раскройте пункт Сайты (Sites).
- Выберите сайт Default Web Site и нажмите Привязки (Bindings) в разделе Действия (Actions).
- Нажмите Добавить (Add):
- Тип (Type) - https.
- Порт (Port) - 443.
- Выберите SSL-сертификат (SSL Certificate).
Сохраните привязку.
Настройка
Info | ||
---|---|---|
| ||
Для сохранения изменений в конфигурационном файле приложения, требуется запустить редактор с правами администратора. По умолчанию компонент Indeed AM User Console настроен на использование SAML аутентификации, при необходимости можно настроить прозрачную Windows аутентификацию. |
Аутентификация с Windows Authentication
- Откройте конфигурационный файл User Console Web.config (C:\inetpub\wwwroot\am\uc\Web.config).
Укажите URL для подключения к серверу Indeed для параметра Url в тэге amAuthServer.
Параметр Url - url адрес сервера Indeed в формате http(s)://полное_dns_имя_сервера/am/core/
Info title Информация Для игнорирования ошибок сертификата сервера необходимо изменить параметр "isIgnoreCertErrors" на значение "true" в файле "applicationSettings.config" ( am\uc\Config ).
Code Block language xml title Пример <amAuthServer Url="https://amserv.indeed-id.local/am/core/"/>
- Запустите IIS Manager, выберите "Default Web Site -> am" и откройте приложение "uc".
- Откройте "Проверка подлинности" и включите следующие методы:
- Олицетворение ASP.NET.
- Проверка подлинности Windows.
- Отключите все остальные методы.
- Откройте конфигурационный файл User Console Web.config (C:\inetpub\wwwroot\am\uc\Web.config).
Для тега "amAuthentication" в параметре "mode" укажите "Windows".
Info title Информация Параметр "loginUrl" оставьте без изменений, при использовании Windows аутентификации данный параметр не учитывается.
Code Block language yml title Пример <amAuthentication mode="Windows" loginUrl="" identityProviderCertificateThumbprint="" serviceProviderCertificateThumbprint="" enableLogout="true"/>
- Перезапустите IIS сервер. User Console будет доступен по адресу: "http(s)://полное_dns_имя_сервера/am/uc/".
Аутентификация с помощью SAML
- Откройте конфигурационный файл User Console Web.config (C:\inetpub\wwwroot\am\uc\Web.config).
- Укажите URL для подключения к серверу Indeed для параметра Url в тэге amAuthServer.
Параметр Url - url адрес сервера Indeed в формате http(s)://полное_dns_имя_сервера/am/core/
Info title Информация Для игнорирования ошибок сертификата сервера необходимо изменить параметр "isIgnoreCertErrors" на значение "true" в файле "applicationSettings.config" ( am\uc\Config ).
Code Block language xml title Пример <amAuthServer Url="https://amserv.indeed-id.local/am/core/"/>
- Запустите IIS Manager, выберите "Default Web Site -> am" и откройте приложение "uc".
- Откройте "Проверка подлинности" и включите следующие методы:
- Анонимная проверка подлинности.
- Проверка подлинности с помощью форм.
- Отключите все остальные методы.
- Откройте конфигурационный файл User Console Web.config (C:\inetpub\wwwroot\am\uc\Web.config).
В теге amAuthentication выполните следующие:
В параметре mode укажите значение Saml.
В параметре loginUrl кажите URL в формате http(s)://полное_dns_имя_сервера/am/idp/ для подключения к серверу Indeed SAML.
Code Block language yml <amAuthentication mode="Saml" loginUrl="http://saml.demo.local/am/idp/"/>
В параметре identityProviderCertificateThumbprint укажите отпечаток сертификата Indeed AM Saml Idp. Сертификат необходимо экспортировать без закрытого ключа с сервера SAML на сервер с Indeed AM User Console. Сертификат необходимо добавить в хранилище сертификатов, в Local Machine -> Personal.
Code Block language powershell title Получение отпечатка сертификата Saml Idp через PS Get-Childitem Cert:\LocalMachine\My\ | Where-Object {$_.Subject -eq "CN=idp"}
В параметре serviceProviderCertificateThumbprint укажите отпечаток сертификата IDP клиента Indeed AM User Console, который был сгенерирован при установке.
Info title Информация Сертификат устанавливается в хранилище сертификатов (Local Machine -> Personal) с общем именем "ucsp".
Получить его отпечаток можно с помощью PowerShell запроса:Code Block language powershell Get-Childitem Cert:\LocalMachine\My\ | Where-Object {$_.Subject -eq "CN=ucsp"}
- Параметр enableLogout (Не обязательный) - включает возможность выполнять выход из User Console.
Code Block language xml title Пример <amAuthentication mode="Saml" loginUrl="https://logserver.indeed.local/am/idp/" identityProviderCertificateThumbprint="C72DF64AE6E039445C8ED53FD83F75A9A2BA37E9" serviceProviderCertificateThumbprint="3A1663D905E543782DD84B50391DEBC5178269D7" enableLogout="true"/>
- Откройте конфигурационный файл Indeed AM Saml Idp Web.configIdp app-settings.json (C:\inetpub\wwwroot\am\idp\Web.config).app-settings.json).
Измените параметр PartnerServiceProviderConfigurations. В строке SingleSignOnServiceUrl укажите адрес Indeed AM User Console в формате http(s)://полное_dns_имя_сервера/am/uc/Account/SLOService.
Code Block title Пример адреса сервера UC https://indeedam.indeed.local/am/uc/Account/SLOService
- Измените параметр PartnerServiceProviderConfigurations. В строке Thumbprint укажите отпечаток сертификата Indeed AM User Console, который был сгенерирован при установке.
- В параметре
- В тегt amPartnerServiceProviderSettings укажите следующие:
- В параметре SelfServiceUrl укажите URL сервера с компонентом Indeed AM User Console в формате http(s)://полное_dns_имя_сервера/am/uc/
В параметре SelfServiceCertificateThumbprint укажите отпечаток сертификата Indeed AM User Console. Сертификат необходимо экспортировать без закрытого ключа с сервера Indeed AM User Console на сервер с Indeed AM Saml Idp. Сертификат необходимо добавить в хранилище сертификатов, в Local Machine -> Personal.
Code Block language powershell title Получение отпечатка сертификата User Console через PS Get-Childitem Cert:\LocalMachine\My\ | Where-Object {$_.Subject -eq "CN=ucsp"}
Code Block language yml title Пример <amPartnerServiceProviderSettings SelfServiceUrl="https://server.indeed.local/am/uc/" EmcServiceUrl="" SelfServiceCertificateThumbprint="3A1663D905E543782DD84B50391DEBC5178269D7" EmcCertificateThumbprint=""/>
- Сохраните изменения в конфигурационных файлах и перезапустите IIS сервера с Indeed AM Saml и с Indeed AM User Console.
Включение защиты от перебора
Сервер Indeed AM поддерживает включение защиты от подбора УЗ пользователей для компонента Indeed AM SAML Idp. По умолчанию данная настройка отключена.
При включенной настройке злоумышленник не сможет определить валидные УЗ в домене по возвращаемой от компонента ошибке.
Для включения настройки необходимо выполнить следующие:
- Откройте конфигурационный файл сервера Indeed AM: C:\inetpub\wwwroot\am\core\Web.config
В теге "appSettings", для параметра "bruteForceProtectionApps", задайте значения "User Console" и "SAML Identity Provider".
Code Block language yml title Пример <appSettings> <add key="bruteForceProtectionApps" value="User Console, SAML Identity Provider" /> ... </appSettings>
- Сохраните изменения и перезапустите IIS сервер.
Вход в User Console с использованием SAML
- Откройте в браузере Web интерфейс консоли User Console.
В появившемся окне аутентификации SAML нажмите "Back" для выбора способа аутентификации, по умолчанию используется последний используемый способ.
Выберите способ аутентификации и нажмите "Select".
Info title Информация Если у пользователя нет обученного аутентификатора, то выберите "Windows Password".
Note title Информация Выход в сессии пользователя из SAML idp не влечет за собой выход пользователя из User Console, до перезапуска браузера или истечения срока хранения cookie. Время хранения cookie для SAML idp - 30 минут.
- Введите пароль и нажмите "Sing in". Если ввод данных был успешный, то отобразится карточка пользователя.
Для выхода из User Console выполните:
Note title Информация Данная опция будет активна если в пункте 3.b раздела "Установка", был настроен параметр enableLogout. По умолчанию отключена.
- Нажмите на имя пользователя в верхней части окна.
Выберите "Выйти" из выпадающего списка.
Info title Информация При выходе из User Console происходит автоматический выход из SAML idp.
Отключение отображения информации о платформе и версии
Для того, чтобы не добавлять заголовки, содержащие информацию о платформе и версии, на которой разрабатывалось приложение, в response, нужно:
- Открыть конфигурационный файл User Console C:\inetpub\wwwroot\am\uc\Web.config;
- В зависимости от версии IIS:
Для IIS 10 убрать комментарии со следующих строк:
Code Block language yml title Пример <security> <requestFiltering removeServerHeader="true" /> </security>
- IIS старше 10:
- Установить URL Rewrite
В секцию
<system.webServer>
добавить:Code Block language yml title Пример <rewrite> <outboundRules> <rule name="replace server header" patternSyntax="Wildcard" lockItem="false"> <match serverVariable="RESPONSE_SERVER" pattern="*" /> <action type="Rewrite" value="MyServer" /> </rule> </outboundRules> </rewrite>
Backtotop |
---|
Table of Contents | ||
---|---|---|
|