Manage customer workspaces in the Workspace Center: pre-onboard customers, monitor health, configure modules, grant consent, and set Gamebook approvers.
The Workspace Center is your administrative control panel for every customer workspace. Monitor active workspaces at a glance, pre-onboard new customers, and drill into per-workspace settings.
Workspaces represent individual customer tenants in ContraForce. Each workspace has its own data, configurations, modules, and user permissions.
What Can You Do Here?
Pre-Onboard Customers
Create workspace placeholders before customer admins complete their setup
Manage Configurations
Edit module settings, integrations, and access from the per-workspace settings page
Monitor Health
See which workspaces are healthy, need attention, or are still onboarding
Control Permissions
Manage module consents and workspace-level access
Accessing the Workspace Center
1
Locate the Workspaces icon
Find the Workspaces icon in the left navigation bar
2
Open the page
Click the icon to open the Workspace Center
Page Layout: Tabs and KPI Cards
The Workspace Center has a set of tabs and a row of rollup KPI cards.
Workspace Center overview
Rollup KPI cards
The cards at the top of the page show counts at a glance and are clickable shortcuts.
Card
What it shows
What clicking does
Workspaces connected
Active customer workspaces in a healthy state
Switches to the Workspaces tab with the All filter
Need attention
Active workspaces that have a missing module or undeployed agent
Switches to the Workspaces tab with the Needs attention filter
Active customer workspaces. Search, filter by health, and click a card to open its settings page
Onboarding
Pre-onboarded workspaces awaiting customer admin setup. Add a new workspace from here, or click an existing card to see its onboarding progress
Profiles
Reusable Workspace Profiles that apply the same access, module, notification, Gamebook, and agent settings to every attached workspace. Available to Organizational Admins on service provider accounts
SLA
SLA configurations that set response and resolution targets for the workspaces you assign. See SLA Tracking
Workspace Cards
Each workspace renders as a card. Click any card to open its settings page (no gear or equalizer button needed).
Workspace card anatomy
What’s on a card
Element
Description
Status light (top-right corner)
Green: healthy. Amber: needs attention. Blue: pre-onboarded. Hidden on the service provider’s own workspace
Workspace name
The customer’s friendly name
Tenant ID
The customer’s Microsoft Entra tenant ID, in muted text below the name
Inline chip
”Your workspace” on the service provider’s own card; “Service provider” if the row represents the MSP itself with no monitoring on it
Modules pill
Visible on the Workspaces tab. Healthy when at least one detection module is configured
Agent pill
Visible on the Workspaces tab. Healthy when an Agent Center is deployed
Health pills only appear on the Workspaces tab. The Onboarding tab uses the blue pre-onboarded status light instead, since health checks are not meaningful until the customer admin completes their onboarding.
Search and Filter
Both tabs include a Search by workspace name field that filters cards as you type.The Workspaces tab also has filter chips:
Filter
Description
All
Every active workspace, regardless of health
Needs attention
Active workspaces with a missing detection module or no deployed Agent Center
Healthy
Active workspaces with both a detection module and an Agent Center deployed
The Onboarding tab does not have filter chips. Use search to narrow the list when you have many pre-onboarded workspaces.
Press Ctrl + K to open Quick Actions, then type part of a workspace name to jump straight to its settings, modules, or notifications.
Opening Workspace Details
Click any card to open the workspace’s settings page.
Workspace settings page after clicking a card
The settings page includes these areas:
General
Account Information and Service Provider Information: account identifiers, points of contact, account ID, account type, and subscription information
Allow Service Providers to Run Gamebooks: manage the team members responsible for approving Gamebooks that require manual authorization. Only users with the Workspace Owner role can be assigned as Gamebook Approvers
Modules: configure and manage detection and response modules
IAM: manage users, groups, and permissions at the workspace level
Notifications: configure the notifications module for Microsoft Sentinel
Environments: review the workspace’s endpoint and license inventory, and which response actions each connection supports. See Workspace Environments
Gamebooks and Agents: set Workspace Policies that allow, block, or require approval for Gamebook actions, and allow or block agent investigations
Pre-Onboarding a Customer Workspace
Pre-onboarding lets you prepare a customer’s workspace before they complete onboarding themselves. The customer admin receives an invite email and finishes the rest. See Customer Workspace Onboarding for the customer-side flow.
Why pre-onboard?
Faster Deployment
Configuration is ready when the customer is
Reduced Errors
Verify settings before the customer is invited
Better Planning
Schedule onboardings in advance
Creating a pre-onboarded workspace
1
Open the Onboarding tab
Click the Onboarding tab at the top of the Workspace Center
2
Click Add workspace
The button is in the top-right of the toolbar. The right-hand rail panel opens with the Add workspace form
Add workspace rail open on the Onboarding tab
3
Fill in customer details
Field
Description
Workspace name
Friendly label you’ll use to refer to this customer
Tenant ID
The customer’s Microsoft Entra tenant ID
Primary point-of-contact email
The customer admin who will receive the invite
Detection modules
Pre-select the security tools the customer is bringing
Response modules
Pre-select the response capabilities the customer will use
4
Click Send Invite
ContraForce sends an invite email to the POC. The new workspace appears as a card on the Onboarding tab with a Pending customer setup badge
New pre-onboarded workspace card
Click any pre-onboarded card to see its onboarding progress in the right-hand rail. Use this to confirm which modules the customer has connected so far.
To pre-onboard many customers at once from a CSV file, and have each new workspace land already configured by a Workspace Profile, see Onboarding Workspaces at Scale.
When the customer finishes onboarding
You’ll receive a real-time Customer onboarding complete notification in the portal. The card moves from the Onboarding tab to the Workspaces tab, and the status light flips from blue (pre-onboarded) to green (healthy) or amber (needs attention) based on what the customer connected.For the post-go-live verification runbook, see Workspace Onboarding Verification.
Module Management
Each workspace can have different modules enabled based on customer needs. Open a workspace’s settings page (click the card), then go to the Modules tab.
These permissions must be granted by a tenant administrator.
Granting consent
1
Open the workspace settings
Click the workspace card to open its settings page
2
Go to the Modules tab
Find the module that needs consent
3
Click Consent
A Microsoft authentication window opens
4
Sign in as a Global Administrator
Sign in with a Global Administrator or Privileged Role Administrator account. ContraForce uses app-only Microsoft Graph permissions, so Cloud Application Administrator and Application Administrator cannot grant this consent
5
Review and accept
Review the requested permissions and click Accept
Consent requires Global Administrator privileges in the customer’s Microsoft tenant. Work with your customer’s IT team if you don’t have Global Administrator access.
Platform Permissions
Which Microsoft Entra ID apps ContraForce uses and which admin roles can grant consent
Best Practices
Use consistent naming conventions
Name workspaces consistently (for example, “CustomerName: Primary”) so they’re easy to identify in search and filters.
Pre-onboard before customer meetings
Create pre-onboarded workspaces before onboarding calls so the customer admin can complete their onboarding immediately.
Watch the Need attention rollup
Periodically click the Need attention rollup card to surface workspaces missing a detection module or Agent Center.
Verify consent status regularly
Token expirations or policy changes can affect access. Open a workspace’s Modules tab to confirm everything still shows Connected.
Document module configurations
Keep records of which modules and settings are enabled for each customer for support and renewal conversations.
Troubleshooting
Common Issues
Issue
Possible cause
Solution
Workspace shows no data
Consent not completed
Re-run consent flow with admin credentials
Module won’t enable
Missing permissions
Verify required permissions are granted
Pre-onboarded card never moves to Workspaces tab
Customer admin hasn’t finished onboarding
Resend the invite or contact the POC
Configuration won’t save
Validation error
Check for required fields or invalid values
Status light is amber
Detection module or Agent Center missing
Open the workspace card and complete the missing module or deploy an agent
If you encounter persistent issues with workspace configuration, contact support@contraforce.com with the workspace name and error details.
Related Guides
MSP Platform Onboarding
Granting access, Agent Center, connecting your own sources
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ContraForce","description":"Documentation for ContraForce, the AI-powered security delivery platform for MSPs, MSSPs, and SOC teams: onboarding, incident response, Gamebooks, agents, and the API.","colors":{"primary":"#2557F9","light":"#2E6FFF","dark":"#1E4CF2"},"logo":{"light":"https://mintcdn.com/contraforce/JwvC6GjQ6Yq_yq8M/images/contraforce_logp_lightmode.svg?fit=max\u0026auto=format\u0026n=JwvC6GjQ6Yq_yq8M\u0026q=85\u0026s=19a655faefc3e38ab74135c16698a7e4","dark":"https://mintcdn.com/contraforce/JwvC6GjQ6Yq_yq8M/images/contraforce_logo_darkmode.svg?fit=max\u0026auto=format\u0026n=JwvC6GjQ6Yq_yq8M\u0026q=85\u0026s=8a74f54b37ce3070d377a7ef69e4ed7b","href":"/"},"favicon":"https://mintcdn.com/contraforce/JwvC6GjQ6Yq_yq8M/images/contraforce_mark_blue.svg?fit=max\u0026auto=format\u0026n=JwvC6GjQ6Yq_yq8M\u0026q=85\u0026s=7814ccc29667eafaec88ff86cda61ad5","navbar":{"links":[{"href":"mailto:support@contraforce.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://portal.contraforce.com"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/contraforce"}},"seo":{"metatags":{"og:site_name":"ContraForce Docs"},"paths":[{"path":"staging","metatags":{"robots":"noindex"}}],"organization":{"name":"ContraForce","url":"https://www.contraforce.com","sameAs":["https://www.linkedin.com/company/contraforce"]},"indexing":"navigable"},"fonts":{"heading":{"family":"Inter","weight":600},"body":{"family":"Inter","weight":300}},"icons":{"library":"fontawesome"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"thumbnails":{"appearance":"dark"},"metadata":{"timestamp":true},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Overview","icon":"street-view","color":{"light":"#2557F9","dark":"#2E6FFF"},"href":"/overview"},{"anchor":"Release Notes","icon":"notes","color":{"light":"#2557F9","dark":"#2E6FFF"},"href":"/release-notes"},{"anchor":"Blog","icon":"newspaper","color":{"light":"#2557F9","dark":"#2E6FFF"},"href":"/blog"},{"anchor":"API Reference","icon":"code","color":{"light":"#2557F9","dark":"#2E6FFF"},"href":"/api-reference/endpoints"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"contraforce","hasAudioNarration":false,"actualSubdomain":"contraforce","customDomains":["docs.contraforce.com"],"gitSource":{"type":"github","owner":"contraforce","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aff73917727cb415fe553ef","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":92},{"language":"default","tag":"API Playground","count":88},{"language":"default","tag":"Guides","count":70},{"language":"default","tag":"Blog","count":56},{"language":"default","tag":"Getting started","count":19},{"language":"default","tag":"Onboarding","count":14},{"language":"default","tag":"Webhooks","count":14},{"language":"default","tag":"Technical","count":13},{"language":"default","tag":"Incidents","count":11},{"language":"default","tag":"agent-tools","count":10}]},"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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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":[]}
{"page":{"pagePath":"guides/getting-started/workspace-manager","slug":"/guides/getting-started/workspace-manager","pageMetadata":{"title":"Workspace Center: Manage Customer Workspaces","sidebarTitle":"Workspace Center","description":"Manage customer workspaces in the Workspace Center: pre-onboard customers, monitor health, configure modules, grant consent, and set Gamebook approvers.","keywords":["manage customer workspaces","ContraForce Workspace Center","pre-onboard customer workspace","workspace health status","module admin consent","Gamebook approvers"],"href":"/guides/getting-started/workspace-manager"},"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 customer workspaces in the Workspace Center: pre-onboard customers, monitor health, configure modules, grant consent, and set Gamebook approvers.\"\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`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,CardGroup,Frame,Heading,Info,Note,OptimizedImage,Step,Steps,Tab,Table,Tabs,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,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:[_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Workspace Center`}),` is your administrative control panel for every customer workspace. Monitor active workspaces at a glance, pre-onboard new customers, and drill into per-workspace settings.`]}),`\n`,_jsx(Info,{children:_jsx(_components.p,{children:`Workspaces represent individual customer tenants in ContraForce. Each workspace has its own data, configurations, modules, and user permissions.`})}),`\n`,_jsx(Heading,{level:`2`,id:`what-can-you-do-here`,children:`What Can You Do Here?`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Pre-Onboard Customers`,icon:`user-plus`,children:_jsx(_components.p,{children:`Create workspace placeholders before customer admins complete their setup`})}),_jsx(Card,{title:`Manage Configurations`,icon:`gear`,children:_jsx(_components.p,{children:`Edit module settings, integrations, and access from the per-workspace settings page`})}),_jsx(Card,{title:`Monitor Health`,icon:`circle-check`,children:_jsx(_components.p,{children:`See which workspaces are healthy, need attention, or are still onboarding`})}),_jsx(Card,{title:`Control Permissions`,icon:`key`,children:_jsx(_components.p,{children:`Manage module consents and workspace-level access`})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`accessing-the-workspace-center`,children:`Accessing the Workspace Center`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Locate the Workspaces icon`,children:_jsxs(_components.p,{children:[`Find the `,_jsx(_components.strong,{children:`Workspaces`}),` icon in the left navigation bar`]})}),_jsx(Step,{title:`Open the page`,children:_jsx(_components.p,{children:`Click the icon to open the Workspace Center`})})]}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/contraforce/EJSv-50EV_kHzCm1/images/nav-sidebar-workspaces.png?fit=max\u0026auto=format\u0026n=EJSv-50EV_kHzCm1\u0026q=85\u0026s=72d2d01bdc89cd91b420ac81921386f7`,alt:`Workspaces icon in the left navigation`,\"data-og-width\":`203`,width:`203`,\"data-og-height\":`309`,height:`309`,\"data-path\":`images/nav-sidebar-workspaces.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/contraforce/EJSv-50EV_kHzCm1/images/nav-sidebar-workspaces.png?w=280\u0026fit=max\u0026auto=format\u0026n=EJSv-50EV_kHzCm1\u0026q=85\u0026s=602f54aab056dd5c383df79f228ee4c2 280w, https://mintcdn.com/contraforce/EJSv-50EV_kHzCm1/images/nav-sidebar-workspaces.png?w=560\u0026fit=max\u0026auto=format\u0026n=EJSv-50EV_kHzCm1\u0026q=85\u0026s=4f82c6b152a238584d7acc780156cac5 560w, https://mintcdn.com/contraforce/EJSv-50EV_kHzCm1/images/nav-sidebar-workspaces.png?w=840\u0026fit=max\u0026auto=format\u0026n=EJSv-50EV_kHzCm1\u0026q=85\u0026s=a67ecb67a013386bf607b56fa807f1e4 840w, https://mintcdn.com/contraforce/EJSv-50EV_kHzCm1/images/nav-sidebar-workspaces.png?w=1100\u0026fit=max\u0026auto=format\u0026n=EJSv-50EV_kHzCm1\u0026q=85\u0026s=2e24e8aaf20fbdf70956693416882e89 1100w, https://mintcdn.com/contraforce/EJSv-50EV_kHzCm1/images/nav-sidebar-workspaces.png?w=1650\u0026fit=max\u0026auto=format\u0026n=EJSv-50EV_kHzCm1\u0026q=85\u0026s=34c419f51310814c85a22ad94001820f 1650w, https://mintcdn.com/contraforce/EJSv-50EV_kHzCm1/images/nav-sidebar-workspaces.png?w=2500\u0026fit=max\u0026auto=format\u0026n=EJSv-50EV_kHzCm1\u0026q=85\u0026s=463c646a338881194ead36e321ff26ca 2500w`})}),`\n`,_jsx(Heading,{level:`2`,id:`page-layout-tabs-and-kpi-cards`,children:`Page Layout: Tabs and KPI Cards`}),`\n`,_jsx(_components.p,{children:`The Workspace Center has a set of tabs and a row of rollup KPI cards.`}),`\n`,_jsx(Frame,{caption:`Workspace Center overview`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/contraforce/OXtE1nSnqbk3dWX9/images/onboarding/workspace-center/workspaces-01-workspace-overview.png?fit=max\u0026auto=format\u0026n=OXtE1nSnqbk3dWX9\u0026q=85\u0026s=84c00da0e8de54fb82ab5484e3f62baa`,alt:`Workspace Center Workspaces tab with Workspaces connected, Need attention, and Onboarding cards above workspace cards`,\"data-og-width\":`1833`,width:`1833`,\"data-og-height\":`1006`,height:`1006`,\"data-path\":`images/onboarding/workspace-center/workspaces-01-workspace-overview.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/contraforce/OXtE1nSnqbk3dWX9/images/onboarding/workspace-center/workspaces-01-workspace-overview.png?w=280\u0026fit=max\u0026auto=format\u0026n=OXtE1nSnqbk3dWX9\u0026q=85\u0026s=55293356ee39d6ba17becac4c26ec64b 280w, https://mintcdn.com/contraforce/OXtE1nSnqbk3dWX9/images/onboarding/workspace-center/workspaces-01-workspace-overview.png?w=560\u0026fit=max\u0026auto=format\u0026n=OXtE1nSnqbk3dWX9\u0026q=85\u0026s=e4d4331b0adc226d85acd318f0b9b5fa 560w, https://mintcdn.com/contraforce/OXtE1nSnqbk3dWX9/images/onboarding/workspace-center/workspaces-01-workspace-overview.png?w=840\u0026fit=max\u0026auto=format\u0026n=OXtE1nSnqbk3dWX9\u0026q=85\u0026s=581a074b7ebf5d32250b9926e4101fee 840w, https://mintcdn.com/contraforce/OXtE1nSnqbk3dWX9/images/onboarding/workspace-center/workspaces-01-workspace-overview.png?w=1100\u0026fit=max\u0026auto=format\u0026n=OXtE1nSnqbk3dWX9\u0026q=85\u0026s=2827af0b87b5bd8858bd2183cbf7ca25 1100w, https://mintcdn.com/contraforce/OXtE1nSnqbk3dWX9/images/onboarding/workspace-center/workspaces-01-workspace-overview.png?w=1650\u0026fit=max\u0026auto=format\u0026n=OXtE1nSnqbk3dWX9\u0026q=85\u0026s=73a88d769612002349da1d147f7cab25 1650w, https://mintcdn.com/contraforce/OXtE1nSnqbk3dWX9/images/onboarding/workspace-center/workspaces-01-workspace-overview.png?w=2500\u0026fit=max\u0026auto=format\u0026n=OXtE1nSnqbk3dWX9\u0026q=85\u0026s=0ea7facd9f88a05d96e40a640706eec7 2500w`})}),`\n`,_jsx(Heading,{level:`3`,id:`rollup-kpi-cards`,children:`Rollup KPI cards`}),`\n`,_jsx(_components.p,{children:`The cards at the top of the page show counts at a glance and are clickable shortcuts.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Card`}),_jsx(_components.th,{children:`What it shows`}),_jsx(_components.th,{children:`What clicking does`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Workspaces connected`})}),_jsx(_components.td,{children:`Active customer workspaces in a healthy state`}),_jsxs(_components.td,{children:[`Switches to the Workspaces tab with the `,_jsx(_components.strong,{children:`All`}),` filter`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Need attention`})}),_jsx(_components.td,{children:`Active workspaces that have a missing module or undeployed agent`}),_jsxs(_components.td,{children:[`Switches to the Workspaces tab with the `,_jsx(_components.strong,{children:`Needs attention`}),` filter`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Onboarding`})}),_jsx(_components.td,{children:`Pre-onboarded workspaces awaiting customer admin setup`}),_jsx(_components.td,{children:`Switches to the Onboarding tab`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`workspace-center-tabs`,children:`Workspace Center tabs`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Tab`}),_jsx(_components.th,{children:`What it contains`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Workspaces`})}),_jsx(_components.td,{children:`Active customer workspaces. Search, filter by health, and click a card to open its settings page`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Onboarding`})}),_jsx(_components.td,{children:`Pre-onboarded workspaces awaiting customer admin setup. Add a new workspace from here, or click an existing card to see its onboarding progress`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Profiles`})}),_jsxs(_components.td,{children:[`Reusable `,_jsx(_components.a,{href:`/guides/fleet-management/workspace-profiles`,children:`Workspace Profiles`}),` that apply the same access, module, notification, Gamebook, and agent settings to every attached workspace. Available to Organizational Admins on service provider accounts`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`SLA`})}),_jsxs(_components.td,{children:[`SLA configurations that set response and resolution targets for the workspaces you assign. See `,_jsx(_components.a,{href:`/guides/getting-started/sla-tracking`,children:`SLA Tracking`})]})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`workspace-cards`,children:`Workspace Cards`}),`\n`,_jsx(_components.p,{children:`Each workspace renders as a card. Click any card to open its settings page (no gear or equalizer button needed).`}),`\n`,_jsx(Frame,{caption:`Workspace card anatomy`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/contraforce/KGdPGoMZjf7nE2PL/images/onboarding/workspace-center/workspaces-02-workspace-card.png?fit=max\u0026auto=format\u0026n=KGdPGoMZjf7nE2PL\u0026q=85\u0026s=11892c01bd5d16e4485a57426862fe9d`,alt:`Workspace card with a Your workspace badge, Modules and Agent pills, a green status light, and the flask icon`,\"data-og-width\":`560`,width:`560`,\"data-og-height\":`115`,height:`115`,\"data-path\":`images/onboarding/workspace-center/workspaces-02-workspace-card.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/contraforce/KGdPGoMZjf7nE2PL/images/onboarding/workspace-center/workspaces-02-workspace-card.png?w=280\u0026fit=max\u0026auto=format\u0026n=KGdPGoMZjf7nE2PL\u0026q=85\u0026s=ab698b30c996b44dbf72b641619ef942 280w, https://mintcdn.com/contraforce/KGdPGoMZjf7nE2PL/images/onboarding/workspace-center/workspaces-02-workspace-card.png?w=560\u0026fit=max\u0026auto=format\u0026n=KGdPGoMZjf7nE2PL\u0026q=85\u0026s=8e33db594a514221ae22eb067e43aebd 560w, https://mintcdn.com/contraforce/KGdPGoMZjf7nE2PL/images/onboarding/workspace-center/workspaces-02-workspace-card.png?w=840\u0026fit=max\u0026auto=format\u0026n=KGdPGoMZjf7nE2PL\u0026q=85\u0026s=f8ff7f35bf710a9981b17a8731e35f29 840w, https://mintcdn.com/contraforce/KGdPGoMZjf7nE2PL/images/onboarding/workspace-center/workspaces-02-workspace-card.png?w=1100\u0026fit=max\u0026auto=format\u0026n=KGdPGoMZjf7nE2PL\u0026q=85\u0026s=8e701be5c2371c9aa721d1ce7abf3ada 1100w, https://mintcdn.com/contraforce/KGdPGoMZjf7nE2PL/images/onboarding/workspace-center/workspaces-02-workspace-card.png?w=1650\u0026fit=max\u0026auto=format\u0026n=KGdPGoMZjf7nE2PL\u0026q=85\u0026s=e309207781042fd1782be239bcb9b7d0 1650w, https://mintcdn.com/contraforce/KGdPGoMZjf7nE2PL/images/onboarding/workspace-center/workspaces-02-workspace-card.png?w=2500\u0026fit=max\u0026auto=format\u0026n=KGdPGoMZjf7nE2PL\u0026q=85\u0026s=8d9ecaf0ff459b2628c8bde0a6c420f4 2500w`})}),`\n`,_jsx(Heading,{level:`3`,id:`what’s-on-a-card`,children:`What’s on a card`}),`\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:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Status light`}),` (top-right corner)`]}),_jsx(_components.td,{children:`Green: healthy. Amber: needs attention. Blue: pre-onboarded. Hidden on the service provider’s own workspace`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Workspace name`})}),_jsx(_components.td,{children:`The customer’s friendly name`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Tenant ID`})}),_jsx(_components.td,{children:`The customer’s Microsoft Entra tenant ID, in muted text below the name`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Inline chip`})}),_jsx(_components.td,{children:`”Your workspace” on the service provider’s own card; “Service provider” if the row represents the MSP itself with no monitoring on it`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Modules pill`})}),_jsx(_components.td,{children:`Visible on the Workspaces tab. Healthy when at least one detection module is configured`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Agent pill`})}),_jsx(_components.td,{children:`Visible on the Workspaces tab. Healthy when an Agent Center is deployed`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Health pills only appear on the Workspaces tab. The Onboarding tab uses the blue `,_jsx(_components.strong,{children:`pre-onboarded`}),` status light instead, since health checks are not meaningful until the customer admin completes their onboarding.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`search-and-filter`,children:`Search and Filter`}),`\n`,_jsxs(_components.p,{children:[`Both tabs include a `,_jsx(_components.strong,{children:`Search by workspace name`}),` field that filters cards as you type.`]}),`\n`,_jsx(_components.p,{children:`The Workspaces tab also has filter chips:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Filter`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`All`})}),_jsx(_components.td,{children:`Every active workspace, regardless of health`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Needs attention`})}),_jsx(_components.td,{children:`Active workspaces with a missing detection module or no deployed Agent Center`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Healthy`})}),_jsx(_components.td,{children:`Active workspaces with both a detection module and an Agent Center deployed`})]})]})]}),`\n`,_jsx(_components.p,{children:`The Onboarding tab does not have filter chips. Use search to narrow the list when you have many pre-onboarded workspaces.`}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Press `,_jsx(_components.strong,{children:`Ctrl + K`}),` to open `,_jsx(_components.a,{href:`/guides/getting-started/quick-actions`,children:`Quick Actions`}),`, then type part of a workspace name to jump straight to its settings, modules, or notifications.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`opening-workspace-details`,children:`Opening Workspace Details`}),`\n`,_jsx(_components.p,{children:`Click any card to open the workspace’s settings page.`}),`\n`,_jsx(Frame,{caption:`Workspace settings page after clicking a card`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/contraforce/OXtE1nSnqbk3dWX9/images/onboarding/workspace-center/workspaces-03-workspace-details.png?fit=max\u0026auto=format\u0026n=OXtE1nSnqbk3dWX9\u0026q=85\u0026s=79832b4141c578ee09693e46f236371c`,alt:`Contoso workspace settings page on the General tab, with Workspace, Primary contact, and Activity sections`,\"data-og-width\":`1833`,width:`1833`,\"data-og-height\":`1006`,height:`1006`,\"data-path\":`images/onboarding/workspace-center/workspaces-03-workspace-details.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/contraforce/OXtE1nSnqbk3dWX9/images/onboarding/workspace-center/workspaces-03-workspace-details.png?w=280\u0026fit=max\u0026auto=format\u0026n=OXtE1nSnqbk3dWX9\u0026q=85\u0026s=f134d9bc6cfb5d1f80215ab8f0f37af0 280w, https://mintcdn.com/contraforce/OXtE1nSnqbk3dWX9/images/onboarding/workspace-center/workspaces-03-workspace-details.png?w=560\u0026fit=max\u0026auto=format\u0026n=OXtE1nSnqbk3dWX9\u0026q=85\u0026s=2d1d56ebce05d62b5dbd7e5f27db86bd 560w, https://mintcdn.com/contraforce/OXtE1nSnqbk3dWX9/images/onboarding/workspace-center/workspaces-03-workspace-details.png?w=840\u0026fit=max\u0026auto=format\u0026n=OXtE1nSnqbk3dWX9\u0026q=85\u0026s=e7fd9a7911c5c0e95e0395c2ef4daf49 840w, https://mintcdn.com/contraforce/OXtE1nSnqbk3dWX9/images/onboarding/workspace-center/workspaces-03-workspace-details.png?w=1100\u0026fit=max\u0026auto=format\u0026n=OXtE1nSnqbk3dWX9\u0026q=85\u0026s=2411274cb6ba6b2e54fb91ff0a5dbcf1 1100w, https://mintcdn.com/contraforce/OXtE1nSnqbk3dWX9/images/onboarding/workspace-center/workspaces-03-workspace-details.png?w=1650\u0026fit=max\u0026auto=format\u0026n=OXtE1nSnqbk3dWX9\u0026q=85\u0026s=4fd88f172ed49b64f5420e92da8994a5 1650w, https://mintcdn.com/contraforce/OXtE1nSnqbk3dWX9/images/onboarding/workspace-center/workspaces-03-workspace-details.png?w=2500\u0026fit=max\u0026auto=format\u0026n=OXtE1nSnqbk3dWX9\u0026q=85\u0026s=b9fa07c9b6734bcc5737a9498aa68e0d 2500w`})}),`\n`,_jsx(_components.p,{children:`The settings page includes these areas:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`General`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Account Information and Service Provider Information`}),`: account identifiers, points of contact, account ID, account type, and subscription information`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Allow Service Providers to Run Gamebooks`}),`: manage the team members responsible for approving Gamebooks that require manual authorization. Only users with the Workspace Owner role can be assigned as Gamebook Approvers`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Modules`}),`: configure and manage detection and response modules`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`IAM`}),`: manage users, groups, and permissions at the workspace level`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Notifications`}),`: configure the notifications module for Microsoft Sentinel`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Environments`}),`: review the workspace’s endpoint and license inventory, and which response actions each connection supports. See `,_jsx(_components.a,{href:`/guides/getting-started/workspace-environments`,children:`Workspace Environments`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Gamebooks`}),` and `,_jsx(_components.strong,{children:`Agents`}),`: set `,_jsx(_components.a,{href:`/guides/getting-started/workspace-policies`,children:`Workspace Policies`}),` that allow, block, or require approval for Gamebook actions, and allow or block agent investigations`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`pre-onboarding-a-customer-workspace`,children:`Pre-Onboarding a Customer Workspace`}),`\n`,_jsxs(_components.p,{children:[`Pre-onboarding lets you prepare a customer’s workspace before they complete onboarding themselves. The customer admin receives an invite email and finishes the rest. See `,_jsx(_components.a,{href:`/guides/onboarding/customer-workspace-onboarding`,children:`Customer Workspace Onboarding`}),` for the customer-side flow.`]}),`\n`,_jsx(Heading,{level:`3`,id:`why-pre-onboard`,children:`Why pre-onboard?`}),`\n`,_jsxs(CardGroup,{cols:3,children:[_jsx(Card,{title:`Faster Deployment`,icon:`bolt`,children:_jsx(_components.p,{children:`Configuration is ready when the customer is`})}),_jsx(Card,{title:`Reduced Errors`,icon:`shield-check`,children:_jsx(_components.p,{children:`Verify settings before the customer is invited`})}),_jsx(Card,{title:`Better Planning`,icon:`calendar`,children:_jsx(_components.p,{children:`Schedule onboardings in advance`})})]}),`\n`,_jsx(Heading,{level:`3`,id:`creating-a-pre-onboarded-workspace`,children:`Creating a pre-onboarded workspace`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open the Onboarding tab`,children:_jsxs(_components.p,{children:[`Click the `,_jsx(_components.strong,{children:`Onboarding`}),` tab at the top of the Workspace Center`]})}),_jsxs(Step,{title:`Click Add workspace`,children:[_jsxs(_components.p,{children:[`The button is in the top-right of the toolbar. The right-hand rail panel opens with the `,_jsx(_components.strong,{children:`Add workspace`}),` form`]}),_jsx(Frame,{caption:`Add workspace rail open on the Onboarding tab`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/msp-images/onboarding-07-add-customer-workspace.png?fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=1a640c2801a814465dd484a71dec8985`,alt:`Onboarding tab with the Add a workspace panel open, showing Workspace name, Tenant ID, and Customer admin email fields`,\"data-og-width\":`2230`,width:`2230`,\"data-og-height\":`1136`,height:`1136`,\"data-path\":`images/onboarding/msp-images/onboarding-07-add-customer-workspace.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/msp-images/onboarding-07-add-customer-workspace.png?w=280\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=4d8f4d90b5bcd66721eac45aeda689a4 280w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/msp-images/onboarding-07-add-customer-workspace.png?w=560\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=7ce382f709ca79119d5626cb28e49f9f 560w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/msp-images/onboarding-07-add-customer-workspace.png?w=840\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=ac4b1ccde9cdaa9cd6a6680edec32cb5 840w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/msp-images/onboarding-07-add-customer-workspace.png?w=1100\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=1424a24c458717845360fe02d02af693 1100w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/msp-images/onboarding-07-add-customer-workspace.png?w=1650\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=c0bae13ef3eb07d2cb21e8b46d51301c 1650w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/msp-images/onboarding-07-add-customer-workspace.png?w=2500\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=6c6ebaa806d980b4ee1e45f1114c2544 2500w`})})]}),_jsx(Step,{title:`Fill in customer details`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Workspace name`})}),_jsx(_components.td,{children:`Friendly label you’ll use to refer to this customer`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Tenant ID`})}),_jsx(_components.td,{children:`The customer’s Microsoft Entra tenant ID`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Primary point-of-contact email`})}),_jsx(_components.td,{children:`The customer admin who will receive the invite`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Detection modules`})}),_jsx(_components.td,{children:`Pre-select the security tools the customer is bringing`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Response modules`})}),_jsx(_components.td,{children:`Pre-select the response capabilities the customer will use`})]})]})]})}),_jsxs(Step,{title:`Click Send Invite`,children:[_jsxs(_components.p,{children:[`ContraForce sends an invite email to the POC. The new workspace appears as a card on the Onboarding tab with a `,_jsx(_components.strong,{children:`Pending customer setup`}),` badge`]}),_jsx(Frame,{caption:`New pre-onboarded workspace card`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/msp-images/onboarding-10-customer-workspace-preonboarded.png?fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=e12d2aed4abd9d2f8f5414483378f86a`,alt:`Onboarding tab with a pre-onboarded workspace card and its Setup progress panel showing module and agent setup status`,\"data-og-width\":`2235`,width:`2235`,\"data-og-height\":`1168`,height:`1168`,\"data-path\":`images/onboarding/msp-images/onboarding-10-customer-workspace-preonboarded.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/msp-images/onboarding-10-customer-workspace-preonboarded.png?w=280\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=6e65e899089cd784bb309f815b6a2010 280w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/msp-images/onboarding-10-customer-workspace-preonboarded.png?w=560\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=26acbe5d0734515cb952e335fcc75991 560w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/msp-images/onboarding-10-customer-workspace-preonboarded.png?w=840\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=f6ca6c3677c31e98aa4ca65a8f2543fd 840w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/msp-images/onboarding-10-customer-workspace-preonboarded.png?w=1100\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=e8f94f73172e10a903086ec3ed035643 1100w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/msp-images/onboarding-10-customer-workspace-preonboarded.png?w=1650\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=e0f06b753074dc02cd9fb789649e9238 1650w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/msp-images/onboarding-10-customer-workspace-preonboarded.png?w=2500\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=0a6aa5daf7b6aa9eea96cd6aa863e58c 2500w`})})]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Click any pre-onboarded card to see its onboarding progress in the right-hand rail. Use this to confirm which modules the customer has connected so far.`})}),`\n`,_jsxs(_components.p,{children:[`To pre-onboard many customers at once from a CSV file, and have each new workspace land already configured by a Workspace Profile, see `,_jsx(_components.a,{href:`/guides/fleet-management/onboarding-workspaces-at-scale`,children:`Onboarding Workspaces at Scale`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`when-the-customer-finishes-onboarding`,children:`When the customer finishes onboarding`}),`\n`,_jsxs(_components.p,{children:[`You’ll receive a real-time `,_jsx(_components.strong,{children:`Customer onboarding complete`}),` notification in the portal. The card moves from the Onboarding tab to the Workspaces tab, and the status light flips from blue (pre-onboarded) to green (healthy) or amber (needs attention) based on what the customer connected.`]}),`\n`,_jsxs(_components.p,{children:[`For the post-go-live verification runbook, see `,_jsx(_components.a,{href:`/guides/onboarding/workspace-onboarding-checklist`,children:`Workspace Onboarding Verification`}),`.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`module-management`,children:`Module Management`}),`\n`,_jsxs(_components.p,{children:[`Each workspace can have different modules enabled based on customer needs. Open a workspace’s settings page (click the card), then go to the `,_jsx(_components.strong,{children:`Modules`}),` tab.`]}),`\n`,_jsx(Heading,{level:`3`,id:`available-modules`,children:`Available modules`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Module`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Key features`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/guides/onboarding/defender-for-endpoint-module-deployment`,children:`Microsoft Defender for Endpoint`})}),_jsx(_components.td,{children:`Defender for Endpoint integration`}),_jsx(_components.td,{children:`Endpoint detection, response actions, device management`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/guides/onboarding/microsoft-sentinel-module`,children:`Microsoft Sentinel`})}),_jsx(_components.td,{children:`Microsoft Sentinel integration`}),_jsx(_components.td,{children:`Log analysis, custom alerts, threat hunting`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/guides/onboarding/sentinelone-module`,children:`SentinelOne XDR`})}),_jsx(_components.td,{children:`SentinelOne XDR integration`}),_jsx(_components.td,{children:`Read SentinelOne alerts and respond to SentinelOne endpoints`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/guides/onboarding/crowdstrike-detection-and-response-modules`,children:`CrowdStrike`})}),_jsx(_components.td,{children:`CrowdStrike Falcon integration`}),_jsx(_components.td,{children:`CrowdStrike detection and response`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/guides/onboarding/sumo-logic-module`,children:`Sumo Logic`})}),_jsx(_components.td,{children:`Sumo Logic monitors integration`}),_jsx(_components.td,{children:`Monitor alerts as incidents, monitor management`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Notifications`}),_jsx(_components.td,{children:`Incident notification engine`}),_jsx(_components.td,{children:`Email notifications for Microsoft Sentinel incidents based on severity`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`configuring-modules`,children:`Configuring modules`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open the workspace`,children:_jsx(_components.p,{children:`Click the workspace card to open its settings page`})}),_jsx(Step,{title:`Go to the Modules tab`,children:_jsx(_components.p,{children:`Navigate to the module you want to configure`})}),_jsx(Step,{title:`Adjust settings`,children:_jsx(_components.p,{children:`Enable or disable features, set thresholds, configure options`})}),_jsx(Step,{title:`Consent permissions`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Consent`}),` to authorize required permissions for the module`]})}),_jsx(Step,{title:`Save changes`,children:_jsx(_components.p,{children:`Apply the configuration`})})]}),`\n`,_jsx(Heading,{level:`3`,id:`module-specific-settings`,children:`Module-specific settings`}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`General`,id:`general`,children:[_jsx(_components.p,{children:`Basic workspace settings:`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Workspace name`}),`\n`,_jsx(_components.li,{children:`Alias name`}),`\n`,_jsx(_components.li,{children:`Domain`}),`\n`,_jsx(_components.li,{children:`Points of contact`}),`\n`,_jsx(_components.li,{children:`Email address`}),`\n`,_jsx(_components.li,{children:`Subscription ID`}),`\n`,_jsx(_components.li,{children:`Subscription type`}),`\n`]})]}),_jsxs(Tab,{title:`Modules`,id:`modules`,children:[_jsx(_components.p,{children:`Enable or disable ContraForce modules:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Microsoft Sentinel (Detection + Response)`}),`\n`,_jsxs(Warning,{children:[_jsx(_components.p,{children:`Prerequisites to manage this module:`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Microsoft Entra Role: Global Administrator or Privileged Role Administrator (required to grant the module Consent)`}),`\n`,_jsx(_components.li,{children:`ContraForce Workspace Role: Owner`}),`\n`,_jsx(_components.li,{children:`Microsoft Subscription Permission: Owner`}),`\n`]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Open this workspace’s `,_jsx(_components.a,{href:`/guides/getting-started/content-management-system`,children:`Content Management System (CMS)`}),`, its Detection Rules page, by selecting the flask icon on the Microsoft Sentinel module.`]})}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Microsoft Defender for Endpoint (Detection + Response)`}),`\n`,_jsxs(Warning,{children:[_jsx(_components.p,{children:`Prerequisites to manage this module:`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Microsoft Entra Role: Global Administrator or Privileged Role Administrator (required to grant the module Consent)`}),`\n`,_jsx(_components.li,{children:`ContraForce Workspace Role: Owner`}),`\n`]})]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`SentinelOne XDR (Detection + Response)`}),`\n`,_jsxs(Warning,{children:[_jsx(_components.p,{children:`Prerequisites to manage this module:`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`ContraForce Workspace Role: Owner`}),`\n`]})]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Gamebooks for Defender XDR (Response for endpoints)`}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Gamebooks for Identity (Response for users)`}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Gamebooks for Microsoft 365 (Response for emails)`}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Gamebooks for Azure (Response for Azure NSG)`}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Gamebooks for SentinelOne (Response for endpoints)`}),`\n`]}),`\n`]})]}),_jsxs(Tab,{title:`IAM`,id:`iam`,children:[_jsx(_components.p,{children:`Group Management. Workspace Roles:`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Owner`}),`\n`,_jsx(_components.li,{children:`Content Admin`}),`\n`,_jsx(_components.li,{children:`Incident Responder`}),`\n`,_jsx(_components.li,{children:`Incident Analyst`}),`\n`,_jsx(_components.li,{children:`Workspace Reader`}),`\n`]}),_jsx(_components.p,{children:`Use Role Management. User Roles:`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Owner`}),`\n`,_jsx(_components.li,{children:`Content Admin`}),`\n`,_jsx(_components.li,{children:`Incident Responder`}),`\n`,_jsx(_components.li,{children:`Incident Analyst`}),`\n`,_jsx(_components.li,{children:`Workspace Reader`}),`\n`]})]}),_jsxs(Tab,{title:`Notifications`,id:`notifications`,children:[_jsx(_components.p,{children:`Notification Settings:`}),_jsxs(Warning,{children:[_jsx(_components.p,{children:`Prerequisites to manage this module:`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`ContraForce Workspace Role: Owner`}),`\n`,_jsx(_components.li,{children:`Sentinel Module Configured`}),`\n`]})]}),_jsx(_components.p,{children:`Microsoft Sentinel Notifications Settings Based on Severity:`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`High`}),`\n`,_jsx(_components.li,{children:`Medium`}),`\n`,_jsx(_components.li,{children:`Low`}),`\n`,_jsx(_components.li,{children:`Info`}),`\n`]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`permission-consent`,children:`Permission Consent`}),`\n`,_jsx(_components.p,{children:`Some features require explicit consent to Microsoft enterprise applications.`}),`\n`,_jsx(Heading,{level:`3`,id:`why-consent-is-required`,children:`Why consent is required`}),`\n`,_jsx(_components.p,{children:`ContraForce uses Microsoft Graph API and other APIs to:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Read security alerts and incidents`}),`\n`,_jsx(_components.li,{children:`Execute response actions (isolate devices, disable users)`}),`\n`,_jsx(_components.li,{children:`Access log data for analysis`}),`\n`]}),`\n`,_jsx(_components.p,{children:`These permissions must be granted by a tenant administrator.`}),`\n`,_jsx(Heading,{level:`3`,id:`granting-consent`,children:`Granting consent`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open the workspace settings`,children:_jsx(_components.p,{children:`Click the workspace card to open its settings page`})}),_jsx(Step,{title:`Go to the Modules tab`,children:_jsx(_components.p,{children:`Find the module that needs consent`})}),_jsx(Step,{title:`Click Consent`,children:_jsx(_components.p,{children:`A Microsoft authentication window opens`})}),_jsx(Step,{title:`Sign in as a Global Administrator`,children:_jsxs(_components.p,{children:[`Sign in with a `,_jsx(_components.strong,{children:`Global Administrator`}),` or `,_jsx(_components.strong,{children:`Privileged Role Administrator`}),` account. ContraForce uses app-only Microsoft Graph permissions, so Cloud Application Administrator and Application Administrator cannot grant this consent`]})}),_jsx(Step,{title:`Review and accept`,children:_jsxs(_components.p,{children:[`Review the requested permissions and click `,_jsx(_components.strong,{children:`Accept`})]})})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Consent requires `,_jsx(_components.strong,{children:`Global Administrator`}),` privileges in the customer’s Microsoft tenant. Work with your customer’s IT team if you don’t have Global Administrator access.`]})}),`\n`,_jsx(Card,{title:`Platform Permissions`,icon:`key`,href:`/guides/getting-started/platform-permissions-and-consent`,children:_jsx(_components.p,{children:`Which Microsoft Entra ID apps ContraForce uses and which admin roles can grant consent`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`best-practices`,children:`Best Practices`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Use consistent naming conventions`,id:`use-consistent-naming-conventions`,children:_jsx(_components.p,{children:`Name workspaces consistently (for example, “CustomerName: Primary”) so they’re easy to identify in search and filters.`})}),_jsx(Accordion,{title:`Pre-onboard before customer meetings`,id:`pre-onboard-before-customer-meetings`,children:_jsx(_components.p,{children:`Create pre-onboarded workspaces before onboarding calls so the customer admin can complete their onboarding immediately.`})}),_jsx(Accordion,{title:`Watch the Need attention rollup`,id:`watch-the-need-attention-rollup`,children:_jsxs(_components.p,{children:[`Periodically click the `,_jsx(_components.strong,{children:`Need attention`}),` rollup card to surface workspaces missing a detection module or Agent Center.`]})}),_jsx(Accordion,{title:`Verify consent status regularly`,id:`verify-consent-status-regularly`,children:_jsxs(_components.p,{children:[`Token expirations or policy changes can affect access. Open a workspace’s Modules tab to confirm everything still shows `,_jsx(_components.strong,{children:`Connected`}),`.`]})}),_jsx(Accordion,{title:`Document module configurations`,id:`document-module-configurations`,children:_jsx(_components.p,{children:`Keep records of which modules and settings are enabled for each customer for support and renewal conversations.`})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsx(Heading,{level:`3`,id:`common-issues`,children:`Common Issues`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Issue`}),_jsx(_components.th,{children:`Possible cause`}),_jsx(_components.th,{children:`Solution`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Workspace shows no data`}),_jsx(_components.td,{children:`Consent not completed`}),_jsx(_components.td,{children:`Re-run consent flow with admin credentials`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Module won’t enable`}),_jsx(_components.td,{children:`Missing permissions`}),_jsx(_components.td,{children:`Verify required permissions are granted`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Pre-onboarded card never moves to Workspaces tab`}),_jsx(_components.td,{children:`Customer admin hasn’t finished onboarding`}),_jsx(_components.td,{children:`Resend the invite or contact the POC`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Configuration won’t save`}),_jsx(_components.td,{children:`Validation error`}),_jsx(_components.td,{children:`Check for required fields or invalid values`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Status light is amber`}),_jsx(_components.td,{children:`Detection module or Agent Center missing`}),_jsx(_components.td,{children:`Open the workspace card and complete the missing module or deploy an agent`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`If you encounter persistent issues with workspace configuration, contact `,_jsx(_components.a,{href:`mailto:support@contraforce.com`,children:`support@contraforce.com`}),` with the workspace name and error details.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`related-guides`,children:`Related Guides`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`MSP Platform Onboarding`,icon:`building-shield`,href:`/guides/onboarding/platform-onboarding`,children:_jsx(_components.p,{children:`Granting access, Agent Center, connecting your own sources`})}),_jsx(Card,{title:`Customer Workspace Onboarding`,icon:`user-check`,href:`/guides/onboarding/customer-workspace-onboarding`,children:_jsx(_components.p,{children:`What customer admins see after the invite email`})}),_jsx(Card,{title:`Workspace Onboarding Verification`,icon:`circle-check`,href:`/guides/onboarding/workspace-onboarding-checklist`,children:_jsx(_components.p,{children:`Post-go-live verification runbook`})}),_jsx(Card,{title:`Multi-Tenant Features`,icon:`building`,href:`/guides/getting-started/multi-tenant-features`,children:_jsx(_components.p,{children:`Managing multiple workspaces`})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Questions about the Workspace Center? Contact us at `,_jsx(_components.a,{href:`mailto:support@contraforce.com`,children:`support@contraforce.com`}),`.`]})})]})}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":"Workspace Center: Manage Customer Workspaces","sidebarTitle":"Workspace Center","description":"Manage customer workspaces in the Workspace Center: pre-onboard customers, monitor health, configure modules, grant consent, and set Gamebook approvers.","keywords":["manage customer workspaces","ContraForce Workspace Center","pre-onboard customer workspace","workspace health status","module admin consent","Gamebook approvers"],"href":"/guides/getting-started/workspace-manager"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What Can You Do Here?","slug":"what-can-you-do-here","depth":2,"children":[]},{"title":"Accessing the Workspace Center","slug":"accessing-the-workspace-center","depth":2,"children":[]},{"title":"Page Layout: Tabs and KPI Cards","slug":"page-layout-tabs-and-kpi-cards","depth":2,"children":[{"title":"Rollup KPI cards","slug":"rollup-kpi-cards","depth":3,"children":[]},{"title":"Workspace Center tabs","slug":"workspace-center-tabs","depth":3,"children":[]}]},{"title":"Workspace Cards","slug":"workspace-cards","depth":2,"children":[{"title":"What’s on a card","slug":"what’s-on-a-card","depth":3,"children":[]}]},{"title":"Search and Filter","slug":"search-and-filter","depth":2,"children":[]},{"title":"Opening Workspace Details","slug":"opening-workspace-details","depth":2,"children":[]},{"title":"Pre-Onboarding a Customer Workspace","slug":"pre-onboarding-a-customer-workspace","depth":2,"children":[{"title":"Why pre-onboard?","slug":"why-pre-onboard","depth":3,"children":[]},{"title":"Creating a pre-onboarded workspace","slug":"creating-a-pre-onboarded-workspace","depth":3,"children":[]},{"title":"When the customer finishes onboarding","slug":"when-the-customer-finishes-onboarding","depth":3,"children":[]}]},{"title":"Module Management","slug":"module-management","depth":2,"children":[{"title":"Available modules","slug":"available-modules","depth":3,"children":[]},{"title":"Configuring modules","slug":"configuring-modules","depth":3,"children":[]},{"title":"Module-specific settings","slug":"module-specific-settings","depth":3,"children":[]}]},{"title":"Permission Consent","slug":"permission-consent","depth":2,"children":[{"title":"Why consent is required","slug":"why-consent-is-required","depth":3,"children":[]},{"title":"Granting consent","slug":"granting-consent","depth":3,"children":[]}]},{"title":"Best Practices","slug":"best-practices","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[{"title":"Common Issues","slug":"common-issues","depth":3,"children":[]}]},{"title":"Related Guides","slug":"related-guides","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"contraforce","siteName":"ContraForce","title":"Workspace Center: Manage Customer Workspaces - ContraForce","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T17:54:18.227Z","gitLastModified":"2026-10-08T16:28:19.000Z","originalFileLocation":"guides/getting-started/workspace-manager.mdx"},"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 customer workspaces in the Workspace Center: pre-onboard customers, monitor health, configure modules, grant consent, and set Gamebook approvers.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ContraForce\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/contraforce/CXQZ_dOqpuuVl-zr/_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/contraforce/CXQZ_dOqpuuVl-zr/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/contraforce/CXQZ_dOqpuuVl-zr/_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/contraforce/CXQZ_dOqpuuVl-zr/_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/contraforce/CXQZ_dOqpuuVl-zr/_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/contraforce/CXQZ_dOqpuuVl-zr/_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/contraforce/CXQZ_dOqpuuVl-zr/_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/contraforce/CXQZ_dOqpuuVl-zr/_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/contraforce/CXQZ_dOqpuuVl-zr/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Workspace Center: Manage Customer Workspaces - ContraForce\">\u003cmeta data-mint-head property=\"og:description\" content=\"Manage customer workspaces in the Workspace Center: pre-onboard customers, monitor health, configure modules, grant consent, and set Gamebook approvers.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ContraForce Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.contraforce.com/guides/getting-started/workspace-manager\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://contraforce.mintlify.site/_mintlify/api/og/v2?division=Getting+started\u0026amp;title=Workspace+Center%3A+Manage+Customer+Workspaces\u0026amp;description=Manage+customer+workspaces+in+the+Workspace+Center%3A+pre-onboard+customers%2C+monitor+health%2C+configure+modules%2C+grant+consent%2C+and+set+Gamebook+approvers.\u0026amp;theme=1c0866f521e74e7fb988d9b6\u0026amp;signature=7ba364687f4599eb7f86b75d0ac169df04b9a91ad3e98b677cb1cb7bd4387fac\">\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=\"Workspace Center: Manage Customer Workspaces - ContraForce\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Manage customer workspaces in the Workspace Center: pre-onboard customers, monitor health, configure modules, grant consent, and set Gamebook approvers.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://contraforce.mintlify.site/_mintlify/api/og/v2?division=Getting+started\u0026amp;title=Workspace+Center%3A+Manage+Customer+Workspaces\u0026amp;description=Manage+customer+workspaces+in+the+Workspace+Center%3A+pre-onboard+customers%2C+monitor+health%2C+configure+modules%2C+grant+consent%2C+and+set+Gamebook+approvers.\u0026amp;theme=1c0866f521e74e7fb988d9b6\u0026amp;signature=7ba364687f4599eb7f86b75d0ac169df04b9a91ad3e98b677cb1cb7bd4387fac\">\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/contraforce/CXQZ_dOqpuuVl-zr/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ContraForce\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2557F9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.contraforce.com/guides/getting-started/workspace-manager\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/getting-started/workspace-manager.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.contraforce.com/#organization\",\"name\":\"ContraForce\",\"url\":\"https://www.contraforce.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/contraforce/JwvC6GjQ6Yq_yq8M/images/contraforce_logp_lightmode.svg?fit=max\u0026auto=format\u0026n=JwvC6GjQ6Yq_yq8M\u0026q=85\u0026s=19a655faefc3e38ab74135c16698a7e4\"},\"sameAs\":[\"https://www.linkedin.com/company/contraforce\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.contraforce.com#website\",\"name\":\"ContraForce\",\"url\":\"https://docs.contraforce.com\",\"publisher\":{\"@id\":\"https://www.contraforce.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.contraforce.com/guides/getting-started/workspace-manager#webpage\",\"url\":\"https://docs.contraforce.com/guides/getting-started/workspace-manager\",\"name\":\"Workspace Center: Manage Customer Workspaces\",\"description\":\"Manage customer workspaces in the Workspace Center: pre-onboard customers, monitor health, configure modules, grant consent, and set Gamebook approvers.\",\"dateModified\":\"2026-10-08T16:28:19.000Z\",\"isPartOf\":{\"@id\":\"https://docs.contraforce.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.contraforce.com/guides/getting-started/workspace-manager#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.contraforce.com/guides/getting-started/workspace-manager#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Getting started\",\"item\":\"https://docs.contraforce.com/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Workspace Center: Manage Customer Workspaces\",\"item\":\"https://docs.contraforce.com/guides/getting-started/workspace-manager\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.contraforce.com/guides/getting-started/workspace-manager#article\",\"headline\":\"Workspace Center: Manage Customer Workspaces\",\"name\":\"Workspace Center: Manage Customer Workspaces\",\"description\":\"Manage customer workspaces in the Workspace Center: pre-onboard customers, monitor health, configure modules, grant consent, and set Gamebook approvers.\",\"url\":\"https://docs.contraforce.com/guides/getting-started/workspace-manager\",\"mainEntityOfPage\":{\"@id\":\"https://docs.contraforce.com/guides/getting-started/workspace-manager#webpage\"},\"dateModified\":\"2026-10-08T16:28:19.000Z\",\"keywords\":\"manage customer workspaces, ContraForce Workspace Center, pre-onboard customer workspace, workspace health status, module admin consent, Gamebook approvers\",\"publisher\":{\"@id\":\"https://www.contraforce.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.contraforce.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ContraForce\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"ContraForce\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/guides/getting-started/workspace-manager.md","siteName":"ContraForce","nav":{"global":{"anchors":[{"anchor":"Overview","icon":"street-view","color":{"light":"#2557F9","dark":"#2E6FFF"},"href":"/overview"},{"anchor":"Release Notes","icon":"notes","color":{"light":"#2557F9","dark":"#2E6FFF"},"href":"/release-notes"},{"anchor":"Blog","icon":"newspaper","color":{"light":"#2557F9","dark":"#2E6FFF"},"href":"/blog"},{"anchor":"API Reference","icon":"code","color":{"light":"#2557F9","dark":"#2E6FFF"},"href":"/api-reference/endpoints"}]},"tabs":[{"tab":"Guides","groups":[{"group":"Getting started","pages":[{"title":"Agentic Security Delivery Platform Documentation","sidebarTitle":"Overview","href":"/overview"},{"title":"Command Dashboard: SOC Metrics Across Workspaces","sidebarTitle":"Command Dashboard","href":"/guides/getting-started/command-dashboard"},{"title":"Quick Actions: Command Palette (Ctrl + K)","sidebarTitle":"Quick Actions","description":"Use the Ctrl + K keyboard shortcut to open Quick Actions, a command palette that takes you to portal pages, workspace settings, and common tasks.","href":"/guides/getting-started/quick-actions"},{"title":"Workspace Center: Manage Customer Workspaces","sidebarTitle":"Workspace Center","href":"/guides/getting-started/workspace-manager"},{"title":"Workspace Environments: Endpoints and Licenses","sidebarTitle":"Workspace Environments","description":"Review a workspace's endpoint and license inventory, find devices not yet onboarded to Defender, and see which response actions each connection supports.","href":"/guides/getting-started/workspace-environments"},{"title":"Content Management System: Detection Rules","sidebarTitle":"Content Management System","href":"/guides/getting-started/content-management-system"},{"title":"Security Incident Management: Triage to Closure","sidebarTitle":"Incident Management","href":"/guides/getting-started/incident-management"},{"title":"Incident Report: Closed Incidents and PDF Export","sidebarTitle":"Incident Report","href":"/guides/getting-started/incident-report"},{"title":"Incident SLA Tracking: Response and Resolution","sidebarTitle":"SLA Tracking","href":"/guides/getting-started/sla-tracking"},{"title":"How to Classify Incidents: True vs False Positive","sidebarTitle":"Incident Classifications","href":"/guides/getting-started/incident-classifications"},{"title":"Multi-Tenant Security for MSPs and MSSPs","sidebarTitle":"Multi-Tenant Features","href":"/guides/getting-started/multi-tenant-features"},{"title":"Workbench: Incident Investigation and Response","sidebarTitle":"Workbench Overview","href":"/guides/getting-started/workbench-overview"},{"title":"Log Search: Run KQL Queries on Workspace Logs","sidebarTitle":"Log Search","href":"/guides/getting-started/log-search"},{"title":"What Are Gamebooks? No-Code Incident Response","sidebarTitle":"What Are Gamebooks?","href":"/guides/getting-started/what-are-gamebooks"},{"title":"Custom Gamebook Actions: Bring Your Own Response","sidebarTitle":"Custom Gamebook Actions","href":"/guides/getting-started/custom-gamebook-actions"},{"title":"Gamebook Preview: Test Before You Run","sidebarTitle":"Gamebook Preview","href":"/guides/getting-started/gamebook-preview"},{"title":"Gamebook Simulation: Run With No Side Effects","sidebarTitle":"Gamebook Simulation","href":"/guides/getting-started/gamebook-simulation"},{"title":"Workspace Policies for Gamebooks and Agents","sidebarTitle":"Workspace Policies","href":"/guides/getting-started/workspace-policies"},{"title":"Platform Permissions: Microsoft Entra ID Consent","sidebarTitle":"Platform Permissions \u0026 Consent","href":"/guides/getting-started/platform-permissions-and-consent"}]},{"group":"Onboarding","pages":[{"title":"Onboarding Overview for MSPs and Customers","sidebarTitle":"Onboarding Workspaces","href":"/onboarding-customer-workspaces"},{"title":"MSP and MSSP Platform Onboarding","sidebarTitle":"Platform Onboarding","href":"/guides/onboarding/platform-onboarding"},{"title":"Customer Workspace Onboarding","href":"/guides/onboarding/customer-workspace-onboarding"},{"title":"Onboarding Admin Roles and App Permissions","sidebarTitle":"Onboarding Permissions","href":"/guides/onboarding/workspace-onboarding"},{"title":"Deploying Agent Center with Microsoft Foundry","sidebarTitle":"Deploying Agent Center","href":"/guides/onboarding/agent-center-deployment"},{"title":"Configuring Security Delivery Agents","href":"/guides/getting-started/configuring-security-delivery-agents"},{"title":"User and Group Management for MSPs and MSSPs","sidebarTitle":"MSP/MSSP Users \u0026 Groups","href":"/guides/onboarding/user-group-management-for-providers"},{"title":"Email Notifications for Incidents and Gamebooks","sidebarTitle":"Email Notifications","href":"/guides/onboarding/notifications-module"},{"title":"Microsoft Sentinel Incident Email Notifications","sidebarTitle":"Configure Notifications","href":"/guides/technical/notifications-configuration"},{"title":"Microsoft Sentinel Module Deployment","sidebarTitle":"Microsoft Sentinel Integration","href":"/guides/onboarding/microsoft-sentinel-module"},{"title":"Microsoft Defender for Endpoint Module Deployment","sidebarTitle":"Defender for Endpoint Module","href":"/guides/onboarding/defender-for-endpoint-module-deployment"},{"title":"CrowdStrike Falcon Detection and Response Modules","href":"/guides/onboarding/crowdstrike-detection-and-response-modules"},{"title":"SentinelOne Detection and Response Modules","href":"/guides/onboarding/sentinelone-module"},{"title":"Sumo Logic Detection Module","href":"/guides/onboarding/sumo-logic-module"}]},{"group":"Fleet Management","pages":[{"title":"Workspace Profiles: Standardize Workspace Settings","sidebarTitle":"Workspace Profiles","href":"/guides/fleet-management/workspace-profiles"},{"title":"Onboarding Workspaces at Scale with CSV Import","sidebarTitle":"Onboarding Workspaces at Scale","href":"/guides/fleet-management/onboarding-workspaces-at-scale"}]},{"group":"Technical","pages":[{"title":"Enterprise Application Permissions and App IDs","sidebarTitle":"Enterprise Applications","href":"/guides/technical/enterprise-applications"},{"title":"Azure Resources Deployed for Sentinel and Agents","sidebarTitle":"Azure Resources Deployed","href":"/guides/technical/azure-resources-deployed"},{"title":"Auditing Enterprise App Permissions","sidebarTitle":"Audit Permissions","href":"/guides/technical/auditing-enterprise-app-permissions"},{"title":"Entity Insights","href":"/entity-insights"},{"title":"Defender for Endpoint Permissions and Consent","sidebarTitle":"Defender for Endpoint Consent","href":"/defender-for-endpoint-module"},{"title":"Defender for Endpoint Capability Matrix by License","sidebarTitle":"Defender Capability Matrix","href":"/guides/technical/microsoft-defender-capability-matrix"},{"title":"Defender AIR, ZAP, and Attack Disruption","sidebarTitle":"Defender Native Automations","href":"/guides/technical/microsoft-defender-native-automations"},{"title":"Sentinel and Defender XDR Incident Deduplication","sidebarTitle":"Incident Deduplication","href":"/guides/technical/parallel-incident-deduplication"},{"title":"How the CrowdStrike Falcon Integration Works","sidebarTitle":"CrowdStrike Falcon Integration","href":"/guides/technical/crowdstrike-falcon-integration"},{"title":"Incident Classification Mapping Across Vendors","sidebarTitle":"Classification Mapping","href":"/concepts/incident-classification"},{"title":"Configure Incident Webhooks","sidebarTitle":"Setting Up Webhooks","href":"/guides/technical/configure-webhooks"},{"title":"Pull Reporting into a BI Tool","sidebarTitle":"Reporting in a BI Tool","href":"/guides/technical/reporting-to-a-bi-tool"},{"title":"Setting Up SCIM Provisioning","href":"/guides/technical/scim-provisioning"}]},{"group":"Agent Center","pages":[{"title":"Agent Shifts: Schedule AI Agent Working Hours","sidebarTitle":"Agent Shifts","href":"/guides/agent-center/agent-shifts"},{"title":"Agent Run History","href":"/guides/agent-center/agent-execution-history"},{"title":"Agent Rule Reviews","href":"/guides/agent-center/rule-reviews"},{"title":"On Queue Agents for Defender for Endpoint","sidebarTitle":"Defender for Endpoint On Queue","mode":"default","href":"/guides/agent-center/defender-for-endpoint-on-queue"},{"title":"SOPs for Security Delivery Agents","sidebarTitle":"SOPs","href":"/guides/agent-center/operating-procedures"},{"title":"Agent Investigation Completed Webhook","href":"/guides/agent-center/agent-investigation-webhook"}]},{"group":"Content Management Center","pages":[{"title":"Content Management Center for Detection Rules","sidebarTitle":"Overview","href":"/guides/content-management-center/overview"},{"title":"Detection Rule Repositories","sidebarTitle":"Repositories","href":"/guides/content-management-center/repositories"},{"title":"Import, Version, and Deploy Detection Rules","sidebarTitle":"Rules","href":"/guides/content-management-center/rules"},{"title":"Detection Rule Drift and Workspace Coverage","sidebarTitle":"Workspace coverage and drift","href":"/guides/content-management-center/workspace-coverage"},{"title":"Detection Rule Change Requests and Approvals","sidebarTitle":"Change requests","href":"/guides/content-management-center/change-requests"},{"title":"Detection Rule Template Marketplace","sidebarTitle":"Marketplace","href":"/guides/content-management-center/marketplace"},{"title":"Microsoft Sentinel and Defender XDR Rule Platforms","sidebarTitle":"Sentinel and Defender","href":"/guides/content-management-center/platforms"}]},{"group":"General Support","pages":[{"title":"Submit a Support Ticket","href":"/submit-ticket"},{"title":"Workspace Onboarding Verification Checklist","sidebarTitle":"Onboarding Verification","href":"/guides/onboarding/workspace-onboarding-checklist"},{"title":"User Roles \u0026 Permissions","href":"/guides/general-support/roles-and-permissions-reference"},{"title":"User Management: Add Users and Groups","sidebarTitle":"User Management","href":"/guides/general-support/user-group-management"},{"title":"Service Accounts and API Keys","sidebarTitle":"Service Accounts","href":"/guides/general-support/service-accounts"},{"title":"Cost Management Center","href":"/guides/general-support/cost-management-center"},{"title":"Offboarding: Remove ContraForce Apps and Resources","sidebarTitle":"Offboarding Procedure","href":"/guides/general-support/offboarding-contra-force"},{"title":"Shared Teams Channel with the Success Team","sidebarTitle":"Shared Teams Channel","href":"/guides/general-support/contraforce-success-teams-channel"}]},{"group":"ContraForce and Compliance","pages":[{"title":"Meeting Cyber Insurance Requirements","sidebarTitle":"Cyber Insurance Requirements","href":"/guides/contraforce-and-compliance/contraforce-and-cyber-insurance"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/endpoints"}]},{"tab":"Release Notes","pages":[{"title":"Release Notes","href":"/release-notes"}]},{"tab":"Blog","pages":[{"title":"Blog","href":"/blog"}]}]},"basePath":"","title":"Workspace Center: Manage Customer Workspaces - ContraForce","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"]}