管理
單一登入與 SCIM
連接組織的 SAML 2.0 身分識別提供者(Okta、Microsoft Entra ID、Microsoft AD FS、Google Workspace、Ping),或直接連接自行託管伺服器的 Active Directory,驗證其電子郵件網域、強制單一登入、將群組對應到角色,並以 SCIM 2.0 佈建帳戶。
本頁內容
組織可以讓其成員以工作帳戶登入 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 的密鑰。它不與任何個人綁定。 |
使用方式
驗證電子郵件網域
- 開啟組織設定,選取組織,開啟存取和登入並找到單一登入。
- 在電子郵件網域下,輸入您成員地址的網域,然後選擇新增網域。
- 發布顯示的 TXT 記錄:名稱
_holarch-challenge.<domain>,值為holarch-domain-verification=…。 - 選擇檢查。DNS 變更可能需要幾分鐘才能生效;請再次檢查,直到網域顯示已驗證。
新增您成員使用的每個網域(例如 example.com 和 eng.example.com)。每個組織最多 20 個網域。
連接身分識別提供者
- 在您的身分識別提供者中,使用 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 中繼資料的提供者可以使用它。
- 實體 ID(對象):
- 將提供者的中繼資料 XML 或其中繼資料 URL 複製到頂端的方塊中,然後選擇讀取中繼資料。Holarch 會填入實體 ID、登入 URL 和憑證。或由您自行輸入。
- 在屬性和角色下,若您的提供者使用不常見的屬性名稱,請設定屬性名稱(請參閱屬性)、新成員的角色,以及選用的群組對應角色。
- 選擇儲存身分識別提供者並輸入您的密碼。
開啟單一登入
- 勾選此組織的單一登入。它需要已儲存的身分識別提供者和已驗證的網域。
- 將成員登入連結提供給成員,或告訴他們在登入畫面選擇使用單一登入並輸入工作電子郵件地址。
- 先以一位成員試用。
成員首次登入時,Holarch 會建立帳戶(已確認,沒有密碼)並將其加入組織,即使註冊需要邀請也一樣。當已有使用該地址的帳戶時,單一登入會與其連結,其擁有者會收到電子郵件。
強制單一登入
單一登入正常運作後,勾選對已驗證網域中的成員強制單一登入。
- 受管理的成員之後只能透過身分識別提供者登入。密碼、通行密鑰、Google 和 Microsoft 登入會回應組織要求單一登入,並提供前往單一登入的按鈕。他們以其他登入方式建立的目前工作階段會立即結束。
- 組織管理員不受此要求限制:他們保留搭配兩步驟登入的密碼或通行密鑰,以便修正損壞的身分識別提供者設定(緊急存取)。請至少保留兩位組織管理員。
- 地址在已驗證網域之外的成員(外部協作者)不受影響。
- 密碼重設仍會設定新密碼,但不會讓成員登入;他們之後要透過身分識別提供者登入。
- 受管理成員的 API 權杖和已連接的應用程式會繼續運作。若要使其失效,請透過 SCIM 停用帳戶。
以 SCIM 佈建帳戶
- 在佈建(SCIM 2.0)下,選擇建立 SCIM 權杖並輸入您的密碼。
- 將權杖和基礎 URL(
https://app.holarch.app/scim/v2)複製到您身分識別提供者的佈建設定中。Holarch 只會顯示權杖一次。 - 在提供者中開啟建立、更新和停用使用者。
每個組織最多 5 個權杖。撤銷會立即使權杖失效。
身分識別提供者的憑證變更時
- 將新憑證貼在舊憑證下方(允許兩個憑證)並儲存。
- 將提供者切換到新憑證。
- 移除舊憑證並再次儲存。
憑證清單會顯示每個憑證的主體、到期日和指紋。
多個組織共用公司登入(自行託管)
一個電子郵件網域只屬於一個組織。當公司在自行託管的伺服器上為每個部門營運一個組織時,由一個組織(通常是 IT 部門的組織)驗證公司網域、連接身分識別提供者並開啟單一登入。其他組織再將身分識別提供者的群組對應到自己的角色:
- 在部門的組織設定 → 存取與登入 → 單一登入中,找到公司登入。它會指出負責公司登入的組織。
- 在群組對應角色下,每行寫一條對應,例如
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 簽署;
- 簽發者、對象(組織的實體 ID)、目的地或收件者(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 為電子郵件地址時的 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(persistent、email、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 的格式)和刪除群組;filter 搭配 eq 用於 displayName、externalId 或 id;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
- 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):實體 ID。
- Name ID format:
EmailAddress或Persistent。Application username:Email。 - Attribute statements:
email→user.email、displayName→user.displayName。Group attribute statements(選用):groups,依需要篩選。 - 完成後,將 Sign On 分頁中的 Metadata URL 複製到 Holarch,然後選擇讀取中繼資料。
- 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
- Enterprise applications → New application → Create your own application(非資源庫應用程式),然後 Single sign-on → SAML。
- Identifier (Entity ID):實體 ID。Reply URL (Assertion Consumer Service URL):ACS URL。
- Attributes & Claims:預設的
emailaddress宣告即可使用;若要對應群組,請新增群組宣告。 - 在 SAML Certificates 下,將 App Federation Metadata Url 複製到 Holarch,然後選擇讀取中繼資料。
- 若要信任 Entra 的多重要素登入,請在該應用程式的條件式存取原則中要求 MFA;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,並輸入 Holarch 的中繼資料 URL。如果 AD FS 伺服器無法連到 Holarch,請將中繼資料儲存為檔案,並選擇 Import data about the relying party from a file。顯示名稱: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 名稱(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複製到 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
- Admin console → Apps → Web and mobile apps → Add app → Add custom SAML app。
- 複製 IdP metadata(下載後將 XML 貼到 Holarch)。
- ACS URL:ACS URL。Entity ID:實體 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 驗證內容;請保持信任身分識別提供者的多重要素登入關閉。Google 的 SCIM 佈建只適用於資源庫應用程式;請改以單一登入建立帳戶。
Ping Identity
- PingOne: Applications → Add Application → SAML Application(PingFederate:SP 連線)。
- 匯入 Holarch 的中繼資料 URL,或輸入 ACS URL 和 Entity ID。
- Attribute mapping:
saml_subject→ Email Address;新增email和displayName。 - 將 IdP 中繼資料 URL 複製到 Holarch,然後選擇讀取中繼資料。
- 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)。
- 在目錄中建立唯讀服務帳戶(例如
svc-holarch)。將其名稱填入繫結帳戶,並將其密碼以HOLARCH_LDAP_BIND_PASSWORD寫入伺服器的.env,然後重新啟動伺服器。密碼絕不會在管理員頁面中顯示。 - 在目錄伺服器下,將每個網域控制站或 LDAP 伺服器輸入為
ldaps://dc1.corp.example.com(連接埠 636),每行一個;會依序嘗試。ldap://host:389只有在開啟對 ldap:// 位址使用 StartTLS 時才能使用。純 LDAP 會被拒絕,因此密碼絕不會以未加密方式在網路上傳輸。請使用每部伺服器憑證中所列的主機名稱。 - 將簽發伺服器憑證之 CA 的憑證放入CA 憑證(PEM),或放在伺服器上的
tls/ldap-ca.pem。留空表示使用系統信任的 CA。 - 輸入基礎 DN(
DC=corp,DC=example,DC=com,或在其他 LDAP 目錄中為dc=example,dc=com)和允許的電子郵件網域。 - 選擇測試連線。它會使用表單中的值連線(不儲存),並在失敗時指出問題(沒有伺服器回應、憑證、繫結帳戶、基礎 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 屬性(具 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 繫結,回到 Holarch 時使用 HTTP-POST。不支援簽署和加密的驗證請求、加密的判斷提示以及單一登出。SCIM 群組僅在自行託管的伺服器上支援(SCIM 群組與部門)。公司目錄以使用者名稱和密碼登入(透過 TLS 的簡單繫結);不支援 Kerberos 和 Windows 整合式登入。
- 設定變更需要最近的密碼驗證,會以電子郵件通知所有組織管理員,並記錄在稽核記錄中(sso.saml-save、sso.enable、sso.require、sso.domain-verify、scim.token-create…)。
- 中繼資料 URL 在公用網際網路上必須使用 https(在自行託管的伺服器上也允許內部位址);Holarch 只會在您選擇讀取中繼資料時擷取一次。
- SCIM 權杖只以雜湊形式儲存。