Microsoft Entra ID(Azure AD)와 연동하여 조직 구조를 자동으로 동기화합니다.
사전 요구사항
Entra ID 동기화를 위해서는 Microsoft OAuth 설정이 필요합니다. 다음 환경 변수를 서버에 설정하세요.
환경 변수
설명
MICROSOFT_CLIENT_ID
Azure App Registration의 Client ID
MICROSOFT_CLIENT_SECRET
Client Secret
MICROSOFT_CLIENT_TENANT_ID
Azure AD Tenant ID
동기화 실행
1
동기화 창 열기
조직 목록 우측 상단 검색창 옆의 동기화 버튼()을 클릭하면 조직 동기화 창이 열립니다.
2
데이터 소스 선택
데이터 소스 드롭다운에서 동기화 방식을 선택합니다 — JSON Import(기본값) · Microsoft Graph · Keycloak · Google Workspace. Entra ID 연동은 Microsoft Graph 를 선택합니다.Microsoft Graph 선택 시 가져올 항목을 옵션으로 지정합니다.
옵션
설명
기본값
관리 단위
Entra ID의 조직 관리 기능. 계층 구조에 적합
ON
보안 그룹
보안 그룹을 조직 단위로 사용. OData 쿼리로 필터링
OFF
부서
사용자 프로필에서 부서명을 자동 추출
OFF
Group Filter 입력란은 보안 그룹을 켰을 때만 나타납니다. 특정 그룹만 가져오려면 OData 필터식을 입력하세요(선택 사항).
데이터 소스 = Microsoft Graph 선택 시 동기화 옵션
3
동기화 실행
창 하단의 “동기화” 버튼을 클릭합니다.
조직 동기화 창 — 데이터 소스 선택(기본값 JSON Import)
4
결과 확인
동기화된 조직 단위 트리와 멤버 매핑 결과를 확인합니다. 성공하면 조직 N개, 단위 M개를 동기화했습니다 형태로 건수가 표시되고, 가져올 데이터가 없으면 “옵션을 다르게 켜 보라”는 안내가 나옵니다.
다른 데이터 소스의 옵션
데이터 소스를 Keycloak 또는 Google Workspace로 바꾸면 옵션 구성도 함께 바뀝니다.
Keycloak
Google Workspace
서버 URL과 인증 정보는 화면에서 입력하지 않고 OPENID_PROVIDER_URL · OAUTH_CLIENT_ID · OAUTH_CLIENT_SECRET 환경변수로 설정합니다.
옵션
설명
기본값
그룹
Keycloak 그룹 계층을 조직 단위로 동기화
ON
조직 (v26+)
Keycloak Organizations 기능을 사용 (Keycloak 26 이상 필요)
OFF
옵션
설명
기본값
조직 단위 (OU)
Google Workspace의 조직 단위 계층 구조를 가져옴
ON
그룹
Google Groups를 조직 단위로 가져옴
OFF
JSON Import
Entra ID가 없는 환경에서는 JSON 데이터로 조직 구조를 직접 import할 수 있습니다.
조직 단위를 활용하여 리소스(에이전트, 지식 기반, 데이터베이스 등)의 접근 범위를 제어합니다.
리소스에 조직 단위 권한 설정
각 워크스페이스 리소스의 접근 권한 설정에서 조직 단위를 지정합니다.
접근 레벨
설명
읽기 (Read)
해당 OU 멤버가 리소스를 조회/사용 가능
쓰기 (Write)
해당 OU 멤버가 리소스를 편집 가능
권한 상속
상위 조직 단위에 부여된 권한은 하위 조직 단위로 상속됩니다.
상위 OU에 리소스 접근 권한이 설정되면, 하위 OU의 모든 멤버도 동일한 권한을 자동으로 부여받습니다.
활용 예시
리소스
접근 제어
설명
인사규정 KB
인사팀 OU (Read)
인사팀만 인사규정 조회 가능
영업 에이전트
영업본부 OU (Read)
영업 부서 전체가 사용 가능
매출 DB
경영지원본부 OU (Read)
경영지원 부서만 매출 데이터 조회
전사 공지 KB
최상위 OU (Read)
전체 조직이 접근 가능
조직 단위 목록 보기
조직을 선택하면 아래에 그 조직의 조직 단위가 계층 순서대로 펼쳐집니다.
요소
설명
들여쓰기
계층 depth를 그대로 반영합니다. 하위 OU일수록 오른쪽으로 밀려납니다
타입 배지
이름 오른쪽의 회색 배지 (department · team · group)
멤버 수 버튼
사람 아이콘 + 숫자. 클릭하면 그 OU의 멤버 목록이 열립니다
타입 탭
타입이 두 종류 이상일 때만 전체 / 부서 / 팀 / 그룹 탭이 목록 위에 나타납니다
멤버 목록에는 IdP 동기화로 매핑된 멤버와 OAuth 로그인으로 자동 배정된 사용자가 함께 표시되며, 아직 Cloosphere 계정이 없는 구성원은 미등록으로 구분됩니다.
조직별 사용량 제한
조직 단위별 토큰 한도는 조직 화면이 아니라 관리자 > 설정 > 모델에서 관리합니다. 모델별로 지정하는 값이며, OU 하나에 일괄 적용되는 단일 한도는 없습니다.
1
사용량 제한 켜기
관리자 > 설정 > 모델 상단의 토큰 제한 버튼을 눌러 토큰 제한 관리 창을 엽니다. 사용량 제한 활성화를 켜고, 필요하면 기본 일별 토큰 제한과 초과 시 동작(경고 / 차단)을 지정합니다.
2
모델 펼치기
사용량 제한을 켜면 모델 목록의 각 행을 펼칠 수 있습니다. 펼치면 그 모델의 이 모델 기본값과 함께 예외 카드 3장이 나타납니다.
3
조직 단위 예외 지정
사용자 예외 · 그룹 예외 · 조직 단위 예외 중 조직 단위 예외를 열어 OU별 한도를 지정합니다. 카드에 표시되는 숫자는 현재 등록된 예외 건수입니다.
값
의미
비어 있음
상속 — 상위 계층에서 결정
0
명시적 무제한
양수
일일 토큰 한도
사용량 제한은 전역, 사용자, 그룹, 조직 단위 네 계층에서 설정할 수 있습니다. 여러 계층에 값이 있으면 가장 관대한(높은) 값이 적용되며, 어느 한 계층이라도 0(무제한)이면 그 값이 곧바로 적용됩니다. 예외는 한도를 올리는 용도로 설계되어 있어, 하위 계층에 낮은 값을 넣어 상위 한도를 깎을 수는 없습니다.
조직 단위별 가드레일
조직 단위에 가드레일을 직접 연결하는 화면은 현재 배포 버전에서 제공되지 않습니다. 조직 단위 행에는 멤버 수 버튼만 있습니다.