Sync organizational structure automatically with Microsoft Entra ID (Azure AD).
Prerequisites
Microsoft OAuth setup is required for Entra ID sync. Set the following environment variables on the server.
Environment Variable
Description
MICROSOFT_CLIENT_ID
Azure App Registration’s Client ID
MICROSOFT_CLIENT_SECRET
Client Secret
MICROSOFT_CLIENT_TENANT_ID
Azure AD Tenant ID
Running Sync
1
Open the sync dialog
Click the sync button () next to the search box at the top-right of the organization list to open the Organization Sync dialog.
2
Pick a data source
In the Data Source dropdown, pick the sync method — JSON Import (default) · Microsoft Graph · Keycloak · Google Workspace. For Entra ID integration, pick Microsoft Graph.When Microsoft Graph is selected, choose which items to fetch.
Option
Description
Default
Administrative Units
Entra ID’s org management feature; suited to hierarchies
ON
Security Groups
Use security groups as organizational units; filter with OData query
OFF
Departments
Auto-extract department names from user profiles
OFF
The Group Filter box appears only while Security Groups is on. Enter an OData filter expression to import specific groups only (optional).
Sync options when Data Source = Microsoft Graph
3
Run sync
Click the Sync button at the bottom of the dialog.
Organization Sync dialog — data source selection (default: JSON Import)
4
Verify results
Verify the synced OU tree and member mapping. On success the dialog reports counts as Synced N organization(s), M unit(s); if nothing was found, it suggests enabling different options.
Options for the other data sources
Switching Data Source to Keycloak or Google Workspace changes the option set as well.
Keycloak
Google Workspace
The server URL and credentials are not entered on screen — they come from the OPENID_PROVIDER_URL · OAUTH_CLIENT_ID · OAUTH_CLIENT_SECRET environment variables.
Option
Description
Default
Groups
Sync the Keycloak group hierarchy as organizational units
ON
Organizations (v26+)
Use the Keycloak Organizations feature (requires Keycloak 26 or later)
OFF
Option
Description
Default
Organizational units (OU)
Import the Google Workspace OU hierarchy
ON
Groups
Import Google Groups as organizational units
OFF
JSON Import
In environments without Entra ID, import the org structure via JSON data directly.
Use OUs to control resource (agents, KBs, databases, etc.) access scope.
Setting OU Permissions on Resources
In each workspace resource’s Access settings, specify the OU.
Access Level
Description
Read
OU members can view/use the resource
Write
OU members can edit the resource
Permission Inheritance
Permissions granted to upper OUs are inherited by lower OUs.
When resource access is set on an upper OU, all members of lower OUs automatically receive the same permission.
Example Use
Resource
Access Control
Description
HR Policy KB
HR Team OU (Read)
Only HR team can view HR policy
Sales Agent
Sales Division OU (Read)
Entire Sales department can use
Sales DB
Operations Division OU (Read)
Only Operations department queries sales data
Company-wide Notice KB
Top-level OU (Read)
Entire organization can access
Viewing the OU List
Selecting an organization expands its organizational units below, in hierarchy order.
Element
Description
Indentation
Mirrors hierarchy depth — the deeper the OU, the further right it sits
Type badge
Grey badge to the right of the name (department · team · group)
Member-count button
People icon + number. Click it to open that OU’s member list
Type tabs
All / Department / Team / Group tabs appear above the list only when two or more types exist
The member list shows both members mapped by IdP sync and users auto-assigned via OAuth login; members without a Cloosphere account yet are marked Not registered.
Per-Organization Usage Limits
Per-OU token caps are managed under Admin > Settings > Models, not on the Organizations screen. They are set per model — there is no single cap that applies to an OU as a whole.
1
Turn usage limits on
Under Admin > Settings > Models, click the Token Limit button at the top to open the Token Limit Management dialog. Turn on Enable Usage Limit, and optionally set the default daily token limit and the action on exceeding (Warn / Block).
2
Expand a model
Once usage limits are on, each model row becomes expandable. Expanding shows that model’s base limit along with three override cards.
3
Set the org unit override
Among User overrides · Group overrides · Org unit overrides, open Org unit overrides and set per-OU caps. The number on each card is the count of overrides currently registered.
Value
Meaning
Empty
Inherit — decided by a higher layer
0
Explicitly unlimited
Positive number
Daily token cap
Usage limits can be set at four layers — global, user, group, and organizational unit. When several layers carry a value, the most permissive (highest) one applies, and if any layer is 0 (unlimited) that wins immediately. Overrides are designed to raise a cap, so you cannot shrink a higher-layer cap by entering a smaller value at a lower layer.
Per-OU Guardrails
A screen for attaching guardrails directly to an organizational unit is not available in the current release. OU rows carry only the member-count button.
Apply guardrails through these paths instead.
Target
Where to configure
Per group
Admin > Users > Groups & Permissions > edit a group > Chat Guardrail on the General tab
Per agent
Workspace > Agents > that agent’s guardrail settings
If you need guardrails at department granularity, map the OU to a group (see Group ↔ OU Mapping) and set the chat guardrail on that group — that is the route available today.
Deleting an Organization
The bottom of the Organizations screen has a Delete Organization area.
Deleting removes the organization and every organizational unit under it, permanently. This cannot be undone. Confirm the organization name in the dialog before proceeding. Member associations are removed as well — user accounts themselves are not deleted.
Verify Azure App Registration has Directory.Read.All permission.
Verify environment variables MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_CLIENT_TENANT_ID are correctly set.
Check server logs for detailed error messages.
Do I need to use both organizations and groups?
Not necessarily. Permission management alone is fine with groups. Use organizations additionally when you need department-based access control with Entra ID integration.
Are members deleted when I delete an OU?
Deleting an OU doesn’t delete the user accounts in it. Only the resource access permissions configured for that OU are removed.
Related Pages
User Management
User list, roles/groups, permission settings
Groups & Permissions
Map OUs to groups to apply permissions and chat guardrails
Usage
Usage and cost monitoring by organization and user
Deployment Checklist
OIDC environment variables required for Keycloak/Entra sync
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cloosphere Guide","colors":{"primary":"#5f22d0","light":"#7c3aed","dark":"#4c1d95"},"logo":{"light":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","dark":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","href":"/ko/index"},"favicon":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/favicon.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=0e41ff0755aa623d52e26f279f285f71","appearance":{"default":"system","strict":false},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"languages":[{"language":"ko","default":true,"href":"ko"},{"language":"en","href":"en"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cloocus","hasAudioNarration":false,"actualSubdomain":"cloocus","customDomains":["docs.cloosphere.ai"],"gitSource":{"type":"github","owner":"ais-cloocus","repo":"cloosphere-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6a954066df6b735599399868","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"en","tag":"Admin","count":30},{"language":"ko","tag":"관리자","count":30},{"language":"en","tag":"Settings","count":24},{"language":"ko","tag":"설정","count":24},{"language":"en","tag":"Monitoring","count":21},{"language":"ko","tag":"모니터링","count":21},{"language":"en","tag":"Workspace","count":16},{"language":"ko","tag":"워크스페이스","count":16},{"language":"en","tag":"Chat","count":11},{"language":"ko","tag":"채팅","count":11},{"language":"en","tag":"Getting Started","count":10},{"language":"ko","tag":"시작하기","count":10},{"language":"en","tag":"Collaboration","count":8},{"language":"ko","tag":"협업","count":8},{"language":"en","tag":"Data \u0026 Operations","count":6},{"language":"ko","tag":"운영 · 지원","count":6},{"language":"ko","tag":"데이터 및 운영 보안","count":6},{"language":"en","tag":"AI Features \u0026 Safety","count":5},{"language":"en","tag":"UI \u0026 Channels","count":5},{"language":"ko","tag":"AI 기능 및 안전","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--brand-primary: #5f22d0;--brand-light: #7c3aed;--brand-dark: #4c1d95;--brand-subtle: #ede9fe;--brand-glow: rgba(95, 34, 208, 0.15);--page-text: #0f172a;--page-muted: #6b7280}body{font-family:\"DM Sans\", sans-serif;color:var(--page-text);font-size:17px}.prose h1,.prose h2,.prose h3,.prose h4{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;letter-spacing:-0.015em}.prose h1{font-size:44px}.prose h2{font-size:28px;margin-top:36px;margin-bottom:10px}.prose h3{font-size:22px;margin-top:28px;margin-bottom:8px}.prose p,.prose li{color:var(--page-text);line-height:1.75;font-size:1rem}.prose hr{border:0;height:1px;background:linear-gradient(90deg, rgba(148, 163, 184, 0.4), rgba(148, 163, 184, 0.05));margin:28px 0}.dark body{color:#e2e8f0}.dark .prose p,.dark .prose li{color:#e2e8f0}.dark .prose hr{background:linear-gradient(90deg, rgba(148, 163, 184, 0.3), rgba(148, 163, 184, 0.05))}[class*=\"Card\"] svg,.card svg,a[href] svg{color:var(--brand-primary)!important}.card [data-component-part=\"card-icon\"]{margin-bottom:8px}.card [data-component-part=\"card-title\"]{margin-top:12px!important}[class*=\"Card\"],.card{border-radius:16px!important;border-color:rgba(148, 163, 184, 0.25)!important;transition:border-color 0.2s ease, box-shadow 0.2s ease, transform 0.2s ease}[class*=\"Card\"]:hover,.card:hover{transform:translateY(-2px);border-color:var(--brand-light)!important;box-shadow:0 4px 20px var(--brand-glow)!important}a:not([class*=\"Card\"]):hover{color:var(--brand-primary)!important}.stable-scrollbar-gutter.overflow-auto{width:220px!important;min-width:220px!important}.stable-scrollbar-gutter.overflow-auto+div,.stable-scrollbar-gutter.overflow-auto~main{flex:1!important}.flex.flex-row-reverse.gap-12{gap:32px!important}.xl\\:flex.self-start.sticky{max-width:15rem!important}.xl\\:flex.box-border.max-h-full.pl-10{width:14rem!important;padding-left:24px!important}.text-sm.leading-6.w-\\[16\\.5rem\\]{width:100%!important;font-size:13px!important;line-height:1.6!important}#table-of-contents-content a{padding:5px 0!important;display:block}#table-of-contents-content,#table-of-contents-content ul{list-style:none!important;padding-left:0!important;margin-left:0!important}#table-of-contents-content li::marker{content:\"\"!important}#table-of-contents-content>li{border-left:2px solid rgba(148, 163, 184, 0.1);padding-left:12px;transition:border-color 0.15s ease}.dark #table-of-contents-content>li{border-left-color:rgba(148, 163, 184, 0.08)}#table-of-contents-content a{color:var(--page-muted)!important;font-weight:400!important;transition:color 0.15s ease}.dark #table-of-contents-content a{color:#94a3b8!important}#table-of-contents-content>li>a{color:var(--page-text)!important;font-weight:500!important}.dark #table-of-contents-content>li>a{color:#e2e8f0!important}#table-of-contents-content>li>ul{padding-left:12px!important}#table-of-contents-content a:hover{color:var(--brand-dark)!important}.dark #table-of-contents-content a:hover{color:#e2e8f0!important}#table-of-contents-content a.text-primary,#table-of-contents-content a.font-semibold,#table-of-contents-content>li.is-active-item>a{color:var(--brand-primary)!important;font-weight:600!important}.dark #table-of-contents-content a.text-primary,.dark #table-of-contents-content a.font-semibold,.dark #table-of-contents-content a[class*=\"dark:text-primary\"],.dark #table-of-contents-content>li.is-active-item>a{color:var(--brand-light)!important;font-weight:600!important}#table-of-contents-content>li.is-active-item{border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li.is-active-item{border-left-color:var(--brand-light)!important}#table-of-contents-content>li:has(>a.border-primary),#table-of-contents-content>li:has(>a.text-primary){border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li:has(>a.border-primary),.dark #table-of-contents-content>li:has(>a.text-primary),.dark #table-of-contents-content>li:has(>a[class*=\"dark:text-primary\"]),.dark #table-of-contents-content>li:has(>a[class*=\"dark:border-primary\"]){border-left-color:var(--brand-light)!important}.landing-hero{text-align:center;padding:72px 32px 24px;max-width:860px;margin:0 auto}.landing-hero h1{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:52px;font-weight:700;letter-spacing:-0.03em;margin:0 0 20px;background:linear-gradient(135deg, var(--brand-dark), var(--brand-primary), var(--brand-light));-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text}.dark .landing-hero h1{background:linear-gradient(135deg, var(--brand-light), #a78bfa, #c4b5fd);-webkit-background-clip:text;background-clip:text}.landing-hero p{font-size:19px;line-height:1.7;color:var(--page-muted);margin:0}.dark .landing-hero p{color:#94a3b8}.landing-section{max-width:1280px;margin:0 auto;padding:0 40px 56px}.landing-section h2{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:26px;font-weight:600;letter-spacing:-0.015em;margin:0 0 6px;color:var(--page-text)}.dark .landing-section h2{color:#e2e8f0}.landing-section>p{color:var(--page-muted);font-size:16px;margin:0 0 24px}.dark .landing-section>p{color:#94a3b8}.landing-cta{max-width:1280px;margin:0 auto;padding:0 40px 48px}.landing-divider{max-width:1280px;margin:0 auto 48px;padding:0 40px}.landing-divider hr{border:0;height:1px;background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.3), transparent);margin:0}.dark .landing-divider hr{background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.15), transparent)}.landing-section [role=\"tablist\"]{margin-bottom:12px}.landing-section [role=\"tabpanel\"]>p:first-child{color:var(--page-muted);font-size:15px;margin-bottom:20px}.dark .landing-section [role=\"tabpanel\"]>p:first-child{color:#94a3b8}.group:has(>.mermaid){background:linear-gradient(135deg, #faf8ff 0%, #f3f0ff 100%);border:1px solid rgba(95, 34, 208, 0.08);border-radius:12px;padding:28px 24px;margin:24px 0}.dark .group:has(>.mermaid){background:linear-gradient(135deg, rgba(95, 34, 208, 0.06) 0%, rgba(95, 34, 208, 0.03) 100%);border-color:rgba(124, 58, 237, 0.12)}.mermaid svg .node rect,.mermaid svg .node circle,.mermaid svg .node ellipse,.mermaid svg .node polygon,.mermaid svg .node path{fill:#ede9fe!important;stroke:#7c3aed!important;stroke-width:1.5px!important;rx:8px}.dark .mermaid svg .node rect,.dark .mermaid svg .node circle,.dark .mermaid svg .node ellipse,.dark .mermaid svg .node polygon,.dark .mermaid svg .node path{fill:rgba(124, 58, 237, 0.15)!important;stroke:#a78bfa!important}.mermaid svg .node.rhombus rect,.mermaid svg .node polygon[points]{fill:#ddd6fe!important;stroke:#6d28d9!important}.dark .mermaid svg .node.rhombus rect,.dark .mermaid svg .node polygon[points]{fill:rgba(109, 40, 217, 0.2)!important;stroke:#a78bfa!important}.mermaid svg .cluster rect{fill:rgba(237, 233, 254, 0.4)!important;stroke:rgba(124, 58, 237, 0.25)!important;stroke-width:1.5px!important;rx:10px!important}.dark .mermaid svg .cluster rect{fill:rgba(124, 58, 237, 0.08)!important;stroke:rgba(167, 139, 250, 0.2)!important}.mermaid svg .cluster-label .nodeLabel,.mermaid svg .cluster span{fill:var(--brand-dark)!important;color:var(--brand-dark)!important;font-weight:600!important}.dark .mermaid svg .cluster-label .nodeLabel,.dark .mermaid svg .cluster span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg .edgePath path.path{stroke:#8b5cf6!important;stroke-width:1.5px!important}.dark .mermaid svg .edgePath path.path{stroke:#a78bfa!important}.mermaid svg .marker{fill:#8b5cf6!important;stroke:#8b5cf6!important}.dark .mermaid svg .marker{fill:#a78bfa!important;stroke:#a78bfa!important}.mermaid svg .label,.mermaid svg .nodeLabel,.mermaid svg .label text,.mermaid svg span{fill:#1e1b4b!important;color:#1e1b4b!important;font-family:\"DM Sans\", sans-serif!important}.dark .mermaid svg .label,.dark .mermaid svg .nodeLabel,.dark .mermaid svg .label text,.dark .mermaid svg span{fill:#e2e8f0!important;color:#e2e8f0!important}.mermaid svg .edgeLabel{background-color:#faf8ff!important}.dark .mermaid svg .edgeLabel{background-color:transparent!important}.mermaid svg .edgeLabel span{fill:#6d28d9!important;color:#6d28d9!important;font-size:13px!important}.dark .mermaid svg .edgeLabel span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg{background:transparent!important}#localization-select-trigger>div:first-child{display:none!important}[data-relocated-lang]{gap:0!important}::selection{background:var(--brand-subtle);color:var(--brand-dark)}.dark ::selection{background:var(--brand-dark);color:#ffffff}*:focus-visible{outline-color:var(--brand-primary)!important}::-webkit-scrollbar-thumb{background:var(--brand-light);border-radius:4px}::-webkit-scrollbar-thumb:hover{background:var(--brand-primary)}.cloo-badge{display:inline-block;font-family:\"DM Sans\", sans-serif;font-size:12px;font-weight:600;line-height:1.5;padding:0 8px;border-radius:6px;letter-spacing:-0.01em;vertical-align:middle;white-space:nowrap;margin-right:2px}.cloo-badge--required{background:#fef2f2;color:#b91c1c}.cloo-badge--multiworker{background:#fff7ed;color:#c2410c}.cloo-badge--recommended{background:#eff6ff;color:#1d4ed8}.cloo-badge--optional{background:#f1f5f9;color:#475569}.dark .cloo-badge--required{background:rgba(185, 28, 28, 0.2);color:#fca5a5}.dark .cloo-badge--multiworker{background:rgba(194, 65, 12, 0.2);color:#fdba74}.dark .cloo-badge--recommended{background:rgba(29, 78, 216, 0.22);color:#93c5fd}.dark .cloo-badge--optional{background:rgba(71, 85, 105, 0.28);color:#cbd5e1}"}]}
{"page":{"pagePath":"en/admin/organizations","slug":"/en/admin/organizations","pageMetadata":{"title":"Organization Management","description":"Manage organizational structure, sync with Microsoft Entra ID, and use OU-based access control","href":"/en/admin/organizations"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Manage organizational structure, sync with Microsoft Entra ID, and use OU-based access control\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,Card,CodeBlock,Columns,Frame,Heading,Icon,Info,Mermaid,Note,OptimizedImage,Step,Steps,Tab,Table,Tabs,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Icon)_missingMdxReference(`Icon`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:`Admin › Users › Organizations`}),`\n`,_jsx(_components.p,{children:`Organization management reflects your company’s department structure in Cloosphere to systematically control resource access.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Sync with Microsoft Entra ID (Azure AD), Keycloak, or Google Workspace, or build the org structure directly via JSON Import.`}),`\n`]}),`\n`,_jsx(Frame,{caption:`Organization management screen`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Or1RjU_AzOVJRxuS/images/admin/orgs-main.png?fit=max\u0026auto=format\u0026n=Or1RjU_AzOVJRxuS\u0026q=85\u0026s=d5534b08f5800a4d679bc3b7ab98d5fe`,alt:`Organization management screen`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/admin/orgs-main.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Or1RjU_AzOVJRxuS/images/admin/orgs-main.png?w=280\u0026fit=max\u0026auto=format\u0026n=Or1RjU_AzOVJRxuS\u0026q=85\u0026s=f480f900ada0bbeb6e6a48fbc8d6e0eb 280w, https://mintcdn.com/cloocus/Or1RjU_AzOVJRxuS/images/admin/orgs-main.png?w=560\u0026fit=max\u0026auto=format\u0026n=Or1RjU_AzOVJRxuS\u0026q=85\u0026s=44f3bfa7d254cbc96b7fd1429940c2c9 560w, https://mintcdn.com/cloocus/Or1RjU_AzOVJRxuS/images/admin/orgs-main.png?w=840\u0026fit=max\u0026auto=format\u0026n=Or1RjU_AzOVJRxuS\u0026q=85\u0026s=846c4163ffa739c531c5c280145c8f67 840w, https://mintcdn.com/cloocus/Or1RjU_AzOVJRxuS/images/admin/orgs-main.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Or1RjU_AzOVJRxuS\u0026q=85\u0026s=c882fea05f16d2acdd99f94e60898814 1100w, https://mintcdn.com/cloocus/Or1RjU_AzOVJRxuS/images/admin/orgs-main.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Or1RjU_AzOVJRxuS\u0026q=85\u0026s=a02554b5f79bce27c35516314790332b 1650w, https://mintcdn.com/cloocus/Or1RjU_AzOVJRxuS/images/admin/orgs-main.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Or1RjU_AzOVJRxuS\u0026q=85\u0026s=4f89acdf5eb98687ae5aa71a1931ba71 2500w`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`organizational-hierarchy`,children:`Organizational Hierarchy`}),`\n`,_jsx(_components.p,{children:`Cloosphere’s organization system consists of hierarchical Organizations and Organizational Units.`}),`\n`,_jsx(Mermaid,{chart:`flowchart TD\n A[Organization] --> B[Organizational Unit OU - Level 0]\n B --> C[Organizational Unit OU - Level 1]\n B --> D[Organizational Unit OU - Level 1]\n C --> E[Organizational Unit OU - Level 2]\n C --> F[Organizational Unit OU - Level 2]\n\n A -.- A1[\"tenant_id, domain\"]\n B -.- B1[\"type: department\"]\n C -.- C1[\"type: department\"]\n E -.- E1[\"member_ids: user list\"]`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Concept`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Example`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Organization`})}),_jsx(_components.td,{children:`Top-level entity. Identified by tenant ID and domain`}),_jsx(_components.td,{children:`”Cloocus Inc.”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Organizational Unit (OU)`})}),_jsx(_components.td,{children:`Sub-units like departments, teams. Hierarchically nestable`}),_jsx(_components.td,{children:`”Engineering > Backend Team”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Members`})}),_jsx(_components.td,{children:`List of users belonging to an OU`}),_jsx(_components.td,{children:`user_id array`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`organizational-unit-types`,children:`Organizational Unit Types`}),`\n`,_jsxs(_components.p,{children:[`OUs distinguish purpose via the `,_jsx(_components.code,{children:`type`}),` field.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`department`})}),_jsx(_components.td,{children:`Department (division-level upper organization)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`team`})}),_jsx(_components.td,{children:`Team (working-unit organization)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`group`})}),_jsx(_components.td,{children:`Group (functional unit, e.g., project team)`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`In the current production environment, most observed organizational units are of type `,_jsx(_components.code,{children:`department`}),`.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`organizations-vs-groups`,children:`Organizations vs Groups`}),`\n`,_jsxs(_components.p,{children:[`Cloosphere offers two user grouping mechanisms — `,_jsx(_components.strong,{children:`groups`}),` and `,_jsx(_components.strong,{children:`organizations`}),`. Use them appropriately by purpose.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Aspect`}),_jsx(_components.th,{children:`Group`}),_jsx(_components.th,{children:`Organization`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Purpose`})}),_jsx(_components.td,{children:`Permission management`}),_jsx(_components.td,{children:`Reflect organizational structure`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Structure`})}),_jsx(_components.td,{children:`Flat (no hierarchy)`}),_jsx(_components.td,{children:`Tree (hierarchical)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Permission setup`})}),_jsx(_components.td,{children:`Permissions assigned directly to the group`}),_jsx(_components.td,{children:`Specify OU in resource’s access_control`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`External integration`})}),_jsx(_components.td,{children:`Manual management`}),_jsx(_components.td,{children:`Auto-sync with Entra ID`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Use case`})}),_jsx(_components.td,{children:`”Grant agent creation permission\"`}),_jsx(_components.td,{children:`\"HR team only accesses HR Policy KB”`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Use groups for `,_jsx(_components.strong,{children:`permission control`}),` (what they can do) and organizations for `,_jsx(_components.strong,{children:`access control`}),` (what they can see). The two systems can be used together.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`creating-organizations`,children:`Creating Organizations`}),`\n`,_jsxs(_components.p,{children:[`Organizations and OUs are created `,_jsx(_components.strong,{children:`only via sync`}),`.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`There’s no UI to create them manually.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`Supported sync methods:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Method`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Microsoft Graph`})}),_jsx(_components.td,{children:`Auto-sync organizational structure from Entra ID (Azure AD)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Keycloak`})}),_jsx(_components.td,{children:`Sync from Keycloak groups/organizations`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Google Workspace`})}),_jsx(_components.td,{children:`Sync from Google Workspace directory`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`JSON Import`})}),_jsx(_components.td,{children:`Upload JSON data to construct the org structure`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`#microsoft-entra-id-sync`,children:`Microsoft Entra ID Sync`}),` and `,_jsx(_components.a,{href:`#json-import`,children:`JSON Import`}),` below for details.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`microsoft-entra-id-sync`,children:`Microsoft Entra ID Sync`}),`\n`,_jsx(_components.p,{children:`Sync organizational structure automatically with Microsoft Entra ID (Azure AD).`}),`\n`,_jsx(Mermaid,{chart:`flowchart LR\n A[Microsoft Entra ID] -->|MS Graph API| B[Cloosphere]\n B --> C[Create/update organization]\n B --> D[Construct OU tree]\n B --> E[Map members]`}),`\n`,_jsx(Heading,{level:`3`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Microsoft OAuth setup is required for Entra ID sync. Set the following environment variables on the server.`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Environment Variable`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`MICROSOFT_CLIENT_ID`})}),_jsx(_components.td,{children:`Azure App Registration’s Client ID`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`MICROSOFT_CLIENT_SECRET`})}),_jsx(_components.td,{children:`Client Secret`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`MICROSOFT_CLIENT_TENANT_ID`})}),_jsx(_components.td,{children:`Azure AD Tenant ID`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`running-sync`,children:`Running Sync`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open the sync dialog`,children:_jsxs(_components.p,{children:[`Click the `,_jsx(_components.strong,{children:`sync button`}),` (`,_jsx(Icon,{icon:`arrows-rotate`,iconType:`solid`}),`) next to the search box at the top-right of the organization list to open the `,_jsx(_components.strong,{children:`Organization Sync`}),` dialog.`]})}),_jsxs(Step,{title:`Pick a data source`,children:[_jsxs(_components.p,{children:[`In the `,_jsx(_components.strong,{children:`Data Source`}),` dropdown, pick the sync method — JSON Import (default) · Microsoft Graph · Keycloak · Google Workspace. For Entra ID integration, pick `,_jsx(_components.strong,{children:`Microsoft Graph`}),`.`]}),_jsx(_components.p,{children:`When Microsoft Graph is selected, choose which items to fetch.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Option`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Administrative Units`})}),_jsx(_components.td,{children:`Entra ID’s org management feature; suited to hierarchies`}),_jsx(_components.td,{style:{textAlign:`center`},children:`ON`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Security Groups`})}),_jsx(_components.td,{children:`Use security groups as organizational units; filter with OData query`}),_jsx(_components.td,{style:{textAlign:`center`},children:`OFF`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Departments`})}),_jsx(_components.td,{children:`Auto-extract department names from user profiles`}),_jsx(_components.td,{style:{textAlign:`center`},children:`OFF`})]})]})]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Group Filter`}),` box appears only while `,_jsx(_components.strong,{children:`Security Groups`}),` is on. Enter an OData filter expression to import specific groups only (optional).`]})}),_jsx(Frame,{caption:`Sync options when Data Source = Microsoft Graph`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/admin/orgs-sync-msgraph.png?fit=max\u0026auto=format\u0026n=Jjr6o_i720oXQtQO\u0026q=85\u0026s=4681a4f722955b86dbc63d2b843194b1`,alt:`Microsoft Graph sync options`,style:{maxWidth:`480px`},\"data-og-width\":`1024`,width:`1024`,\"data-og-height\":`992`,height:`992`,\"data-path\":`images/admin/orgs-sync-msgraph.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/admin/orgs-sync-msgraph.png?w=280\u0026fit=max\u0026auto=format\u0026n=Jjr6o_i720oXQtQO\u0026q=85\u0026s=1c7ef61eb518154e78b558c3bffb6edf 280w, https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/admin/orgs-sync-msgraph.png?w=560\u0026fit=max\u0026auto=format\u0026n=Jjr6o_i720oXQtQO\u0026q=85\u0026s=6b7484b1fa29d8744f559d4edd26c603 560w, https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/admin/orgs-sync-msgraph.png?w=840\u0026fit=max\u0026auto=format\u0026n=Jjr6o_i720oXQtQO\u0026q=85\u0026s=a984c0472d9f8f402b25e746b2a7c2b6 840w, https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/admin/orgs-sync-msgraph.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Jjr6o_i720oXQtQO\u0026q=85\u0026s=66c31f5cee156cfea6cf8574c60de08b 1100w, https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/admin/orgs-sync-msgraph.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Jjr6o_i720oXQtQO\u0026q=85\u0026s=15b63de5d9fbfe98a314b3833997e8e8 1650w, https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/admin/orgs-sync-msgraph.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Jjr6o_i720oXQtQO\u0026q=85\u0026s=a4468969d355e02aaaf3deeff69069e4 2500w`})})]}),_jsxs(Step,{title:`Run sync`,children:[_jsxs(_components.p,{children:[`Click the `,_jsx(_components.strong,{children:`Sync`}),` button at the bottom of the dialog.`]}),_jsx(Frame,{caption:`Organization Sync dialog — data source selection (default: JSON Import)`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/admin/orgs-sync-modal.png?fit=max\u0026auto=format\u0026n=Jjr6o_i720oXQtQO\u0026q=85\u0026s=79ee1e9aca45dd64a7067ebc8c766cdf`,alt:`Organization Sync dialog`,style:{maxWidth:`480px`},\"data-og-width\":`1526`,width:`1526`,\"data-og-height\":`1379`,height:`1379`,\"data-path\":`images/admin/orgs-sync-modal.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/admin/orgs-sync-modal.png?w=280\u0026fit=max\u0026auto=format\u0026n=Jjr6o_i720oXQtQO\u0026q=85\u0026s=90e194da7269ff7e45a80197301f0755 280w, https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/admin/orgs-sync-modal.png?w=560\u0026fit=max\u0026auto=format\u0026n=Jjr6o_i720oXQtQO\u0026q=85\u0026s=db96d20e9cfef48ba5dd438a1d4ba682 560w, https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/admin/orgs-sync-modal.png?w=840\u0026fit=max\u0026auto=format\u0026n=Jjr6o_i720oXQtQO\u0026q=85\u0026s=df5a7906d232cb07c3031eadc9594d31 840w, https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/admin/orgs-sync-modal.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Jjr6o_i720oXQtQO\u0026q=85\u0026s=62a4587318c8ee0c7be504ca2745f112 1100w, https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/admin/orgs-sync-modal.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Jjr6o_i720oXQtQO\u0026q=85\u0026s=6ba7ae0e733a63ff2dca9fef86ea818e 1650w, https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/admin/orgs-sync-modal.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Jjr6o_i720oXQtQO\u0026q=85\u0026s=49ddc541adf8e90052d5f945313cd652 2500w`})})]}),_jsx(Step,{title:`Verify results`,children:_jsxs(_components.p,{children:[`Verify the synced OU tree and member mapping. On success the dialog reports counts as `,_jsx(_components.code,{children:`Synced N organization(s), M unit(s)`}),`; if nothing was found, it suggests enabling different options.`]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`options-for-the-other-data-sources`,children:`Options for the other data sources`}),`\n`,_jsxs(_components.p,{children:[`Switching `,_jsx(_components.strong,{children:`Data Source`}),` to Keycloak or Google Workspace changes the option set as well.`]}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Keycloak`,id:`keycloak`,children:[_jsxs(_components.p,{children:[`The server URL and credentials are not entered on screen — they come from the `,_jsx(_components.code,{children:`OPENID_PROVIDER_URL`}),` · `,_jsx(_components.code,{children:`OAUTH_CLIENT_ID`}),` · `,_jsx(_components.code,{children:`OAUTH_CLIENT_SECRET`}),` environment variables.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Option`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Groups`})}),_jsx(_components.td,{children:`Sync the Keycloak group hierarchy as organizational units`}),_jsx(_components.td,{style:{textAlign:`center`},children:`ON`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Organizations (v26+)`})}),_jsx(_components.td,{children:`Use the Keycloak Organizations feature (requires Keycloak 26 or later)`}),_jsx(_components.td,{style:{textAlign:`center`},children:`OFF`})]})]})]})]}),_jsx(Tab,{title:`Google Workspace`,id:`google-workspace`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Option`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Organizational units (OU)`})}),_jsx(_components.td,{children:`Import the Google Workspace OU hierarchy`}),_jsx(_components.td,{style:{textAlign:`center`},children:`ON`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Groups`})}),_jsx(_components.td,{children:`Import Google Groups as organizational units`}),_jsx(_components.td,{style:{textAlign:`center`},children:`OFF`})]})]})]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`json-import`,children:`JSON Import`}),`\n`,_jsx(_components.p,{children:`In environments without Entra ID, import the org structure via JSON data directly.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`18`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`18`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"organization\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"tenant_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"my-company\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"My Company\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"domain\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"mycompany.com\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"units\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"dept-1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Engineering\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"department\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"children\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"team-1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Backend Team\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"team\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"team-2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Frontend Team\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"team\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`organization-based-access-control`,children:`Organization-based Access Control`}),`\n`,_jsx(_components.p,{children:`Use OUs to control resource (agents, KBs, databases, etc.) access scope.`}),`\n`,_jsx(Heading,{level:`3`,id:`setting-ou-permissions-on-resources`,children:`Setting OU Permissions on Resources`}),`\n`,_jsxs(_components.p,{children:[`In each workspace resource’s `,_jsx(_components.strong,{children:`Access`}),` settings, specify the OU.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Access Level`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Read`})}),_jsx(_components.td,{children:`OU members can view/use the resource`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Write`})}),_jsx(_components.td,{children:`OU members can edit the resource`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`permission-inheritance`,children:`Permission Inheritance`}),`\n`,_jsx(_components.p,{children:`Permissions granted to upper OUs are inherited by lower OUs.`}),`\n`,_jsx(Mermaid,{chart:`flowchart TD\n A[\"Engineering (Read permission)\"] --> B[\"Backend Team (inherited)\"]\n A --> C[\"Frontend Team (inherited)\"]\n B --> D[\"Backend Team members: can access\"]\n C --> E[\"Frontend Team members: can access\"]`}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`When resource access is set on an upper OU, all members of lower OUs automatically receive the same permission.`})}),`\n`,_jsx(Heading,{level:`3`,id:`example-use`,children:`Example Use`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Resource`}),_jsx(_components.th,{children:`Access Control`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`HR Policy KB`})}),_jsx(_components.td,{children:`HR Team OU (Read)`}),_jsx(_components.td,{children:`Only HR team can view HR policy`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Sales Agent`})}),_jsx(_components.td,{children:`Sales Division OU (Read)`}),_jsx(_components.td,{children:`Entire Sales department can use`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Sales DB`})}),_jsx(_components.td,{children:`Operations Division OU (Read)`}),_jsx(_components.td,{children:`Only Operations department queries sales data`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Company-wide Notice KB`})}),_jsx(_components.td,{children:`Top-level OU (Read)`}),_jsx(_components.td,{children:`Entire organization can access`})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`viewing-the-ou-list`,children:`Viewing the OU List`}),`\n`,_jsx(_components.p,{children:`Selecting an organization expands its organizational units below, in hierarchy order.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Element`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Indentation`})}),_jsx(_components.td,{children:`Mirrors hierarchy depth — the deeper the OU, the further right it sits`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Type badge`})}),_jsxs(_components.td,{children:[`Grey badge to the right of the name (`,_jsx(_components.code,{children:`department`}),` · `,_jsx(_components.code,{children:`team`}),` · `,_jsx(_components.code,{children:`group`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Member-count button`})}),_jsx(_components.td,{children:`People icon + number. Click it to open that OU’s member list`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Type tabs`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`All / Department / Team / Group`}),` tabs appear above the list only when two or more types exist`]})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The member list shows both members mapped by IdP sync and users auto-assigned via OAuth login; members without a Cloosphere account yet are marked `,_jsx(_components.code,{children:`Not registered`}),`.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`per-organization-usage-limits`,children:`Per-Organization Usage Limits`}),`\n`,_jsxs(_components.p,{children:[`Per-OU token caps are managed under `,_jsx(_components.strong,{children:`Admin > Settings > Models`}),`, not on the Organizations screen. They are set `,_jsx(_components.strong,{children:`per model`}),` — there is no single cap that applies to an OU as a whole.`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Turn usage limits on`,children:_jsxs(_components.p,{children:[`Under Admin > Settings > `,_jsx(_components.strong,{children:`Models`}),`, click the `,_jsx(_components.strong,{children:`Token Limit`}),` button at the top to open the `,_jsx(_components.code,{children:`Token Limit Management`}),` dialog. Turn on `,_jsx(_components.strong,{children:`Enable Usage Limit`}),`, and optionally set the `,_jsx(_components.strong,{children:`default daily token limit`}),` and the `,_jsx(_components.strong,{children:`action on exceeding`}),` (Warn / Block).`]})}),_jsx(Step,{title:`Expand a model`,children:_jsxs(_components.p,{children:[`Once usage limits are on, each model row becomes expandable. Expanding shows that model’s `,_jsx(_components.strong,{children:`base limit`}),` along with three override cards.`]})}),_jsx(Step,{title:`Set the org unit override`,children:_jsxs(_components.p,{children:[`Among `,_jsx(_components.strong,{children:`User overrides · Group overrides · Org unit overrides`}),`, open `,_jsx(_components.strong,{children:`Org unit overrides`}),` and set per-OU caps. The number on each card is the count of overrides currently registered.`]})})]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Empty`})}),_jsx(_components.td,{children:`Inherit — decided by a higher layer`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.strong,{children:`0`})}),_jsx(_components.td,{children:`Explicitly unlimited`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Positive number`})}),_jsx(_components.td,{children:`Daily token cap`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Usage limits can be set at four layers — global, user, group, and organizational unit. When several layers carry a value, the `,_jsx(_components.strong,{children:`most permissive (highest)`}),` one applies, and if any layer is `,_jsx(_components.code,{children:`0`}),` (unlimited) that wins immediately. Overrides are designed to `,_jsx(_components.strong,{children:`raise`}),` a cap, so you cannot shrink a higher-layer cap by entering a smaller value at a lower layer.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`per-ou-guardrails`,children:`Per-OU Guardrails`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`A screen for attaching guardrails directly to an organizational unit is `,_jsx(_components.strong,{children:`not available in the current release.`}),` OU rows carry only the member-count button.`]})}),`\n`,_jsx(_components.p,{children:`Apply guardrails through these paths instead.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Target`}),_jsx(_components.th,{children:`Where to configure`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Per group`})}),_jsxs(_components.td,{children:[`Admin > Users > Groups \u0026 Permissions > edit a group > `,_jsx(_components.code,{children:`Chat Guardrail`}),` on the `,_jsx(_components.strong,{children:`General`}),` tab`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Per agent`})}),_jsx(_components.td,{children:`Workspace > Agents > that agent’s guardrail settings`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Global (AI coding tools)`})}),_jsxs(_components.td,{children:[`The `,_jsx(_components.code,{children:`Security`}),` section of `,_jsx(_components.a,{href:`/en/admin/code-gateway`,children:`Admin > Settings > Code Gateway`})]})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`If you need guardrails at department granularity, map the OU to a group (see `,_jsx(_components.a,{href:`/en/admin/groups#group--organizational-unit-mapping`,children:`Group ↔ OU Mapping`}),`) and set the chat guardrail on that `,_jsx(_components.strong,{children:`group`}),` — that is the route available today.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`deleting-an-organization`,children:`Deleting an Organization`}),`\n`,_jsxs(_components.p,{children:[`The bottom of the Organizations screen has a `,_jsx(_components.strong,{children:`Delete Organization`}),` area.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Deleting removes `,_jsx(_components.strong,{children:`the organization and every organizational unit under it, permanently`}),`. This cannot be undone. Confirm the organization name in the dialog before proceeding. Member associations are removed as well — user accounts themselves are not deleted.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`sync-provider-list`,children:`Sync Provider List`}),`\n`,_jsx(_components.p,{children:`The four currently supported sync providers:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Provider`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Requirements`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`JSON Import`})}),_jsx(_components.td,{children:`Direct configuration via JSON data`}),_jsx(_components.td,{children:`None`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Microsoft Graph`})}),_jsx(_components.td,{children:`Auto-sync from Entra ID (Azure AD)`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`MICROSOFT_CLIENT_ID`}),`, `,_jsx(_components.code,{children:`MICROSOFT_CLIENT_SECRET`}),`, `,_jsx(_components.code,{children:`MICROSOFT_CLIENT_TENANT_ID`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Keycloak`})}),_jsx(_components.td,{children:`Sync from Keycloak groups/organizations`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`OPENID_PROVIDER_URL`}),`, `,_jsx(_components.code,{children:`OAUTH_CLIENT_ID`}),`, `,_jsx(_components.code,{children:`OAUTH_CLIENT_SECRET`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Google Workspace`})}),_jsx(_components.td,{children:`Sync from Google Workspace directory`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`GOOGLE_ADMIN_SERVICE_ACCOUNT_KEY`}),`, `,_jsx(_components.code,{children:`GOOGLE_ADMIN_IMPERSONATE_EMAIL`})]})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsx(Accordion,{title:`Organization sync fails`,id:`organization-sync-fails`,children:_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Verify Azure App Registration has `,_jsx(_components.code,{children:`Directory.Read.All`}),` permission.`]}),`\n`,_jsxs(_components.li,{children:[`Verify environment variables `,_jsx(_components.code,{children:`MICROSOFT_CLIENT_ID`}),`, `,_jsx(_components.code,{children:`MICROSOFT_CLIENT_SECRET`}),`, `,_jsx(_components.code,{children:`MICROSOFT_CLIENT_TENANT_ID`}),` are correctly set.`]}),`\n`,_jsx(_components.li,{children:`Check server logs for detailed error messages.`}),`\n`]})}),`\n`,_jsx(Accordion,{title:`Do I need to use both organizations and groups?`,id:`do-i-need-to-use-both-organizations-and-groups`,children:_jsxs(_components.p,{children:[`Not necessarily. `,_jsx(_components.strong,{children:`Permission management`}),` alone is fine with groups. Use organizations additionally when you need `,_jsx(_components.strong,{children:`department-based access control`}),` with Entra ID integration.`]})}),`\n`,_jsx(Accordion,{title:`Are members deleted when I delete an OU?`,id:`are-members-deleted-when-i-delete-an-ou`,children:_jsx(_components.p,{children:`Deleting an OU doesn’t delete the user accounts in it. Only the resource access permissions configured for that OU are removed.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`related-pages`,children:`Related Pages`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`User Management`,icon:`users`,href:`/en/admin/users`,children:_jsx(_components.p,{children:`User list, roles/groups, permission settings`})}),_jsx(Card,{title:`Groups \u0026 Permissions`,icon:`user-shield`,href:`/en/admin/groups`,children:_jsx(_components.p,{children:`Map OUs to groups to apply permissions and chat guardrails`})}),_jsx(Card,{title:`Usage`,icon:`chart-line`,href:`/en/monitoring/usage`,children:_jsx(_components.p,{children:`Usage and cost monitoring by organization and user`})}),_jsx(Card,{title:`Deployment Checklist`,icon:`list-check`,href:`/en/admin/deployment-checklist`,children:_jsx(_components.p,{children:`OIDC environment variables required for Keycloak/Entra sync`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Organization Management","description":"Manage organizational structure, sync with Microsoft Entra ID, and use OU-based access control","href":"/en/admin/organizations"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Organizational Hierarchy","slug":"organizational-hierarchy","depth":2,"children":[{"title":"Organizational Unit Types","slug":"organizational-unit-types","depth":3,"children":[]}]},{"title":"Organizations vs Groups","slug":"organizations-vs-groups","depth":2,"children":[]},{"title":"Creating Organizations","slug":"creating-organizations","depth":2,"children":[]},{"title":"Microsoft Entra ID Sync","slug":"microsoft-entra-id-sync","depth":2,"children":[{"title":"Prerequisites","slug":"prerequisites","depth":3,"children":[]},{"title":"Running Sync","slug":"running-sync","depth":3,"children":[]},{"title":"Options for the other data sources","slug":"options-for-the-other-data-sources","depth":3,"children":[]}]},{"title":"JSON Import","slug":"json-import","depth":2,"children":[]},{"title":"Organization-based Access Control","slug":"organization-based-access-control","depth":2,"children":[{"title":"Setting OU Permissions on Resources","slug":"setting-ou-permissions-on-resources","depth":3,"children":[]},{"title":"Permission Inheritance","slug":"permission-inheritance","depth":3,"children":[]},{"title":"Example Use","slug":"example-use","depth":3,"children":[]}]},{"title":"Viewing the OU List","slug":"viewing-the-ou-list","depth":2,"children":[]},{"title":"Per-Organization Usage Limits","slug":"per-organization-usage-limits","depth":2,"children":[]},{"title":"Per-OU Guardrails","slug":"per-ou-guardrails","depth":2,"children":[]},{"title":"Deleting an Organization","slug":"deleting-an-organization","depth":2,"children":[]},{"title":"Sync Provider List","slug":"sync-provider-list","depth":2,"children":[]},{"title":"FAQ","slug":"faq","depth":2,"children":[]},{"title":"Related Pages","slug":"related-pages","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/cloocus/45db6ee3c57396cb/toc.js","/_mintlify/custom/cloocus/9670a2c81dc38d5e/tools/playwright-video-mcp/index.js","/_mintlify/custom/cloocus/4540e1c308555295/lang-toggle.js"],"subdomain":"cloocus","siteName":"Cloosphere Guide","title":"Organization Management - Cloosphere Guide","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"ko":{"href":"/ko/admin/organizations","matchLevel":1},"en":{"href":"/en/admin/organizations","matchLevel":0}}},"lastModified":"2026-08-26T06:17:14.349Z","originalFileLocation":"en/admin/organizations.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Manage organizational structure, sync with Microsoft Entra ID, and use OU-based access control\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Organization Management - Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:description\" content=\"Manage organizational structure, sync with Microsoft Entra ID, and use OU-based access control\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cloosphere.ai/en/admin/organizations\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=Users\u0026amp;title=Organization+Management\u0026amp;description=Manage+organizational+structure%2C+sync+with+Microsoft+Entra+ID%2C+and+use+OU-based+access+control\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=75af4ef0b51609bbfd18970c4ca104b4ceadd6cee59a87cffe666590b5797d7e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Organization Management - Cloosphere Guide\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Manage organizational structure, sync with Microsoft Entra ID, and use OU-based access control\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=Users\u0026amp;title=Organization+Management\u0026amp;description=Manage+organizational+structure%2C+sync+with+Microsoft+Entra+ID%2C+and+use+OU-based+access+control\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=75af4ef0b51609bbfd18970c4ca104b4ceadd6cee59a87cffe666590b5797d7e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5f22d0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cloosphere.ai/en/admin/organizations\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/admin/organizations.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.cloosphere.ai/en/admin/organizations\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.cloosphere.ai/ko/admin/organizations\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.cloosphere.ai/ko/admin/organizations\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cloosphere.ai/#organization\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cloosphere.ai#website\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cloosphere.ai/en/admin/organizations#webpage\",\"url\":\"https://docs.cloosphere.ai/en/admin/organizations\",\"name\":\"Organization Management\",\"description\":\"Manage organizational structure, sync with Microsoft Entra ID, and use OU-based access control\",\"dateModified\":\"2026-08-26T06:17:14.349Z\",\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cloosphere.ai/en/admin/organizations#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cloosphere.ai/en/admin/organizations#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Users\",\"item\":\"https://docs.cloosphere.ai/en/admin/users\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Organization Management\",\"item\":\"https://docs.cloosphere.ai/en/admin/organizations\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cloosphere.ai/en/admin/organizations#article\",\"headline\":\"Organization Management\",\"name\":\"Organization Management\",\"description\":\"Manage organizational structure, sync with Microsoft Entra ID, and use OU-based access control\",\"url\":\"https://docs.cloosphere.ai/en/admin/organizations\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cloosphere.ai/en/admin/organizations#webpage\"},\"dateModified\":\"2026-08-26T06:17:14.349Z\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cloosphere Guide\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cloosphere Guide\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/en/admin/organizations.md","siteName":"Cloosphere Guide","nav":{"global":null,"languages":[{"language":"ko","default":true,"pages":[{"title":"ko","href":"/ko/admin/organizations"}]},{"language":"en","tabs":[{"tab":"Getting Started","icon":"rocket","pages":[{"title":"Getting Started","href":"/en"}]},{"tab":"Chat","icon":"comments","pages":[{"title":"Chat","href":"/en/chat/overview"}]},{"tab":"Workspace","icon":"briefcase","pages":[{"title":"Workspace","href":"/en/workspace/overview"}]},{"tab":"Collaboration","icon":"users","pages":[{"title":"Collaboration","href":"/en/collaboration/overview"}]},{"tab":"Automation","icon":"clock","pages":[{"title":"Automation","href":"/en/automation/overview"}]},{"tab":"Admin","icon":"gear","groups":[{"group":"Admin","pages":[{"title":"Admin Panel","href":"/en/admin/overview"}]},{"group":"Users","pages":[{"title":"User Management","href":"/en/admin/users"},{"title":"Groups \u0026 Permissions","description":"Create permission groups, 3-level permission tiers, default permissions, and OU mapping","href":"/en/admin/groups"},{"title":"Organization Management","href":"/en/admin/organizations"},{"title":"Inquiries","description":"Receive user inquiries, handle via Kanban/list, and manage status flow","href":"/en/admin/inquiries"}]},{"group":"Settings","pages":[{"group":"General \u0026 Connections","expanded":false,"pages":[{"title":"General","href":"/en/admin/settings/general"},{"title":"Connections","href":"/en/admin/settings/connections"},{"title":"Models","href":"/en/admin/settings/models"},{"title":"Marketplace","href":"/en/admin/settings/marketplace"}]},{"group":"Knowledge \u0026 Documents","expanded":false,"pages":[{"title":"Documents","href":"/en/admin/settings/documents"},{"title":"Document Templates","href":"/en/admin/settings/document-templates"},{"title":"Search Engine","href":"/en/admin/settings/search-engine"},{"title":"Web Search","href":"/en/admin/settings/web-search"}]},{"group":"AI Features \u0026 Safety","expanded":false,"pages":[{"title":"Guardrails","href":"/en/admin/settings/guardrails"},{"title":"Code Execution","href":"/en/admin/settings/code-execution"},{"title":"Code Gateway","href":"/en/admin/code-gateway"},{"title":"Audio","href":"/en/admin/settings/audio"},{"title":"Images","href":"/en/admin/settings/images"}]},{"group":"UI \u0026 Channels","expanded":false,"pages":[{"title":"Interface","href":"/en/admin/settings/interface"},{"title":"Branding","href":"/en/admin/settings/branding"},{"title":"Channels","href":"/en/admin/notifications"},{"title":"Microsoft Teams Bot","href":"/en/admin/teams-bot"},{"title":"Embed Widgets","href":"/en/admin/settings/embed-widgets"}]},{"group":"Data \u0026 Operations","expanded":false,"pages":[{"title":"Data Retention","href":"/en/admin/settings/data-retention"},{"title":"Memory","href":"/en/admin/settings/memory"},{"title":"Monitoring","href":"/en/admin/settings/monitoring"},{"title":"Database","href":"/en/admin/settings/database"},{"title":"Encryption","href":"/en/admin/settings/encryption"},{"title":"License","href":"/en/admin/settings/license"}]}]}]},{"tab":"Monitoring","icon":"chart-line","pages":[{"title":"Monitoring","href":"/en/monitoring/overview"}]},{"tab":"Resources","icon":"screwdriver-wrench","pages":[{"title":"Resources","href":"/en/admin/deployment-checklist"}]}]}]},"basePath":"","title":"Organization Management - Cloosphere Guide","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-D0FT0qQs.js","DynamicMarkdown-CQM9Bhbv.js","zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js"]}