Finish customer workspace onboarding: open your invite link, grant the ContraForce API and Portal consents, consent each module, and fix sign-in failures.
This guide is for customer admins whose service provider has pre-onboarded their workspace in ContraForce. You’ll receive an invite email from your service provider. Click the link to start.
Who is this for?
Customer security or IT admins finishing the workspace their MSP/MSSP started for them
Global Administrators in the customer’s Microsoft Entra tenant who need to grant ContraForce access
Required to grant the two core ContraForce consents. Global Administrator, Privileged Role Administrator, Application Administrator, or Cloud Application Administrator can all grant these
Invite email from your service provider
The link in this email is your onboarding entry point
Pop-ups allowed for portal.contraforce.com
The Microsoft consent prompts open in a popup window
Azure Subscription Owner
Only if you’ll deploy the Microsoft Sentinel module, which deploys supporting Azure infrastructure
The two core consents on this page can be granted by a Global Administrator, Privileged Role Administrator, Application Administrator, or Cloud Application Administrator. If you hold none of these, forward your invite link to someone in your organization who does and have them sign in instead.Connecting security modules later is stricter: those consents request Microsoft Graph application permissions and need a Global Administrator or Privileged Role Administrator.
How onboarding works
Your service provider has already created your workspace and pre-selected the Detection and Response modules you need. Your job is to sign in, grant ContraForce access to your tenant, and grant Consent for each module on the Modules tab.There’s no completion screen to wait for. Your workspace is onboarded when its status light turns green on its card in the Workspace Center. Your service provider receives a real-time notification the moment your workspace goes live.
Step 1: Grant ContraForce Access to Your Tenant
When you click the link in your invite email, you’ll be redirected to Microsoft to sign in. The first time anyone from your organization signs in, a Global Administrator must approve the core ContraForce app.ContraForce requests two core consents — ContraForce API and ContraForce Portal — as two separate Microsoft consent prompts. Accept both.
1
Click the invite link
Open the email from your service provider and click the onboarding link. You’ll be taken to portal.contraforce.com.
2
Sign in as a Global Administrator
You’ll be redirected to Microsoft. Sign in with your Global Admin credentials.
3
Review and accept the ContraForce API consent
Microsoft displays a consent screen listing the permissions ContraForce needs to read security data from your tenant. Check Consent on behalf of your organization and click Accept.
Microsoft consent screen: ContraForce API permissions
4
Review and accept the ContraForce Portal consent
A second Microsoft consent prompt appears for the ContraForce Portal. Check Consent on behalf of your organization again and click Accept.
Second Microsoft consent screen: ContraForce Portal
This is a one-time approval. Once a Global Admin grants both core consents, the rest of your team can sign in normally.
Step 2: Consent to Your Modules
After the core consents are granted, open your workspace and go to the Modules tab. The modules your service provider pre-selected are already listed for you — you just grant Consent for each one.
1
Open your workspace
From the Workspace Center, open the workspace your service provider created for you.
2
Go to the Modules tab
Each pre-selected detection and response module appears here with a Consent action.
3
Click Consent on each module
A Microsoft consent window opens. Sign in if prompted, review the permissions, and click Accept. Consent is granted per module — repeat for each module on the tab. You can consent to modules in any order.
Microsoft Sentinel customers: Consenting to the Sentinel module automatically deploys the supporting Azure infrastructure in your subscription, including the Azure Lighthouse delegation, the Apollo resource group, and the Sentinel-side automation. You don’t need to run a separate Azure deployment step. To deploy Sentinel, you must be an Azure Subscription Owner. Allow a few minutes for resources to appear.
Response modules (such as Gamebooks for Defender XDR, Identity, Microsoft 365, Azure, and SentinelOne) enable Gamebook actions like isolating devices, disabling users, and quarantining files. Consent to them the same way — a single Consent per module.
Step 3: Confirm Your Workspace Is Live
There’s no completion screen. Your workspace is onboarded when its status light turns green on its card in the Workspace Center.
Status light
What it means
Blue
Pre-onboarded — your service provider created the workspace and invited you
Amber
A module or agent is still missing — finish consenting to your modules
Green
Onboarded and live — incidents will begin to flow in
Your service provider receives a real-time notification when your workspace goes live, so they’ll know you’re ready.
Adding Users (After Onboarding)
Adding users is not part of onboarding. Once your workspace is live, add teammates from Settings → User Management using the Invite people to the organization dialog. Manage groups from Settings → Group Management.
Troubleshooting: Sign-in Failed
If you click your invite link and see a Sign In Failed page, it’s almost always because:
You aren’t a Global Administrator and ContraForce hasn’t been pre-approved for your tenant yet
A previous sign-in attempt got into a bad state
Consent required
What to do
1
Click Sign out in the top right
This clears any stale session that might be blocking sign-in.
2
If you're a Global Admin, click Try Again
Sign in. Microsoft will show the consent screen. Accept both core consents, and you’ll proceed into your workspace.
3
If you're not a Global Admin, click Email Your Admin
Or copy the Admin Consent Link from the page and send it to a Global Admin in your organization. Once they accept, return to your invite link and click Try Again.
Don’t keep retrying the same sign-in repeatedly without signing out. Repeated failures can compound the bad-session state and require a browser cache clear to recover.
Next Steps
Defender for Endpoint Module
Deploy and consent to the Defender for Endpoint module
Command Dashboard
Your home base for incident triage across your environment
Incident Management
How to triage, investigate, and respond to incidents
What Are Gamebooks?
Automated response workflows you can run from any incident
{"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":"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":[]}
{"page":{"pagePath":"guides/onboarding/customer-workspace-onboarding","slug":"/guides/onboarding/customer-workspace-onboarding","pageMetadata":{"title":"Customer Workspace Onboarding","description":"Finish customer workspace onboarding: open your invite link, grant the ContraForce API and Portal consents, consent each module, and fix sign-in failures.","keywords":["customer workspace onboarding","accept ContraForce workspace invite","grant Microsoft Entra admin consent to ContraForce","consent modules on the Modules tab","Sign In Failed need admin approval","workspace status light"],"href":"/guides/onboarding/customer-workspace-onboarding"},"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: \"Finish customer workspace onboarding: open your invite link, grant the ContraForce API and Portal consents, consent each module, and fix sign-in failures.\"\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`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Card,CardGroup,Frame,Heading,Info,Note,OptimizedImage,Step,Steps,Table,Tip,Warning}=_components;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(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`This guide is for `,_jsx(_components.strong,{children:`customer admins`}),` whose service provider has pre-onboarded their workspace in ContraForce. You’ll receive an invite email from your service provider. Click the link to start.`]}),`\n`,_jsxs(Info,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Who is this for?`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Customer security or IT admins finishing the workspace their MSP/MSSP started for them`}),`\n`,_jsx(_components.li,{children:`Global Administrators in the customer’s Microsoft Entra tenant who need to grant ContraForce access`}),`\n`]})]}),`\n`,_jsxs(_components.p,{children:[`If your sign-in fails before you reach your workspace, jump to `,_jsx(_components.a,{href:`#troubleshooting-sign-in-failed`,children:`Troubleshooting: Sign-in failed`}),`.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Requirement`}),_jsx(_components.th,{children:`Why`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Microsoft Entra admin role`})}),_jsx(_components.td,{children:`Required to grant the two core ContraForce consents. Global Administrator, Privileged Role Administrator, Application Administrator, or Cloud Application Administrator can all grant these`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Invite email from your service provider`})}),_jsx(_components.td,{children:`The link in this email is your onboarding entry point`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsxs(_components.strong,{children:[`Pop-ups allowed for `,_jsx(_components.code,{children:`portal.contraforce.com`})]})}),_jsx(_components.td,{children:`The Microsoft consent prompts open in a popup window`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Azure Subscription Owner`})}),_jsxs(_components.td,{children:[`Only if you’ll deploy the `,_jsx(_components.strong,{children:`Microsoft Sentinel`}),` module, which deploys supporting Azure infrastructure`]})]})]})]}),`\n`,_jsxs(Warning,{children:[_jsxs(_components.p,{children:[`The two core consents on this page can be granted by a `,_jsx(_components.strong,{children:`Global Administrator`}),`, `,_jsx(_components.strong,{children:`Privileged Role Administrator`}),`, `,_jsx(_components.strong,{children:`Application Administrator`}),`, or `,_jsx(_components.strong,{children:`Cloud Application Administrator`}),`. If you hold none of these, forward your invite link to someone in your organization who does and have them sign in instead.`]}),_jsxs(_components.p,{children:[`Connecting security `,_jsx(_components.strong,{children:`modules`}),` later is stricter: those consents request Microsoft Graph application permissions and need a `,_jsx(_components.strong,{children:`Global Administrator`}),` or `,_jsx(_components.strong,{children:`Privileged Role Administrator`}),`.`]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`how-onboarding-works`,children:`How onboarding works`}),`\n`,_jsxs(_components.p,{children:[`Your service provider has already created your workspace and pre-selected the `,_jsx(_components.strong,{children:`Detection`}),` and `,_jsx(_components.strong,{children:`Response`}),` modules you need. Your job is to sign in, grant ContraForce access to your tenant, and grant `,_jsx(_components.strong,{children:`Consent`}),` for each module on the `,_jsx(_components.strong,{children:`Modules`}),` tab.`]}),`\n`,_jsxs(_components.p,{children:[`There’s no completion screen to wait for. Your workspace is onboarded when its `,_jsx(_components.strong,{children:`status light turns green`}),` on its card in the Workspace Center. Your service provider receives a real-time notification the moment your workspace goes live.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`step-1-grant-contraforce-access-to-your-tenant`,children:`Step 1: Grant ContraForce Access to Your Tenant`}),`\n`,_jsx(_components.p,{children:`When you click the link in your invite email, you’ll be redirected to Microsoft to sign in. The first time anyone from your organization signs in, a Global Administrator must approve the core ContraForce app.`}),`\n`,_jsxs(_components.p,{children:[`ContraForce requests two core consents — `,_jsx(_components.strong,{children:`ContraForce API`}),` and `,_jsx(_components.strong,{children:`ContraForce Portal`}),` — as `,_jsx(_components.strong,{children:`two separate`}),` Microsoft consent prompts. Accept both.`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Click the invite link`,children:_jsxs(_components.p,{children:[`Open the email from your service provider and click the onboarding link. You’ll be taken to `,_jsx(_components.strong,{children:`portal.contraforce.com`}),`.`]})}),_jsx(Step,{title:`Sign in as a Global Administrator`,children:_jsx(_components.p,{children:`You’ll be redirected to Microsoft. Sign in with your Global Admin credentials.`})}),_jsxs(Step,{title:`Review and accept the ContraForce API consent`,children:[_jsxs(_components.p,{children:[`Microsoft displays a consent screen listing the permissions ContraForce needs to read security data from your tenant. Check `,_jsx(_components.strong,{children:`Consent on behalf of your organization`}),` and click `,_jsx(_components.strong,{children:`Accept`}),`.`]}),_jsx(Frame,{caption:`Microsoft consent screen: ContraForce API permissions`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/customer-images/onboarding-01-customer-api-consent.png?fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=6c795bef90f96c825b3d9be9c9fd3e99`,alt:`Microsoft consent dialog showing ContraForce API permissions`,\"data-og-width\":`663`,width:`663`,\"data-og-height\":`980`,height:`980`,\"data-path\":`images/onboarding/customer-images/onboarding-01-customer-api-consent.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/customer-images/onboarding-01-customer-api-consent.png?w=280\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=735133ca569090f7061bda3793af3ce5 280w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/customer-images/onboarding-01-customer-api-consent.png?w=560\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=4a52590938142b3e797e6e0f49be9a0e 560w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/customer-images/onboarding-01-customer-api-consent.png?w=840\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=55a03217a2d48c5984d60e6b59dca6f5 840w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/customer-images/onboarding-01-customer-api-consent.png?w=1100\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=0e49b8445a627dc42fe3aeeb2a821aae 1100w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/customer-images/onboarding-01-customer-api-consent.png?w=1650\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=fc0acefb1c0ea993ecc77d6819424562 1650w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/customer-images/onboarding-01-customer-api-consent.png?w=2500\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=eb089e3d042b9d23d0c7772d0e4e8410 2500w`})})]}),_jsxs(Step,{title:`Review and accept the ContraForce Portal consent`,children:[_jsxs(_components.p,{children:[`A second Microsoft consent prompt appears for the ContraForce Portal. Check `,_jsx(_components.strong,{children:`Consent on behalf of your organization`}),` again and click `,_jsx(_components.strong,{children:`Accept`}),`.`]}),_jsx(Frame,{caption:`Second Microsoft consent screen: ContraForce Portal`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/customer-images/onboarding-02-customer-second-consent.png?fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=4f388d348400602809c9394d9253d0c2`,alt:`Second Microsoft consent screen with the org-wide checkbox highlighted`,\"data-og-width\":`658`,width:`658`,\"data-og-height\":`931`,height:`931`,\"data-path\":`images/onboarding/customer-images/onboarding-02-customer-second-consent.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/customer-images/onboarding-02-customer-second-consent.png?w=280\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=07e50c78367454df586b6a0a37104d58 280w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/customer-images/onboarding-02-customer-second-consent.png?w=560\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=164214c9df9d0f59bae0316ac7d5f617 560w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/customer-images/onboarding-02-customer-second-consent.png?w=840\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=f88c014dff691ef3f34b655b275c8105 840w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/customer-images/onboarding-02-customer-second-consent.png?w=1100\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=b487a4ca2bb347f28bdd26c16f2198d0 1100w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/customer-images/onboarding-02-customer-second-consent.png?w=1650\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=7615ce16c55347daf2848b78d1f00df6 1650w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/customer-images/onboarding-02-customer-second-consent.png?w=2500\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=4152a375a8623a5246f51ed18eca3c26 2500w`})})]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`This is a one-time approval. Once a Global Admin grants both core consents, the rest of your team can sign in normally.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`step-2-consent-to-your-modules`,children:`Step 2: Consent to Your Modules`}),`\n`,_jsxs(_components.p,{children:[`After the core consents are granted, open your workspace and go to the `,_jsx(_components.strong,{children:`Modules`}),` tab. The modules your service provider pre-selected are already listed for you — you just grant `,_jsx(_components.strong,{children:`Consent`}),` for each one.`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open your workspace`,children:_jsx(_components.p,{children:`From the Workspace Center, open the workspace your service provider created for you.`})}),_jsx(Step,{title:`Go to the Modules tab`,children:_jsxs(_components.p,{children:[`Each pre-selected detection and response module appears here with a `,_jsx(_components.strong,{children:`Consent`}),` action.`]})}),_jsx(Step,{title:`Click Consent on each module`,children:_jsxs(_components.p,{children:[`A Microsoft consent window opens. Sign in if prompted, review the permissions, and click `,_jsx(_components.strong,{children:`Accept`}),`. Consent is granted `,_jsx(_components.strong,{children:`per module`}),` — repeat for each module on the tab. You can consent to modules in any order.`]})})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Microsoft Sentinel customers:`}),` Consenting to the Sentinel module automatically deploys the supporting Azure infrastructure in your subscription, including the Azure Lighthouse delegation, the Apollo resource group, and the Sentinel-side automation. You don’t need to run a separate Azure deployment step. To deploy Sentinel, you must be an `,_jsx(_components.strong,{children:`Azure Subscription Owner`}),`. Allow a few minutes for resources to appear.`]})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Response modules (such as Gamebooks for Defender XDR, Identity, Microsoft 365, Azure, and SentinelOne) enable Gamebook actions like isolating devices, disabling users, and quarantining files. Consent to them the same way — a single `,_jsx(_components.strong,{children:`Consent`}),` per module.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`step-3-confirm-your-workspace-is-live`,children:`Step 3: Confirm Your Workspace Is Live`}),`\n`,_jsxs(_components.p,{children:[`There’s no completion screen. Your workspace is onboarded when its `,_jsx(_components.strong,{children:`status light turns green`}),` on its card in the Workspace Center.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status light`}),_jsx(_components.th,{children:`What it means`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Blue`})}),_jsx(_components.td,{children:`Pre-onboarded — your service provider created the workspace and invited you`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Amber`})}),_jsx(_components.td,{children:`A module or agent is still missing — finish consenting to your modules`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Green`})}),_jsx(_components.td,{children:`Onboarded and live — incidents will begin to flow in`})]})]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Your service provider receives a real-time notification when your workspace goes live, so they’ll know you’re ready.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`adding-users-after-onboarding`,children:`Adding Users (After Onboarding)`}),`\n`,_jsxs(_components.p,{children:[`Adding users is `,_jsx(_components.strong,{children:`not`}),` part of onboarding. Once your workspace is live, add teammates from `,_jsx(_components.strong,{children:`Settings → User Management`}),` using the `,_jsx(_components.strong,{children:`Invite people to the organization`}),` dialog. Manage groups from `,_jsx(_components.strong,{children:`Settings → Group Management`}),`.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting-sign-in-failed`,children:`Troubleshooting: Sign-in Failed`}),`\n`,_jsxs(_components.p,{children:[`If you click your invite link and see a `,_jsx(_components.strong,{children:`Sign In Failed`}),` page, it’s almost always because:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`You aren’t a Global Administrator and ContraForce hasn’t been pre-approved for your tenant yet`}),`\n`,_jsx(_components.li,{children:`A previous sign-in attempt got into a bad state`}),`\n`]}),`\n`,_jsx(Frame,{caption:`Consent required`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/customer-non-admin/onboarding-01-non-admin-customer-need-approval.png?fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=e8cebe48a7f5584ec0576ee1e2ac1eb5`,alt:`Microsoft Need admin approval page for ContraForce API, with a Return to the application without granting consent link`,\"data-og-width\":`662`,width:`662`,\"data-og-height\":`668`,height:`668`,\"data-path\":`images/onboarding/customer-non-admin/onboarding-01-non-admin-customer-need-approval.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/customer-non-admin/onboarding-01-non-admin-customer-need-approval.png?w=280\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=f630616e0f4c525085b98579c0286c7a 280w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/customer-non-admin/onboarding-01-non-admin-customer-need-approval.png?w=560\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=d9a08af1bf90eecb50d8e8e1145ebb5f 560w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/customer-non-admin/onboarding-01-non-admin-customer-need-approval.png?w=840\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=ece3fa27a39c1d26ff5a25cd23b9c7f3 840w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/customer-non-admin/onboarding-01-non-admin-customer-need-approval.png?w=1100\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=18d43d4b427e938153559798c1ba1864 1100w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/customer-non-admin/onboarding-01-non-admin-customer-need-approval.png?w=1650\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=77f1ede3b7e9d0625d74af3fcedd20db 1650w, https://mintcdn.com/contraforce/WrVM0ufvE8QAC_TC/images/onboarding/customer-non-admin/onboarding-01-non-admin-customer-need-approval.png?w=2500\u0026fit=max\u0026auto=format\u0026n=WrVM0ufvE8QAC_TC\u0026q=85\u0026s=3f53da8865126fc94fc0f8905b86a6ca 2500w`})}),`\n`,_jsx(Heading,{level:`3`,id:`what-to-do`,children:`What to do`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Click Sign out in the top right`,children:_jsx(_components.p,{children:`This clears any stale session that might be blocking sign-in.`})}),_jsx(Step,{title:`If you're a Global Admin, click Try Again`,children:_jsx(_components.p,{children:`Sign in. Microsoft will show the consent screen. Accept both core consents, and you’ll proceed into your workspace.`})}),_jsx(Step,{title:`If you're not a Global Admin, click Email Your Admin`,children:_jsxs(_components.p,{children:[`Or copy the `,_jsx(_components.strong,{children:`Admin Consent Link`}),` from the page and send it to a Global Admin in your organization. Once they accept, return to your invite link and click `,_jsx(_components.strong,{children:`Try Again`}),`.`]})})]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Don’t keep retrying the same sign-in repeatedly without signing out. Repeated failures can compound the bad-session state and require a browser cache clear to recover.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next Steps`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Defender for Endpoint Module`,icon:`laptop-code`,href:`/guides/onboarding/defender-for-endpoint-module-deployment`,children:_jsx(_components.p,{children:`Deploy and consent to the Defender for Endpoint module`})}),_jsx(Card,{title:`Command Dashboard`,icon:`chart-line`,href:`/guides/getting-started/command-dashboard`,children:_jsx(_components.p,{children:`Your home base for incident triage across your environment`})}),_jsx(Card,{title:`Incident Management`,icon:`shield-halved`,href:`/guides/getting-started/incident-management`,children:_jsx(_components.p,{children:`How to triage, investigate, and respond to incidents`})}),_jsx(Card,{title:`What Are Gamebooks?`,icon:`bolt`,href:`/guides/getting-started/what-are-gamebooks`,children:_jsx(_components.p,{children:`Automated response workflows you can run from any incident`})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Need help?`}),` 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":"Customer Workspace Onboarding","description":"Finish customer workspace onboarding: open your invite link, grant the ContraForce API and Portal consents, consent each module, and fix sign-in failures.","keywords":["customer workspace onboarding","accept ContraForce workspace invite","grant Microsoft Entra admin consent to ContraForce","consent modules on the Modules tab","Sign In Failed need admin approval","workspace status light"],"href":"/guides/onboarding/customer-workspace-onboarding"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[]},{"title":"How onboarding works","slug":"how-onboarding-works","depth":2,"children":[]},{"title":"Step 1: Grant ContraForce Access to Your Tenant","slug":"step-1-grant-contraforce-access-to-your-tenant","depth":2,"children":[]},{"title":"Step 2: Consent to Your Modules","slug":"step-2-consent-to-your-modules","depth":2,"children":[]},{"title":"Step 3: Confirm Your Workspace Is Live","slug":"step-3-confirm-your-workspace-is-live","depth":2,"children":[]},{"title":"Adding Users (After Onboarding)","slug":"adding-users-after-onboarding","depth":2,"children":[]},{"title":"Troubleshooting: Sign-in Failed","slug":"troubleshooting-sign-in-failed","depth":2,"children":[{"title":"What to do","slug":"what-to-do","depth":3,"children":[]}]},{"title":"Next Steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"contraforce","siteName":"ContraForce","title":"Customer Workspace Onboarding - ContraForce","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T17:54:18.227Z","gitLastModified":"2026-10-08T16:28:19.000Z","originalFileLocation":"guides/onboarding/customer-workspace-onboarding.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=\"Finish customer workspace onboarding: open your invite link, grant the ContraForce API and Portal consents, consent each module, and fix sign-in failures.\">\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=\"Customer Workspace Onboarding - ContraForce\">\u003cmeta data-mint-head property=\"og:description\" content=\"Finish customer workspace onboarding: open your invite link, grant the ContraForce API and Portal consents, consent each module, and fix sign-in failures.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ContraForce Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.contraforce.com/guides/onboarding/customer-workspace-onboarding\">\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=Onboarding\u0026amp;title=Customer+Workspace+Onboarding\u0026amp;description=Finish+customer+workspace+onboarding%3A+open+your+invite+link%2C+grant+the+ContraForce+API+and+Portal+consents%2C+consent+each+module%2C+and+fix+sign-in+failures.\u0026amp;theme=1c0866f521e74e7fb988d9b6\u0026amp;signature=b3d4933175d92a9b2a81fa8d3db5e282ce3ac54ea97c17437d9bf8773e196413\">\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=\"Customer Workspace Onboarding - ContraForce\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Finish customer workspace onboarding: open your invite link, grant the ContraForce API and Portal consents, consent each module, and fix sign-in failures.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://contraforce.mintlify.site/_mintlify/api/og/v2?division=Onboarding\u0026amp;title=Customer+Workspace+Onboarding\u0026amp;description=Finish+customer+workspace+onboarding%3A+open+your+invite+link%2C+grant+the+ContraForce+API+and+Portal+consents%2C+consent+each+module%2C+and+fix+sign-in+failures.\u0026amp;theme=1c0866f521e74e7fb988d9b6\u0026amp;signature=b3d4933175d92a9b2a81fa8d3db5e282ce3ac54ea97c17437d9bf8773e196413\">\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/onboarding/customer-workspace-onboarding\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/onboarding/customer-workspace-onboarding.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/onboarding/customer-workspace-onboarding#webpage\",\"url\":\"https://docs.contraforce.com/guides/onboarding/customer-workspace-onboarding\",\"name\":\"Customer Workspace Onboarding\",\"description\":\"Finish customer workspace onboarding: open your invite link, grant the ContraForce API and Portal consents, consent each module, and fix sign-in failures.\",\"dateModified\":\"2026-10-08T16:28:19.000Z\",\"isPartOf\":{\"@id\":\"https://docs.contraforce.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.contraforce.com/guides/onboarding/customer-workspace-onboarding#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.contraforce.com/guides/onboarding/customer-workspace-onboarding#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Onboarding\",\"item\":\"https://docs.contraforce.com/onboarding-customer-workspaces\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Customer Workspace Onboarding\",\"item\":\"https://docs.contraforce.com/guides/onboarding/customer-workspace-onboarding\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.contraforce.com/guides/onboarding/customer-workspace-onboarding#article\",\"headline\":\"Customer Workspace Onboarding\",\"name\":\"Customer Workspace Onboarding\",\"description\":\"Finish customer workspace onboarding: open your invite link, grant the ContraForce API and Portal consents, consent each module, and fix sign-in failures.\",\"url\":\"https://docs.contraforce.com/guides/onboarding/customer-workspace-onboarding\",\"mainEntityOfPage\":{\"@id\":\"https://docs.contraforce.com/guides/onboarding/customer-workspace-onboarding#webpage\"},\"dateModified\":\"2026-10-08T16:28:19.000Z\",\"keywords\":\"customer workspace onboarding, accept ContraForce workspace invite, grant Microsoft Entra admin consent to ContraForce, consent modules on the Modules tab, Sign In Failed need admin approval, workspace status light\",\"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/onboarding/customer-workspace-onboarding.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","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","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","description":"Onboard your MSP or MSSP organization: grant Microsoft Entra admin consent, set up your Agent Center, connect detection sources, and pre-onboard customers.","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","description":"See which Microsoft Entra roles can grant ContraForce admin consent, when you need Subscription Owner, and the permissions each enterprise app requests.","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":"Customer Workspace Onboarding - 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"]}