Holarch

Администрирование

Единый вход и SCIM

Подключение поставщика удостоверений SAML 2.0 организации (Okta, Microsoft Entra ID, Microsoft AD FS, Google Workspace, Ping) или напрямую Active Directory самостоятельно размещённого сервера, подтверждение его доменов эл. почты, обязательный единый вход, сопоставление групп с ролями и подготовка учётных записей через SCIM 2.0.

Как использовать →

На этой странице
  1. Понятия
  2. Как использовать
    1. Подтверждение почтового домена
    2. Подключение поставщика удостоверений
    3. Включение единого входа
    4. Обязательный единый вход
    5. Подготовка учётных записей через SCIM
    6. Когда меняется сертификат поставщика удостоверений
    7. Корпоративный вход для нескольких организаций (самостоятельное размещение)
    8. Доступ к проектам отдела (самостоятельное размещение)
  3. Правила входа
    1. Двухэтапный вход
  4. Атрибуты
    1. Группы в роли
  5. SCIM
    1. Группы SCIM и отделы (самостоятельное размещение)
  6. Настройка поставщика удостоверений
    1. Okta
    2. Microsoft Entra ID
    3. Microsoft AD FS
    4. Google Workspace
    5. Ping Identity
  7. Корпоративный каталог (Active Directory / LDAP)
    1. Настройка корпоративного каталога
    2. Отделы из групп каталога
    3. Кто может входить
    4. Периодическая проверка
    5. Двухэтапный вход с корпоративным каталогом
  8. Ограничения и замечания по безопасности

Организация может разрешить своим участникам входить в Holarch с рабочей учётной записью. Holarch является поставщиком услуг; поставщик удостоверений вашей организации (Okta, Microsoft Entra ID, Microsoft AD FS, Google Workspace, Ping Identity или любой поставщик SAML 2.0) проверяет, кто они. Поставщик удостоверений также может создавать, обновлять и деактивировать учётные записи Holarch через SCIM 2.0.

Единый вход настраивает администратор организации в разделе Настройки организации → организация → Доступ и вход → Единый вход. Он работает в размещённом сервисе и на самостоятельно размещённых серверах, но не в настольном приложении. Самостоятельно размещённому серверу нужен исходящий доступ, чтобы подтвердить домен (запрос DNS) и прочитать метаданные по URL. Самостоятельно размещённый сервер также может сам проверять корпоративные учётные записи через Active Directory или другой каталог LDAP, без поставщика удостоверений: см. Корпоративный каталог (Active Directory / LDAP).

Примечание: единый вход и подготовка учётных записей через SCIM входят в тариф Team (тариф организации). Организации, которые использовали их до версии 2.29.0, сохраняют их. Без тарифа настройки сохраняются, но участники входят с паролем (Забыли пароль? задаёт его), через Google или Microsoft, а запросы SCIM отклоняются.

Понятия

УсловиеЗначение
Подтверждённый доменПочтовый домен (например, example.com), контроль над которым организация подтвердила записью DNS TXT. Единый вход и SCIM работают только для адресов в подтверждённых доменах. Домен может подтвердить одна организация.
Поставщик удостоверений (IdP)Сервис, через который входят ваши участники: его ID сущности (издатель), URL входа и сертификат подписи.
Поставщик услуг (SP)Holarch для этой организации. У каждой организации свои ID сущности, URL ACS и URL метаданных.
Управляемые участникиУчастники организации, адрес электронной почты которых находится в подтверждённом домене и которые не являются администраторами организации. К ним применяется Требовать единый вход.
Токен SCIMСекрет, который поставщик удостоверений использует для вызова API SCIM Holarch для этой организации. Он не привязан к человеку.

Как использовать

Подтверждение почтового домена

  1. Откройте Настройки организации, выберите организацию, откройте Доступ и вход и найдите Единый вход.
  2. В разделе Почтовые домены введите домен адресов ваших участников и выберите Добавить домен.
  3. Опубликуйте показанную запись TXT: имя _holarch-challenge.<domain> со значением holarch-domain-verification=….
  4. Выберите Проверить. Изменения DNS могут распространяться несколько минут; проверяйте снова, пока домен не покажет Подтверждён.

Добавьте все домены, которые используют ваши участники (например, example.com и eng.example.com). До 20 доменов на организацию.

Подключение поставщика удостоверений

  1. В поставщике удостоверений создайте приложение SAML 2.0 (см. разделы о поставщиках ниже) со значениями из раздела Поставщик удостоверений в Holarch:
    • ID сущности (аудитория): https://app.holarch.app/api/auth/saml/<organization id>/metadata
    • URL ACS (URL ответа): https://app.holarch.app/api/auth/saml/<organization id>/acs
    • URL метаданных: тот же, что и ID сущности; поставщики, импортирующие метаданные SP, могут его использовать.
  2. Скопируйте XML метаданных поставщика или его URL метаданных в поле вверху и выберите Прочитать метаданные. Holarch заполнит ID сущности, URL входа и сертификат. Или введите их сами.
  3. В разделе Атрибуты и роли задайте имена атрибутов, если ваш поставщик использует необычные (см. Атрибуты), Роль новых участников и необязательные Группы в роли.
  4. Выберите Сохранить поставщика удостоверений и введите пароль.

Включение единого входа

  1. Отметьте Единый вход для этой организации. Для этого нужны сохранённый поставщик удостоверений и подтверждённый домен.
  2. Дайте участникам Ссылку для входа участников или скажите им выбрать Войти через единый вход на экране входа и ввести рабочий адрес электронной почты.
  3. Сначала попробуйте с одним участником.

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

Обязательный единый вход

Отметьте Требовать единый вход для участников в подтверждённых доменах после того, как единый вход заработает.

  • Тогда управляемые участники входят только через поставщика удостоверений. Вход по паролю, ключу доступа, через Google и Microsoft отвечает, что организация требует единый вход, и показывает кнопку перехода к нему. Их текущие сеансы, открытые другими способами входа, сразу завершаются.
  • Администраторам организации это не требуется: они сохраняют пароль или ключ доступа с двухэтапным входом, чтобы иметь возможность исправить сломанную настройку поставщика удостоверений (аварийный доступ). Держите не менее двух администраторов организации.
  • Участников, чей адрес находится вне подтверждённых доменов (внешних соавторов), это не затрагивает.
  • Сброс пароля по-прежнему задаёт новый пароль, но не выполняет вход участника; затем он входит через поставщика удостоверений.
  • Токены API и подключённые приложения управляемых участников продолжают работать. Чтобы прекратить их работу, деактивируйте учётную запись через SCIM.

Подготовка учётных записей через SCIM

  1. В разделе Подготовка учётных записей (SCIM 2.0) выберите Создать токен SCIM и введите пароль.
  2. Скопируйте токен и Базовый URL (https://app.holarch.app/scim/v2) в настройки подготовки учётных записей поставщика удостоверений. Holarch показывает токен один раз.
  3. Включите у поставщика создание, обновление и деактивацию пользователей.

До 5 токенов на организацию. Отозвать сразу прекращает действие токена.

Когда меняется сертификат поставщика удостоверений

  1. Вставьте новый сертификат под старым (допускаются два сертификата) и сохраните.
  2. Переключите поставщика на новый сертификат.
  3. Удалите старый сертификат и снова сохраните.

Список сертификатов показывает субъект, срок действия и отпечаток каждого сертификата.

Корпоративный вход для нескольких организаций (самостоятельное размещение)

Почтовый домен принадлежит одной организации. Когда компания ведёт по одной организации на отдел на самостоятельно размещённом сервере, одна организация (обычно ИТ-отдела) подтверждает домен компании, подключает поставщика удостоверений и включает единый вход. Остальные организации затем сопоставляют группы поставщика удостоверений со своими ролями:

  1. В разделе отдела Настройки организации → Доступ и вход → Единый вход найдите Вход компании. Там указана организация, которая ведёт корпоративный вход.
  2. В поле Группы и роли напишите по одному сопоставлению в строке, например packs-engineers = member и packs-leads = admin, и выберите Сохранить группы.
  3. Необязательно: добавьте после запятой доступ группы к проектам отдела, например packs-contractors = member, viewer. См. Доступ к проектам отдела.

При каждом входе через корпоративный вход человек из сопоставленной группы вступает в эту организацию с этой ролью или становится там администратором организации. Вход никогда никого не удаляет и не понижает (группы SCIM могут: см. Группы SCIM и отделы); администраторы организации удаляют людей в Настройках организации. Поставщик удостоверений должен передавать группы (Атрибут групп корпоративного входа).

Администраторы организации, которая ведёт корпоративный вход, управляют входом для всех адресов домена. Оставьте в этой организации только тех, кто обслуживает поставщика удостоверений.

Доступ к проектам отдела (самостоятельное размещение)

Каждое сопоставление группы может также указывать, какой доступ получают её люди к проектам, предоставленным всей организации (Поделиться → Организации): viewer, reviewer или editor (по умолчанию). Роль человека в таком проекте — меньшая из роли совместного доступа и наивысшего доступа среди его сопоставленных групп там. Например, если проект предоставлен с ролью “Редактор” и задано packs-contractors = member, viewer, подрядчик его просматривает; тот, кто состоит и в packs-contractors, и в packs-engineers = member, его редактирует. Правило действует независимо от источника групп: корпоративный единый вход, группы SCIM и корпоративный каталог. Проекты, предоставленные человеку напрямую, не затрагиваются, а участник, добавленный вручную (не входящий ни в одну сопоставленную группу), получает роль совместного доступа. Изменение доступа группы сразу применяется ко всем, кого она распределила.

Места редакторов. Лицензия ограничивает число редакторов; читатели и рецензенты бесплатны. Если доступ “Редактор” группы сделал бы человека редактором, а свободного места нет, он получает роль “Читатель”, и вход по-прежнему работает. Настройки организации и Администратор → Корпоративный каталог показывают, сколько людей удерживается на роли “Читатель”; страница “Корпоративный каталог” перечисляет каждого редактора, чьё место получено через группу, и каждого удерживаемого человека. Когда места освобождаются, удерживаемые люди получают роль “Редактор” при следующей проверке, в порядке членства — сначала самые ранние.

Серверы в закрытой сети. Если сервер не может обращаться к публичному DNS, администратор сайта может выбрать Отметить как подтверждённый рядом с неподтверждённым доменом вместо публикации записи TXT. Домен по-прежнему принадлежит только одной организации, а изменение записывается в журнал аудита.

Правила входа

Holarch строго проверяет каждый ответ поставщика удостоверений. Вход отклоняется, если:

  • утверждение не подписано настроенным сертификатом или подписано с SHA-1;
  • издатель, аудитория (ID сущности организации), назначение или получатель (URL ACS) не совпадают;
  • утверждение ещё не действительно или истекло (допускается расхождение часов на 2 минуты);
  • оно отвечает на вход, который не был начат в том же браузере, или на уже использованный вход (каждый вход начинается один раз и истекает через 10 минут);
  • то же утверждение приходит повторно (атака повторного воспроизведения);
  • адрес электронной почты отсутствует или находится вне подтверждённых доменов организации;
  • учётная запись отключена.

Тогда экран входа сообщает, что пошло не так, а журнал аудита организации записывает это как auth.sso-failed.

Вход с портала поставщика удостоверений (по инициативе IdP, когда участники начинают с панели приложений поставщика) по умолчанию выключен, потому что такой ответ не привязан к входу, начатому браузером. Включайте Разрешить вход с портала поставщика удостоверений, только если участникам это нужно. Защита от повторного воспроизведения и все остальные проверки по-прежнему действуют.

Двухэтапный вход

По умолчанию единый вход — это первый этап. Учётные записи с включённым двухэтапным входом по-прежнему подтверждают ключ доступа или код, а параметр организации Требовать двухэтапный вход по-прежнему требует его от участников.

При включённом Доверять многофакторному входу поставщика удостоверений вход, утверждение которого сообщает о многофакторной аутентификации, не требует второго этапа Holarch и удовлетворяет требованию двухэтапного входа этой организации для данного сеанса (но не других организаций). Holarch принимает следующие контексты аутентификации как многофакторные:

Контекст аутентификацииКем отправляется
https://refeds.org/profile/mfaМногими поставщиками при соответствующей настройке
http://schemas.microsoft.com/claims/multipleauthnMicrosoft Entra ID
urn:oasis:names:tc:SAML:2.0:ac:classes:MobileTwoFactorContract (и …MobileTwoFactorUnregistered)Okta и другими
urn:oasis:names:tc:SAML:2.0:ac:classes:TimeSyncTokenОдноразовый код
urn:oasis:names:tc:SAML:2.0:ac:classes:Smartcard и …SmartcardPKIСмарт-карты

Утверждение Entra ID http://schemas.microsoft.com/claims/authnmethodsreferences со значением multipleauthn тоже учитывается. Вход только по паролю у поставщика удостоверений не является многофакторным, даже при включённом доверии.

Атрибуты

HolarchИмена атрибутов по умолчанию (используется первый присутствующий)
Эл. почта (обязательно)email, mail, emailaddress, http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress, urn:oid:0.9.2342.19200300.100.1.3, NameID, если это адрес электронной почты, иначе утверждение UPN (http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn)
ИмяdisplayName, name, http://schemas.microsoft.com/identity/claims/displayname, утверждение WS-Federation name или имя и фамилия (givenName/firstName, sn/surname/lastName и их формы утверждений)
ГруппыАтрибут, указанный вами в поле Атрибут групп, например groups. Если ничего не указано: groups, memberOf, Role, http://schemas.xmlsoap.org/claims/Group от AD FS, http://schemas.microsoft.com/ws/2008/06/identity/claims/role, …/claims/groupsid и …/claims/groups

Учётная запись находится по NameID поставщика удостоверений (формат persistent, email, Windows domain qualified name или другой). Без NameID (AD FS не передаёт его, если правило утверждений его не выдаёт) учётную запись определяет адрес электронной почты. Если NameID меняется, а адрес электронной почты остаётся прежним, учётная запись привязывается заново.

Имена групп сравниваются без учёта регистра. Имя с доменом, например CORP\Packs Engineers, также соответствует сопоставлению для Packs Engineers, а SID группы (S-1-5-21-…) соответствует сопоставлению, записанному с этим SID.

Группы в роли

Пишите по одному сопоставлению в строке: holarch-admins = admin или engineering = member. При каждом входе участник группы, сопоставленной с admin, становится администратором организации; иначе участник сопоставленной группы становится участником. Участники, не входящие ни в одну сопоставленную группу, сохраняют свою роль. Последний администратор организации никогда не понижается.

SCIM

API SCIM соответствует RFC 7643 и RFC 7644 по адресу https://app.holarch.app/scim/v2 с Authorization: Bearer hsc_….

Конечная точкаЧто он делает
GET /ServiceProviderConfig, /ResourceTypes, /SchemasОписание сервиса
GET /UsersСписок подготовленных пользователей организации и участников в её подтверждённых доменах; filter с eq по userName, externalId, id, emails.value или emails[type eq "work"].value; startIndex и count
POST /UsersСоздание пользователя (или привязка существующей учётной записи с этим адресом) и добавление его в организацию
GET, PUT, PATCH /Users/<id>Чтение, замена или изменение пользователя: userName, name, displayName, emails, externalId, active
DELETE /Users/<id>Деактивация пользователя и удаление внешнего ID
/GroupsСамостоятельно размещённые серверы: перечисление, создание, чтение, замена, изменение (PATCH для members, displayName, externalId, в форматах Okta и Microsoft Entra ID) и удаление групп; filter с eq по displayName, externalId или id; excludedAttributes=members. См. Группы SCIM и отделы. Размещённый сервис: пустой список, изменения отклоняются; вместо этого сопоставляйте группы с ролями в настройках единого входа.
  • Создавать или изменять можно только адреса в подтверждённых доменах организации.
  • Деактивация (active: false или DELETE) удаляет человека из организации, отключает учётную запись, завершает все её сеансы и отзывает её токены API и подключённые приложения. Повторная активация включает учётную запись и восстанавливает её роль в организации. Учётная запись, отключённая самим Holarch (например, после злоупотреблений), остаётся отключённой.
  • Атрибуты расширения Enterprise принимаются и игнорируются.
  • Каждый токен может выполнять 600 запросов в минуту. Каждое изменение записывается в журнал аудита организации (scim.create, scim.deactivate и т. д.).

Группы SCIM и отделы (самостоятельное размещение)

На самостоятельно размещённом сервере поставщик удостоверений может передавать свои группы в конечную точку SCIM организации, которой принадлежит домен компании. Затем Группы и роли отделов в разделе Вход компании определяют, кто в какой отдел входит и с какой ролью. Одно сопоставление служит для обоих случаев: входа через корпоративный единый вход и групп SCIM.

  • Человек, добавленный в сопоставленную группу, вступает в эту организацию с сопоставленной ролью; смена группы меняет роль.
  • Человек, удалённый из всех сопоставленных групп, покидает организации, в которые его добавили группы.
  • Членство, добавленное другим способом (администратором организации, приглашением, импортом или входом), группы никогда не удаляют и не понижают; они могут только повысить его до администратора организации. Когда администратор организации вручную меняет роль участника, с этого момента членство управляется вручную.
  • Последний администратор организации никогда не удаляется и не понижается.
  • Изменение Группы и роли отдела сразу применяется ко всем в группах.
  • Участниками групп должны быть пользователи, которых подготавливает или которыми управляет этот токен; другие id игнорируются.
  • Деактивация пользователя работает как прежде; его отделы следуют за его группами.
  • Каждое изменение записывается: scim.group-create, scim.group-update и scim.group-delete в журнале аудита организации компании, а каждое изменение членства — в журнале отдела.

Настройка поставщика удостоверений

Okta

  1. Applications → Create App Integration → SAML 2.0.
  2. Single sign-on URL: URL ACS. Оставьте отмеченным Use this for Recipient URL and Destination URL. Audience URI (SP Entity ID): ID сущности.
  3. Name ID format: EmailAddress или Persistent. Application username: Email.
  4. Attribute statements: email → user.email, displayName → user.displayName. Group attribute statements (необязательно): groups, фильтр по необходимости.
  5. Завершите, затем скопируйте Metadata URL с вкладки Sign On в Holarch и выберите Прочитать метаданные.
  6. Для SCIM: на вкладке General приложения включите SCIM provisioning; на вкладке Provisioning поле SCIM connector base URL — это базовый URL, Unique identifier field — userName, Authentication Mode — HTTP Header с токеном SCIM; включите Create Users, Update User Attributes и Deactivate Users.

Microsoft Entra ID

  1. Enterprise applications → New application → Create your own application (не из коллекции), затем Single sign-on → SAML.
  2. Identifier (Entity ID): ID сущности. Reply URL (Assertion Consumer Service URL): URL ACS.
  3. Attributes & Claims: утверждение emailaddress по умолчанию подходит; добавьте утверждение групп, если сопоставляете группы.
  4. В разделе SAML Certificates скопируйте App Federation Metadata Url в Holarch и выберите Прочитать метаданные.
  5. Чтобы доверять многофакторному входу Entra, потребуйте MFA в политике условного доступа (Conditional Access) для приложения; тогда Entra отправляет multipleauthn.
  6. Для SCIM: Provisioning → Automatic; Tenant URL — базовый URL, а Secret Token — токен SCIM. Test Connection, затем запустите подготовку учётных записей.

Microsoft AD FS

AD FS (Active Directory Federation Services, Windows Server 2016 или новее) выполняет вход людей из вашей локальной Active Directory. В консоли AD FS Management:

  1. Relying Party Trusts → Add Relying Party Trust → Claims aware → Import data about the relying party published online и введите URL метаданных Holarch. Если сервер AD FS не может обратиться к Holarch, сохраните метаданные в файл и выберите Import data about the relying party from a file. Display name: Holarch.
  2. Access control policy: Permit everyone или Permit everyone and require MFA (см. шаг 6).
  3. Откройте для доверия Edit Claim Issuance Policy → Add Rule → Send LDAP Attributes as Claims, хранилище атрибутов Active Directory:
Атрибут LDAPТип исходящего утверждения
E-Mail-AddressesE-Mail Address
Display-NameИмя
Token-Groups – Unqualified NamesГруппа

Используйте вместо этого Token-Groups – Qualified by Domain Name, если в двух доменах есть группы с одинаковыми именами; Token-Groups as SIDs (тип утверждения Group SID) — если имена групп меняются. Holarch читает утверждения Group, Role и Group SID без Атрибут групп.

AD FS передаёт для каждой группы её pre-Windows 2000 name (sAMAccountName), а не отображаемое имя или cn, и включает основную группу (обычно Domain Users). Сопоставляйте группы по этому имени или по SID. На сервере с подключённым корпоративным каталогом Администратор → Корпоративный каталог → Проверить пользователя показывает оба значения для каждой группы человека.

  1. Необязательно, стабильный NameID: Add Rule → Transform an Incoming Claim, входящее E-Mail Address (или UPN), исходящее Name ID, формат Email (или Persistent Identifier). Без этого Holarch определяет учётную запись по её адресу электронной почты.
  2. В Properties → Advanced доверия оставьте SHA-256. Оставьте вкладку Encryption пустой: Holarch не расшифровывает утверждения, а соединение идёт по https. AD FS по умолчанию подписывает утверждение (SamlResponseSignature AssertionOnly), что Holarch требует.
  3. Скопируйте https://<your AD FS host>/FederationMetadata/2007-06/FederationMetadata.xml в поле URL метаданных Holarch и выберите Прочитать метаданные. Это заполняет ID сущности (http://<host>/adfs/services/trust), URL входа (https://<host>/adfs/ls/) и сертификат подписи токенов. Чтобы доверять многофакторному входу AD FS, потребуйте MFA в политике управления доступом и включите Доверять многофакторному входу поставщика удостоверений; тогда AD FS передаёт http://schemas.microsoft.com/claims/multipleauthn.

На самостоятельно размещённом сервере URL метаданных может быть внутренним адресом (https://adfs.corp.example.com/…, частный IP), а его сертификат проверяется по CA компании в tls/ldap-ca.pem, а также по доверенным CA системы. Сертификат подписи токенов AD FS обновляется каждый год: Holarch показывает дату окончания срока; снова выполните Прочитать метаданные, когда AD FS добавит новый (в период перекрытия сохраняются оба). У AD FS нет SCIM; при корпоративном каталоге на самостоятельно размещённом сервере Holarch проверяет учётные записи сам (см. ниже).

Google Workspace

  1. Admin console → Apps → Web and mobile apps → Add app → Add custom SAML app.
  2. Скопируйте IdP metadata (скачайте их, затем вставьте XML в Holarch).
  3. ACS URL: URL ACS. Entity ID: ID сущности. Name ID format: EMAIL, Name ID: Basic Information › Primary email.
  4. Attribute mapping: Primary email → email; First name → givenName; Last name → sn. Group membership → groups (необязательно).
  5. Включите приложение: ON for everyone (или для организационного подразделения).
  6. Google Workspace не отправляет контекст аутентификации MFA; оставьте Доверять многофакторному входу поставщика удостоверений выключенным. Подготовка учётных записей через SCIM в Google работает только с приложениями из коллекции; вместо этого создавайте учётные записи через единый вход.

Ping Identity

  1. PingOne: Applications → Add Application → SAML Application (PingFederate: подключение SP).
  2. Импортируйте URL метаданных Holarch или введите ACS URL и Entity ID.
  3. Attribute mapping: saml_subject → Email Address; добавьте email и displayName.
  4. Скопируйте URL метаданных IdP в Holarch и выберите Прочитать метаданные.
  5. Для SCIM: подготовка учётных записей PingOne с подключением SCIM; базовый URL и аутентификация OAuth 2 Bearer Token с токеном SCIM.

Корпоративный каталог (Active Directory / LDAP)

На самостоятельно размещённом сервере люди могут входить со своим корпоративным именем пользователя и паролем, которые проверяет каталог компании: Active Directory (его контроллеры домена) или другой каталог LDAP, например OpenLDAP или FreeIPA. Поставщик удостоверений не нужен. Администратор сайта настраивает это в разделе Администратор → Корпоративный каталог; начальные значения может задать файл .env сервера (HOLARCH_LDAP_*, SIGN-IN.md из поставки для самостоятельного размещения). В размещённом сервисе это не предлагается.

Настройка корпоративного каталога

Сначала выберите Тип каталога в верхней части страницы Администратор → Корпоративный каталог: Active Directory или Другой каталог LDAP (OpenLDAP, FreeIPA, …). В любом случае это одно подключение; тип определяет, какие варианты поиска групп предлагаются, какие значения Использовать стандартные параметры Active Directory или Использовать стандартные параметры LDAP подставляют в форму, а также подсказки и примеры. При смене типа заменяются фильтр пользователей или поиск групп, которые ещё имеют значение по умолчанию другого типа, а написанный вами фильтр сохраняется. Страница определяет тип по сохранённым настройкам (вложенные группы или фильтр Active Directory означают Active Directory).

  1. Создайте в каталоге служебную учётную запись только для чтения (например svc-holarch). Укажите её имя в поле Учётная запись для привязки, а её пароль — в файле .env сервера как HOLARCH_LDAP_BIND_PASSWORD, затем перезапустите сервер. Пароль никогда не показывается в разделе “Администратор”.
  2. В поле Серверы каталога введите каждый контроллер домена или сервер LDAP как ldaps://dc1.corp.example.com (порт 636), по одному в строке; они опрашиваются по порядку. ldap://host:389 работает только при включённом Использовать StartTLS. Простой LDAP отклоняется, поэтому пароль никогда не передаётся по сети в незашифрованном виде. Используйте имя хоста каждого сервера так, как оно указано в его сертификате.
  3. Поместите сертификат CA, выпустившего сертификаты серверов, в поле Сертификат CA (PEM) или в tls/ldap-ca.pem на сервере. Пусто — используются доверенные CA системы.
  4. Введите Базовый DN (DC=corp,DC=example,DC=com или dc=example,dc=com в другом каталоге LDAP) и Разрешённые почтовые домены.
  5. Выберите Проверить подключение. Проверка подключается со значениями из формы, не сохраняя их, и называет проблему, если что-то не работает (ни один сервер не ответил, сертификат, учётная запись для привязки, базовый DN).
  6. В разделе Проверить пользователя введите имя пользователя, чтобы увидеть, что найдёт вход: адрес эл. почты, активна ли учётная запись, её группы и организации, в которые она вступит. Пароль необязателен; он проверяется один раз и никогда не сохраняется.
  7. Включите Разрешить вход с корпоративными учётными записями и выберите Сохранить. После этого экран входа показывает Войти с корпоративной учётной записью (или ваш Текст кнопки).

Active Directory: Фильтр пользователей по умолчанию находит активных пользователей по sAMAccountName, userPrincipalName или mail, поэтому люди могут ввести jsmith, [email protected] или CORP\jsmith. Отключённые учётные записи исключаются. Поиск групп предлагает Active Directory, с вложенными группами (по умолчанию) и Атрибут memberOf (только прямые группы).

Другой каталог LDAP: Использовать стандартные параметры LDAP подставляет (&(objectClass=inetOrgPerson)(|(uid={username})(mail={username}))) в Фильтр пользователей, поэтому люди вводят свой uid или адрес эл. почты; подойдёт любой фильтр с {username} на месте введённого имени. Поиск групп предлагает Атрибут memberOf (OpenLDAP с оверлеем memberof, FreeIPA, 389 Directory Server) и Группы, в которых человек указан как участник (groupOfNames и groupOfUniqueNames; Базовый DN групп указывает, где они находятся). Вложенные группы не учитываются.

Отделы из групп каталога

Группы каталога распределяют людей по организациям с помощью тех же Группы в роли в разделе Вход компании, что и SAML (см. Корпоративный вход для нескольких организаций): в блоке Единый вход каждой организации сопоставьте группы с ролями, например Packs Engineers = member и Packs Leads = admin. Имена сравниваются без учёта регистра; DN группы тоже подходит, а в Active Directory — её SID. Active Directory, с вложенными группами учитывает человека в группе и через другие группы внутри неё.

При каждом входе и каждой периодической проверке человек из сопоставленной группы вступает в эту организацию с этой ролью и с доступом к проектам отдела этой группы. Членство, выданное каталогом, удаляется, когда человек покидает все группы, которые с ним сопоставлены; членство, добавленное вручную, сохраняется (каталог может повысить там участника до администратора организации, но никогда не понижает). Последний администратор организации никогда не удаляется.

Кто может входить

  • Учётная запись должна быть активна в каталоге: отключённые, заблокированные и просроченные учётные записи отклоняются, как и учётные записи, у которых истёк срок действия пароля или пароль нужно сменить при следующем входе в систему.
  • У записи каталога должен быть адрес эл. почты в разрешённом домене. Первый вход создаёт учётную запись Holarch или связывает существующую учётную запись с этим адресом. Учётная запись, уже связанная с другой записью каталога, не перехватывается.
  • Требовать корпоративного входа для связанных учётных записей запрещает связанным учётным записям входить с паролем Holarch. Администраторы сайта сохраняют свой пароль, поэтому сбой каталога никогда не заблокирует всех.
  • После Неудачных попыток до паузы (по умолчанию 3) неверные пароли приостанавливают вход для этой корпоративной учётной записи на 15 минут, в какой бы форме ни было введено имя (jsmith, [email protected], CORP\jsmith). Держите это значение ниже порога блокировки домена, чтобы Holarch никогда не блокировал корпоративную учётную запись. Неизвестные имена пользователей и неверные пароли получают одинаковый ответ примерно за одинаковое время.

Периодическая проверка

Каждые Проверять учётные записи каждые минут (по умолчанию 15) сервер проверяет каждую связанную учётную запись, которая выполнила вход или имеет членство из каталога. Человек, который был отключён, заблокирован, удалён из каталога или у которого истёк срок действия пароля или пароль нужно сменить при следующем входе (часто это сброс администратором после подозрения на компрометацию), выходит из системы везде и теряет членство, выданное каталогом; изменения групп обновляют членство. Заблокированная учётная запись получает членство обратно при следующем входе после разблокировки. Если каталог недоступен, ничего не меняется. Если большинство проверенных учётных записей отсутствует (например, после неверного базового DN), ничего не завершается, и раздел “Администратор” показывает предупреждение. Проверить сейчас сразу запускает проверку. Раздел “Администратор” показывает результат последней проверки.

Каждая проверка также находит участников всех сопоставленных групп (вложенные группы учитываются при Active Directory, с вложенными группами) и создаёт учётные записи для тех, у кого их ещё нет, по тем же правилам, что и вход (активна, разрешённый почтовый домен, без перехвата учётной записи, связанной с другой записью). Письмо не отправляется; человек входит со своей корпоративной учётной записью, когда ему впервые понадобится Holarch, и уже состоит в своих отделах, поэтому проекты можно предоставить ему заранее. Одна проверка создаёт не более 200 учётных записей; раздел “Администратор” показывает, сколько ещё ждут следующей проверки. Группы, указанные только по SID, так не ищутся; их люди распределяются при входе.

Двухэтапный вход с корпоративным каталогом

Корпоративный вход — это первый шаг. Организации, требующие двухэтапного входа, всё равно запрашивают второй шаг Holarch (ключ доступа или код), а учётные записи с включённым двухэтапным входом всё равно его подтверждают. Включайте Считать корпоративный вход двухэтапным входом, только если сама корпоративная учётная запись требует второго фактора; тогда он выполняет требование двухэтапного входа любой организации для этого сеанса.

Каждый вход через каталог, каждый отказ и каждое изменение настроек есть в журнале аудита (admin.directory-save, admin.directory-test, directory.account-ended) и в записях о входе каждой учётной записи. Пароли никогда не записываются.

Ограничения и замечания по безопасности

Ограничение: единый вход использует привязку HTTP-Redirect к поставщику удостоверений и HTTP-POST обратно в Holarch. Подписанные и зашифрованные запросы аутентификации, зашифрованные утверждения и единый выход не поддерживаются. Группы SCIM поддерживаются только на самостоятельно размещённых серверах (Группы SCIM и отделы). Корпоративный каталог выполняет вход по имени пользователя и паролю (простая привязка поверх TLS); Kerberos и встроенный вход Windows не поддерживаются.

  • Изменения настроек требуют недавней проверки пароля, отправляются по почте всем администраторам организации и записываются в журнал аудита (sso.saml-save, sso.enable, sso.require, sso.domain-verify, scim.token-create…).
  • URL метаданных должны использовать https в публичном интернете (на самостоятельно размещённом сервере допускаются и внутренние адреса); Holarch загружает их один раз, когда вы выбираете Прочитать метаданные.
  • Токены SCIM хранятся только в виде хеша.