- Created by Vladislav Fomichev, last modified by Lyazat Shabalina on Dec 05, 2022
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 29 Next »
Indeed AM User Console - это Web-приложение, которое работает на базе IIS. В данном модуле пользователь может осуществлять управление своими аутентификаторами.
Информация
Файлы для indeed AM User Console расположены: indeed AM <номер версии>|Indeed AM User Console|<номер версии>.
IndeedAM.UserConsole-<номер версии>.x64.ru-ru.msi — пакет для установки Indeed AM User Console.
Информация
Путь к User Console в браузере: http(s)://<днс_сервера>/am/uc
Путь к User Console в IIS: <имя_машины>\сайты\Default Web Site\am\uc
Установка
- Выполнить установку Indeed AM User Console через запуск соответствующего пакета.
Информация
Опциональная настройка. Генерация сертификата необходима при аутентификации в Indeed AM User Console с использованием Indeed AM Identity Provider.
Данный сертификат не предназначен для организации SSL соединения.
Если данный сертификат был сгенерирован ранее, то необходимо убрать флажок.
По завершении установки будет предложено сгенерировать новый IDP сертификат. Если флажок будет выставлен, то сгенерируется и установится в хранилище сертификатов (Local Machine -> Personal) новый самоподписанный сертификат. Сертификат используется для шифрования данных, передаваемых между сервером аутентификации и клиентским приложением.
Добавить привязку https в настройках Default Web Site в IIS Manager.
Информация
User Console является Web приложением, которое работает на базе IIS, в процессе установки для него по умолчанию включается обязательно требование SSL в настройках, что в свою очередь требует включенной привязки https.
Если вы не намерены использовать протокол https, необходимо отключить требование SSL в настройках IIS для User Console.
Также в этом случае необходимо в конфигурационном файле UC (C:\inetpub\wwwroot\am\uc\Web.config) изменить значение параметра requireSSL на false:Пример<httpCookies httpOnlyCookies="true" requireSSL="false" />
- Запустите IIS Manager и раскройте пункт Сайты (Sites).
- Выберите сайт Default Web Site и нажмите Привязки (Bindings) в разделе Действия (Actions).
- Нажмите Добавить (Add):
- Тип (Type) - https.
- Порт (Port) - 443.
- Выберите SSL-сертификат (SSL Certificate).
Сохраните привязку.
Настройка
Информация
Для сохранения изменений в конфигурационном файле приложения, требуется запустить редактор с правами администратора.
По умолчанию компонент 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/
Информация
Для игнорирования ошибок сертификата сервера необходимо изменить параметр "isIgnoreCertErrors" на значение "true" в файле "applicationSettings.config" ( am\uc\Config ).
Пример<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".
Информация
Параметр "loginUrl" оставьте без изменений, при использовании Windows аутентификации данный параметр не учитывается.
Пример<amAuthentication mode="Windows" loginUrl="" identityProviderCertificateThumbprint="" serviceProviderCertificateThumbprint="" enableLogout="true"/>
- Перезапустите IIS сервер. User Console будет доступен по адресу: "http(s)://полное_dns_имя_сервера/am/uc/".
Аутентификация с помощью Identity Provider (ранее SAML IDP)
Вы можете настроить аутентификацию в User Console через модуль Identity Provider (ранее SAML IDP).
Настройка зависит от версии Indeed Access Manager:
Вы можете настроить защищенный вход в User Console с использованием Identity Provider.
Редактирование конфигурационного файла User Console
Важно
Перед редактированием конфигурационного файла, выполните следующие действия:
- Запустите Диспетчер служб IIS,
- Выберите <имя сервера>→Sites→Default Web Site→am→uc.
- Выберите Проверка подлинности и включите опции Анонимная проверка подлинности и Проверка подлинности с помощью форм.
- Откройте конфигурационный файл web.config из C:\inetpub\wwwroot\am\uc\Web.config.
В параметре amAuthServer Url укажите адрес сервера Indeed в формате http(s)://полное_dns_имя_сервера/am/core/
Пример<amAuthServer Url="https://amserv.indeed-id.local/am/core/"/>
- В параметре amAuthentication выполните следующие действия:
В строке mode укажите значение Saml.
В строке loginUrl укажите адрес Identity Provider в формате http(s)://полное_dns_имя_сервера/am/idp/
Пример<amAuthentication mode="Saml" loginUrl="https://server.test.local/am/idp/>
В строке identityProviderCertificateThumbprint укажите отпечаток сертификата Identity Provider.
Если Identity Provider и User Console были установлены на разные серверы, экспортируйте сертификат без закрытого ключа с сервера с модулем Identity Provider на сервер с User Console. Сертификат необходимо добавить в хранилище сертификатов в Local Machine→Personal.
Чтобы получить отпечаток сертификата с помощью запроса PowerShell:Get-Childitem
Cert:\LocalMachine\My\ |
Where-Object
{$_.Subject
-eq
"CN=idp"
}
В строке serviceProviderCertificateThumbprint укажите отпечаток сертификата User Console, который был сгенерирован при установке пакета.
Сертификат устанавливается в хранилище сертификатов Local Machine→Personal с общем именем ucsp.
Чтобы получить отпечаток сертификата с помощью запроса PowerShell:Get-Childitem
Cert:\LocalMachine\My\ |
Where-Object
{$_.Subject
-eq
"CN=ucsp"
}
- Сохраните изменения и перезапустите IIS.
Редактирование конфигурационного файла Identity Provider
Перед редактированием конфигурационного файла, выполните следующие действия:
- Запустите Диспетчер служб IIS,
- Выберите <имя сервера>→Sites→Default Web Site→am→idp.
- Выберите Проверка подлинности и отключите опцию Проверка подлинности Windows.
Откройте конфигурационный файл app-settings.json из C:\inetpub\wwwroot\am\idp.
- В параметре PartnerServiceProviderConfigurations выполните следующие действия:
- В строке SingleLogoutServiceUrl укажите адрес сервера, где вы развернули User Console, в формате http(s)://полное_dns_имя_сервера/am/uc/Account/SLOService
В строке Thumbprint укажите отпечаток сертификата User Console.
Если Identity Provider и User Console были установлены на разные серверы, экспортируйте сертификат без закрытого ключа с сервера развернутым User Console на сервер с модулем Identity Provider. Сертификат необходимо добавить в хранилище сертификатов в Local Machine→Personal.
Чтобы получить с помощью запроса PowerShell:
Get-Childitem
Cert:\LocalMachine\My\ |
Where-Object
{$_.Subject
-eq
"CN=ucsp"
}
Пример"PartnerServiceProviderConfigurations": { "Name": "urn:indeedid:emc", "SingleLogoutServiceUrl": "https://server.indeed.local/am/uc/Account/SLOService", "PartnerCertificates": [ { "Thumbprint": "C77EDF29EA05B468BDAF553DE3D804DA4B139C1E"
- Сохраните изменения и перезапустите IIS.
Настройка выхода из User Console с использованием Identity Provider
- Откройте конфигурационный файл консоли web.config из C:\inetpub\wwwroot\am\uc\Web.config.
В параметр amAuthentication добавьте параметр enableLogout со значением true (по умолчанию установлено значение false).
Пример<amAuthentication mode="Saml" loginUrl="https://server.test.local/am/idp/" enableLogout="true"/>
- Откройте конфигурационный файл Identity Provider app-settings.json из C:\inetpub\wwwroot\am\idp.
Измените параметр PartnerServiceProviderConfigurations. В строке SingleLogoutServiceUrl укажите адрес сервера с компонентом Indeed AM Management Console в формате http(s)://полное_dns_имя_сервера/am/mc/Account/SLOService
Пример"PartnerServiceProviderConfigurations": [ { ... "SingleLogoutServiceUrl": "https://server01.test.local/am/mc/Account/SLOService", ... ] }
Сохраните изменения и перезапустите IIS.
- Откройте конфигурационный файл User Console Web.config (C:\inetpub\wwwroot\am\uc\Web.config).
- Укажите URL для подключения к серверу Indeed для параметра Url в тэге amAuthServer.
Параметр Url - url адрес сервера Indeed в формате http(s)://полное_dns_имя_сервера/am/core/
Информация
Для игнорирования ошибок сертификата сервера необходимо изменить параметр "isIgnoreCertErrors" на значение "true" в файле "applicationSettings.config" ( am\uc\Config ).
Пример<
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.
<amAuthentication mode=
"Saml"
loginUrl=
"http://saml.demo.local/am/idp/"
/>
В параметре identityProviderCertificateThumbprint укажите отпечаток сертификата Indeed AM Saml Idp. Сертификат необходимо экспортировать без закрытого ключа с сервера SAML на сервер с Indeed AM User Console. Сертификат необходимо добавить в хранилище сертификатов, в Local Machine -> Personal.
Получение отпечатка сертификата Saml Idp через PSGet-Childitem
Cert:\LocalMachine\My\ |
Where-Object
{$_.Subject
-eq
"CN=idp"
}
В параметре serviceProviderCertificateThumbprint укажите отпечаток сертификата IDP клиента Indeed AM User Console, который был сгенерирован при установке.
Информация
Сертификат устанавливается в хранилище сертификатов (Local Machine -> Personal) с общем именем "ucsp".
Получить его отпечаток можно с помощью PowerShell запроса:Get-Childitem
Cert:\LocalMachine\My\ |
Where-Object
{$_.Subject
-eq
"CN=ucsp"
}
Параметр enableLogout (Не обязательный) - включает возможность выполнять выход из User Console.
Пример<
amAuthentication
mode
=
"Saml"
loginUrl
=
"https://logserver.indeed.local/am/idp/"
identityProviderCertificateThumbprint
=
"C72DF64AE6E039445C8ED53FD83F75A9A2BA37E9"
serviceProviderCertificateThumbprint
=
"3A1663D905E543782DD84B50391DEBC5178269D7"
enableLogout
=
"true"
/>
- Откройте конфигурационный файл Indeed AM Saml Idp Web.config (C:\inetpub\wwwroot\am\idp\Web.config).
- В тег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.
Получение отпечатка сертификата User Console через PSGet-Childitem
Cert:\LocalMachine\My\ |
Where-Object
{$_.Subject
-eq
"CN=ucsp"
}
Пример<amPartnerServiceProviderSettings SelfServiceUrl=
"https://server.indeed.local/am/uc/"
EmcServiceUrl=
""
SelfServiceCertificateThumbprint=
"3A1663D905E543782DD84B50391DEBC5178269D7"
EmcCertificateThumbprint=
""
/>
- В тегt amPartnerServiceProviderSettings укажите следующие:
- Сохраните изменения в конфигурационных файлах и перезапустите 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".
Пример<appSettings> <!-- <=8.1.4 --> <add key="bruteForceProtectionApps" value="Self Service, SAML Identity Provider" /> <!-- 8.1.5=> --> <add key="bruteForceProtectionApps" value="Self Service, Identity Provider" /> ... </appSettings>
- Сохраните изменения и перезапустите IIS сервер.
Настройка срока жизни сессии
Информация
Данная настройка не является обязательной
Для увеличения или уменьшения срока жизни сессии в Admin Console выполните следующие действия
- Откройте конфигурационный файл Indeed Admin Console applicationSettings.config: C:\inetpub\wwwroot\am\uc\Config\applicationSettings.config
Для параметра "sessionExpirationTimeInMinutes" установите необходимое значение. Значение по умолчанию 30(минут).
Пример<?xml version="1.0"?> <amApplicationSettings isIgnoreCertErrors="false" sessionExpirationTimeInMinutes="30"/>
- Сохраните изменения.
Вход в User Console с использованием SAML
- Откройте в браузере Web интерфейс консоли User Console.
В появившемся окне аутентификации SAML нажмите "Back" для выбора способа аутентификации, по умолчанию используется последний используемый способ.
Выберите способ аутентификации и нажмите "Select".
Информация
Если у пользователя нет обученного аутентификатора, то выберите "Windows Password".
Информация
Выход в сессии пользователя из SAML idp не влечет за собой выход пользователя из User Console, до перезапуска браузера или истечения срока хранения cookie. Время хранения cookie для SAML idp - 30 минут.
- Введите пароль и нажмите "Sing in". Если ввод данных был успешный, то отобразится карточка пользователя.
Для выхода из User Console выполните:
Информация
Данная опция будет активна если в пункте 3.b раздела "Установка", был настроен параметр enableLogout. По умолчанию отключена.
- Нажмите на имя пользователя в верхней части окна.
Выберите "Выйти" из выпадающего списка.
Информация
При выходе из User Console происходит автоматический выход из SAML idp.
Отключение отображения информации о платформе и версии
Для того, чтобы не добавлять заголовки, содержащие информацию о платформе и версии, на которой разрабатывалось приложение, в response, нужно:
- Открыть конфигурационный файл User Console C:\inetpub\wwwroot\am\uc\Web.config;
- В зависимости от версии IIS:
Для IIS 10 убрать комментарии со следующих строк:
Пример<security> <requestFiltering removeServerHeader="true" /> </security>
- IIS старше 10:
- Установить URL Rewrite
В секцию
<system.webServer>
добавить:Пример<rewrite> <outboundRules> <rule name="replace server header" patternSyntax="Wildcard" lockItem="false"> <match serverVariable="RESPONSE_SERVER" pattern="*" /> <action type="Rewrite" value="MyServer" /> </rule> </outboundRules> </rewrite>
![](https://confluence.indeed-id.com/img/up.png)
- No labels