Holarch

管理

单点登录和 SCIM

连接组织的 SAML 2.0 身份提供商(Okta、Microsoft Entra ID、Microsoft AD FS、Google Workspace、Ping),或直接连接自托管服务器的 Active Directory,验证其邮箱域名,要求使用单点登录,将组映射到角色,并通过 SCIM 2.0 预配账户。

使用方法 →

本页内容
  1. 概念
  2. 如何使用
    1. 验证电子邮件域名
    2. 连接身份提供商
    3. 开启单点登录
    4. 强制单点登录
    5. 使用 SCIM 预配账户
    6. 当身份提供商的证书更改时
    7. 多个组织共用公司登录(自托管)
    8. 部门项目的访问权限(自托管)
  3. 登录规则
    1. 两步登录
  4. 属性
    1. 组到角色
  5. SCIM
    1. SCIM 组和部门(自托管)
  6. 设置您的身份提供商
    1. Okta
    2. Microsoft Entra ID
    3. Microsoft AD FS
    4. Google Workspace
    5. Ping Identity
  7. 公司目录(Active Directory / LDAP)
    1. 设置公司目录
    2. 按目录组划分部门
    3. 谁可以登录
    4. 定期检查
    5. 使用公司目录时的两步登录
  8. 限制和安全说明

组织可以让其成员使用工作账户登录 Holarch。Holarch 是服务提供商;您组织的身份提供商(Okta、Microsoft Entra ID、Microsoft AD FS、Google Workspace、Ping Identity 或任何 SAML 2.0 提供商)负责核实他们的身份。身份提供商还可以通过 SCIM 2.0 创建、更新和停用 Holarch 账户。

单点登录由组织管理员在组织设置 → 该组织 → 访问和登录 → 单点登录下设置。它适用于托管服务和自托管服务器,不适用于桌面应用。自托管服务器需要出站访问权限才能验证域名(DNS 查询)以及从 URL 读取元数据。自托管服务器还可以不经身份提供商,直接使用 Active Directory 或其他 LDAP 目录检查公司账户:请参阅公司目录(Active Directory / LDAP)。

注意:单点登录和 SCIM 预配是(组织的)Team 方案的一部分。在 2.29.0 版本之前已使用它们的组织会保留它们。没有该方案时,设置会被保留,但成员需使用其密码(忘记密码?可设置密码)、Google 或 Microsoft 登录,并且 SCIM 请求会被拒绝。

概念

词项含义
已验证的域名组织已通过 DNS TXT 记录证明其控制的电子邮件域名(例如 example.com)。单点登录和 SCIM 只适用于已验证域名中的地址。一个域名只能由一个组织验证。
身份提供商(IdP)为您的成员登录的服务:其实体 ID(颁发者)、其登录 URL 及其签名证书。
服务提供商(SP)对于此组织而言即 Holarch。每个组织都有自己的实体 ID、ACS URL 和元数据 URL。
受管成员电子邮件地址位于已验证域名中且不是组织管理员的组织成员。强制单点登录适用于他们。
SCIM 令牌身份提供商用于为此组织调用 Holarch 的 SCIM API 的密钥。它不与任何个人绑定。

如何使用

验证电子邮件域名

  1. 打开组织设置,选择该组织,打开访问和登录,然后找到单点登录。
  2. 在电子邮件域名下,输入您成员地址的域名,然后选择添加域名。
  3. 发布显示的 TXT 记录:名称为 _holarch-challenge.<domain>,值为 holarch-domain-verification=…。
  4. 选择检查。DNS 更改可能需要几分钟才能生效;请再次检查,直到该域名显示为已验证。

添加您的成员使用的每个域名(例如 example.com 和 eng.example.com)。每个组织最多 20 个域名。

连接身份提供商

  1. 在您的身份提供商中,使用 Holarch 中身份提供商下的值创建一个 SAML 2.0 应用程序(请参阅下文的各提供商部分):
    • 实体 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:与实体 ID 相同;可以导入 SP 元数据的提供商可以使用它。
  2. 将提供商的元数据 XML 或其元数据 URL 复制到顶部的框中,然后选择读取元数据。Holarch 会填入实体 ID、登录 URL 和证书。您也可以自己输入。
  3. 在属性和角色下,如果您的提供商使用不常见的属性名称,请设置这些名称(请参阅属性),并设置新成员的角色以及可选的组到角色。
  4. 选择保存身份提供商并输入您的密码。

开启单点登录

  1. 勾选此组织的单点登录。它需要已保存的身份提供商和已验证的域名。
  2. 将成员登录链接提供给成员,或告诉他们在登录屏幕上选择使用单点登录并输入其工作电子邮件地址。
  3. 先用一位成员试用。

成员首次登录时,Holarch 会创建账户(已确认,无密码)并将其添加到组织,即使注册需要邀请时也是如此。如果已存在使用该地址的账户,单点登录会与其关联,账户所有者会收到一封电子邮件。

强制单点登录

在单点登录正常工作后,勾选对已验证域名中的成员强制单点登录。

  • 此后,受管成员只能通过身份提供商登录。使用密码、通行密钥、Google 和 Microsoft 登录时,会提示该组织要求单点登录,并提供一个跳转按钮。他们通过其他登录方式建立的当前会话会立即结束。
  • 组织管理员不受强制:他们保留带两步登录的密码或通行密钥,以便修复损坏的身份提供商设置(紧急访问)。请至少保留两位组织管理员。
  • 地址不在已验证域名中的成员(外部协作者)不受影响。
  • 密码重置仍会设置新密码,但不会让成员登录;他们随后需通过身份提供商登录。
  • 受管成员的 API 令牌和已连接的应用仍可继续使用。要终止它们,请通过 SCIM 停用该账户。

使用 SCIM 预配账户

  1. 在预配(SCIM 2.0)下,选择创建 SCIM 令牌并输入您的密码。
  2. 将令牌和基础 URL(https://app.holarch.app/scim/v2)复制到身份提供商的预配设置中。Holarch 只显示一次令牌。
  3. 在提供商中开启用户的创建、更新和停用。

每个组织最多 5 个令牌。撤销会立即终止令牌。

当身份提供商的证书更改时

  1. 将新证书粘贴到旧证书下方(允许两个证书),然后保存。
  2. 将提供商切换到新证书。
  3. 移除旧证书,然后再次保存。

证书列表显示每个证书的主题、到期日期和指纹。

多个组织共用公司登录(自托管)

一个邮箱域名只属于一个组织。当公司在自托管服务器上为每个部门运行一个组织时,由一个组织(通常是 IT 部门的组织)验证公司域名、连接身份提供商并开启单点登录。其他组织再将身份提供商的组映射到自己的角色:

  1. 在部门的组织设置 → 访问和登录 → 单点登录中,找到公司登录。其中会指明运行公司登录的组织。
  2. 在群组对应角色下,每行写一条映射,例如 packs-engineers = member 和 packs-leads = admin,然后选择保存群组。
  3. 可选:在逗号后添加该组的部门项目访问权限,例如 packs-contractors = member, viewer。请参阅部门项目的访问权限。

每次通过公司登录进行登录时,已映射组中的人员会以相应角色加入该组织,或成为该组织的组织管理员。登录从不会移除任何人或降低其角色(SCIM 组可以:请参阅SCIM 组和部门);组织管理员在组织设置中移除人员。身份提供商必须发送组信息(公司登录的组属性)。

运行公司登录的组织的组织管理员控制该域名所有地址的登录。请只让负责运行身份提供商的人员加入该组织。

部门项目的访问权限(自托管)

每条组映射还可以指定组内人员对与整个组织共享的项目(共享 → 组织)拥有多少权限:viewer、reviewer 或 editor(默认)。一个人在此类项目中的角色,取共享的角色与其在该组织中所属已映射组的最高访问权限中较低的一个。例如,项目以编辑者身份共享,且映射为 packs-contractors = member, viewer 时,承包商只能查看该项目;同时属于 packs-contractors 和 packs-engineers = member 的人则可以编辑它。无论组来自何处,此规则都适用:公司单点登录、SCIM 组和公司目录。直接与个人共享的项目不受影响,手动添加的成员(不属于任何已映射组)获得共享的角色。更改某个组的访问权限会立即对其安置的所有人生效。

编辑者席位。许可证限制编辑者数量;查看者和评审者免费。当组的编辑者访问权限会使某人成为编辑者但没有空闲席位时,此人会改为获得查看者权限,登录仍然有效。组织设置和管理 → 公司目录显示有多少人保持为查看者;“公司目录”页面列出每位席位来自组的编辑者,以及每位保持为查看者的人。席位空出后,保持为查看者的人会在下次检查时获得编辑者权限,按加入时间先后依次进行。

封闭网络中的服务器。当服务器无法查询公共 DNS 时,站点管理员可以在未验证的域名旁选择标记为已验证,而无需发布 TXT 记录。该域名仍只属于一个组织,且此更改会记录在审计日志中。

登录规则

Holarch 会严格检查身份提供商的每个应答。在以下情况下,登录会被拒绝:

  • 断言未使用已配置的证书签名,或使用 SHA-1 签名;
  • 颁发者、受众(组织的实体 ID)、目的地或接收方(ACS URL)不匹配;
  • 断言尚未生效或已过期(允许 2 分钟的时钟偏差);
  • 它应答的登录不是在同一浏览器中发起的,或者是已被使用过的登录(每次登录只能发起一次,并在 10 分钟后过期);
  • 同一断言第二次到达(重放);
  • 电子邮件地址缺失或不在组织的已验证域名中;
  • 账户已被禁用。

此时登录屏幕会说明出了什么问题,组织的审计日志会将其记录为 auth.sso-failed。

从身份提供商门户登录(IdP 发起,即成员从提供商的应用仪表板开始登录)默认处于关闭状态,因为这样的应答与浏览器发起的登录没有关联。只有在您的成员需要时,才开启允许从身份提供商门户登录。重放保护和所有其他检查仍然适用。

两步登录

默认情况下,单点登录是第一步。已开启两步登录的账户仍需确认通行密钥或代码,组织的要求两步登录设置仍会要求成员完成这一步。

开启信任身份提供商的多重身份验证登录后,断言报告了多重身份验证的登录无需 Holarch 的第二步,并且在该会话中满足此组织的两步要求(不满足其他组织的要求)。Holarch 将以下身份验证上下文视为多重身份验证:

身份验证上下文发送方
https://refeds.org/profile/mfa许多已为此进行配置的提供商
http://schemas.microsoft.com/claims/multipleauthnMicrosoft Entra ID
urn:oasis:names:tc:SAML:2.0:ac:classes:MobileTwoFactorContract(以及 …MobileTwoFactorUnregistered)Okta 等
urn:oasis:names:tc:SAML:2.0:ac:classes:TimeSyncToken一次性代码
urn:oasis:names:tc:SAML:2.0:ac:classes:Smartcard 和 …SmartcardPKI智能卡

Entra ID 的 http://schemas.microsoft.com/claims/authnmethodsreferences 声明带有 multipleauthn 时也算数。在身份提供商处仅使用密码的登录不属于多重身份验证,即使开启了信任也是如此。

属性

Holarch默认属性名称(使用找到的第一个)
电子邮件(必需)email、mail、emailaddress、http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress、urn:oid:0.9.2342.19200300.100.1.3、NameID(当它是电子邮件地址时),否则为 UPN 声明(http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn)
姓名displayName、name、http://schemas.microsoft.com/identity/claims/displayname、WS-Federation 的 name 声明,或名字和姓氏(givenName/firstName、sn/surname/lastName 及其声明形式)
组您在组属性中指定的属性,例如 groups。未指定时:groups、memberOf、Role、AD FS 的 http://schemas.xmlsoap.org/claims/Group、http://schemas.microsoft.com/ws/2008/06/identity/claims/role、…/claims/groupsid 和 …/claims/groups

账户通过身份提供商的 NameID 查找(持久格式、电子邮件格式、Windows 域限定名格式或其他格式)。没有 NameID 时(除非声明规则签发 NameID,否则 AD FS 不发送),由电子邮件地址识别账户。当 NameID 更改但电子邮件地址不变时,账户会重新关联。

组名比较时不区分大小写。诸如 CORP\Packs Engineers 的域限定名称也会匹配 Packs Engineers 的映射,组 SID(S-1-5-21-…)会匹配使用该 SID 编写的映射。

组到角色

每行写一个映射:holarch-admins = admin 或 engineering = member。每次登录时,位于映射到 admin 的组中的成员会成为组织管理员;否则,位于已映射组中的成员会成为成员。不在任何已映射组中的成员保留其角色。最后一位组织管理员永远不会被降级。

SCIM

SCIM API 遵循 RFC 7643 和 RFC 7644,地址为 https://app.holarch.app/scim/v2,使用 Authorization: Bearer hsc_…。

端点功能
GET /ServiceProviderConfig, /ResourceTypes, /Schemas描述该服务
GET /Users列出组织已预配的用户及其已验证域名中的成员;filter 可对 userName、externalId、id、emails.value 或 emails[type eq "work"].value 使用 eq;startIndex 和 count
POST /Users创建用户(或关联使用该地址的现有账户)并将其添加到组织
GET, PUT, PATCH /Users/<id>读取、替换或更改用户:userName、name、displayName、emails、externalId、active
DELETE /Users/<id>停用用户并清除外部 ID
/Groups自托管服务器:列出、创建、读取、替换、更改(对 members、displayName、externalId 执行 PATCH,支持 Okta 和 Microsoft Entra ID 的格式)和删除组;对 displayName、externalId 或 id 使用 eq 的 filter;excludedAttributes=members。请参阅SCIM 组和部门。托管服务:返回空列表,拒绝更改;请改为在单点登录下将组映射到角色。
  • 只能创建或更改组织已验证域名中的地址。
  • 停用(active: false 或 DELETE)会将此人从组织中移除、禁用账户、结束其所有会话,并吊销其 API 令牌和已连接的应用。重新激活会启用账户并恢复其组织角色。被 Holarch 禁用的账户(例如因滥用)保持禁用状态。
  • 企业扩展属性会被接受并忽略。
  • 每个令牌每分钟最多可发出 600 个请求。每项更改都会记录在组织的审计日志中(scim.create、scim.deactivate 等)。

SCIM 组和部门(自托管)

在自托管服务器上,身份提供商可以将其组推送到持有公司域名的组织的 SCIM 端点。然后,各部门在公司登录下的群组对应角色决定谁属于哪个部门、担任什么角色。一份映射同时用于两者:通过公司单点登录的登录和 SCIM 组。

  • 被添加到已映射组的人员会以映射的角色加入该组织;所在组发生变化时,角色随之更改。
  • 从所有已映射组中移除的人员,会离开由这些组将其加入的组织。
  • 以其他方式添加的成员身份(由组织管理员、邀请、导入或登录添加)绝不会因组而被移除或降级;组只能将其提升为组织管理员。组织管理员手动更改某成员的角色后,该成员身份此后即由组织管理员管理。
  • 组织的最后一位组织管理员绝不会被移除或降级。
  • 更改部门的群组对应角色会立即对组内的所有人生效。
  • 组成员必须是此令牌预配或管理的用户;其他 ID 会被忽略。
  • 停用用户的方式与以前相同;其所属部门随其所在组而变。
  • 每次更改都会记录:scim.group-create、scim.group-update 和 scim.group-delete 记录在公司组织的审计日志中,每次成员身份更改记录在部门的日志中。

设置您的身份提供商

Okta

  1. Applications → Create App Integration → SAML 2.0。
  2. Single sign-on URL:ACS URL。保持勾选 Use this for Recipient URL and Destination URL。Audience URI (SP Entity ID):实体 ID。
  3. Name ID format:EmailAddress 或 Persistent。Application username:Email。
  4. Attribute statements:email → user.email,displayName → user.displayName。Group attribute statements(可选):groups,按需设置筛选。
  5. 完成后,将 Sign On 标签页中的 Metadata URL 复制到 Holarch,然后选择读取元数据。
  6. 对于 SCIM:在应用的 General 标签页中启用 SCIM provisioning;在 Provisioning 中,SCIM connector base URL 为基础 URL,Unique identifier field 为 userName,Authentication Mode 为带有 SCIM 令牌的 HTTP Header;启用 Create Users、Update User Attributes 和 Deactivate Users。

Microsoft Entra ID

  1. Enterprise applications → New application → Create your own application(非库应用),然后选择 Single sign-on → SAML。
  2. Identifier (Entity ID):实体 ID。Reply URL (Assertion Consumer Service URL):ACS URL。
  3. Attributes & Claims:默认的 emailaddress 声明即可使用;如果要映射组,请添加组声明。
  4. 在 SAML Certificates 下,将 App Federation Metadata Url 复制到 Holarch,然后选择读取元数据。
  5. 要信任 Entra 的多重身份验证登录,请在该应用的条件访问策略中要求 MFA;Entra 随后会发送 multipleauthn。
  6. 对于 SCIM:Provisioning → Automatic;Tenant URL 为基础 URL,Secret Token 为 SCIM 令牌。点击 Test Connection,然后开始预配。

Microsoft AD FS

AD FS(Active Directory 联合身份验证服务,Windows Server 2016 或更高版本)让本地 Active Directory 中的人员登录。在 AD FS Management 控制台中:

  1. Relying Party Trusts → Add Relying Party Trust → Claims aware → Import data about the relying party published online,然后输入 Holarch 的元数据 URL。如果 AD FS 服务器无法访问 Holarch,请将元数据保存为文件,然后选择 Import data about the relying party from a file。显示名称:Holarch。
  2. Access control policy:Permit everyone,或 Permit everyone and require MFA(请参阅第 6 步)。
  3. 打开该信任的 Edit Claim Issuance Policy → Add Rule → Send LDAP Attributes as Claims,属性存储选择 Active Directory:
LDAP 属性传出声明类型
E-Mail-AddressesE-Mail Address
Display-Name姓名
Token-Groups – Unqualified Names组

当两个域有同名组时,请改用 Token-Groups – Qualified by Domain Name;当组名会更改时,请使用 Token-Groups as SIDs(声明类型 Group SID)。无需设置组属性,Holarch 即可读取 Group、Role 和 Group SID 声明。

AD FS 发送每个组的 pre-Windows 2000 name(sAMAccountName),而不是其显示名称或 cn,并且包括主要组(通常为 Domain Users)。请按该名称或按 SID 映射组。在已连接公司目录的服务器上,管理 → 公司目录 → 测试用户会为某人的每个组同时列出这两项。

  1. 可选,稳定的 NameID:Add Rule → Transform an Incoming Claim,传入 E-Mail Address(或 UPN),传出 Name ID,格式 Email(或 Persistent Identifier)。没有它时,Holarch 通过电子邮件地址识别账户。
  2. 在该信任的 Properties → Advanced 中,保持 SHA-256。将 Encryption 标签页留空:Holarch 不解密断言,且连接使用 https。AD FS 默认对断言签名(SamlResponseSignature AssertionOnly),这是 Holarch 所要求的。
  3. 将 https://<your AD FS host>/FederationMetadata/2007-06/FederationMetadata.xml 复制到 Holarch 的元数据 URL中,然后选择读取元数据。这会填入实体 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),其证书会依据 tls/ldap-ca.pem 中的公司 CA 以及系统信任的 CA 进行检查。AD FS 的令牌签名证书每年轮换一次:Holarch 会显示到期日期;当 AD FS 添加新证书时,请再次读取元数据(重叠期间两个证书都会保留)。AD FS 不支持 SCIM;在自托管服务器上使用公司目录时,Holarch 会自行检查账户(见下文)。

Google Workspace

  1. Admin console → Apps → Web and mobile apps → Add app → Add custom SAML app。
  2. 复制 IdP metadata(下载后将 XML 粘贴到 Holarch 中)。
  3. ACS URL:ACS URL。Entity ID:实体 ID。Name ID format:EMAIL,Name ID:Basic Information › Primary email。
  4. Attribute mapping:Primary email → email;First name → givenName;Last name → sn。Group membership → groups(可选)。
  5. 将应用设为 ON for everyone(或对某个组织部门开启)。
  6. Google Workspace 不发送 MFA 身份验证上下文;请保持信任身份提供商的多重身份验证登录为关闭状态。Google 的 SCIM 预配只适用于库中的应用;请改为通过单点登录创建账户。

Ping Identity

  1. PingOne: Applications → Add Application → SAML Application(PingFederate:一个 SP 连接)。
  2. 导入 Holarch 的元数据 URL,或输入 ACS URL 和实体 ID。
  3. Attribute mapping:saml_subject → Email Address;添加 email 和 displayName。
  4. 将 IdP 元数据 URL 复制到 Holarch,然后选择读取元数据。
  5. 对于 SCIM:使用带有 SCIM 连接的 PingOne 预配;使用基础 URL 以及以 SCIM 令牌进行的 OAuth 2 Bearer Token 身份验证。

公司目录(Active Directory / LDAP)

在自托管服务器上,用户可以使用公司用户名和密码登录,由公司的目录进行验证:Active Directory(其域控制器)或其他 LDAP 目录,例如 OpenLDAP 或 FreeIPA。无需身份提供商。站点管理员在管理 → 公司目录中进行设置;服务器的 .env 可以提供初始值(HOLARCH_LDAP_*,见自托管交付包中的 SIGN-IN.md)。托管服务不提供此功能。

设置公司目录

首先在管理 → 公司目录顶部选择目录类型:Active Directory 或其他 LDAP 目录(OpenLDAP、FreeIPA、…)。两种情况都只有一个连接;类型决定提供哪些组查询方式、使用 Active Directory 默认值或使用 LDAP 默认值填入表单的值,以及提示和示例。更改类型会替换仍为另一类型默认值的用户筛选器或组查询方式,并保留您自己编写的筛选器。页面会根据已保存的设置判断类型(嵌套组或 Active Directory 筛选器表示 Active Directory)。

  1. 在目录中创建一个只读服务账户(例如 svc-holarch)。将其名称填入绑定账户,将其密码作为 HOLARCH_LDAP_BIND_PASSWORD 写入服务器的 .env,然后重启服务器。“管理”中从不显示该密码。
  2. 在目录服务器下,以 ldaps://dc1.corp.example.com(端口 636)的形式输入每个域控制器或 LDAP 服务器,每行一个;会按顺序尝试。ldap://host:389 仅在开启使用 StartTLS 时可用。不接受未加密的 LDAP,因此密码绝不会以未加密形式通过网络传输。请使用每台服务器证书中显示的主机名。
  3. 将签发服务器证书的 CA 的证书填入CA 证书(PEM),或放在服务器上的 tls/ldap-ca.pem 中。留空表示使用系统信任的 CA。
  4. 输入基准 DN(DC=corp,DC=example,DC=com,或在其他 LDAP 目录中为 dc=example,dc=com)和允许的邮箱域名。
  5. 选择测试连接。它使用表单中的值进行连接(不保存),失败时会指出问题所在(没有服务器响应、证书、绑定账户、基准 DN)。
  6. 在测试用户下,输入用户名以查看登录时会找到的内容:电子邮件地址、账户是否处于活动状态、其所属组以及将加入的组织。密码可不填;如填写,仅验证一次,且绝不存储。
  7. 开启允许使用公司账户登录,然后选择保存。登录页面随后会显示使用公司账户登录(或您设置的按钮文字)。

Active Directory:默认的用户筛选器通过 sAMAccountName、userPrincipalName 或 mail 查找活跃用户,因此用户可以输入 jsmith、[email protected] 或 CORP\jsmith。已禁用的账户会被排除。组查询方式提供 Active Directory(含嵌套组)(默认)和 memberOf 属性(仅直接组)。

其他 LDAP 目录:使用 LDAP 默认值会将 (&(objectClass=inetOrgPerson)(|(uid={username})(mail={username}))) 填入用户筛选器,因此用户输入自己的 uid 或邮箱地址;任何在输入名称的位置使用 {username} 的筛选器都可以使用。组查询方式提供 memberOf 属性(带 memberof overlay 的 OpenLDAP、FreeIPA、389 Directory Server)和将该用户列为成员的组(groupOfNames 和 groupOfUniqueNames;组基准 DN 指明它们的位置)。嵌套组不计入。

按目录组划分部门

目录组通过与 SAML 相同的、公司登录下的组到角色将人员安置到组织中(请参阅多个组织共用公司登录):在每个组织的单点登录框中,将组映射到角色,例如 Packs Engineers = member 和 Packs Leads = admin。名称比较时不区分大小写;也可以使用组的 DN,在 Active Directory 中还可以使用其 SID。Active Directory(含嵌套组)会将通过组内其他组间接属于某个组的人计入该组。

每次登录和每次定期检查时,已映射组中的人员会以相应角色加入该组织,并获得该组的部门项目访问权限。当此人离开映射到某个成员身份的所有组时,由目录授予的该成员身份会被移除;手动添加的成员身份保持不变(目录可以在该处将成员提升为组织管理员,但绝不会降级)。最后一位组织管理员绝不会被移除。

谁可以登录

  • 账户必须在目录中处于活动状态:已停用、已锁定和已过期的账户会被拒绝,密码已过期或必须在下次登录时更改的账户也会被拒绝。
  • 目录条目必须具有允许域名中的电子邮件地址。首次登录会创建 Holarch 账户,或关联具有该地址的现有账户。已关联到其他目录条目的账户不会被接管。
  • 已关联账户必须使用公司账户登录会阻止已关联账户使用 Holarch 密码登录。站点管理员保留其密码,因此目录故障绝不会将所有人锁定在外。
  • 错误密码次数达到暂停前允许的失败次数(默认 3)后,该公司账户的登录会暂停 15 分钟,无论输入的是哪种形式的名称(jsmith、[email protected]、CORP\jsmith)。请将其设置为低于域的账户锁定阈值,以免 Holarch 锁定公司账户。未知用户名和错误密码得到的响应相同,所用时间也大致相同。

定期检查

服务器每隔检查账户间隔分钟(默认 15)查询每个已登录或持有目录成员身份的已关联账户。已停用、已锁定、已从目录中删除,或密码已过期或必须在下次登录时更改(通常是管理员在怀疑账户遭入侵后进行的重置)的人员,会在所有地方被退出登录,并失去由目录授予的成员身份;组变更会更新成员身份。被锁定的账户在解锁后的下次登录时会恢复其成员身份。无法连接目录时,不做任何更改。当所检查的大部分账户都缺失时(例如基准 DN 错误之后),不会终止任何账户,“管理”中会显示警告。立即检查会立即运行检查。“管理”中会显示上次检查的结果。

每次检查还会查询每个已映射组的成员(使用 Active Directory(含嵌套组)时包括嵌套组),并按与登录相同的规则(处于活动状态、使用允许的邮箱域名、不接管已关联到其他条目的账户)为尚无账户的人员创建账户。不会发送电子邮件;此人在首次需要使用 Holarch 时使用公司账户登录,并且已经在其所属部门中,因此可以在此之前就与其共享项目。一次检查最多创建 200 个账户;“管理”会显示还有多少账户等待下次检查。仅以 SID 命名的组不会以这种方式查询;其中的人员会在登录时被安置。

使用公司目录时的两步登录

公司登录是第一步。要求两步登录的组织仍会要求 Holarch 的第二步(通行密钥或验证码),已开启两步登录的账户仍需确认。仅当公司账户本身需要第二因素时,才开启将公司账户登录视为两步登录;此后,在该会话中它即满足所有组织的两步登录要求。

每次目录登录、拒绝和设置更改都会记录在审计日志中(admin.directory-save、admin.directory-test、directory.account-ended)以及每个账户的登录记录中。密码从不记录。

限制和安全说明

限制:单点登录使用 HTTP-Redirect 绑定发送到身份提供商,并使用 HTTP-POST 返回 Holarch。不支持签名和加密的身份验证请求、加密的断言以及单点注销。SCIM 组仅在自托管服务器上受支持(SCIM 组和部门)。公司目录使用用户名和密码登录(通过 TLS 的简单绑定);不支持 Kerberos 和 Windows 集成登录。

  • 设置更改需要最近进行过的密码检查,会通过电子邮件发送给所有组织管理员,并记录在审计日志中(sso.saml-save、sso.enable、sso.require、sso.domain-verify、scim.token-create…)。
  • 元数据 URL 在公共互联网上必须使用 https(在自托管服务器上也允许内部地址);Holarch 只在您选择读取元数据时获取一次。
  • SCIM 令牌只以哈希形式存储。