Holarch

관리

Single Sign-On 및 SCIM

조직의 SAML 2.0 ID 공급자(Okta, Microsoft Entra ID, Microsoft AD FS, Google Workspace, Ping) 또는 자체 호스팅 서버의 Active Directory를 직접 연결하고, 이메일 도메인을 확인하고, Single Sign-On을 필수로 지정하고, 그룹을 역할에 매핑하고, SCIM 2.0으로 계정을 프로비저닝합니다.

사용 방법 →

이 페이지의 내용
  1. 개념
  2. 사용 방법
    1. 이메일 도메인 확인
    2. ID 공급자 연결
    3. Single Sign-On 켜기
    4. Single Sign-On 필수로 지정
    5. SCIM으로 계정 프로비저닝
    6. ID 공급자의 인증서가 바뀌는 경우
    7. 여러 조직을 위한 회사 로그인(자체 호스팅)
    8. 부서 프로젝트에 대한 액세스(자체 호스팅)
  3. 로그인 규칙
    1. 2단계 로그인
  4. 속성
    1. 그룹과 역할 매핑
  5. SCIM
    1. SCIM 그룹과 부서(자체 호스팅)
  6. ID 공급자 설정
    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. 회사 디렉터리를 사용한 2단계 로그인
  8. 한도 및 보안 참고 사항

조직은 구성원이 업무용 계정으로 Holarch에 로그인하게 할 수 있습니다. Holarch는 서비스 공급자이고, 조직의 ID 공급자(Okta, Microsoft Entra ID, Microsoft AD FS, Google Workspace, Ping Identity 또는 모든 SAML 2.0 공급자)가 사용자가 누구인지 확인합니다. ID 공급자는 SCIM 2.0으로 Holarch 계정을 생성, 업데이트 및 비활성화할 수도 있습니다.

Single Sign-On은 조직 관리자가 조직 설정 → 조직 → 액세스 및 로그인 → Single Sign-On에서 설정합니다. 호스팅 서비스와 자체 호스팅 서버에서 작동하며, 데스크톱 앱에서는 작동하지 않습니다. 자체 호스팅 서버는 도메인을 확인하고(DNS 조회) URL에서 메타데이터를 읽기 위해 외부 접속이 필요합니다. 자체 호스팅 서버는 ID 공급자 없이 Active Directory나 다른 LDAP 디렉터리로 회사 계정을 직접 확인할 수도 있습니다. 회사 디렉터리(Active Directory / LDAP)를 참조하십시오.

참고: Single Sign-On과 SCIM 프로비저닝은 (조직의) Team 요금제에 포함됩니다. 버전 2.29.0 이전에 이를 사용한 조직은 계속 사용합니다. 요금제가 없으면 설정은 보관되지만 구성원은 비밀번호(비밀번호를 잊으셨습니까?로 설정), Google 또는 Microsoft로 로그인하며 SCIM 요청은 거부됩니다.

개념

용어의미
확인된 도메인조직이 DNS TXT 레코드로 관리 권한을 증명한 이메일 도메인(예: example.com)입니다. Single Sign-On과 SCIM은 확인된 도메인의 주소에만 작동합니다. 도메인은 한 조직만 확인할 수 있습니다.
ID 공급자(IdP)구성원을 로그인시키는 서비스로, 엔터티 ID(발급자), 로그인 URL 및 서명 인증서를 가집니다.
서비스 공급자(SP)이 조직에 대해서는 Holarch입니다. 각 조직에는 고유한 엔터티 ID, ACS URL 및 메타데이터 URL이 있습니다.
관리 대상 구성원이메일 주소가 확인된 도메인에 있고 조직 관리자가 아닌 조직의 구성원입니다. Single Sign-On 필수가 이들에게 적용됩니다.
SCIM 토큰ID 공급자가 이 조직에 대해 Holarch의 SCIM API를 호출할 때 사용하는 비밀 값입니다. 특정 사람에게 묶여 있지 않습니다.

사용 방법

이메일 도메인 확인

  1. 조직 설정을 열고, 조직을 선택하고, 액세스 및 로그인을 열어 Single Sign-On을 찾습니다.
  2. 이메일 도메인에 구성원 주소의 도메인을 입력하고 도메인 추가를 선택합니다.
  3. 표시된 TXT 레코드를 게시합니다. 이름은 _holarch-challenge.<domain>, 값은 holarch-domain-verification=…입니다.
  4. 확인을 선택합니다. DNS 변경이 반영되는 데 몇 분이 걸릴 수 있습니다. 도메인에 확인됨이 표시될 때까지 다시 확인하십시오.

구성원이 사용하는 모든 도메인을 추가합니다(예: example.com과 eng.example.com). 조직당 최대 20개 도메인입니다.

ID 공급자 연결

  1. ID 공급자에서 Holarch의 ID 공급자 아래 값으로 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. ID 공급자 저장을 선택하고 비밀번호를 입력합니다.

Single Sign-On 켜기

  1. 이 조직의 Single Sign-On을 선택합니다. 저장된 ID 공급자와 확인된 도메인이 필요합니다.
  2. 구성원에게 구성원용 로그인 링크를 주거나, 로그인 화면에서 Single Sign-On으로 로그인을 선택하고 업무용 이메일 주소를 입력하라고 알려 줍니다.
  3. 먼저 구성원 한 명으로 시험해 보십시오.

구성원이 처음 로그인하면 Holarch가 계정(확인됨, 비밀번호 없음)을 만들고 조직에 추가합니다. 가입에 초대가 필요한 동안에도 마찬가지입니다. 그 주소의 계정이 이미 있으면 Single Sign-On이 그 계정에 연결되고 계정 소유자에게 이메일이 갑니다.

Single Sign-On 필수로 지정

Single Sign-On이 작동하면 확인된 도메인의 구성원에게 Single Sign-On 필수를 선택합니다.

  • 그러면 관리 대상 구성원은 ID 공급자를 통해서만 로그인합니다. 비밀번호, 패스키, Google 및 Microsoft 로그인은 조직이 Single Sign-On을 요구한다고 답하며 그곳으로 가는 버튼을 표시합니다. 다른 로그인 방법으로 시작한 현재 세션은 즉시 끝납니다.
  • 조직 관리자는 필수 대상이 아닙니다. 고장 난 ID 공급자 설정을 고칠 수 있도록(비상 접근) 2단계 로그인과 함께 비밀번호나 패스키를 유지합니다. 조직 관리자를 두 명 이상 두십시오.
  • 주소가 확인된 도메인 밖에 있는 구성원(외부 공동 작업자)은 영향을 받지 않습니다.
  • 비밀번호 재설정은 여전히 새 비밀번호를 설정하지만 구성원을 로그인시키지는 않습니다. 그 후 ID 공급자를 통해 로그인합니다.
  • 관리 대상 구성원의 API 토큰과 연결된 앱은 계속 작동합니다. 끝내려면 SCIM으로 계정을 비활성화하십시오.

SCIM으로 계정 프로비저닝

  1. 프로비저닝(SCIM 2.0)에서 SCIM 토큰 만들기를 선택하고 비밀번호를 입력합니다.
  2. 토큰과 기본 URL(https://app.holarch.app/scim/v2)을 ID 공급자의 프로비저닝 설정에 복사합니다. Holarch는 토큰을 한 번만 보여 줍니다.
  3. 공급자에서 사용자 생성, 업데이트 및 비활성화를 켭니다.

조직당 최대 5개의 토큰. 취소는 토큰을 즉시 끝냅니다.

ID 공급자의 인증서가 바뀌는 경우

  1. 새 인증서를 이전 인증서 아래에 붙여 넣고(인증서 두 개 허용) 저장합니다.
  2. 공급자를 새 인증서로 전환합니다.
  3. 이전 인증서를 제거하고 다시 저장합니다.

인증서 목록에는 각 인증서의 주체, 만료 날짜 및 지문이 표시됩니다.

여러 조직을 위한 회사 로그인(자체 호스팅)

이메일 도메인은 하나의 조직에 속합니다. 회사가 자체 호스팅 서버에서 부서마다 조직 하나를 운영하는 경우, 한 조직(보통 IT 조직)이 회사 도메인을 확인하고, ID 공급자를 연결하고, Single Sign-On을 켭니다. 그러면 다른 조직은 ID 공급자 그룹을 자신의 역할에 매핑합니다.

  1. 부서의 조직 설정 → 액세스 및 로그인 → Single Sign-On에서 회사 로그인을 찾습니다. 회사 로그인을 운영하는 조직이 표시됩니다.
  2. 그룹별 역할에 한 줄에 하나씩 매핑을 씁니다. 예: packs-engineers = member, packs-leads = admin. 그런 다음 그룹 저장을 선택합니다.
  3. 선택 사항: 쉼표 뒤에 그룹의 부서 프로젝트에 대한 액세스를 추가합니다. 예: packs-contractors = member, viewer. 부서 프로젝트에 대한 액세스를 참조하십시오.

회사 로그인을 통해 로그인할 때마다 매핑된 그룹의 사람은 그 역할로 해당 조직에 가입하거나, 그곳의 조직 관리자가 됩니다. 로그인으로 누군가가 제거되거나 역할이 낮아지는 일은 없습니다(SCIM 그룹은 가능합니다. SCIM 그룹과 부서 참조). 사람을 제거하는 일은 조직 관리자가 조직 설정에서 합니다. ID 공급자는 그룹을 보내야 합니다(회사 로그인의 그룹 속성).

회사 로그인을 운영하는 조직의 조직 관리자는 도메인의 모든 주소에 대한 로그인을 제어합니다. 그 조직에는 ID 공급자를 운영하는 사람만 두십시오.

부서 프로젝트에 대한 액세스(자체 호스팅)

각 그룹 매핑은 그 그룹의 사람이 조직 전체와 공유된 프로젝트(공유 → 조직)에서 받는 권한도 지정할 수 있습니다: viewer, reviewer 또는 editor(기본값). 이런 프로젝트에서 사람의 역할은 공유의 역할과, 그곳에서 매핑된 그룹들이 주는 가장 높은 권한 중 더 낮은 쪽입니다. 예를 들어 프로젝트가 편집자로 공유되고 packs-contractors = member, viewer이면 계약자는 프로젝트를 보기만 합니다. packs-contractors와 packs-engineers = member에 모두 속한 사람은 편집합니다. 이 규칙은 그룹의 출처와 관계없이 적용됩니다: 회사 Single Sign-On, SCIM 그룹, 회사 디렉터리. 사람과 직접 공유된 프로젝트는 영향을 받지 않으며, 직접 추가된 구성원(매핑된 그룹에 없음)은 공유의 역할을 받습니다. 그룹의 권한을 변경하면 그 그룹이 배치한 모든 사람에게 즉시 적용됩니다.

편집자 좌석. 라이선스는 편집자 수를 제한하며, 뷰어와 검토자는 무료입니다. 그룹의 편집자 권한으로 누군가가 편집자가 되어야 하는데 빈 좌석이 없으면, 그 사람은 대신 뷰어가 되며 로그인은 계속 작동합니다. 조직 설정과 관리자 → 회사 디렉터리에는 뷰어로 유지된 사람 수가 표시되며, 회사 디렉터리 페이지에는 그룹에서 좌석을 받은 모든 편집자와 유지된 각 사람이 나열됩니다. 좌석이 비면 유지된 사람은 다음 확인 때 가입이 오래된 순으로 편집자가 됩니다.

폐쇄망의 서버. 서버가 공용 DNS를 조회할 수 없으면 사이트 관리자가 TXT 레코드를 게시하는 대신 확인되지 않은 도메인 옆의 확인됨으로 표시를 선택할 수 있습니다. 도메인은 여전히 하나의 조직에만 속하며, 변경은 감사 로그에 기록됩니다.

로그인 규칙

Holarch는 ID 공급자의 모든 응답을 엄격하게 확인합니다. 다음 경우 로그인이 거부됩니다.

  • 어설션이 구성된 인증서로 서명되지 않았거나 SHA-1로 서명된 경우,
  • 발급자, 대상(조직의 엔터티 ID), 목적지 또는 수신자(ACS URL)가 일치하지 않는 경우,
  • 어설션이 아직 유효하지 않거나 만료된 경우(2분의 시계 차이 허용),
  • 같은 브라우저에서 시작되지 않은 로그인이나 이미 사용된 로그인에 대한 응답인 경우(각 로그인은 한 번 시작되며 10분 후 만료됨),
  • 같은 어설션이 두 번째로 도착한 경우(재전송),
  • 이메일 주소가 없거나 조직의 확인된 도메인 밖에 있는 경우,
  • 계정이 비활성화된 경우.

그러면 로그인 화면에 무엇이 잘못되었는지 표시되고, 조직의 감사 로그에 auth.sso-failed로 기록됩니다.

ID 공급자 포털에서 로그인(IdP 시작 방식, 구성원이 공급자의 앱 대시보드에서 시작하는 경우)은 기본적으로 꺼져 있습니다. 그런 응답은 브라우저가 시작한 로그인에 묶여 있지 않기 때문입니다. 구성원에게 필요할 때만 ID 공급자 포털에서 로그인 허용을 켜십시오. 재전송 방지와 다른 모든 검사는 계속 적용됩니다.

2단계 로그인

기본적으로 Single Sign-On은 첫 번째 단계입니다. 2단계 로그인이 켜진 계정은 여전히 패스키나 코드를 확인하며, 조직의 2단계 로그인 필수 설정도 여전히 구성원에게 이를 요구합니다.

ID 공급자의 다단계 로그인 신뢰가 켜져 있으면, 어설션이 다단계 인증을 보고하는 로그인에는 Holarch의 두 번째 단계가 필요하지 않으며, 그 세션 동안 이 조직(다른 조직은 아님)의 2단계 요구 사항을 충족합니다. 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스마트 카드

multipleauthn이 있는 Entra ID의 http://schemas.microsoft.com/claims/authnmethodsreferences 클레임도 인정됩니다. ID 공급자에서 비밀번호만으로 한 로그인은 신뢰가 켜져 있어도 다단계가 아닙니다.

속성

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

계정은 ID 공급자의 NameID(persistent, email, Windows 도메인 정규화 이름 또는 다른 형식)로 찾습니다. NameID가 없으면(AD FS는 클레임 규칙이 발급하지 않는 한 보내지 않음) 이메일 주소로 계정을 식별합니다. NameID가 바뀌어도 이메일 주소가 같으면 계정이 다시 연결됩니다.

그룹 이름은 대소문자를 구분하지 않고 비교합니다. CORP\Packs Engineers 같은 도메인 정규화 이름은 Packs Engineers에 대한 매핑과도 일치하며, 그룹 SID(S-1-5-21-…)는 그 SID로 작성된 매핑과 일치합니다.

그룹과 역할 매핑

한 줄에 매핑 하나씩 작성합니다: holarch-admins = admin 또는 engineering = member. 로그인할 때마다 admin에 매핑된 그룹의 구성원은 조직 관리자가 되고, 그 밖의 매핑된 그룹의 구성원은 구성원이 됩니다. 매핑된 그룹에 없는 구성원은 역할을 유지합니다. 마지막 조직 관리자는 절대 강등되지 않습니다.

SCIM

SCIM API는 Authorization: Bearer hsc_…와 함께 https://app.holarch.app/scim/v2에서 RFC 7643 및 RFC 7644를 따릅니다.

엔드포인트기능
GET /ServiceProviderConfig, /ResourceTypes, /Schemas서비스 설명
GET /Users조직이 프로비저닝한 사용자와 확인된 도메인의 구성원 나열. userName, externalId, id, emails.value 또는 emails[type eq "work"].value에 대한 eq가 있는 filter, startIndex 및 count
POST /Users사용자를 만들고(또는 그 주소의 기존 계정을 연결하고) 조직에 추가
GET, PUT, PATCH /Users/<id>사용자 읽기, 대체 또는 변경: userName, name, displayName, emails, externalId, active
DELETE /Users/<id>사용자를 비활성화하고 외부 ID 삭제
/Groups자체 호스팅 서버: 그룹 나열, 생성, 읽기, 교체, 변경(Okta 및 Microsoft Entra ID 형식으로 members, displayName, externalId에 대한 PATCH), 삭제. displayName, externalId 또는 id에 대한 eq를 사용하는 filter, excludedAttributes=members. SCIM 그룹과 부서를 참조하십시오. 호스팅 서비스: 빈 목록을 반환하고 변경을 거부합니다. 대신 Single Sign-On에서 그룹을 역할에 매핑하십시오.
  • 조직의 확인된 도메인에 있는 주소만 만들거나 변경할 수 있습니다.
  • 비활성화(active: false 또는 DELETE)는 그 사람을 조직에서 제거하고, 계정을 비활성화하고, 모든 세션을 끝내고, API 토큰과 연결된 앱을 취소합니다. 다시 활성화하면 계정이 활성화되고 조직 역할이 복원됩니다. Holarch가 비활성화한 계정(예: 남용 후)은 비활성 상태로 남습니다.
  • Enterprise 확장 속성은 받지만 무시합니다.
  • 각 토큰은 분당 600건의 요청을 할 수 있습니다. 모든 변경은 조직의 감사 로그에 기록됩니다(scim.create, scim.deactivate 등).

SCIM 그룹과 부서(자체 호스팅)

자체 호스팅 서버에서 ID 공급자는 회사 도메인을 보유한 조직의 SCIM 엔드포인트로 그룹을 보낼 수 있습니다. 그러면 회사 로그인의 각 부서 그룹별 역할이 누가 어느 부서에 어떤 역할로 속하는지 결정합니다. 하나의 매핑이 회사 Single Sign-On을 통한 로그인과 SCIM 그룹 모두에 쓰입니다.

  • 매핑된 그룹에 추가된 사람은 매핑된 역할로 해당 조직에 가입하며, 그룹이 바뀌면 역할도 바뀝니다.
  • 매핑된 모든 그룹에서 제거된 사람은 그룹이 추가한 조직에서 나갑니다.
  • 다른 방법(조직 관리자, 초대, 가져오기 또는 로그인)으로 추가된 구성원 자격은 그룹에 의해 제거되거나 낮아지지 않으며, 그룹은 이를 조직 관리자로 올릴 수만 있습니다. 조직 관리자가 구성원의 역할을 직접 변경하면 그때부터 그 구성원 자격은 조직 관리자가 관리합니다.
  • 조직의 마지막 조직 관리자는 제거되거나 역할이 낮아지지 않습니다.
  • 부서의 그룹별 역할을 변경하면 그룹의 모든 사람에게 즉시 적용됩니다.
  • 그룹 구성원은 이 토큰이 프로비저닝하거나 관리하는 사용자여야 하며, 다른 ID는 무시됩니다.
  • 사용자 비활성화는 이전과 같이 작동하며, 사용자의 부서는 그룹을 따릅니다.
  • 모든 변경이 기록됩니다: 회사 조직의 감사 로그에 scim.group-create, scim.group-update, scim.group-delete, 그리고 부서의 로그에 각 구성원 자격 변경.

ID 공급자 설정

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 Federation Services, 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는 각 그룹의 표시 이름이나 cn이 아니라 pre-Windows 2000 name(sAMAccountName)을 보내며, 기본 그룹(보통 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를 요구하고 ID 공급자의 다단계 로그인 신뢰를 켭니다. 그러면 AD FS가 http://schemas.microsoft.com/claims/multipleauthn을 보냅니다.

자체 호스팅 서버에서는 메타데이터 URL이 내부 주소(https://adfs.corp.example.com/…, 사설 IP)일 수 있으며, 그 인증서는 시스템의 신뢰할 수 있는 CA와 함께 tls/ldap-ca.pem의 회사 CA로도 확인됩니다. AD FS의 토큰 서명 인증서는 매년 교체됩니다. Holarch는 만료일을 표시합니다. AD FS가 새 인증서를 추가하면 메타데이터 읽기를 다시 실행하십시오(겹치는 기간에는 둘 다 유지됩니다). AD FS에는 SCIM이 없습니다. 자체 호스팅 서버에 회사 디렉터리가 있으면 Holarch가 계정을 직접 확인합니다(아래 참조).

Google Workspace

  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 인증 컨텍스트를 보내지 않으므로 ID 공급자의 다단계 로그인 신뢰를 끈 상태로 두십시오. Google의 SCIM 프로비저닝은 갤러리 앱에서만 작동합니다. 대신 Single Sign-On으로 계정을 만드십시오.

Ping Identity

  1. PingOne: Applications → Add Application → SAML Application(PingFederate: SP 연결).
  2. Holarch의 메타데이터 URL을 가져오거나 ACS URL과 Entity 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(해당 도메인 컨트롤러) 또는 OpenLDAP, FreeIPA와 같은 다른 LDAP 디렉터리입니다. ID 공급자는 필요하지 않습니다. 사이트 관리자가 관리자 → 회사 디렉터리에서 설정하며, 서버의 .env로 초기값을 지정할 수 있습니다(HOLARCH_LDAP_*, 자체 호스팅 배포본의 SIGN-IN.md). 호스팅 서비스에서는 제공되지 않습니다.

회사 디렉터리 설정

먼저 관리자 → 회사 디렉터리 위쪽에서 디렉터리 유형을 선택합니다. Active Directory 또는 기타 LDAP 디렉터리(OpenLDAP, FreeIPA, …)입니다. 어느 쪽이든 연결은 하나입니다. 유형에 따라 제공되는 그룹 조회, Active Directory 기본값 사용 또는 LDAP 기본값 사용이 양식에 넣는 값, 힌트와 예가 결정됩니다. 유형을 바꾸면 아직 다른 유형의 기본값인 사용자 필터나 그룹 조회는 교체되고 직접 작성한 필터는 유지됩니다. 페이지는 저장된 설정에서 유형을 판단합니다(중첩 그룹이나 Active Directory 필터가 있으면 Active Directory입니다).

  1. 디렉터리에 읽기 전용 서비스 계정을 만듭니다(예: svc-holarch). 그 이름을 바인드 계정에 입력하고, 비밀번호는 서버의 .env에 HOLARCH_LDAP_BIND_PASSWORD로 넣은 다음 서버를 다시 시작합니다. 비밀번호는 관리자 화면에 표시되지 않습니다.
  2. 디렉터리 서버에 각 도메인 컨트롤러 또는 LDAP 서버를 ldaps://dc1.corp.example.com(포트 636) 형식으로 한 줄에 하나씩 입력합니다. 순서대로 시도됩니다. 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 오버레이를 사용하는 OpenLDAP, FreeIPA, 389 Directory Server)과 사용자를 구성원으로 나열하는 그룹(groupOfNames 및 groupOfUniqueNames. 위치는 그룹 기본 DN에서 지정)이 있습니다. 중첩 그룹은 계산되지 않습니다.

디렉터리 그룹 기반 부서

디렉터리 그룹은 SAML과 같은 회사 로그인의 그룹과 역할 매핑으로 사람을 조직에 배치합니다(여러 조직을 위한 회사 로그인 참조). 각 조직의 Single Sign-On 상자에서 그룹을 역할에 매핑합니다. 예: Packs Engineers = member, Packs Leads = admin. 이름은 대소문자를 구분하지 않고 비교하며, 그룹의 DN도 사용할 수 있고 Active Directory에서는 SID도 사용할 수 있습니다. Active Directory(중첩 그룹 포함)는 그룹 안의 다른 그룹을 통해 속한 사람도 그 그룹의 구성원으로 셉니다.

로그인할 때와 정기 확인 때마다 매핑된 그룹의 사람은 그 역할과 그룹의 부서 프로젝트에 대한 액세스로 해당 조직에 가입합니다. 디렉터리가 부여한 구성원 자격은 그 사람이 거기에 매핑된 모든 그룹을 떠나면 제거됩니다. 직접 추가한 구성원 자격은 유지됩니다(디렉터리는 그곳에서 구성원을 조직 관리자로 올릴 수는 있지만 낮추지는 않습니다). 마지막 조직 관리자는 제거되지 않습니다.

로그인할 수 있는 사람

  • 계정은 디렉터리에서 활성 상태여야 합니다. 비활성화, 잠김, 만료된 계정은 거부되며, 비밀번호가 만료되었거나 다음 로그온 때 변경해야 하는 계정도 거부됩니다.
  • 디렉터리 항목에는 허용된 도메인의 이메일 주소가 있어야 합니다. 첫 로그인 때 Holarch 계정이 만들어지거나, 그 주소의 기존 계정이 연결됩니다. 이미 다른 디렉터리 항목에 연결된 계정은 넘겨받지 않습니다.
  • 연결된 계정에 회사 로그인 필수는 연결된 계정이 Holarch 비밀번호로 로그인하지 못하게 합니다. 사이트 관리자는 비밀번호를 유지하므로 디렉터리 장애가 생겨도 모든 사람이 잠기는 일은 없습니다.
  • 잘못된 비밀번호가 일시 중지 전 실패 횟수(기본값 3)만큼 입력되면, 어떤 형태의 이름(jsmith, [email protected], CORP\jsmith)을 입력했든 그 회사 계정의 로그인이 15분 동안 일시 중지됩니다. Holarch가 회사 계정을 잠그는 일이 없도록 이 값을 도메인의 잠금 임계값보다 낮게 유지하십시오. 알 수 없는 사용자 이름과 잘못된 비밀번호는 같은 응답을 거의 같은 시간에 받습니다.

정기 확인

계정 확인 간격(분)(기본값 15)마다 서버는 로그인되어 있거나 디렉터리 구성원 자격을 가진 연결된 계정을 각각 조회합니다. 비활성화되었거나, 잠겼거나, 디렉터리에서 제거되었거나, 비밀번호가 만료되었거나 다음 로그온 때 변경해야 하는(침해가 의심될 때 관리자가 재설정한 경우가 많음) 사람은 모든 곳에서 로그아웃되고 디렉터리가 부여한 구성원 자격을 잃습니다. 그룹 변경은 구성원 자격을 업데이트합니다. 잠긴 계정은 잠금이 해제된 후 다음 로그인 때 구성원 자격을 되찾습니다. 디렉터리에 연결할 수 없으면 아무것도 바뀌지 않습니다. 확인한 계정 대부분이 없으면(예: 잘못된 기본 DN 이후) 아무것도 종료하지 않으며 관리자 화면에 경고가 표시됩니다. 지금 확인은 확인을 즉시 실행합니다. 관리자 화면에는 마지막 확인 결과가 표시됩니다.

각 확인에서는 매핑된 모든 그룹의 구성원도 조회하며(Active Directory(중첩 그룹 포함)에서는 중첩 그룹도 포함), 아직 계정이 없는 사람에게 로그인과 같은 규칙(활성 상태, 허용된 이메일 도메인, 다른 곳에 연결된 계정을 넘겨받지 않음)으로 계정을 만듭니다. 이메일은 전송되지 않습니다. 그 사람은 처음 Holarch가 필요할 때 회사 계정으로 로그인하며, 이미 자신의 부서에 속해 있으므로 그 전에도 프로젝트를 공유받을 수 있습니다. 한 번의 확인으로 최대 200개 계정을 만들며, 관리자 화면에 다음 확인을 기다리는 계정 수가 표시됩니다. SID로만 지정된 그룹은 이 방식으로 조회되지 않으며, 그 구성원은 로그인할 때 배치됩니다.

회사 디렉터리를 사용한 2단계 로그인

회사 로그인은 첫 번째 단계입니다. 2단계 로그인을 요구하는 조직은 여전히 Holarch의 두 번째 단계(패스키 또는 코드)를 요구하며, 2단계 로그인을 켠 계정도 여전히 이를 확인합니다. 회사 계정 자체에 두 번째 요소가 필요한 경우에만 회사 로그인을 2단계 로그인으로 인정을 켜십시오. 그러면 그 세션 동안 모든 조직의 2단계 요구 사항을 충족합니다.

모든 디렉터리 로그인, 거부, 설정 변경은 감사 로그(admin.directory-save, admin.directory-test, directory.account-ended)와 각 계정의 로그인 기록에 남습니다. 비밀번호는 기록되지 않습니다.

한도 및 보안 참고 사항

제한: Single Sign-On은 ID 공급자로 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 토큰은 해시로만 저장됩니다.