Administration
Single Sign-On und SCIM
Verbinden Sie den SAML-2.0-Identitätsanbieter einer Organisation (Okta, Microsoft Entra ID, Microsoft AD FS, Google Workspace, Ping) oder auf einem selbst gehosteten Server direkt das Active Directory, bestätigen Sie ihre E-Mail-Domains, verlangen Sie Single Sign-On, ordnen Sie Gruppen Rollen zu und stellen Sie Konten mit SCIM 2.0 bereit.
Auf dieser Seite
- Konzepte
- So setzen Sie es ein
- Eine E-Mail-Domain bestätigen
- Den Identitätsanbieter verbinden
- Single Sign-On einschalten
- Single Sign-On verlangen
- Konten mit SCIM bereitstellen
- Wenn sich das Zertifikat des Identitätsanbieters ändert
- Unternehmensanmeldung für mehrere Organisationen (selbst gehostet)
- Zugriff auf Abteilungsprojekte (selbst gehostet)
- Anmelderegeln
- Attribute
- SCIM
- Ihren Identitätsanbieter einrichten
- Firmenverzeichnis (Active Directory / LDAP)
- Grenzen und Sicherheitshinweise
Eine Organisation kann ihren Mitgliedern erlauben, sich mit ihrem Arbeitskonto bei Holarch anzumelden. Holarch ist der Dienstanbieter; der Identitätsanbieter Ihrer Organisation (Okta, Microsoft Entra ID, Microsoft AD FS, Google Workspace, Ping Identity oder ein beliebiger SAML-2.0-Anbieter) prüft, wer sie sind. Der Identitätsanbieter kann Holarch-Konten außerdem über SCIM 2.0 erstellen, aktualisieren und deaktivieren.
Single Sign-On richtet ein Organisationsadmin unter Organisationseinstellungen → die Organisation → Zugriff und Anmeldung → Single Sign-On ein. Es funktioniert im gehosteten Dienst und auf selbst gehosteten Servern, nicht in der Desktop-App. Ein selbst gehosteter Server braucht ausgehenden Zugang, um eine Domain zu bestätigen (eine DNS-Abfrage) und Metadaten von einer URL zu lesen. Ein selbst gehosteter Server kann Firmenkonten auch selbst mit Active Directory oder einem anderen LDAP-Verzeichnis prüfen, ohne Identitätsanbieter: siehe Firmenverzeichnis (Active Directory / LDAP).
Hinweis: Single Sign-On und SCIM-Provisionierung gehören zum Tarif Team (dem der Organisation). Organisationen, die sie vor Version 2.29.0 verwendet haben, behalten sie. Ohne den Tarif bleiben die Einstellungen erhalten, aber Mitglieder melden sich mit ihrem Passwort (Passwort vergessen? legt eines fest), Google oder Microsoft an, und SCIM-Anfragen werden abgelehnt.
Konzepte
| Begriff | Bedeutung |
|---|---|
| Bestätigte Domain | Eine E-Mail-Domain (etwa example.com), für die die Organisation mit einem DNS-TXT-Eintrag nachgewiesen hat, dass sie sie kontrolliert. Single Sign-On und SCIM funktionieren nur für Adressen in bestätigten Domains. Eine Domain kann von einer Organisation bestätigt werden. |
| Identitätsanbieter (IdP) | Der Dienst, der Ihre Mitglieder anmeldet: seine Entity-ID (Aussteller), seine Anmelde-URL und sein Signaturzertifikat. |
| Dienstanbieter (SP) | Holarch, für diese Organisation. Jede Organisation hat ihre eigene Entity-ID, ACS-URL und Metadaten-URL. |
| Verwaltete Mitglieder | Mitglieder der Organisation, deren E-Mail-Adresse in einer bestätigten Domain liegt und die keine Organisationsadmins sind. Single Sign-On verlangen gilt für sie. |
| SCIM-Token | Ein Geheimnis, mit dem der Identitätsanbieter die SCIM-API von Holarch für diese Organisation aufruft. Es ist an keine Person gebunden. |
So setzen Sie es ein
Eine E-Mail-Domain bestätigen
- Öffnen Sie die Organisationseinstellungen, wählen Sie die Organisation aus, öffnen Sie Zugriff und Anmeldung und suchen Sie Single Sign-on.
- Geben Sie unter E-Mail-Domains die Domain der Adressen Ihrer Mitglieder ein und wählen Sie Domain hinzufügen.
- Veröffentlichen Sie den angezeigten TXT-Eintrag: den Namen
_holarch-challenge.<domain>mit dem Wertholarch-domain-verification=…. - Wählen Sie Prüfen. DNS-Änderungen können einige Minuten brauchen; prüfen Sie erneut, bis die Domain Verifiziert zeigt.
Fügen Sie jede Domain hinzu, die Ihre Mitglieder verwenden (zum Beispiel example.com und eng.example.com). Bis zu 20 Domains pro Organisation.
Den Identitätsanbieter verbinden
- Erstellen Sie in Ihrem Identitätsanbieter eine SAML-2.0-Anwendung (siehe die Abschnitte zu den Anbietern unten) mit den Werten unter Identitätsanbieter in Holarch:
- Entity-ID (Audience):
https://app.holarch.app/api/auth/saml/<organization id>/metadata - ACS-URL (Antwort-URL):
https://app.holarch.app/api/auth/saml/<organization id>/acs - Metadaten-URL: dieselbe wie die Entity-ID; Anbieter, die SP-Metadaten importieren, können sie verwenden.
- Entity-ID (Audience):
- Kopieren Sie das Metadaten-XML des Anbieters oder seine Metadaten-URL in das Feld oben und wählen Sie Metadaten lesen. Holarch füllt Entity-ID, Anmelde-URL und Zertifikat aus. Oder geben Sie sie selbst ein.
- Legen Sie unter Attribute und Rollen die Attributnamen fest, wenn Ihr Anbieter ungewöhnliche verwendet (siehe Attribute), die Rolle neuer Mitglieder und optional Gruppen zu Rollen.
- Wählen Sie Identitätsanbieter speichern und geben Sie Ihr Passwort ein.
Single Sign-On einschalten
- Haken Sie Single Sign-on für diese Organisation an. Es braucht einen gespeicherten Identitätsanbieter und eine bestätigte Domain.
- Geben Sie Mitgliedern den Anmeldelink für Mitglieder oder sagen Sie ihnen, auf dem Anmeldebildschirm Mit Single Sign-On anmelden zu wählen und ihre Arbeits-E-Mail-Adresse einzugeben.
- Probieren Sie es zuerst mit einem Mitglied aus.
Bei der ersten Anmeldung eines Mitglieds erstellt Holarch das Konto (bestätigt, ohne Passwort) und fügt es der Organisation hinzu, auch wenn die Registrierung eine Einladung erfordert. Existiert bereits ein Konto mit dieser Adresse, wird Single Sign-On damit verknüpft, und sein Inhaber erhält eine E-Mail.
Single Sign-On verlangen
Haken Sie Single Sign-on für Mitglieder in den verifizierten Domains verlangen an, sobald Single Sign-On funktioniert.
- Verwaltete Mitglieder melden sich dann nur noch über den Identitätsanbieter an. Die Anmeldung mit Passwort, Passkey, Google und Microsoft antwortet, dass die Organisation Single Sign-On verlangt, mit einer Schaltfläche, die dorthin führt. Ihre laufenden Sitzungen aus anderen Anmeldemethoden enden sofort.
- Organisationsadmins sind ausgenommen: Sie behalten ihr Passwort oder ihren Passkey mit Zwei-Schritt-Anmeldung, damit sie eine fehlerhafte Einrichtung des Identitätsanbieters beheben können (Notfallzugang). Behalten Sie mindestens zwei Organisationsadmins.
- Mitglieder, deren Adresse außerhalb der bestätigten Domains liegt (externe Mitarbeitende), sind nicht betroffen.
- Ein Zurücksetzen des Passworts setzt weiterhin das neue Passwort, meldet das Mitglied aber nicht an; es meldet sich dann über den Identitätsanbieter an.
- API-Token und verbundene Apps verwalteter Mitglieder funktionieren weiter. Deaktivieren Sie das Konto über SCIM, um sie zu beenden.
Konten mit SCIM bereitstellen
- Wählen Sie unter Provisionierung (SCIM 2.0) SCIM-Token erstellen und geben Sie Ihr Passwort ein.
- Kopieren Sie das Token und die Basis-URL (
https://app.holarch.app/scim/v2) in die Provisionierungseinstellungen Ihres Identitätsanbieters. Holarch zeigt das Token einmal an. - Schalten Sie im Anbieter das Erstellen, Aktualisieren und Deaktivieren von Benutzern ein.
Bis zu 5 Token pro Organisation. Widerrufen beendet ein Token sofort.
Wenn sich das Zertifikat des Identitätsanbieters ändert
- Fügen Sie das neue Zertifikat unter dem alten ein (zwei Zertifikate sind erlaubt) und speichern Sie.
- Stellen Sie den Anbieter auf das neue Zertifikat um.
- Entfernen Sie das alte Zertifikat und speichern Sie erneut.
Die Zertifikatsliste zeigt Subjekt, Ablaufdatum und Fingerabdruck jedes Zertifikats.
Unternehmensanmeldung für mehrere Organisationen (selbst gehostet)
Eine E-Mail-Domain gehört zu einer Organisation. Wenn ein Unternehmen auf einem selbst gehosteten Server eine Organisation je Abteilung betreibt, bestätigt eine Organisation (meist die der IT) die Unternehmensdomain, verbindet den Identitätsanbieter und schaltet Single Sign-On ein. Die anderen Organisationen ordnen dann Gruppen des Identitätsanbieters ihren eigenen Rollen zu:
- Suchen Sie in den Organisationseinstellungen → Zugriff und Anmeldung → Single Sign-On der Abteilung den Bereich Unternehmensanmeldung. Er nennt die Organisation, die die Unternehmensanmeldung betreibt.
- Schreiben Sie unter Gruppen zu Rollen eine Zuordnung pro Zeile, zum Beispiel
packs-engineers = memberundpacks-leads = admin, und wählen Sie Gruppen speichern. - Optional: Fügen Sie nach einem Komma den Zugriff auf Abteilungsprojekte der Gruppe hinzu, zum Beispiel
packs-contractors = member, viewer. Siehe Zugriff auf Abteilungsprojekte.
Bei jeder Anmeldung über die Unternehmensanmeldung tritt eine Person in einer zugeordneten Gruppe dieser Organisation mit dieser Rolle bei oder wird dort Organisationsadmin. Die Anmeldung entfernt oder senkt nie jemanden (SCIM-Gruppen können das: siehe SCIM-Gruppen und Abteilungen); Organisationsadmins entfernen Personen in den Organisationseinstellungen. Der Identitätsanbieter muss die Gruppen senden (Gruppenattribut der Unternehmensanmeldung).
Die Organisationsadmins der Organisation, die die Unternehmensanmeldung betreibt, steuern die Anmeldung für jede Adresse der Domain. Beschränken Sie diese Organisation auf die Personen, die den Identitätsanbieter betreiben.
Zugriff auf Abteilungsprojekte (selbst gehostet)
Jede Gruppenzuordnung kann auch festlegen, wie viel ihre Personen in den Projekten erhalten, die mit der ganzen Organisation geteilt sind (Teilen → Organisationen): viewer, reviewer oder editor (Standard). Die Rolle einer Person in einem solchen Projekt ist die niedrigere aus der Rolle der Freigabe und dem höchsten Zugriff unter ihren dort zugeordneten Gruppen. Ist ein Projekt zum Beispiel als Bearbeiter geteilt und gilt packs-contractors = member, viewer, sieht sich ein Auftragnehmer es nur an; wer sowohl in packs-contractors als auch in packs-engineers = member ist, bearbeitet es. Die Regel gilt unabhängig davon, woher die Gruppen kommen: Single Sign-On des Unternehmens, SCIM-Gruppen und das Firmenverzeichnis. Direkt mit einer Person geteilte Projekte sind nicht betroffen, und ein von Hand hinzugefügtes Mitglied (in keiner zugeordneten Gruppe) erhält die Rolle der Freigabe. Eine Änderung des Zugriffs einer Gruppe gilt sofort für alle, die sie eingeordnet hat.
Bearbeiterplätze. Die Lizenz begrenzt die Bearbeiter; Betrachter und Reviewer sind kostenlos. Wenn der Bearbeiterzugriff einer Gruppe jemanden zum Bearbeiter machen würde und kein Platz frei ist, erhält diese Person stattdessen Betrachter, und die Anmeldung funktioniert weiterhin. Die Organisationseinstellungen und Admin → Firmenverzeichnis zeigen, wie viele Personen als Betrachter zurückgehalten werden; die Seite Firmenverzeichnis listet jeden Bearbeiter, dessen Platz aus einer Gruppe stammt, und jede zurückgehaltene Person auf. Sobald Plätze frei werden, erhalten zurückgehaltene Personen bei der nächsten Prüfung Bearbeiter, die mit der ältesten Mitgliedschaft zuerst.
Server in einem geschlossenen Netzwerk. Wenn der Server kein öffentliches DNS abfragen kann, kann ein Website-Administrator neben einer unbestätigten Domain Als verifiziert markieren wählen, statt den TXT-Eintrag zu veröffentlichen. Die Domain gehört weiterhin nur zu einer Organisation, und die Änderung wird im Audit-Protokoll erfasst.
Anmelderegeln
Holarch prüft jede Antwort des Identitätsanbieters streng. Eine Anmeldung wird abgelehnt, wenn
- die Assertion nicht mit einem konfigurierten Zertifikat oder mit SHA-1 signiert ist;
- Aussteller, Audience (die Entity-ID der Organisation), Destination oder Recipient (die ACS-URL) nicht übereinstimmen;
- die Assertion noch nicht gültig oder abgelaufen ist (2 Minuten Uhrenabweichung sind erlaubt);
- sie auf eine Anmeldung antwortet, die nicht im selben Browser gestartet wurde, oder auf eine bereits verwendete (jede Anmeldung startet einmal und läuft nach 10 Minuten ab);
- dieselbe Assertion ein zweites Mal eintrifft (Replay);
- die E-Mail-Adresse fehlt oder außerhalb der bestätigten Domains der Organisation liegt;
- das Konto deaktiviert ist.
Der Anmeldebildschirm sagt dann, was schiefgegangen ist, und das Audit-Protokoll der Organisation erfasst es als auth.sso-failed.
Anmeldung über das Portal des Identitätsanbieters (IdP-initiiert, wenn Mitglieder im App-Dashboard des Anbieters beginnen) ist standardmäßig aus, weil eine solche Antwort an keine vom Browser gestartete Anmeldung gebunden ist. Schalten Sie Anmeldung über das Portal des Identitätsanbieters erlauben nur ein, wenn Ihre Mitglieder sie brauchen. Replay-Schutz und alle anderen Prüfungen gelten weiterhin.
Zwei-Schritt-Anmeldung
Standardmäßig ist ein Single Sign-On der erste Schritt. Konten mit eingeschalteter Zwei-Schritt-Anmeldung bestätigen weiterhin einen Passkey oder Code, und die Einstellung Zwei-Schritt-Anmeldung verlangen der Organisation fragt Mitglieder weiterhin danach.
Mit eingeschaltetem Der Multi-Faktor-Anmeldung des Identitätsanbieters vertrauen braucht eine Anmeldung, deren Assertion eine Multi-Faktor-Authentifizierung meldet, keinen zweiten Schritt in Holarch und erfüllt die Zwei-Schritt-Anforderung dieser Organisation für diese Sitzung (nicht die anderer Organisationen). Holarch akzeptiert diese Authentifizierungskontexte als Multi-Faktor:
| Authentifizierungskontext | Gesendet von |
|---|---|
https://refeds.org/profile/mfa | Vielen Anbietern, wenn dafür konfiguriert |
http://schemas.microsoft.com/claims/multipleauthn | Microsoft Entra ID |
urn:oasis:names:tc:SAML:2.0:ac:classes:MobileTwoFactorContract (und …MobileTwoFactorUnregistered) | Okta und anderen |
urn:oasis:names:tc:SAML:2.0:ac:classes:TimeSyncToken | Einmalcode |
urn:oasis:names:tc:SAML:2.0:ac:classes:Smartcard und …SmartcardPKI | Smartcards |
Der Claim http://schemas.microsoft.com/claims/authnmethodsreferences von Entra ID mit multipleauthn zählt ebenfalls. Eine Anmeldung nur mit Passwort beim Identitätsanbieter ist kein Multi-Faktor, auch nicht mit eingeschaltetem Vertrauen.
Attribute
| Holarch | Standard-Attributnamen (der erste vorhandene wird verwendet) |
|---|---|
| E-Mail (erforderlich) | email, mail, emailaddress, http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress, urn:oid:0.9.2342.19200300.100.1.3, die NameID, wenn sie eine E-Mail-Adresse ist, oder sonst der UPN-Claim (http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn) |
| Name | displayName, name, http://schemas.microsoft.com/identity/claims/displayname, der WS-Federation-Claim name oder Vor- und Nachname (givenName/firstName, sn/surname/lastName und ihre Claim-Formen) |
| Gruppen | Das Attribut, das Sie unter Gruppenattribut angeben, zum Beispiel groups. Ohne Angabe: groups, memberOf, Role, das http://schemas.xmlsoap.org/claims/Group von AD FS, http://schemas.microsoft.com/ws/2008/06/identity/claims/role, …/claims/groupsid und …/claims/groups |
Das Konto wird über die NameID des Identitätsanbieters gefunden (persistent, E-Mail, domänenqualifizierter Windows-Name oder ein anderes Format). Ohne NameID (AD FS sendet keine, sofern keine Anspruchsregel eine ausstellt) identifiziert die E-Mail-Adresse das Konto. Ändert sich die NameID, die E-Mail-Adresse aber bleibt, wird das Konto neu verknüpft.
Gruppennamen werden ohne Rücksicht auf Groß- und Kleinschreibung verglichen. Ein domänenqualifizierter Name wie CORP\Packs Engineers passt auch zu einer Zuordnung für Packs Engineers, und eine Gruppen-SID (S-1-5-21-…) passt zu einer Zuordnung, die mit dieser SID geschrieben ist.
Gruppen zu Rollen
Schreiben Sie eine Zuordnung pro Zeile: holarch-admins = admin oder engineering = member. Bei jeder Anmeldung wird ein Mitglied in einer Gruppe, die admin zugeordnet ist, Organisationsadmin; sonst wird ein Mitglied in einer zugeordneten Gruppe Mitglied. Mitglieder in keiner zugeordneten Gruppe behalten ihre Rolle. Der letzte Organisationsadmin wird nie herabgestuft.
SCIM
Die SCIM-API folgt RFC 7643 und RFC 7644 unter https://app.holarch.app/scim/v2 mit Authorization: Bearer hsc_….
| Endpunkt | Was sie tut |
|---|---|
GET /ServiceProviderConfig, /ResourceTypes, /Schemas | Den Dienst beschreiben |
GET /Users | Die bereitgestellten Benutzer der Organisation und die Mitglieder in ihren bestätigten Domains auflisten; filter mit eq auf userName, externalId, id, emails.value oder emails[type eq "work"].value; startIndex und count |
POST /Users | Einen Benutzer erstellen (oder ein bestehendes Konto mit dieser Adresse verknüpfen) und ihn der Organisation hinzufügen |
GET, PUT, PATCH /Users/<id> | Einen Benutzer lesen, ersetzen oder ändern: userName, name, displayName, emails, externalId, active |
DELETE /Users/<id> | Den Benutzer deaktivieren und die externe ID verwerfen |
/Groups | Selbst gehostete Server: Gruppen auflisten, erstellen, lesen, ersetzen, ändern (PATCH auf members, displayName, externalId, in den Formen von Okta und Microsoft Entra ID) und löschen; filter mit eq auf displayName, externalId oder id; excludedAttributes=members. Siehe SCIM-Gruppen und Abteilungen. Gehosteter Dienst: eine leere Liste, Änderungen werden abgelehnt; ordnen Sie stattdessen unter Single Sign-On Gruppen Rollen zu. |
- Nur Adressen in den bestätigten Domains der Organisation können erstellt oder geändert werden.
- Deaktivieren (
active: falseoderDELETE) entfernt die Person aus der Organisation, deaktiviert das Konto, beendet alle seine Sitzungen und widerruft seine API-Token und verbundenen Apps. Reaktivieren aktiviert das Konto und stellt seine Organisationsrolle wieder her. Ein Konto, das Holarch deaktiviert hat (zum Beispiel nach Missbrauch), bleibt deaktiviert. - Attribute der Enterprise-Erweiterung werden angenommen und ignoriert.
- Jedes Token darf 600 Anfragen pro Minute stellen. Jede Änderung wird im Audit-Protokoll der Organisation erfasst (scim.create, scim.deactivate und so weiter).
SCIM-Gruppen und Abteilungen (selbst gehostet)
Auf einem selbst gehosteten Server kann der Identitätsanbieter seine Gruppen an den SCIM-Endpunkt der Organisation übertragen, der die Unternehmensdomain gehört. Die Gruppen zu Rollen der Abteilungen unter Unternehmensanmeldung entscheiden dann, wer zu welcher Abteilung gehört, mit welcher Rolle. Eine Zuordnung dient beidem: der Anmeldung über das Single Sign-On des Unternehmens und den SCIM-Gruppen.
- Eine Person, die zu einer zugeordneten Gruppe hinzugefügt wird, tritt dieser Organisation mit der zugeordneten Rolle bei; ein Gruppenwechsel ändert die Rolle.
- Aus jeder zugeordneten Gruppe entfernt, verlässt eine Person die Organisationen, denen die Gruppen sie hinzugefügt haben.
- Auf andere Weise hinzugefügte Mitgliedschaften (durch einen Organisationsadmin, eine Einladung, einen Import oder eine Anmeldung) werden von Gruppen nie entfernt oder gesenkt; Gruppen können sie nur zum Organisationsadmin erhöhen. Wenn ein Organisationsadmin die Rolle eines Mitglieds von Hand ändert, gehört die Mitgliedschaft von da an ihm.
- Der letzte Organisationsadmin einer Organisation wird nie entfernt oder gesenkt.
- Eine Änderung von Gruppen zu Rollen einer Abteilung gilt sofort für alle in den Gruppen.
- Gruppenmitglieder müssen Benutzer sein, die dieses Token bereitstellt oder verwaltet; andere IDs werden ignoriert.
- Das Deaktivieren eines Benutzers funktioniert wie bisher; seine Abteilungen folgen seinen Gruppen.
- Jede Änderung wird erfasst: scim.group-create, scim.group-update und scim.group-delete im Audit-Protokoll der Unternehmensorganisation und jede Änderung einer Mitgliedschaft im Protokoll der Abteilung.
Ihren Identitätsanbieter einrichten
Okta
- Applications → Create App Integration → SAML 2.0.
- Single sign-on URL: die ACS-URL. Lassen Sie Use this for Recipient URL and Destination URL angehakt. Audience URI (SP Entity ID): die Entity-ID.
- Name ID format:
EmailAddressoderPersistent. Application username: Email. - Attribute statements:
email→user.email,displayName→user.displayName. Group attribute statements (optional):groups, nach Bedarf filtern. - Schließen Sie ab und kopieren Sie dann die Metadata URL aus der Registerkarte Sign On in Holarch und wählen Sie Metadaten lesen.
- Für SCIM: Aktivieren Sie in der Registerkarte General der App SCIM provisioning; in Provisioning ist SCIM connector base URL die Basis-URL, Unique identifier field
userName, Authentication Mode HTTP Header mit dem SCIM-Token; aktivieren Sie Create Users, Update User Attributes und Deactivate Users.
Microsoft Entra ID
- Enterprise applications → New application → Create your own application (nicht aus der Galerie), dann Single sign-on → SAML.
- Identifier (Entity ID): die Entity-ID. Reply URL (Assertion Consumer Service URL): die ACS-URL.
- Attributes & Claims: Der Standard-Claim
emailaddressfunktioniert; fügen Sie einen Gruppen-Claim hinzu, wenn Sie Gruppen zuordnen. - Kopieren Sie unter SAML Certificates die App Federation Metadata Url in Holarch und wählen Sie Metadaten lesen.
- Um der Multi-Faktor-Anmeldung von Entra zu vertrauen, verlangen Sie MFA in einer Conditional-Access-Richtlinie für die App; Entra sendet dann
multipleauthn. - Für SCIM: Provisioning → Automatic; Tenant URL ist die Basis-URL und Secret Token das SCIM-Token. Test Connection, dann die Provisionierung starten.
Microsoft AD FS
AD FS (Active Directory Federation Services, Windows Server 2016 oder neuer) meldet Personen aus Ihrem lokalen Active Directory an. In der Konsole AD FS Management:
- Relying Party Trusts → Add Relying Party Trust → Claims aware → Import data about the relying party published online, und geben Sie die Metadaten-URL von Holarch ein. Wenn der AD-FS-Server Holarch nicht erreichen kann, speichern Sie die Metadaten als Datei und wählen Sie Import data about the relying party from a file. Anzeigename: Holarch.
- Access control policy: Permit everyone oder Permit everyone and require MFA (siehe Schritt 6).
- Öffnen Sie bei der Vertrauensstellung Edit Claim Issuance Policy → Add Rule → Send LDAP Attributes as Claims, Attributspeicher Active Directory:
| LDAP-Attribut | Ausgehender Anspruchstyp |
|---|---|
| E-Mail-Addresses | E-Mail Address |
| Display-Name | Name |
| Token-Groups – Unqualified Names | Gruppe |
Verwenden Sie stattdessen Token-Groups – Qualified by Domain Name, wenn zwei Domains Gruppen mit gleichem Namen haben, und Token-Groups as SIDs (Anspruchstyp Group SID), wenn sich Gruppennamen ändern. Holarch liest die Claims Group, Role und Group SID ohne Gruppenattribut.
AD FS sendet den pre-Windows 2000 name jeder Gruppe (sAMAccountName), nicht ihren Anzeigenamen oder cn, und schließt die primäre Gruppe ein (meist Domain Users). Ordnen Sie Gruppen über diesen Namen oder über die SID zu. Auf einem Server mit verbundenem Firmenverzeichnis zeigt Admin → Firmenverzeichnis → Benutzer testen beides für jede Gruppe einer Person an.
- Optional, eine stabile NameID: Add Rule → Transform an Incoming Claim, eingehend E-Mail Address (oder UPN), ausgehend Name ID, Format Email (oder Persistent Identifier). Ohne sie identifiziert Holarch das Konto über seine E-Mail-Adresse.
- Behalten Sie in den Properties → Advanced der Vertrauensstellung SHA-256 bei. Lassen Sie die Registerkarte Encryption leer: Holarch entschlüsselt keine Assertions, und die Verbindung läuft über https. AD FS signiert die Assertion standardmäßig (
SamlResponseSignatureAssertionOnly), was Holarch verlangt. - Kopieren Sie
https://<your AD FS host>/FederationMetadata/2007-06/FederationMetadata.xmlin die Metadaten-URL von Holarch und wählen Sie Metadaten lesen. Das füllt die Entitäts-ID (http://<host>/adfs/services/trust), die Anmelde-URL (https://<host>/adfs/ls/) und das Tokensignaturzertifikat aus. Um der Multi-Faktor-Anmeldung von AD FS zu vertrauen, verlangen Sie MFA in der Zugriffssteuerungsrichtlinie und schalten Sie Der Multi-Faktor-Anmeldung des Identitätsanbieters vertrauen ein; AD FS sendet dannhttp://schemas.microsoft.com/claims/multipleauthn.
Auf einem selbst gehosteten Server darf die Metadaten-URL eine interne Adresse sein (https://adfs.corp.example.com/…, eine private IP), und ihr Zertifikat wird gegen die Unternehmens-CA in tls/ldap-ca.pem sowie die vertrauenswürdigen CAs des Systems geprüft. Das Tokensignaturzertifikat von AD FS wird jedes Jahr erneuert: Holarch zeigt das Ablaufdatum; wählen Sie erneut Metadaten lesen, wenn AD FS das neue hinzufügt (während der Überschneidung bleiben beide erhalten). AD FS hat kein SCIM; mit einem Firmenverzeichnis auf einem selbst gehosteten Server prüft Holarch die Konten selbst (siehe unten).
Google Workspace
- Admin console → Apps → Web and mobile apps → Add app → Add custom SAML app.
- Kopieren Sie die IdP metadata (laden Sie sie herunter und fügen Sie dann das XML in Holarch ein).
- ACS URL: die ACS-URL. Entity ID: die 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(optional). - Schalten Sie die App ON for everyone (oder für eine Organisationseinheit).
- Google Workspace sendet keinen MFA-Authentifizierungskontext; lassen Sie Der Multi-Faktor-Anmeldung des Identitätsanbieters vertrauen ausgeschaltet. Die SCIM-Provisionierung von Google funktioniert nur mit Galerie-Apps; erstellen Sie Konten stattdessen per Single Sign-On.
Ping Identity
- PingOne: Applications → Add Application → SAML Application (PingFederate: eine SP-Verbindung).
- Importieren Sie die Metadaten-URL von Holarch oder geben Sie ACS-URL und Entity-ID ein.
- Attribute mapping:
saml_subject→ Email Address; fügen SieemailunddisplayNamehinzu. - Kopieren Sie die IdP-Metadaten-URL in Holarch und wählen Sie Metadaten lesen.
- Für SCIM: PingOne-Provisionierung mit einer SCIM-Verbindung; die Basis-URL und Authentifizierung per OAuth 2 Bearer Token mit dem SCIM-Token.
Firmenverzeichnis (Active Directory / LDAP)
Auf einem selbst gehosteten Server können sich Personen mit ihrem Firmenbenutzernamen und -passwort anmelden, geprüft vom Verzeichnis des Unternehmens: Active Directory (seinen Domänencontrollern) oder einem anderen LDAP-Verzeichnis wie OpenLDAP oder FreeIPA. Es wird kein Identitätsanbieter benötigt. Ein Website-Administrator richtet es unter Admin → Firmenverzeichnis ein; die .env des Servers kann die Startwerte liefern (HOLARCH_LDAP_*, SIGN-IN.md der selbst gehosteten Auslieferung). Im gehosteten Dienst wird es nicht angeboten.
Das Firmenverzeichnis einrichten
Wählen Sie zuerst oben unter Admin → Firmenverzeichnis den Verzeichnistyp: Active Directory oder Anderes LDAP-Verzeichnis (OpenLDAP, FreeIPA, …). Es ist in beiden Fällen eine Verbindung; der Typ bestimmt, welche Gruppenabfragen angeboten werden, welche Standardwerte Active Directory-Standardwerte verwenden oder LDAP-Standardwerte verwenden in das Formular eintragen, sowie die Hinweise und Beispiele. Ein Wechsel ersetzt einen Benutzerfilter oder eine Gruppenabfrage, die noch auf dem Standardwert des anderen Typs stehen, und behält einen selbst geschriebenen Filter. Die Seite ermittelt den Typ aus den gespeicherten Einstellungen (verschachtelte Gruppen oder ein Active-Directory-Filter bedeuten Active Directory).
- Legen Sie im Verzeichnis ein schreibgeschütztes Dienstkonto an (zum Beispiel
svc-holarch). Tragen Sie seinen Namen unter Bind-Konto ein und sein Passwort in der.envdes Servers alsHOLARCH_LDAP_BIND_PASSWORD, und starten Sie dann den Server neu. Das Passwort wird in Admin nie angezeigt. - Geben Sie unter Verzeichnisserver jeden Domänencontroller oder LDAP-Server als
ldaps://dc1.corp.example.com(Port 636) ein, einen pro Zeile; sie werden der Reihe nach versucht.ldap://host:389funktioniert nur mit eingeschaltetem StartTLS für ldap://-Adressen verwenden. Einfaches LDAP wird abgelehnt, damit ein Passwort nie unverschlüsselt durch das Netzwerk geht. Verwenden Sie den Hostnamen jedes Servers so, wie er in seinem Zertifikat steht. - Legen Sie das Zertifikat der CA, die die Zertifikate der Server ausgestellt hat, unter CA-Zertifikat (PEM) ab oder in
tls/ldap-ca.pemauf dem Server. Leer bedeutet die vertrauenswürdigen CAs des Systems. - Geben Sie den Basis-DN (
DC=corp,DC=example,DC=comoderdc=example,dc=comin einem anderen LDAP-Verzeichnis) und die Zugelassene E-Mail-Domains ein. - Wählen Sie Verbindung testen. Die Verbindung wird mit den Werten im Formular aufgebaut, ohne zu speichern, und benennt das Problem, wenn etwas fehlschlägt (kein Server hat geantwortet, Zertifikat, Bind-Konto, Basis-DN).
- Geben Sie unter Benutzer testen einen Benutzernamen ein, um zu sehen, was die Anmeldung finden würde: die E-Mail-Adresse, ob das Konto aktiv ist, seine Gruppen und die Organisationen, denen es beitreten würde. Das Passwort ist optional; es wird einmal geprüft und nie gespeichert.
- Schalten Sie Anmeldung mit Firmenkonten zulassen ein und wählen Sie Speichern. Der Anmeldebildschirm zeigt dann Mit Firmenkonto anmelden (oder Ihren Schaltflächentext).
Active Directory: Der Standard-Benutzerfilter findet aktive Benutzer über sAMAccountName, userPrincipalName oder mail, sodass Personen jsmith, [email protected] oder CORP\jsmith eingeben können. Deaktivierte Konten werden ausgelassen. Gruppenabfrage bietet Active Directory, mit verschachtelten Gruppen (der Standard) und memberOf-Attribut (nur direkte Gruppen).
Anderes LDAP-Verzeichnis: LDAP-Standardwerte verwenden trägt (&(objectClass=inetOrgPerson)(|(uid={username})(mail={username}))) in Benutzerfilter ein, sodass Personen ihre uid oder E-Mail-Adresse eingeben; jeder Filter funktioniert mit {username} an der Stelle des eingegebenen Namens. Gruppenabfrage bietet memberOf-Attribut (OpenLDAP mit dem memberof-Overlay, FreeIPA, 389 Directory Server) und Gruppen, die die Person als Mitglied aufführen (groupOfNames und groupOfUniqueNames; Basis-DN für Gruppen gibt an, wo sie liegen). Verschachtelte Gruppen zählen nicht.
Abteilungen aus Verzeichnisgruppen
Verzeichnisgruppen ordnen Personen Organisationen über dieselben Gruppen zu Rollen unter Unternehmensanmeldung zu wie SAML (siehe Unternehmensanmeldung für mehrere Organisationen): Ordnen Sie im Feld Single Sign-on jeder Organisation Gruppen Rollen zu, zum Beispiel Packs Engineers = member und Packs Leads = admin. Namen werden ohne Rücksicht auf Groß- und Kleinschreibung verglichen; auch der DN einer Gruppe funktioniert, in Active Directory außerdem ihre SID. Active Directory, mit verschachtelten Gruppen zählt eine Person auch über andere darin enthaltene Gruppen zu einer Gruppe.
Bei jeder Anmeldung und jeder regelmäßigen Prüfung tritt eine Person in einer zugeordneten Gruppe dieser Organisation mit dieser Rolle bei, und mit dem Zugriff auf Abteilungsprojekte der Gruppe. Eine vom Verzeichnis vergebene Mitgliedschaft wird entfernt, wenn die Person jede Gruppe verlässt, die ihr zugeordnet ist; von Hand hinzugefügte Mitgliedschaften bleiben (das Verzeichnis kann ein Mitglied dort zum Organisationsadmin erhöhen, senkt es aber nie). Der letzte Organisationsadmin wird nie entfernt.
Wer sich anmelden kann
- Das Konto muss im Verzeichnis aktiv sein: Deaktivierte, gesperrte und abgelaufene Konten werden abgelehnt, ebenso Konten, deren Passwort abgelaufen ist oder bei der nächsten Anmeldung geändert werden muss.
- Der Verzeichniseintrag muss eine E-Mail-Adresse in einer zugelassenen Domain haben. Die erste Anmeldung erstellt das Holarch-Konto oder verknüpft das bestehende Konto mit dieser Adresse. Ein Konto, das bereits mit einem anderen Verzeichniseintrag verknüpft ist, wird nicht übernommen.
- Firmenanmeldung für verknüpfte Konten verlangen verhindert, dass sich verknüpfte Konten mit einem Holarch-Passwort anmelden. Website-Administratoren behalten ihr Passwort, damit ein Ausfall des Verzeichnisses nie alle aussperrt.
- Falsche Passwörter pausieren die Anmeldung für dieses Firmenkonto für 15 Minuten nach Fehlversuche bis zur Pause (Standard 3), gleich in welcher Form der Name eingegeben wurde (
jsmith,[email protected],CORP\jsmith). Halten Sie den Wert unter dem Sperrschwellenwert der Domain, damit Holarch nie ein Firmenkonto sperrt. Unbekannte Benutzernamen und falsche Passwörter erhalten dieselbe Antwort, in etwa derselben Zeit.
Regelmäßige Prüfung
Alle Konten prüfen alle Minuten (Standard 15) fragt der Server jedes verknüpfte Konto ab, das angemeldet ist oder Verzeichnismitgliedschaften hat. Eine Person, die deaktiviert, gesperrt oder aus dem Verzeichnis entfernt wurde oder deren Passwort abgelaufen ist oder bei der nächsten Anmeldung geändert werden muss (oft ein Zurücksetzen durch einen Administrator nach einer vermuteten Kompromittierung), wird überall abgemeldet und verliert die vom Verzeichnis vergebenen Mitgliedschaften; Gruppenänderungen aktualisieren Mitgliedschaften. Ein gesperrtes Konto erhält seine Mitgliedschaften bei der nächsten Anmeldung nach der Entsperrung zurück. Wenn das Verzeichnis nicht erreichbar ist, ändert sich nichts. Wenn die meisten geprüften Konten fehlen (zum Beispiel nach einem falschen Basis-DN), wird nichts beendet, und Admin zeigt die Warnung. Jetzt prüfen führt die Prüfung sofort aus. Admin zeigt das Ergebnis der letzten Prüfung.
Jede Prüfung fragt außerdem die Mitglieder jeder zugeordneten Gruppe ab (verschachtelte Gruppen zählen mit Active Directory, mit verschachtelten Gruppen) und richtet Konten für Personen ein, die noch keines haben, nach denselben Regeln wie die Anmeldung (aktiv, eine zugelassene E-Mail-Domain, keine Übernahme eines anderswo verknüpften Kontos). Es wird keine E-Mail gesendet; die Person meldet sich mit ihrem Firmenkonto an, wenn sie Holarch zum ersten Mal braucht, und ist bereits in ihren Abteilungen, sodass Projekte schon vorher mit ihr geteilt werden können. Eine Prüfung richtet höchstens 200 Konten ein; Admin zeigt, wie viele weitere auf die nächste Prüfung warten. Nur über ihre SID benannte Gruppen werden so nicht abgefragt; ihre Personen werden bei der Anmeldung eingeordnet.
Zwei-Schritt-Anmeldung mit dem Firmenverzeichnis
Die Unternehmensanmeldung ist der erste Schritt. Organisationen, die Zwei-Schritt-Anmeldung verlangen, fragen weiterhin den zweiten Schritt von Holarch ab (einen Passkey oder Code), und Konten mit eingeschalteter Zwei-Schritt-Anmeldung bestätigen ihn weiterhin. Schalten Sie Firmenanmeldung als Zwei-Schritt-Anmeldung werten nur ein, wenn das Firmenkonto selbst einen zweiten Faktor verlangt; sie erfüllt dann für diese Sitzung die Zwei-Schritt-Vorgabe jeder Organisation.
Jede Verzeichnisanmeldung, Ablehnung und Einstellungsänderung steht im Audit-Protokoll (admin.directory-save, admin.directory-test, directory.account-ended) und in den Anmeldeaufzeichnungen jedes Kontos. Passwörter werden nie erfasst.
Grenzen und Sicherheitshinweise
Grenze: Single Sign-On verwendet die HTTP-Redirect-Bindung zum Identitätsanbieter und HTTP-POST zurück zu Holarch. Signierte und verschlüsselte Authentifizierungsanfragen, verschlüsselte Assertions und Single Logout werden nicht unterstützt. SCIM-Gruppen werden nur auf selbst gehosteten Servern unterstützt (SCIM-Gruppen und Abteilungen). Das Firmenverzeichnis meldet mit Benutzername und Passwort an (Simple Bind über TLS); Kerberos und integrierte Windows-Anmeldung werden nicht unterstützt.
- Änderungen an den Einstellungen erfordern eine aktuelle Passwortprüfung, werden allen Organisationsadmins per E-Mail gemeldet und im Audit-Protokoll erfasst (sso.saml-save, sso.enable, sso.require, sso.domain-verify, scim.token-create…).
- Metadaten-URLs müssen im öffentlichen Internet https verwenden (auf einem selbst gehosteten Server sind auch interne Adressen erlaubt); Holarch ruft sie einmal ab, wenn Sie Metadaten lesen wählen.
- SCIM-Token werden nur als Hash gespeichert.