BusinessProxyДокументация
ENЛичный кабинет
BusinessProxy
На этой странице

Настройте AD FS для BusinessProxy

Beta

Подготовьте HTTPS для федерации, зарегистрируйте OIDC-приложение и проверьте вход, права и отзыв доступа на тестовой группе.

1. Подготовьте домен и сервер федерации

В примере домен Active Directory называется corp.example.com, адрес федерации — adfs.example.com, а корпоративная почта — example.com. Подставьте свои имена. Инструкция рассчитана на существующий домен AD DS и профиль Microsoft AD FS на Windows Server 2019 или новее.

  • Если ферма уже работает, проверьте её и переходите к регистрации приложения. Для новой фермы выделите отдельный сервер — член домена. Назначьте ему доменный DNS, проверьте время и подготовьте управляемую сервисную учётку gMSA. Хостам фермы нужно разрешение получать пароль gMSA, а ключ KDS должен вступить в силу и реплицироваться.
  • Создайте запись adfs.example.com. Во внутреннем DNS она ведёт на ферму или её балансировщик. При внешнем доступе опубликуйте федерацию по HTTPS через Web Application Proxy или согласованный шлюз. Браузеру сотрудника и BusinessProxy нужен путь к OIDC через TCP 443. Контроллер AD оставьте во внутренней сети.
  • Импортируйте TLS-сертификат с закрытым ключом в хранилище «Локальный компьютер → Личное». Установите роль командой Install-WindowsFeature ADFS-Federation -IncludeManagementTools. В мастере Server Manager выберите создание первой фермы, укажите adfs.example.com, TLS-сертификат, gMSA и согласованную базу конфигурации.

2. Проверьте TLS и доверие к УЦ

Для облачного BusinessProxy используйте на публичной точке AD FS сертификат публично доверенного УЦ. Укажите adfs.example.com в SAN, проверьте срок действия и назначение Server Authentication. HTTPS-сервер должен отдавать промежуточные сертификаты цепочки.

  • Частный корневой сертификат для управляемых устройств разворачивает администратор организации через GPO или MDM. На Windows путь в GPO: «Конфигурация компьютера → Политики → Конфигурация Windows → Параметры безопасности → Политики открытого ключа → Доверенные корневые центры сертификации». Распространяйте публичный сертификат УЦ.
  • Доверие на устройстве действует только для браузера и других клиентов этого устройства. Проверка OIDC issuer в BusinessProxy выполняется на сервере. Форма SSO не добавляет частный корневой УЦ в доверие этого сервера.
  • Чтение закрытого AD по LDAPS настраивается отдельно. Передайте публичный сертификат или цепочку корпоративного УЦ администратору, который настраивает подключение каталога или Directory Connector. Проверьте DNS-имя контроллера и TLS в предпросмотре каталога.
  • Сертификат HTTPS подтверждает имя сервера. Ключи подписи токенов AD FS публикуются через JWKS и проверяются отдельно. Для обновления ключей подписи используйте отдельный порядок ротации.

3. Проверьте адрес издателя и ключи

Выполните проверки из сети сотрудника и с внешней точки. Значение issuer должно совпадать с адресом, который вы внесёте в BusinessProxy. Discovery и JWKS должны открываться по HTTPS без запроса учётных данных. После сохранения настройки проверьте маршрут из самого BusinessProxy кнопкой «Проверить подключение».

$Issuer = 'https://adfs.example.com/adfs'
Resolve-DnsName ([uri]$Issuer).DnsSafeHost
Test-NetConnection ([uri]$Issuer).DnsSafeHost -Port 443
$metadata = Invoke-RestMethod ($Issuer + '/.well-known/openid-configuration')
if ($metadata.issuer -cne $Issuer) { throw 'Unexpected issuer' }
$keys = Invoke-RestMethod $metadata.jwks_uri
if (-not $keys.keys) { throw 'The issuer published no signing keys' }
$metadata | Select-Object issuer, authorization_endpoint, token_endpoint, jwks_uri
$keys.keys | Select-Object kid, kty, use

4. Зарегистрируйте отдельный клиент OIDC

В BusinessProxy откройте «Команда → SSO» нужной рабочей области и скопируйте OIDC callback URL. В AD FS Management откройте Application Groups и создайте группу приложений BusinessProxy по шаблону Server application accessing a web API.

  • Для Server application сохраните Client ID и укажите скопированный Redirect URI целиком, включая /api/auth/oidc/callback. Используйте отдельный Client ID для каждого тестового или рабочего кабинета.
  • Сгенерируйте Client secret. Сохраните его в корпоративном хранилище секретов и внесите в закрытое поле BusinessProxy. AD FS использует конфиденциальный клиент и обмен кода с PKCE S256.
  • Для корпоративных атрибутов добавьте Web API с уникальным идентификатором, например urn:businessproxy:example:corporate. Задайте уникальное отображаемое имя Web API для этой регистрации. Дайте вашему Client ID права openid и allatclaims на этот ресурс. Ограничьте доступ пилотной группой с помощью политики этого приложения. Для уже связанных пользователей без дополнительных claims доступен базовый профиль openid, описанный в руководстве по SSO.

5. Настройте подписанные атрибуты

Правила выдачи настройте на Web API, созданном для BusinessProxy. Проверьте фактические короткие имена и значения полей в ID token тестового входа в защищённой среде администратора.

Import-Module ActiveDirectory
Get-ADGroup -Identity 'APP_BusinessProxy_Pilot' |
  Select-Object Name, @{Name='SID'; Expression={$_.SID.Value}}
  • Для первого входа (JIT) передайте email из заполненного AD-атрибута mail и email_verified со значением true только для адресов, достоверность которых подтверждает организация. Ограничьте правило точным корпоративным доменом. Если mail пуст, исправьте запись AD.
  • Для групп зарегистрируйте короткое имя claim, например bp_groups. Передавайте SID только выбранных AD-групп, сопоставленных с разрешениями BusinessProxy. Ищите SID команды через Get-ADGroup. После пересоздания группы прежний SID требуется заменить в правилах AD FS и сопоставлении BusinessProxy.
  • Для управляемого каталога настройте отдельный claim с единственным SID сотрудника, например bp_object_sid. В настройках импорта укажите его точное короткое имя.

6. Подключите рабочую область и проверьте права

В «Команда → SSO» выберите «Microsoft AD FS (OIDC)». Заполните Issuer URL, Client ID, Client secret и, для корпоративных атрибутов, «Ресурс AD FS», scopes openid allatclaims и «Атрибут групп». Сохраните и нажмите «Проверить подключение».

  • Сохраните независимый вход администратора BusinessProxy. Создайте локальную группу BusinessProxy, сопоставьте с ней SID пилотной группы и выдайте ей доступ к одному тестовому ресурсу. Подтвердите изменение ключом доступа или кодом BusinessProxy.
  • Для доступа обычных участников только по группе откройте «Настройки безопасности → Доступ по умолчанию» у CMS и выберите «Только owner». При выборе «Все участники» обычный участник с этой базовой ролью может войти и без разрешающей группы. Владельцы и администраторы имеют собственные права BusinessProxy.
  • Откройте ссылку для сотрудников в чистом профиле браузера. Проверьте вход разрешённого пользователя и отказ пользователю вне выбранной группы. Для нового пользователя проверьте настройки JIT или допуска импортированных сотрудников. Доступ через BusinessProxy открывает маршрут к CMS. Для входа в админку нужна локальная учётная запись с нужными правами. Если включён вход в CMS через BusinessProxy, пользователь сначала связывает свою существующую учётную запись CMS. Роли и второй фактор самой CMS действуют и после привязки.
  • Откройте защищённую страницу. Завершите тестовую сессию в BusinessProxy и обновите ту же вкладку. Проверьте отказ на следующем защищённом запросе. Для постоянного отзыва также снимите разрешение, затем проверьте новый вход. При использовании каталога дождитесь успешного импорта и убедитесь, что он принял изменение.

7. Настройте пользовательский портал и включите вход через AD FS

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

  • Если у портала уже есть рабочий HTTPS-адрес, перейдите к настройке SSO. Для нового портала откройте настройки рабочей области и найдите «Пользовательские домены». Нажмите «Добавить домен», внесите в DNS показанные записи для подтверждения и маршрутизации, затем запустите проверку DNS. Дождитесь готовности домена и откройте выделенный адрес портала app. на этом домене.
  • В кабинете откройте «Публичные приложения», найдите адрес портала и выберите «Оформление портала». Здесь задаются тема, логотипы, подложка, цвет основных кнопок и иконка вкладки. Чтобы тёмный логотип хорошо читался на тёмной иллюстрации, выберите белую или светло-серую подложку. Для отдельного адреса приложения откройте его параметры, перейдите в «Адреса» и выберите режим «Брендированный портал».
  • Владелец рабочей области включает публикацию в разделе «Услуги → Брендированные порталы». Перед подтверждением проверьте цену в валюте своего баланса. Для порталов, уже опубликованных к моменту введения тарифа, доступен 30-дневный переходный период. При завершении публикации адрес портала переводит посетителя в стандартный каталог BusinessProxy.
  • В этой же рабочей области откройте «Команда → SSO». Добавьте или отредактируйте подключение «Microsoft AD FS (OIDC)», выберите статус «Активен», сохраните и нажмите «Проверить подключение». В AD FS используйте callback, показанный на странице SSO. Адрес брендированного портала отдельно в список callback добавлять не требуется.
  • В чистом профиле браузера откройте HTTPS-адрес портала и нажмите «Войти через AD FS». Введите пароль доменной учётной записи на странице AD FS, вернитесь на портал и пройдите проверку BusinessProxy, если она запрошена. Разрешённый сотрудник должен открыть назначенное приложение, а сотрудник без доступа должен получить отказ. Завершите тестовую сессию в кабинете и проверьте отказ в той же вкладке.
  • Если кнопка не появилась, проверьте статус подключения, тип «Microsoft AD FS (OIDC)», совпадение рабочей области и использование брендированного адреса в обычном браузере. Если кнопка есть, но вход не завершается, проверьте callback и правила допуска ниже.

Если проверка не прошла

  • Браузер показывает ошибку сертификата или проверка issuer не проходит. Проверьте DNS снаружи и внутри, доступность TCP 443, совпадение имени в SAN, срок и промежуточные сертификаты. Если браузер доверяет частному УЦ, проверьте доверие самой установки BusinessProxy.
  • Проверка подключения проходит, реальный вход возвращает ошибку discovery. В своей серверной установке проверьте сетевой маршрут и доверие к УЦ на всех репликах, обслуживающих проверку и вход. В облаке передайте поддержке время ошибки и имя издателя.
  • AD FS отказывает на странице входа или после неё. Сверьте точный callback, Client ID, ресурс, разрешённые scopes и политику пилотной группы. Проверьте AD FS → Admin в Event Viewer. В обращении в поддержку достаточно времени и идентификатора события.
  • AD FS возвращает MSIS7614 при добавлении Web API. Проверьте отображаемое имя ресурса во всей ферме и задайте уникальное имя для этой регистрации. Перед повтором проверьте, какие объекты предыдущая попытка успела создать.
  • Сотрудник вошёл без доступа к ресурсу. Проверьте подписанное короткое имя claim, SID, сопоставление, разрешения на конкретный ресурс и его состояние. Для CMS проверьте свежий второй фактор BusinessProxy и, если выбран платный способ доступа, состояние услуги.
Документация
BusinessProxy

Поиск по документации

Открыть руководство

Поиск по тексту и заголовкам статейEsc Закрыть