Holarch

Administracja

Logowanie jednokrotne i SCIM

Połącz dostawcę tożsamości SAML 2.0 organizacji (Okta, Microsoft Entra ID, Microsoft AD FS, Google Workspace, Ping) lub bezpośrednio Active Directory serwera samodzielnie hostowanego, zweryfikuj domeny e-mail, wymagaj logowania jednokrotnego, mapuj grupy na role i udostępniaj konta przez SCIM 2.0.

Jak z niego korzystać →

Na tej stronie
  1. Pojęcia
  2. Jak z niego korzystać
    1. Weryfikacja domeny e-mail
    2. Połączenie dostawcy tożsamości
    3. Włączenie logowania jednokrotnego
    4. Wymaganie logowania jednokrotnego
    5. Aprowizacja kont przez SCIM
    6. Gdy zmienia się certyfikat dostawcy tożsamości
    7. Logowanie firmowe dla kilku organizacji (wersja samodzielnie hostowana)
    8. Dostęp do projektów działu (wersja samodzielnie hostowana)
  3. Zasady logowania
    1. Logowanie dwuetapowe
  4. Atrybuty
    1. Grupy na role
  5. SCIM
    1. Grupy SCIM i działy (wersja samodzielnie hostowana)
  6. Konfiguracja dostawcy tożsamości
    1. Okta
    2. Microsoft Entra ID
    3. Microsoft AD FS
    4. Google Workspace
    5. Ping Identity
  7. Katalog firmowy (Active Directory / LDAP)
    1. Konfiguracja katalogu firmowego
    2. Działy z grup katalogu
    3. Kto może się logować
    4. Okresowe sprawdzanie
    5. Logowanie dwuetapowe z katalogiem firmowym
  8. Limity i uwagi dotyczące bezpieczeństwa

Organizacja może pozwolić swoim członkom logować się do Holarch kontem służbowym. Holarch jest dostawcą usługi; dostawca tożsamości Twojej organizacji (Okta, Microsoft Entra ID, Microsoft AD FS, Google Workspace, Ping Identity lub dowolny dostawca SAML 2.0) sprawdza, kim są. Dostawca tożsamości może też tworzyć, aktualizować i dezaktywować konta Holarch przez SCIM 2.0.

Logowanie jednokrotne konfiguruje administrator organizacji w Ustawienia organizacji → organizacja → Dostęp i logowanie → Logowanie jednokrotne. Działa w usłudze hostowanej i na serwerach samodzielnie hostowanych, ale nie w aplikacji desktopowej. Serwer samodzielnie hostowany potrzebuje dostępu wychodzącego, aby zweryfikować domenę (zapytanie DNS) i odczytać metadane z adresu URL. Serwer samodzielnie hostowany może też sam sprawdzać konta firmowe w Active Directory lub innym katalogu LDAP, bez dostawcy tożsamości: zobacz Katalog firmowy (Active Directory / LDAP).

Uwaga: logowanie jednokrotne i aprowizacja SCIM są częścią planu Team (organizacji). Organizacje, które korzystały z nich przed wersją 2.29.0, zachowują je. Bez planu ustawienia są zachowywane, ale członkowie logują się hasłem (Nie pamiętasz hasła? pozwala je ustawić), przez Google lub Microsoft, a zapytania SCIM są odrzucane.

Pojęcia

TerminZnaczenie
Zweryfikowana domenaDomena e-mail (np. example.com), nad którą organizacja udowodniła kontrolę rekordem DNS TXT. Logowanie jednokrotne i SCIM działają tylko dla adresów w zweryfikowanych domenach. Domenę może zweryfikować jedna organizacja.
Dostawca tożsamości (IdP)Usługa, która loguje Twoich członków: jej identyfikator encji (wystawca), adres URL logowania i certyfikat podpisujący.
Dostawca usługi (SP)Holarch dla tej organizacji. Każda organizacja ma własny identyfikator encji, ACS URL i URL metadanych.
Członkowie zarządzaniCzłonkowie organizacji, których adres e-mail należy do zweryfikowanej domeny i którzy nie są administratorami organizacji. Dotyczy ich Wymagaj logowania jednokrotnego.
Token SCIMSekret, którego dostawca tożsamości używa do wywoływania API SCIM Holarch dla tej organizacji. Nie jest powiązany z osobą.

Jak z niego korzystać

Weryfikacja domeny e-mail

  1. Otwórz Ustawienia organizacji, wybierz organizację, otwórz Dostęp i logowanie i znajdź Logowanie jednokrotne.
  2. W sekcji Domeny e-mail wpisz domenę adresów członków i wybierz Dodaj domenę.
  3. Opublikuj pokazany rekord TXT: nazwa _holarch-challenge.<domain> z wartością holarch-domain-verification=….
  4. Wybierz Sprawdź. Zmiany DNS mogą docierać przez kilka minut; sprawdzaj ponownie, aż domena pokaże Zweryfikowana.

Dodaj każdą domenę używaną przez członków (np. example.com i eng.example.com). Do 20 domen na organizację.

Połączenie dostawcy tożsamości

  1. U swojego dostawcy tożsamości utwórz aplikację SAML 2.0 (zob. sekcje dostawców poniżej) z wartościami z sekcji Dostawca tożsamości w Holarch:
    • Entity ID (odbiorca): https://app.holarch.app/api/auth/saml/<organization id>/metadata
    • ACS URL (adres URL odpowiedzi): https://app.holarch.app/api/auth/saml/<organization id>/acs
    • URL metadanych: taki sam jak identyfikator encji; dostawcy, którzy importują metadane SP, mogą go użyć.
  2. Skopiuj XML metadanych dostawcy lub jego URL metadanych do pola u góry i wybierz Odczytaj metadane. Holarch wypełnia identyfikator encji, adres URL logowania i certyfikat. Możesz też wpisać je samodzielnie.
  3. W sekcji Atrybuty i role ustaw nazwy atrybutów, jeśli dostawca używa nietypowych (zob. Atrybuty), Rolę nowych członków i opcjonalnie Grupy na role.
  4. Wybierz Zapisz dostawcę tożsamości i wpisz hasło.

Włączenie logowania jednokrotnego

  1. Zaznacz Logowanie jednokrotne dla tej organizacji. Wymaga to zapisanego dostawcy tożsamości i zweryfikowanej domeny.
  2. Przekaż członkom Łącze logowania dla członków lub poleć im wybrać Zaloguj się przez logowanie jednokrotne na ekranie logowania i wpisać służbowy adres e-mail.
  3. Najpierw wypróbuj to z jednym członkiem.

Przy pierwszym logowaniu członka Holarch tworzy konto (potwierdzone, bez hasła) i dodaje je do organizacji, także wtedy, gdy rejestracja wymaga zaproszenia. Gdy istnieje konto z tym adresem, logowanie jednokrotne zostaje z nim powiązane, a jego właściciel otrzymuje e-mail.

Wymaganie logowania jednokrotnego

Zaznacz Wymagaj logowania jednokrotnego dla członków w zweryfikowanych domenach, gdy logowanie jednokrotne działa.

  • Członkowie zarządzani logują się wtedy tylko przez dostawcę tożsamości. Logowanie hasłem, kluczem dostępu, przez Google i Microsoft odpowiada, że organizacja wymaga logowania jednokrotnego, z przyciskiem, który do niego prowadzi. Ich bieżące sesje z innych metod logowania kończą się natychmiast.
  • Administratorzy organizacji nie podlegają wymogowi: zachowują hasło lub klucz dostępu z logowaniem dwuetapowym, aby móc naprawić uszkodzoną konfigurację dostawcy tożsamości (dostęp awaryjny). Utrzymuj co najmniej dwóch administratorów organizacji.
  • Nie dotyczy to członków, których adres znajduje się poza zweryfikowanymi domenami (współpracowników zewnętrznych).
  • Resetowanie hasła nadal ustawia nowe hasło, ale nie loguje członka; loguje się on następnie przez dostawcę tożsamości.
  • Tokeny API i połączone aplikacje członków zarządzanych nadal działają. Aby je zakończyć, dezaktywuj konto przez SCIM.

Aprowizacja kont przez SCIM

  1. W sekcji Aprowizacja (SCIM 2.0) wybierz Utwórz token SCIM i wpisz hasło.
  2. Skopiuj token i Base URL (https://app.holarch.app/scim/v2) do ustawień aprowizacji dostawcy tożsamości. Holarch pokazuje token tylko raz.
  3. Włącz u dostawcy tworzenie, aktualizowanie i dezaktywowanie użytkowników.

Do 5 tokenów na organizację. Odwołaj natychmiast kończy ważność tokenu.

Gdy zmienia się certyfikat dostawcy tożsamości

  1. Wklej nowy certyfikat pod starym (dozwolone są dwa certyfikaty) i zapisz.
  2. Przełącz dostawcę na nowy certyfikat.
  3. Usuń stary certyfikat i zapisz ponownie.

Lista certyfikatów pokazuje podmiot, datę wygaśnięcia i odcisk każdego certyfikatu.

Logowanie firmowe dla kilku organizacji (wersja samodzielnie hostowana)

Domena e-mail należy do jednej organizacji. Gdy firma prowadzi na serwerze samodzielnie hostowanym jedną organizację na dział, jedna organizacja (zwykle działu IT) weryfikuje domenę firmy, łączy dostawcę tożsamości i włącza logowanie jednokrotne. Pozostałe organizacje mapują następnie grupy dostawcy tożsamości na własne role:

  1. W Ustawienia organizacji → Dostęp i logowanie → Logowanie jednokrotne działu znajdź Logowanie firmowe. Podaje ono organizację, która prowadzi logowanie firmowe.
  2. W polu Grupy i role wpisz jedno mapowanie w wierszu, np. packs-engineers = member i packs-leads = admin, i wybierz Zapisz grupy.
  3. Opcjonalnie: po przecinku dodaj dostęp grupy do projektów działu, np. packs-contractors = member, viewer. Zobacz Dostęp do projektów działu.

Przy każdym logowaniu przez logowanie firmowe osoba z mapowanej grupy dołącza do tej organizacji z tą rolą lub zostaje w niej administratorem organizacji. Logowanie nigdy nikogo nie usuwa ani nie obniża (grupy SCIM mogą: zobacz Grupy SCIM i działy); administratorzy organizacji usuwają osoby w Ustawieniach organizacji. Dostawca tożsamości musi wysyłać grupy (Atrybut grup logowania firmowego).

Administratorzy organizacji, która prowadzi logowanie firmowe, kontrolują logowanie każdego adresu w domenie. Ogranicz tę organizację do osób, które obsługują dostawcę tożsamości.

Dostęp do projektów działu (wersja samodzielnie hostowana)

Każde mapowanie grupy może też określać, co jej osoby otrzymują w projektach udostępnionych całej organizacji (Udostępnij → Organizacje): viewer, reviewer lub editor (domyślnie). Rola osoby w takim projekcie jest niższą z roli udostępnienia i najwyższego dostępu spośród jej mapowanych grup w tej organizacji. Na przykład przy projekcie udostępnionym z rolą Edytor i mapowaniu packs-contractors = member, viewer podwykonawca go przegląda; ktoś w obu grupach packs-contractors i packs-engineers = member go edytuje. Zasada obowiązuje bez względu na źródło grup: firmowe logowanie jednokrotne, grupy SCIM i katalog firmowy. Projekty udostępnione osobie bezpośrednio nie są objęte tą zasadą, a członek dodany ręcznie (spoza mapowanych grup) otrzymuje rolę udostępnienia. Zmiana dostępu grupy od razu dotyczy wszystkich osób, które ta grupa umieściła.

Miejsca edytorów. Licencja ogranicza liczbę edytorów; czytelnicy i recenzenci są bezpłatni. Gdy dostęp Edytor z grupy uczyniłby kogoś edytorem, a nie ma wolnego miejsca, osoba otrzymuje rolę Czytelnik, a logowanie nadal działa. Ustawienia organizacji i Administracja → Katalog firmowy pokazują, ile osób jest wstrzymanych na roli Czytelnik; strona Katalog firmowy wymienia każdego edytora, którego miejsce pochodzi z grupy, i każdą wstrzymaną osobę. Gdy zwolnią się miejsca, wstrzymane osoby otrzymują rolę Edytor przy następnym sprawdzeniu, według najwcześniejszego członkostwa.

Serwery w sieci zamkniętej. Gdy serwer nie może sprawdzać publicznego DNS, administrator witryny może wybrać Oznacz jako zweryfikowaną obok niezweryfikowanej domeny zamiast publikować rekord TXT. Domena nadal należy tylko do jednej organizacji, a zmiana jest rejestrowana w dzienniku audytu.

Zasady logowania

Holarch rygorystycznie sprawdza każdą odpowiedź dostawcy tożsamości. Logowanie jest odrzucane, gdy:

  • asercja nie jest podpisana skonfigurowanym certyfikatem lub jest podpisana algorytmem SHA-1;
  • wystawca, odbiorca (identyfikator encji organizacji), miejsce docelowe lub adresat (ACS URL) nie pasują;
  • asercja nie jest jeszcze ważna lub wygasła (dozwolona jest różnica zegarów 2 minut);
  • odpowiada na logowanie, które nie zostało rozpoczęte w tej samej przeglądarce, lub na logowanie już wykorzystane (każde logowanie rozpoczyna się raz i wygasa po 10 minutach);
  • ta sama asercja nadchodzi po raz drugi (powtórzenie);
  • brakuje adresu e-mail lub znajduje się on poza zweryfikowanymi domenami organizacji;
  • konto jest wyłączone.

Ekran logowania informuje wtedy, co poszło nie tak, a dziennik audytu organizacji rejestruje to jako auth.sso-failed.

Logowanie z portalu dostawcy tożsamości (inicjowane przez IdP, gdy członkowie zaczynają od panelu aplikacji dostawcy) jest domyślnie wyłączone, ponieważ taka odpowiedź nie jest powiązana z logowaniem rozpoczętym przez przeglądarkę. Włącz Zezwól na logowanie z portalu dostawcy tożsamości tylko wtedy, gdy członkowie tego potrzebują. Ochrona przed powtórzeniem i wszystkie pozostałe kontrole nadal obowiązują.

Logowanie dwuetapowe

Domyślnie logowanie jednokrotne jest pierwszym krokiem. Konta z włączonym logowaniem dwuetapowym nadal potwierdzają klucz dostępu lub kod, a ustawienie organizacji Wymagaj logowania dwuetapowego nadal o nie prosi członków.

Gdy włączona jest opcja Ufaj wieloskładnikowemu logowaniu dostawcy tożsamości, logowanie, którego asercja zgłasza uwierzytelnianie wieloskładnikowe, nie wymaga drugiego kroku w Holarch i spełnia wymóg logowania dwuetapowego tej organizacji dla danej sesji (ale nie innych organizacji). Holarch uznaje te konteksty uwierzytelniania za wieloskładnikowe:

Kontekst uwierzytelnianiaWysyłany przez
https://refeds.org/profile/mfaWielu dostawców po odpowiedniej konfiguracji
http://schemas.microsoft.com/claims/multipleauthnMicrosoft Entra ID
urn:oasis:names:tc:SAML:2.0:ac:classes:MobileTwoFactorContract (i …MobileTwoFactorUnregistered)Okta i inni
urn:oasis:names:tc:SAML:2.0:ac:classes:TimeSyncTokenKod jednorazowy
urn:oasis:names:tc:SAML:2.0:ac:classes:Smartcard i …SmartcardPKIKarty inteligentne

Liczy się także oświadczenie Entra ID http://schemas.microsoft.com/claims/authnmethodsreferences z wartością multipleauthn. Logowanie u dostawcy tożsamości samym hasłem nie jest wieloskładnikowe, nawet przy włączonym zaufaniu.

Atrybuty

HolarchDomyślne nazwy atrybutów (używana jest pierwsza obecna)
E-mail (wymagany)email, mail, emailaddress, http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress, urn:oid:0.9.2342.19200300.100.1.3, NameID, gdy jest adresem e-mail, a w przeciwnym razie oświadczenie UPN (http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn)
Imię i nazwiskodisplayName, name, http://schemas.microsoft.com/identity/claims/displayname, oświadczenie WS-Federation name albo imię i nazwisko (givenName/firstName, sn/surname/lastName i ich formy oświadczeń)
GrupyAtrybut wskazany w polu Atrybut grup, np. groups. Gdy żaden nie jest wskazany: groups, memberOf, Role, http://schemas.xmlsoap.org/claims/Group z AD FS, http://schemas.microsoft.com/ws/2008/06/identity/claims/role, …/claims/groupsid i …/claims/groups

Konto jest odnajdywane na podstawie NameID dostawcy tożsamości (w formacie trwałym, e-mail, nazwy kwalifikowanej domeną Windows lub innym). Bez NameID (AD FS go nie wysyła, chyba że wystawia go reguła oświadczeń) konto identyfikuje adres e-mail. Gdy NameID się zmienia, ale adres e-mail pozostaje, konto jest ponownie powiązywane.

Nazwy grup są porównywane bez względu na wielkość liter. Nazwa kwalifikowana domeną, np. CORP\Packs Engineers, pasuje także do mapowania Packs Engineers, a SID grupy (S-1-5-21-…) pasuje do mapowania zapisanego z tym SID.

Grupy na role

Wpisz jedno mapowanie w wierszu: holarch-admins = admin lub engineering = member. Przy każdym logowaniu członek grupy zmapowanej na admin staje się administratorem organizacji; w przeciwnym razie członek zmapowanej grupy staje się członkiem. Członkowie spoza zmapowanych grup zachowują swoją rolę. Ostatni administrator organizacji nigdy nie jest degradowany.

SCIM

API SCIM jest zgodne z RFC 7643 i RFC 7644 pod adresem https://app.holarch.app/scim/v2 z nagłówkiem Authorization: Bearer hsc_….

Punkt końcowyCo robi
GET /ServiceProviderConfig, /ResourceTypes, /SchemasOpis usługi
GET /UsersLista użytkowników aprowizowanych w organizacji i członków w jej zweryfikowanych domenach; filter z eq na userName, externalId, id, emails.value lub emails[type eq "work"].value; startIndex i count
POST /UsersUtworzenie użytkownika (lub powiązanie istniejącego konta z tym adresem) i dodanie go do organizacji
GET, PUT, PATCH /Users/<id>Odczyt, zastąpienie lub zmiana użytkownika: userName, name, displayName, emails, externalId, active
DELETE /Users/<id>Dezaktywacja użytkownika i usunięcie identyfikatora zewnętrznego
/GroupsSerwery samodzielnie hostowane: wyświetlanie, tworzenie, odczyt, zastępowanie, zmiana (PATCH dla members, displayName, externalId, w formatach Okta i Microsoft Entra ID) i usuwanie grup; filter z eq dla displayName, externalId lub id; excludedAttributes=members. Zobacz Grupy SCIM i działy. Usługa hostowana: pusta lista, zmiany odrzucane; zamiast tego mapuj grupy na role w ustawieniach logowania jednokrotnego.
  • Tworzyć lub zmieniać można tylko adresy w zweryfikowanych domenach organizacji.
  • Dezaktywacja (active: false lub DELETE) usuwa osobę z organizacji, wyłącza konto, kończy wszystkie jego sesje oraz unieważnia jego tokeny API i połączone aplikacje. Ponowna aktywacja włącza konto i przywraca jego rolę w organizacji. Konto wyłączone przez Holarch (np. po nadużyciu) pozostaje wyłączone.
  • Atrybuty rozszerzenia Enterprise są akceptowane i ignorowane.
  • Każdy token może wykonać 600 zapytań na minutę. Każda zmiana jest rejestrowana w dzienniku audytu organizacji (scim.create, scim.deactivate itd.).

Grupy SCIM i działy (wersja samodzielnie hostowana)

Na serwerze samodzielnie hostowanym dostawca tożsamości może przesyłać swoje grupy do punktu końcowego SCIM organizacji, do której należy domena firmy. Pola Grupy i role działów w sekcji Logowanie firmowe decydują wtedy, kto należy do którego działu i z jaką rolą. Jedno mapowanie obsługuje oba przypadki: logowanie przez firmowe logowanie jednokrotne i grupy SCIM.

  • Osoba dodana do mapowanej grupy dołącza do tej organizacji z mapowaną rolą; zmiana grupy zmienia rolę.
  • Osoba usunięta ze wszystkich mapowanych grup opuszcza organizacje, do których dodały ją grupy.
  • Członkostwa dodane w inny sposób (przez administratora organizacji, zaproszenie, import lub logowanie) nigdy nie są usuwane ani obniżane przez grupy; grupy mogą je jedynie podnieść do administratora organizacji. Gdy administrator organizacji ręcznie zmieni rolę członka, od tej chwili członkostwo należy do niego.
  • Ostatni administrator organizacji nigdy nie jest usuwany ani obniżany.
  • Zmiana pola Grupy i role działu od razu dotyczy wszystkich w grupach.
  • Członkowie grup muszą być użytkownikami, których ten token udostępnia lub którymi zarządza; inne identyfikatory są pomijane.
  • Dezaktywacja użytkownika działa jak dotąd; jego działy podążają za jego grupami.
  • Każda zmiana jest rejestrowana: scim.group-create, scim.group-update i scim.group-delete w dzienniku audytu organizacji firmy, a każda zmiana członkostwa w dzienniku działu.

Konfiguracja dostawcy tożsamości

Okta

  1. Applications → Create App Integration → SAML 2.0.
  2. Single sign-on URL: ACS URL. Pozostaw zaznaczone Use this for Recipient URL and Destination URL. Audience URI (SP Entity ID): identyfikator encji.
  3. Name ID format: EmailAddress lub Persistent. Application username: Email.
  4. Attribute statements: email → user.email, displayName → user.displayName. Group attribute statements (opcjonalnie): groups, z filtrem według potrzeb.
  5. Zakończ, a następnie skopiuj Metadata URL z karty Sign On do Holarch i wybierz Odczytaj metadane.
  6. Dla SCIM: na karcie General aplikacji włącz SCIM provisioning; w Provisioning wartość SCIM connector base URL to Base URL, Unique identifier field to userName, a Authentication Mode to HTTP Header z tokenem SCIM; włącz Create Users, Update User Attributes i Deactivate Users.

Microsoft Entra ID

  1. Enterprise applications → New application → Create your own application (spoza galerii), a następnie Single sign-on → SAML.
  2. Identifier (Entity ID): identyfikator encji. Reply URL (Assertion Consumer Service URL): ACS URL.
  3. Attributes & Claims: domyślne oświadczenie emailaddress działa; dodaj oświadczenie grupy, jeśli mapujesz grupy.
  4. W sekcji SAML Certificates skopiuj App Federation Metadata Url do Holarch i wybierz Odczytaj metadane.
  5. Aby ufać wieloskładnikowemu logowaniu Entra, wymagaj MFA w zasadach dostępu warunkowego (Conditional Access) dla aplikacji; Entra wysyła wtedy multipleauthn.
  6. Dla SCIM: Provisioning → Automatic; Tenant URL to Base URL, a Secret Token to token SCIM. Test Connection, a następnie uruchom aprowizację.

Microsoft AD FS

AD FS (Active Directory Federation Services, Windows Server 2016 lub nowszy) loguje osoby z lokalnego Active Directory. W konsoli AD FS Management:

  1. Relying Party Trusts → Add Relying Party Trust → Claims aware → Import data about the relying party published online i wpisz URL metadanych Holarch. Jeśli serwer AD FS nie może połączyć się z Holarch, zapisz metadane jako plik i wybierz Import data about the relying party from a file. Nazwa wyświetlana: Holarch.
  2. Access control policy: Permit everyone lub Permit everyone and require MFA (zobacz krok 6).
  3. Otwórz w zaufaniu Edit Claim Issuance Policy → Add Rule → Send LDAP Attributes as Claims, magazyn atrybutów Active Directory:
Atrybut LDAPTyp oświadczenia wychodzącego
E-Mail-AddressesE-Mail Address
Display-NameImię i nazwisko
Token-Groups – Unqualified NamesGrupa

Użyj zamiast tego Token-Groups – Qualified by Domain Name, gdy dwie domeny mają grupy o tej samej nazwie; Token-Groups as SIDs (typ oświadczenia Group SID), gdy nazwy grup się zmieniają. Holarch odczytuje oświadczenia Group, Role i Group SID bez ustawiania pola Atrybut grup.

AD FS wysyła nazwę sprzed Windows 2000 każdej grupy (sAMAccountName), a nie jej nazwę wyświetlaną ani cn, i dołącza grupę podstawową (zwykle Domain Users). Mapuj grupy według tej nazwy lub według SID. Na serwerze z połączonym katalogiem firmowym Administracja → Katalog firmowy → Testuj użytkownika pokazuje obie wartości dla każdej grupy osoby.

  1. Opcjonalnie stały NameID: Add Rule → Transform an Incoming Claim, przychodzące E-Mail Address (lub UPN), wychodzące Name ID, format Email (lub Persistent Identifier). Bez tego Holarch identyfikuje konto po adresie e-mail.
  2. W Properties → Advanced zaufania pozostaw SHA-256. Pozostaw pustą kartę Encryption: Holarch nie odszyfrowuje asercji, a połączenie odbywa się przez https. AD FS domyślnie podpisuje asercję (SamlResponseSignature AssertionOnly), czego Holarch wymaga.
  3. Skopiuj https://<your AD FS host>/FederationMetadata/2007-06/FederationMetadata.xml do pola URL metadanych Holarch i wybierz Odczytaj metadane. Wypełnia to identyfikator encji (http://<host>/adfs/services/trust), URL logowania (https://<host>/adfs/ls/) i certyfikat podpisywania tokenów. Aby ufać wieloskładnikowemu logowaniu AD FS, wymagaj MFA w zasadach kontroli dostępu i włącz Ufaj wieloskładnikowemu logowaniu dostawcy tożsamości; AD FS wysyła wtedy http://schemas.microsoft.com/claims/multipleauthn.

Na serwerze samodzielnie hostowanym URL metadanych może być adresem wewnętrznym (https://adfs.corp.example.com/…, prywatny adres IP), a jego certyfikat jest sprawdzany względem firmowego CA w tls/ldap-ca.pem oraz zaufanych CA systemu. Certyfikat podpisywania tokenów AD FS jest co roku wymieniany: Holarch pokazuje datę wygaśnięcia; gdy AD FS doda nowy, ponownie wybierz Odczytaj metadane (w okresie nakładania się oba są zachowywane). AD FS nie obsługuje SCIM; z katalogiem firmowym na serwerze samodzielnie hostowanym Holarch sam sprawdza konta (poniżej).

Google Workspace

  1. Admin console → Apps → Web and mobile apps → Add app → Add custom SAML app.
  2. Skopiuj IdP metadata (pobierz je, a następnie wklej XML do Holarch).
  3. ACS URL: ACS URL. Entity ID: identyfikator encji. 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 (opcjonalnie).
  5. Włącz aplikację: ON for everyone (lub dla jednostki organizacyjnej).
  6. Google Workspace nie wysyła kontekstu uwierzytelniania MFA; pozostaw wyłączoną opcję Ufaj wieloskładnikowemu logowaniu dostawcy tożsamości. Aprowizacja SCIM Google działa tylko z aplikacjami z galerii; zamiast tego twórz konta przez logowanie jednokrotne.

Ping Identity

  1. PingOne: Applications → Add Application → SAML Application (PingFederate: połączenie SP).
  2. Zaimportuj URL metadanych Holarch lub wpisz ACS URL i Entity ID.
  3. Attribute mapping: saml_subject → Email Address; dodaj email i displayName.
  4. Skopiuj URL metadanych IdP do Holarch i wybierz Odczytaj metadane.
  5. Dla SCIM: aprowizacja PingOne z połączeniem SCIM; Base URL i uwierzytelnianie OAuth 2 Bearer Token z tokenem SCIM.

Katalog firmowy (Active Directory / LDAP)

Na serwerze samodzielnie hostowanym osoby mogą logować się firmową nazwą użytkownika i hasłem, sprawdzanymi przez katalog firmy: Active Directory (jego kontrolery domeny) lub inny katalog LDAP, taki jak OpenLDAP lub FreeIPA. Dostawca tożsamości nie jest potrzebny. Konfiguruje to administrator witryny w Administracja → Katalog firmowy; plik .env serwera może podać wartości początkowe (HOLARCH_LDAP_*, SIGN-IN.md w pakiecie wersji samodzielnie hostowanej). Ta funkcja nie jest dostępna w usłudze hostowanej.

Konfiguracja katalogu firmowego

Najpierw wybierz Typ katalogu u góry strony Administracja → Katalog firmowy: Active Directory lub Inny katalog LDAP (OpenLDAP, FreeIPA, …). W obu przypadkach jest to jedno połączenie; typ decyduje o tym, jakie wyszukiwania grup są oferowane, jakie wartości Użyj wartości domyślnych Active Directory lub Użyj wartości domyślnych LDAP wstawiają do formularza, oraz o podpowiedziach i przykładach. Zmiana typu zastępuje filtr użytkowników lub wyszukiwanie grup, które nadal mają wartość domyślną drugiego typu, i zachowuje filtr napisany samodzielnie. Strona ustala typ na podstawie zapisanych ustawień (grupy zagnieżdżone lub filtr Active Directory oznaczają Active Directory).

  1. Utwórz w katalogu konto usługi tylko do odczytu (np. svc-holarch). Wpisz jego nazwę w polu Konto powiązania, a hasło w pliku .env serwera jako HOLARCH_LDAP_BIND_PASSWORD, a następnie uruchom ponownie serwer. Hasło nigdy nie jest pokazywane w Administracji.
  2. W polu Serwery katalogu wpisz każdy kontroler domeny lub serwer LDAP jako ldaps://dc1.corp.example.com (port 636), po jednym w wierszu; są próbowane w kolejności. ldap://host:389 działa tylko z włączoną opcją Używaj StartTLS dla adresów ldap://. Zwykły LDAP jest odrzucany, więc hasło nigdy nie przechodzi przez sieć niezaszyfrowane. Używaj nazwy hosta każdego serwera w postaci podanej w jego certyfikacie.
  3. Wstaw certyfikat CA, który wystawił certyfikaty serwerów, w polu Certyfikat CA (PEM) lub w pliku tls/ldap-ca.pem na serwerze. Puste pole oznacza zaufane CA systemu.
  4. Wpisz Bazowy DN (DC=corp,DC=example,DC=com lub dc=example,dc=com w innym katalogu LDAP) i Dozwolone domeny e-mail.
  5. Wybierz Testuj połączenie. Łączy się z wartościami z formularza, bez zapisywania, i nazywa problem, gdy coś zawiedzie (żaden serwer nie odpowiedział, certyfikat, konto powiązania, bazowy DN).
  6. W sekcji Testuj użytkownika wpisz nazwę użytkownika, aby zobaczyć, co znalazłoby logowanie: adres e-mail, czy konto jest aktywne, jego grupy i organizacje, do których by dołączyło. Hasło jest opcjonalne; jest sprawdzane raz i nigdy nie jest przechowywane.
  7. Włącz Zezwalaj na logowanie kontami firmowymi i wybierz Zapisz. Ekran logowania pokazuje wtedy Zaloguj się kontem firmowym (lub Twój Tekst przycisku).

Active Directory: domyślny Filtr użytkowników znajduje aktywnych użytkowników według sAMAccountName, userPrincipalName lub mail, więc można wpisać jsmith, [email protected] lub CORP\jsmith. Wyłączone konta są pomijane. Wyszukiwanie grup oferuje Active Directory, z grupami zagnieżdżonymi (domyślnie) i Atrybut memberOf (tylko grupy bezpośrednie).

Inny katalog LDAP: Użyj wartości domyślnych LDAP wstawia (&(objectClass=inetOrgPerson)(|(uid={username})(mail={username}))) w polu Filtr użytkowników, więc wpisuje się swój uid lub adres e-mail; każdy filtr działa z {username} w miejscu wpisanej nazwy. Wyszukiwanie grup oferuje Atrybut memberOf (OpenLDAP z nakładką memberof, FreeIPA, 389 Directory Server) i Grupy, które wymieniają osobę jako członka (groupOfNames i groupOfUniqueNames; Bazowy DN grup określa, gdzie się znajdują). Grupy zagnieżdżone się nie liczą.

Działy z grup katalogu

Grupy katalogu umieszczają osoby w organizacjach za pomocą tych samych pól Grupy na role w sekcji Logowanie firmowe co SAML (zobacz Logowanie firmowe dla kilku organizacji): w polu Logowanie jednokrotne każdej organizacji mapuj grupy na role, np. Packs Engineers = member i Packs Leads = admin. Nazwy są porównywane bez względu na wielkość liter; działa też DN grupy, a w Active Directory jej SID. Active Directory, z grupami zagnieżdżonymi liczy osobę jako członka grupy także przez inne grupy w niej zawarte.

Przy każdym logowaniu i każdym okresowym sprawdzeniu osoba z mapowanej grupy dołącza do tej organizacji z tą rolą oraz z dostępem grupy do projektów działu. Członkostwo nadane przez katalog jest usuwane, gdy osoba opuści wszystkie grupy na nie mapowane; członkostwa dodane ręcznie pozostają (katalog może tam podnieść członka do administratora organizacji, ale nigdy go nie obniża). Ostatni administrator organizacji nigdy nie jest usuwany.

Kto może się logować

  • Konto musi być aktywne w katalogu: konta wyłączone, zablokowane i wygasłe są odrzucane, podobnie jak konta, których hasło wygasło lub musi zostać zmienione przy następnym logowaniu.
  • Wpis w katalogu musi mieć adres e-mail w dozwolonej domenie. Pierwsze logowanie tworzy konto Holarch lub łączy istniejące konto o tym adresie. Konto już połączone z innym wpisem katalogu nie zostaje przejęte.
  • Wymagaj logowania firmowego dla połączonych kont uniemożliwia połączonym kontom logowanie hasłem Holarch. Administratorzy witryny zachowują swoje hasło, więc awaria katalogu nigdy nie blokuje wszystkich.
  • Błędne hasła wstrzymują logowanie danego konta firmowego na 15 minut po liczbie prób z pola Nieudane próby przed przerwą (domyślnie 3), niezależnie od wpisanej formy nazwy (jsmith, [email protected], CORP\jsmith). Ustaw tę wartość poniżej progu blokady domeny, aby Holarch nigdy nie blokował konta firmowego. Nieznane nazwy użytkowników i błędne hasła dostają tę samą odpowiedź, w mniej więcej tym samym czasie.

Okresowe sprawdzanie

Co tyle minut, ile podano w polu Sprawdzaj konta co (minuty) (domyślnie 15), serwer sprawdza każde połączone konto, które jest zalogowane lub ma członkostwa z katalogu. Osoba wyłączona, zablokowana, usunięta z katalogu albo z hasłem wygasłym lub wymagającym zmiany przy następnym logowaniu (często po resecie przez administratora z powodu podejrzenia włamania) zostaje wylogowana wszędzie i traci członkostwa nadane przez katalog; zmiany grup aktualizują członkostwa. Zablokowane konto odzyskuje członkostwa przy następnym logowaniu po odblokowaniu. Gdy katalog jest nieosiągalny, nic się nie zmienia. Gdy brakuje większości sprawdzanych kont (np. po błędnym bazowym DN), nic nie zostaje zakończone, a Administracja pokazuje ostrzeżenie. Sprawdź teraz uruchamia sprawdzenie od razu. Administracja pokazuje wynik ostatniego sprawdzenia.

Każde sprawdzenie wyszukuje też członków każdej mapowanej grupy (grupy zagnieżdżone liczą się przy opcji Active Directory, z grupami zagnieżdżonymi) i tworzy konta dla osób, które jeszcze ich nie mają, na tych samych zasadach co logowanie (konto aktywne, dozwolona domena e-mail, bez przejmowania konta połączonego gdzie indziej). Żaden e-mail nie jest wysyłany; osoba loguje się kontem firmowym, gdy po raz pierwszy potrzebuje Holarch, i jest już w swoich działach, więc projekty można jej udostępnić wcześniej. Jedno sprawdzenie tworzy najwyżej 200 kont; Administracja pokazuje, ile kolejnych czeka na następne sprawdzenie. Grupy podane tylko przez SID nie są w ten sposób wyszukiwane; ich osoby są umieszczane przy logowaniu.

Logowanie dwuetapowe z katalogiem firmowym

Logowanie firmowe jest pierwszym krokiem. Organizacje wymagające logowania dwuetapowego nadal proszą o drugi krok Holarch (klucz dostępu lub kod), a konta z włączonym logowaniem dwuetapowym nadal je potwierdzają. Włącz Traktuj logowanie firmowe jako logowanie dwuetapowe tylko wtedy, gdy samo konto firmowe wymaga drugiego składnika; spełnia ono wtedy wymóg logowania dwuetapowego każdej organizacji w tej sesji.

Każde logowanie przez katalog, odmowa i zmiana ustawień jest w dzienniku audytu (admin.directory-save, admin.directory-test, directory.account-ended) i w rekordach logowań każdego konta. Hasła nigdy nie są rejestrowane.

Limity i uwagi dotyczące bezpieczeństwa

Ograniczenie: logowanie jednokrotne używa powiązania HTTP-Redirect do dostawcy tożsamości i HTTP-POST z powrotem do Holarch. Podpisane i szyfrowane żądania uwierzytelnienia, szyfrowane asercje i pojedyncze wylogowanie (single logout) nie są obsługiwane. Grupy SCIM są obsługiwane tylko na serwerach samodzielnie hostowanych (Grupy SCIM i działy). Katalog firmowy loguje nazwą użytkownika i hasłem (proste powiązanie przez TLS); Kerberos i zintegrowane logowanie Windows nie są obsługiwane.

  • Zmiany ustawień wymagają niedawnego potwierdzenia hasła, są wysyłane e-mailem do wszystkich administratorów organizacji i rejestrowane w dzienniku audytu (sso.saml-save, sso.enable, sso.require, sso.domain-verify, scim.token-create…).
  • Adresy URL metadanych muszą używać https w publicznym internecie (na serwerze samodzielnie hostowanym dozwolone są też adresy wewnętrzne); Holarch pobiera je raz, gdy wybierzesz Odczytaj metadane.
  • Tokeny SCIM są przechowywane wyłącznie jako skrót.