Skip to main content

Indeed User Console

Indeed User Console (User Console) — это веб-приложение, которое работает на базе IIS. В User Console пользователь может управлять своими аутентификаторами. 

Как открыть User Console
  • в браузере: http(s)://<днс_сервера>/am/uc
  • в IIS: <имя_машины>\сайты\Default Web Site\am\uc

Файлы для установки​

Файлы для User Console расположены в папке indeed AM <номер версии>|Indeed AM User Console|<номер версии>.

  • IndeedAM.UserConsole-<номер версии>.x64.ru-ru.msi — пакет для установки User Console.

Установка User Console​

Системные требования

Выполните установку User Console через запуск пакета IndeedAM.UserConsole-<номер версии>.x64.ru-ru.msi.

По завершении установки будет предложено сгенерировать новый IDP сертификат. Это необязательная настройка.

Генерация сертификата необходима при аутентификации в User Console с использованием Indeed AM Identity Provider.

Данный сертификат не предназначен для организации SSL-соединения.

Если данный сертификат был сгенерирован ранее, то необходимо убрать флажок. 

Если флажок будет выставлен, то новый самоподписанный сертификат сгенерируется и установится в хранилище сертификатов (Local Machine→Personal). Сертификат используется для шифрования данных, передаваемых между сервером аутентификации и клиентским приложением.

Привязка HTTPS в настройках в IIS Manager​

User Console является веб-приложением, которое работает на базе IIS, в процессе установки для User Console включается обязательное требование SSL в настройках, что в свою очередь требует включенной привязки HTTPS.

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

Если вы не намерены использовать протокол HTTPS, отключите требование SSL в настройках IIS для User Console.

Также в этом случае необходимо в конфигурационном файле C:\inetpub\wwwroot\am\uc\Web.config изменить значение параметра requireSSL на false:

Пример
<httpCookies httpOnlyCookies="true" requireSSL="false" />

Аутентификация с помощью Windows Authentication​

По умолчанию User Console настроен на использование SAML-аутентификации, при необходимости можно настроить прозрачную Windows-аутентификацию.

Для этого выполните следующее:

  1. Запустите редактор с правами администратора.

  2. Откройте конфигурационный файл консоли Web.config (находится в папке C:\inetpub\wwwroot\am\uc\Web.config).

  3. Укажите URL для подключения к Core Server для параметра Url в теге amAuthServer в формате http(s)://полное_dns_имя_сервера/am/core/.

    Пример
    <amAuthServer Url="https://amserv.indeed-id.local/am/core/"/>
Примечание

Для игнорирования ошибок сертификата сервера измените параметр isIgnoreCertErrors на значение true в файле applicationSettings.config (расположен по пути: am\uc\Config).

  1. Запустите IIS Manager, выберите Default Web Site->am и откройте приложение uc.

  2. Откройте Проверка подлинности и включите следующие методы:

    • Олицетворение ASP.NET;
    • Проверка подлинности Windows;

  3. Отключите все остальные методы.

  4. Откройте конфигурационный файл User Console Web.config (находится в папке C:\inetpub\wwwroot\am\uc\Web.config).

  5. Для тега amAuthentication в параметре mode укажите Windows. Опционально вы можете добавить параметр enableLogout="true", чтобы настроить возможность выйти из User Console.

    Примечание

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

    Пример
    <amAuthentication mode="Windows" loginUrl="" identityProviderCertificateThumbprint="" serviceProviderCertificateThumbprint="" enableLogout="true"/>

  6. Сохраните изменения в файле и перезапустите сервер IIS.

User Console будет доступен по адресу: http(s)://полное_dns_имя_сервера/am/uc/.

Аутентификация с помощью Indeed Identity Provider​

Вы можете настроить защищенный вход в User Console с использованием Indeed Identity Provider.

Важно!

Для входа в User Console с использованием Identity Provider вам необходимо установить и настроить провайдер аутентификации.

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

Важно

Перед редактированием конфигурационного файла, выполните следующие действия:

  1. Запустите Диспетчер служб IIS.
  2. Выберите <имя сервера>→Sites→Default Web Site→am→uc.
  3. Выберите Проверка подлинности и включите опции Анонимная проверка подлинности и Проверка подлинности с помощью форм.

  1. Откройте конфигурационный файл web.config из папки C:\inetpub\wwwroot\am\uc\Web.config.

  2. В параметре amAuthServer Url укажите адрес сервера Indeed в формате http(s)://полное_dns_имя_сервера/am/core/.

    Пример
    <amAuthServer Url="https://amserv.indeed-id.local/am/core/"/>

  3. В параметре 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, который был сгенерирован при установке пакета .msi.

      Информация

      Сертификат устанавливается в хранилище сертификатов Local Machine→Personal с общим именем ucsp.

      Чтобы получить отпечаток сертификата с помощью запроса PowerShell:
      Get-Childitem Cert:\LocalMachine\My\ | Where-Object {$_.Subject -eq "CN=ucsp"}

  4. Сохраните изменения в файле и перезапустите сервер IIS.

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

Важно

Перед редактированием конфигурационного файла выполните следующие действия:

  1. Запустите Диспетчер служб IIS.
  2. Выберите <имя сервера>→Sites→Default Web Site→am→idp.
  3. Выберите Проверка подлинности и отключите опцию Проверка подлинности Windows.

  1. Откройте конфигурационный файл app-settings.json из папки C:\inetpub\wwwroot\am\idp.

  2. В параметре 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:selfservice",
                  "SingleLogoutServiceUrl": "https://server.indeed.local/am/uc/Account/SLOService",
                  "PartnerCertificates": [
                    {
                      "Thumbprint": "C77EDF29EA05B468BDAF553DE3D804DA4B139C1E"

  3. В параметре AllowWinPwdIfAuthMethodsAreNotAvailable вы можете установить значение true, что позволит войти через IDP в User Console с использованием Windows Password, даже если этот способ не указан в конфигурационном файле app-settings.json.

    Если в параметре AllowWinPwdIfAuthMethodsAreNotAvailable указано значение true, возможны следующие сценарии:

    • Отображаются только зарегистрированные и доступные пользователю методы аутентификации. При многофакторной аутентификации если хотя бы один из методов аутентификации не доступен, вся цепочка не отображается.
    • При отсутствии любых доступных методов аутентификации, включая методы, не требующие регистрации в User Console (Windows Password, Email и SMS), отображается Windows Password.

  4. Сохраните изменения в файле и перезапустите сервер IIS.

Настройка выхода из User Console с использованием Identity Provider​

  1. Откройте конфигурационный файл консоли web.config из папки C:\inetpub\wwwroot\am\uc\Web.config.

  2. В параметр amAuthentication добавьте параметр enableLogout со значением true (по умолчанию установлено значение false).

    Пример
    <amAuthentication mode="Saml" loginUrl="https://server.test.local/am/idp/" enableLogout="true"/>

  3. Откройте конфигурационный файл Identity Provider app-settings.json из папки C:\inetpub\wwwroot\am\idp.

  4. Измените параметр PartnerServiceProviderConfigurations. В строке SingleLogoutServiceUrl укажите адрес сервера с компонентом User Console в формате http(s)://полное_dns_имя_сервера/am/uc/Account/SLOService

    Пример
    "PartnerServiceProviderConfigurations": [
              {
                ...
                "SingleLogoutServiceUrl": "https://server01.test.local/am/uc/Account/SLOService",
                ...
                ]
              }

  5. Сохраните изменения и перезапустите IIS.

Пример входа в User Console с использованием Identity Provider​

  1. Откройте в браузере интерфейс User Console. Пример адреса консоли: http(s)://полное_dns_имя_сервера/am/uc/.

  2. В появившемся окне аутентификации нажмите Back для выбора способа аутентификации. По умолчанию используется последний используемый способ.

  3. Выберите способ аутентификации и нажмите Select. 

    Информация

    Если у пользователя нет обученного аутентификатора, выберите Windows Password.

    Примечание

    Выход в сессии пользователя из Identity Provider не влечет за собой выход пользователя из User Console, до перезапуска браузера или истечения срока хранения cookie. Время хранения cookie для Identity Provider — 30 минут.

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

  5. Для выхода из User Console выполните следующее:

    Примечание

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

    • Нажмите имя пользователя в верхней части окна.

    • Выберите Выйти из выпадающего списка.

      Информация

      При выходе из User Console происходит автоматический выход из Identity Provider.

Включение защиты от перебора​

В Indeed Access Manager вы можете настроить защиту от подбора учетных записей для компонента User Console.

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

Если эта настройка выключена, то при вводе несуществующего имени пользователя Indeed Access Manager отображает ошибку Внутренняя ошибка сервера: Пользователь не найден.

По умолчанию данная настройка отключена.

Чтобы включить защиту от перебора, выполните следующее:

  1. Откройте конфигурационный файл сервера Indeed AM Web.config из папки C:\inetpub\wwwroot\am\core.

  2. В параметре appSettings в строке bruteForceProtectionApps укажите значения Self Service и Identity Provider.

    Пример
    <appSettings>
        ...
        <add key="bruteForceProtectionApps" value="Self Service, Identity Provider" />
    </appSettings>

  3. Сохраните изменения и перезапустите сервер IIS. 

Настройка срока жизни сессии​

Информация

Данная настройка не обязательна.

Чтобы изменить срок жизни сессии в User Console, выполните следующее:

  1. Откройте конфигурационный файл applicationSettings.config из папки C:\inetpub\wwwroot\am\uc\Config.

  2. Для параметра sessionExpirationTimeInMinutes установите необходимое значение. Значение по умолчанию 30 (минут).

    Пример
    <amApplicationSettings isIgnoreCertErrors="false" sessionExpirationTimeInMinutes="30"/>

  3. Сохраните изменения.

Отключение отображения информации о платформе и версии​

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

  1. Откройте конфигурационный файл User Console C:\inetpub\wwwroot\am\uc\Web.config.

  2. В зависимости от версии IIS:

    • Для IIS 10 уберите комментарии со следующих строк:

      Пример
       <security>
            <requestFiltering removeServerHeader="true" />
         </security>

    1. Для 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>