Skip to main content

Руководство по установке BriefCam

SAML – Настройка требований проверяющей стороны ADFS для BriefCam

Последнее обновление: 3 минуты чтения
Версия2024r2
ЯзыкРусский

  1. Чтобы использовать ADFS для входа в ваш BriefCamэкземпляр, вам понадобятся следующие компоненты:

    • Экземпляр Active Directory.

    • В этом руководстве используются снимки экрана из Server 2012R2, но аналогичные действия должны быть возможны и в других версиях.

    • SSL-сертификат для подписи страницы входа ADFS и отпечаток этого сертификата.

    • После выполнения этих основных требований необходимо установить ADFS на сервер. Настройка и установка ADFS выходит за рамки данного руководства, но подробно описана в статье базы знаний Microsoft .

    Примечание

    BriefCam использует электронную почту пользователя, предоставленную ADFS, как часть утверждений SAML, чтобы идентифицировать пользователя.

  2. Если у вас полностью установлена система ADFS, запишите значение URL-адреса SAML 2.0/W-Federation в разделе "Конечные точки ADFS ". Если для установки выбраны значения по умолчанию, будет показано следующее.'/adfs/ls/'

Шаг 1. Добавление отношений доверия между проверяющими сторонами

  1. На этом этапе вы должны быть готовы настроить соединение ADFS с вашим BriefCamэкземпляром. Связь между ADFS и BriefCamXP определяется с помощью отношения доверия между полагающейся стороной (RPT).

  2. Выберите папку " Доверия проверяющей стороны " в окне "Управление ADFS" и добавьте новое Стандартное доверие проверяющей стороны в боковой панели "Действия". Запустится мастер настройки нового отношения доверия.

    SAML welcome.png

  3. На экране Выбор источника данных выберите последний вариант Ввести данные о проверяющей стороне вручную .

    SAML select source.png

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

    SAML display name.png

  5. На следующем экране установите переключатель профиль AD FS .

    SAML AD FS profile.png

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

    SAML configure certificate.png

  7. На следующем экране установите флажок " Включить поддержку протокола SAML 2.0 WebSSO" . URL-адрес службы будет таким: https://<WebServices>/ProWebApi/AuthenticationApi/AuthenticateSaml

    Замените <WebServices>адресом сервера BriefCamWebServices. Обратите внимание, что в конце URL-адреса нет косой черты.

    SAML Enable support for protocol.png

  8. На следующем экране добавьте идентификатор доверия проверяющей стороны .

    https://<WebServices>/prowebapi должен точно соответствовать адресу prowebapi в настройках (учитывается регистр).

    Замените <WebServices>адресом сервера BriefCamвеб-служб.

    SAML relying identifier.png

    В адресе должен быть указан протокол HTTPS.

  9. На следующем экране вы можете настроить многофакторную аутентификацию, но это выходит за рамки данного руководства.

    SAML multi-factor.png

  10. На следующем экране установите переключатель Разрешить всем пользователям доступ к этой проверяющей стороне .

    SAML permit all.png

  11. На следующих двух экранах мастер отобразит обзор ваших настроек. На последнем экране используйте кнопку Закрыть , чтобы выйти и открыть редактор правил заявки .

    SAML claim rules.png

Шаг 2: Создание правил заявки

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

  1. Чтобы создать новое правило, нажмите " Добавить правило" . Создание правилаотправки атрибутов LDAP в качестве заявок .

    SAML claim rule template.png

  2. На следующем экране, используя Active Directory в качестве хранилища атрибутов, выполните следующие действия:

    • В столбце Атрибут LDAP выберите Адреса электронной почты .

    • В списке Тип исходящей заявки выберите Адрес электронной почты .

      SAML configure rule.png

  3. Повторите этот шаг для UPN.

  4. Нажмите кнопку OK , чтобы сохранить новое правило.

Шаг 3: настройка BriefCam

  1. После настройки ADFS необходимо настроить аутентификацию BriefCamэкземпляра через SAML.

  2. Вы будете использовать полный URL-адрес сервера ADFS с конечной точкой SAML в качестве URL-адреса SSO.

  3. Отпечаток будет отпечатком сертификата подписи токена, установленного в вашем экземпляре ADFS. В утилите сертификатов Windows это также называется отпечатком SHA-1.

  4. Экспорт сертификата подписи токена ADFS (на сервере ADFS) в PowerShell от имени администратора:

    $certRefs=Get-AdfsCertificate -CertificateType-Подпись Токена

    $certBytes=$certRefs[0].Certificate.Export([Система.Безопасность.Криптография.X509Certificates.X509ContentType]::Cert)

    [System.IO.File]::WriteAllBytes("c:\foo.cer", $certBytes)

  5. Копировать c:\foo.cerна BriefCamсервер.

  6. Запустите mmc.

  7. Файл -> добавить или удалить оснастки .

  8. Сертификаты -> добавить -> учетная запись компьютера -> локальный компьютер.

  9. Перейдите в раздел Сертификаты -> Персональные -> Сертификаты.

  10. Нажмите правой кнопкой мыши Сертификаты и выберите Все задачи -> Импортfoo.cer.

    SAML import certificate.png

  11. Дважды нажмите новый сертификат, перейдите на вкладку "Сведения" и скопируйте отпечаток сертификата.

  12. Вставьте отпечаток в текстовый редактор, удалите пробелы, а затем скопируйте и вставьте его в раздел ProWebAPI в поле "Веб-администратор"> "Настройки" SamlCertificate ".

  13. Настройте следующие поля в параметрах BriefCam Administrator Consoleсреды:

    • SamlLoginUrl = https:// <адрес сервера ADFS>/adfs/ls/idинициированный вход

    • SamlLogoutUrl = URL выхода сервера ADFS

    • SamlCertificate = <Сертификат SAML>

    Примечание

    Не изменяйте параметры среды ProWebApiAddress и ProWebClientAddress (оставьте значения по умолчанию).

  14. В диспетчере IIS на компьютере с веб-службами перейдите в BriefCam Web Services > Привязки > Добавить, в раскрывающемся меню "Тип " выберите <https и нажмите <OK.

    SAML Add binding.png

  15. Перезапустите службы IIS (откройте службы Windows, нажмите правой кнопкой мыши World Wide Web Publishing Service и выберите " Перезапустить ).

  16. Теперь вы должны быть настроены и готовы к работе. Для тестирования запустите: https://localhost/authenticationApi/RequestAuthenticationRoute

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

В противном случае убедитесь, что вы правильно выполнили все действия.