Адміністрування
Єдиний вхід і SCIM
Під’єднайте постачальника ідентичності SAML 2.0 організації (Okta, Microsoft Entra ID, Microsoft AD FS, Google Workspace, Ping) або безпосередньо Active Directory самостійно розміщеного сервера, підтвердьте домени електронної пошти, вимагайте єдиного входу, зіставляйте групи з ролями та створюйте облікові записи через SCIM 2.0.
На цій сторінці
- Поняття
- Як користуватися
- Підтвердити домен електронної пошти
- Підключити постачальника ідентичності
- Увімкнути єдиний вхід
- Вимагати єдиний вхід
- Підготувати облікові записи через SCIM
- Коли сертифікат постачальника ідентичності змінюється
- Вхід компанії для кількох організацій (самостійне розміщення)
- Доступ до проєктів відділу (самостійне розміщення)
- Правила входу
- Атрибути
- SCIM
- Налаштувати постачальника ідентичності
- Корпоративний каталог (Active Directory / LDAP)
- Ліміти та примітки щодо безпеки
Організація може дозволити своїм учасникам входити в 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) | Сервіс, який виконує вхід ваших учасників: його ідентифікатор сутності (видавець), URL входу й сертифікат підпису. |
| Постачальник послуг (SP) | Holarch для цієї організації. Кожна організація має власний ідентифікатор сутності, ACS URL і URL метаданих. |
| Керовані учасники | Учасники організації, чия електронна адреса належить до підтвердженого домену і які не є адміністраторами організації. До них застосовується Вимагати єдиний вхід. |
| Токен SCIM | Секрет, який постачальник ідентичності використовує для виклику API SCIM Holarch для цієї організації. Він не прив’язаний до людини. |
Як користуватися
Підтвердити домен електронної пошти
- Відкрийте Налаштування організації, виберіть організацію, відкрийте Доступ і вхід і знайдіть Єдиний вхід.
- У розділі Домени електронної пошти введіть домен адрес ваших учасників і виберіть Додати домен.
- Опублікуйте показаний запис TXT: ім’я
_holarch-challenge.<domain>зі значеннямholarch-domain-verification=…. - Виберіть Перевірити. Зміни DNS можуть поширюватися кілька хвилин; перевіряйте знову, доки домен не покаже Підтверджено.
Додайте кожен домен, який використовують ваші учасники (наприклад, example.com і eng.example.com). До 20 доменів на організацію.
Підключити постачальника ідентичності
- У своєму постачальнику ідентичності створіть застосунок SAML 2.0 (див. розділи постачальників нижче) зі значеннями з Постачальник ідентичності в Holarch:
- Entity ID (аудиторія):
https://app.holarch.app/api/auth/saml/<organization id>/metadata - ACS URL (URL відповіді):
https://app.holarch.app/api/auth/saml/<organization id>/acs - URL метаданих: те саме, що й ідентифікатор сутності; постачальники, які імпортують метадані SP, можуть його використати.
- Entity ID (аудиторія):
- Скопіюйте XML метаданих постачальника або його URL метаданих у поле вгорі й виберіть Прочитати метадані. Holarch заповнює ідентифікатор сутності, URL входу й сертифікат. Або введіть їх самостійно.
- У розділі Атрибути й ролі задайте назви атрибутів, якщо ваш постачальник використовує незвичні (див. Атрибути), Роль нових учасників і необов’язкові Групи в ролі.
- Виберіть Зберегти постачальника ідентичності і введіть пароль.
Увімкнути єдиний вхід
- Позначте Єдиний вхід для цієї організації. Для цього потрібні збережений постачальник ідентичності й підтверджений домен.
- Надайте учасникам Посилання для входу учасників або скажіть їм вибрати Увійти через єдиний вхід на екрані входу й ввести робочу електронну адресу.
- Спершу спробуйте з одним учасником.
Під час першого входу учасника Holarch створює обліковий запис (підтверджений, без пароля) і додає його до організації, навіть якщо реєстрація потребує запрошення. Коли обліковий запис із цією адресою існує, єдиний вхід пов’язується з ним, а його власник отримує лист.
Вимагати єдиний вхід
Позначте Вимагати єдиний вхід для учасників у підтверджених доменах, коли єдиний вхід запрацює.
- Тоді керовані учасники входять лише через постачальника ідентичності. Вхід із паролем, ключем доступу, через Google і Microsoft відповідає, що організація вимагає єдиного входу, і показує кнопку для переходу туди. Їхні поточні сеанси з інших способів входу одразу завершуються.
- Від адміністраторів організації це не вимагається: вони зберігають пароль або ключ доступу з двоетапним входом, щоб могли виправити зламане налаштування постачальника ідентичності (аварійний доступ). Тримайте щонайменше двох адміністраторів організації.
- Це не стосується учасників, чия адреса поза підтвердженими доменами (зовнішніх співпрацівників).
- Скидання пароля й далі задає новий пароль, але не виконує вхід учасника; потім учасник входить через постачальника ідентичності.
- Токени API і підключені застосунки керованих учасників продовжують працювати. Щоб їх припинити, деактивуйте обліковий запис через SCIM.
Підготувати облікові записи через SCIM
- У розділі Підготовка облікових записів (SCIM 2.0) виберіть Створити токен SCIM і введіть пароль.
- Скопіюйте токен і Базовий URL (
https://app.holarch.app/scim/v2) у налаштування підготовки облікових записів вашого постачальника ідентичності. Holarch показує токен один раз. - Увімкніть у постачальнику створення, оновлення й деактивацію користувачів.
До 5 токенів на організацію. Відкликати одразу припиняє дію токена.
Коли сертифікат постачальника ідентичності змінюється
- Вставте новий сертифікат під старим (дозволено два сертифікати) і збережіть.
- Перемкніть постачальника на новий сертифікат.
- Вилучіть старий сертифікат і збережіть знову.
Список сертифікатів показує суб’єкт, дату закінчення й відбиток кожного сертифіката.
Вхід компанії для кількох організацій (самостійне розміщення)
Домен електронної пошти належить одній організації. Коли компанія веде на самостійно розміщеному сервері окрему організацію для кожного відділу, одна організація (зазвичай ІТ-відділу) підтверджує домен компанії, під’єднує постачальника ідентичності й умикає єдиний вхід. Інші організації потім зіставляють групи постачальника ідентичності з власними ролями:
- У Налаштування організації → Доступ і вхід → Єдиний вхід відділу знайдіть Вхід компанії. Там названо організацію, яка керує входом компанії.
- У Групи та ролі запишіть по одному зіставленню в рядку, наприклад
packs-engineers = memberіpacks-leads = admin, і виберіть Зберегти групи. - Необов’язково: додайте після коми доступ до проєктів відділу для групи, наприклад
packs-contractors = member, viewer. Див. Доступ до проєктів відділу.
Під час кожного входу через вхід компанії людина в зіставленій групі приєднується до цієї організації з цією роллю або стає там адміністратором організації. Вхід ніколи нікого не вилучає й не знижує (групи SCIM можуть: див. Групи SCIM і відділи); адміністратори організації вилучають людей у налаштуваннях організації. Постачальник ідентичності має надсилати групи (Атрибут груп входу компанії).
Адміністратори організації, яка керує входом компанії, контролюють вхід для кожної адреси домену. Залиште в цій організації лише людей, які обслуговують постачальника ідентичності.
Доступ до проєктів відділу (самостійне розміщення)
Кожне зіставлення групи може також визначати, скільки отримують її люди в проєктах, якими поділилися з цілою організацією (Поділитися → Організації): viewer, reviewer або editor (типово). Роль людини в такому проєкті — нижча з ролі спільного доступу і найвищого доступу серед її зіставлених груп там. Наприклад, якщо проєктом поділилися як Редактор і задано packs-contractors = member, viewer, підрядник його переглядає; хтось одночасно в packs-contractors і packs-engineers = member його редагує. Правило діє незалежно від того, звідки надходять групи: корпоративний єдиний вхід, групи SCIM і корпоративний каталог. Проєкти, якими поділилися з людиною безпосередньо, не зачіпаються, а учасник, доданий вручну (не в зіставленій групі), отримує роль спільного доступу. Зміна доступу групи одразу діє для всіх, кого вона додала.
Місця редакторів. Ліцензія обмежує кількість редакторів; читачі й рецензенти безкоштовні. Коли доступ Редактор групи зробив би когось редактором, а вільного місця немає, ця людина отримує доступ Читач, і вхід усе одно працює. Налаштування організації та Адміністрування → Корпоративний каталог показують, скільки людей утримується на рівні Читач; сторінка “Корпоративний каталог” перелічує кожного редактора, чиє місце надходить від групи, і кожну утримувану людину. Коли місця звільняються, утримувані люди отримують доступ Редактор під час наступної перевірки, у порядку давності членства.
Сервери в закритій мережі. Коли сервер не може звертатися до публічного DNS, адміністратор сайту може вибрати Позначити як підтверджений поруч із непідтвердженим доменом замість публікації запису TXT. Домен і далі належить лише одній організації, а зміна записується в журнал аудиту.
Правила входу
Holarch суворо перевіряє кожну відповідь постачальника ідентичності. Вхід відхиляється, коли:
- твердження не підписано налаштованим сертифікатом або підписано з SHA-1;
- видавець, аудиторія (ідентифікатор сутності організації), призначення або одержувач (ACS URL) не збігаються;
- твердження ще не дійсне або вже прострочене (дозволено 2 хвилини розбіжності годинників);
- воно відповідає на вхід, який не розпочато в тому самому браузері, або на вже використаний (кожен вхід починається один раз і спливає через 10 хвилин);
- те саме твердження надходить удруге (повторне відтворення);
- електронна адреса відсутня або поза підтвердженими доменами організації;
- обліковий запис вимкнено.
Тоді екран входу повідомляє, що пішло не так, а журнал аудиту організації записує це як auth.sso-failed.
Вхід із порталу постачальника ідентичності (ініційований IdP, коли учасники починають із панелі застосунків постачальника) типово вимкнено, бо така відповідь не прив’язана до входу, розпочатого браузером. Вмикайте Дозволити вхід із порталу постачальника ідентичності, лише коли це потрібно вашим учасникам. Захист від повторного відтворення та всі інші перевірки й далі діють.
Двоетапний вхід
Типово єдиний вхід є першим кроком. Облікові записи з увімкненим двоетапним входом і далі підтверджують ключ доступу або код, а налаштування організації Вимагати двоетапний вхід і далі запитує його в учасників.
Коли ввімкнено Довіряти багатофакторному входу постачальника ідентичності, вхід, твердження якого повідомляє про багатофакторну автентифікацію, не потребує другого кроку Holarch і задовольняє вимогу двоетапного входу цієї організації для цього сеансу (але не інших організацій). Holarch приймає як багатофакторні такі контексти автентифікації:
| Контекст автентифікації | Надсилає |
|---|---|
https://refeds.org/profile/mfa | Багато постачальників, якщо їх так налаштовано |
http://schemas.microsoft.com/claims/multipleauthn | Microsoft 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 постачальника ідентичності (постійний, електронна адреса, повне ім’я в домені Windows або інший формат). Без 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> | Деактивувати користувача й забути зовнішній ідентифікатор |
/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
- Applications → Create App Integration → SAML 2.0.
- Single sign-on URL: ACS URL. Залиште позначеним Use this for Recipient URL and Destination URL. Audience URI (SP Entity ID): ідентифікатор сутності.
- Name ID format:
EmailAddressабоPersistent. Application username: Email. - Attribute statements:
email→user.email,displayName→user.displayName. Group attribute statements (необов’язково):groups, фільтр за потреби. - Завершіть, потім скопіюйте Metadata URL із вкладки Sign On у Holarch і виберіть Прочитати метадані.
- Для 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
- Enterprise applications → New application → Create your own application (не з галереї), потім Single sign-on → SAML.
- Identifier (Entity ID): ідентифікатор сутності. Reply URL (Assertion Consumer Service URL): ACS URL.
- Attributes & Claims: типове твердження
emailaddressпрацює; додайте твердження груп, якщо зіставляєте групи. - У розділі SAML Certificates скопіюйте App Federation Metadata Url у Holarch і виберіть Прочитати метадані.
- Щоб довіряти багатофакторному входу Entra, вимагайте MFA в політиці Conditional Access для застосунку; тоді Entra надсилає
multipleauthn. - Для 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:
- 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.
- Access control policy: Permit everyone або Permit everyone and require MFA (див. крок 6).
- Відкрийте для довіри Edit Claim Issuance Policy → Add Rule → Send LDAP Attributes as Claims, сховище атрибутів Active Directory:
| Атрибут LDAP | Тип вихідного твердження |
|---|---|
| E-Mail-Addresses | E-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. На сервері з під’єднаним корпоративним каталогом Адміністрування → Корпоративний каталог → Перевірити користувача показує обидва значення для кожної групи людини.
- Необов’язково, стабільний NameID: Add Rule → Transform an Incoming Claim, вхідне E-Mail Address (або UPN), вихідне Name ID, формат Email (або Persistent Identifier). Без нього Holarch визначає обліковий запис за адресою електронної пошти.
- У Properties → Advanced довіри залиште SHA-256. Залиште вкладку Encryption порожньою: Holarch не розшифровує твердження, а з’єднання працює через https. AD FS типово підписує твердження (
SamlResponseSignatureAssertionOnly), чого й вимагає Holarch. - Скопіюйте
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
- Admin console → Apps → Web and mobile apps → Add app → Add custom SAML app.
- Скопіюйте IdP metadata (завантажте її, потім вставте XML у Holarch).
- ACS URL: ACS URL. Entity ID: ідентифікатор сутності. Name ID format:
EMAIL, Name ID: Basic Information › Primary email. - Attribute mapping: Primary email →
email; First name →givenName; Last name →sn. Group membership →groups(необов’язково). - Увімкніть застосунок ON for everyone (або для організаційного підрозділу).
- Google Workspace не надсилає контекст автентифікації MFA; залиште Довіряти багатофакторному входу постачальника ідентичності вимкненим. Підготовка облікових записів SCIM від Google працює лише із застосунками з галереї; натомість створюйте облікові записи через єдиний вхід.
Ping Identity
- PingOne: Applications → Add Application → SAML Application (PingFederate: підключення SP).
- Імпортуйте URL метаданих Holarch або введіть ACS URL і Entity ID.
- Attribute mapping:
saml_subject→ Email Address; додайтеemailіdisplayName. - Скопіюйте URL метаданих IdP у Holarch і виберіть Прочитати метадані.
- Для 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).
- Створіть у каталозі службовий обліковий запис лише для читання (наприклад,
svc-holarch). Укажіть його ім’я в Обліковий запис прив’язки, а пароль — у файлі.envсервера якHOLARCH_LDAP_BIND_PASSWORD, а потім перезапустіть сервер. Пароль ніколи не показується в “Адмініструванні”. - У полі Сервери каталогу введіть кожен контролер домену або сервер LDAP як
ldaps://dc1.corp.example.com(порт 636), по одному в рядку; їх пробують по черзі.ldap://host:389працює лише з увімкненим Використовувати StartTLS для адрес ldap://. Простий LDAP відхиляється, тому пароль ніколи не передається мережею незашифрованим. Використовуйте ім’я хоста кожного сервера так, як воно вказане в його сертифікаті. - Помістіть сертифікат CA, що видав сертифікати серверів, у Сертифікат CA (PEM) або в
tls/ldap-ca.pemна сервері. Порожнє значення означає довірені CA системи. - Введіть Базовий DN (
DC=corp,DC=example,DC=comабоdc=example,dc=comв іншому каталозі LDAP) і Дозволені домени пошти. - Виберіть Перевірити з’єднання. Перевірка під’єднується зі значеннями у формі, не зберігаючи їх, і називає проблему, коли щось не вдається (жоден сервер не відповів, сертифікат, обліковий запис прив’язки, базовий DN).
- У Перевірити користувача введіть ім’я користувача, щоб побачити, що знайде вхід: адресу електронної пошти, чи активний обліковий запис, його групи й організації, до яких він приєднається. Пароль необов’язковий; його перевіряють один раз і ніколи не зберігають.
- Увімкніть Дозволити вхід з корпоративними обліковими записами і виберіть Зберегти. Після цього екран входу показує Увійти з корпоративним обліковим записом (або ваш Текст кнопки).
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. Адміністратори сайту зберігають свій пароль, тож збій каталогу ніколи не заблокує всіх.
- Неправильні паролі призупиняють вхід для цього корпоративного облікового запису на 15 хвилин після Невдалих спроб до паузи (типово 3), незалежно від того, яку форму імені введено (
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 зберігаються лише як хеш.