> For the complete documentation index, see [llms.txt](https://cortex-docs.paloaltonetworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-saas/multi-tenant.md). # Multi-Tenant - [What is Cortex XSOAR multi-tenant?](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-saas/multi-tenant/what-is-cortex-xsoar-multi-tenant.md): Learn about Cortex XSOAR multi-tenant deployments that provide data segregation while enabling you to manage multiple tenants from a single console. - [Onboard Cortex XSOAR multi-tenant](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-saas/multi-tenant/onboard-cortex-xsoar-multi-tenant.md): Learn how to activate and manage tenants and configure single sign-on. - [Onboarding checklist for multi-tenant deployments](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-saas/multi-tenant/onboard-cortex-xsoar-multi-tenant/onboarding-checklist-for-multi-tenant-deployments.md): Onboard for Multi-tenant/MSSP deployments - [Step 1. Activate Cortex XSOAR (Main Tenant)](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-saas/multi-tenant/onboard-cortex-xsoar-multi-tenant/step-1.-activate-cortex-xsoar-main-tenant.md): Learn how to activate Cortex XSOAR from the Cortex Gateway. - [Step 2. Create a child tenant](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-saas/multi-tenant/onboard-cortex-xsoar-multi-tenant/step-2.-create-a-child-tenant.md): Create child tenants in the Cortex Gateway. - [Step 3. Allocate incident retention licenses](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-saas/multi-tenant/onboard-cortex-xsoar-multi-tenant/step-3.-allocate-incident-retention-licenses.md): Retention policy for Cortex XSOAR multi-tenant and MSSP users. - [Step 4. Set up an engine](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-saas/multi-tenant/onboard-cortex-xsoar-multi-tenant/step-4.-set-up-an-engine.md): Install engines on tenants in a Cortex XSOAR multi-tenant deployment. Configure firewall to allow communication between engine and tenant. - [Step 5. Set up a remote repository](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-saas/multi-tenant/onboard-cortex-xsoar-multi-tenant/step-5.-set-up-a-remote-repository.md): Overview of how remote repositories work and how to configure a remote repository in Cortex XSOAR for a multi-tenant deployment. - [Step 6. Set up users and roles](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-saas/multi-tenant/onboard-cortex-xsoar-multi-tenant/step-6.-set-up-users-and-roles.md): Create user groups and roles, manage users in the Main Tenant, and Authenticate users using SAML 2.0 or the Cortex Gateway in a multi-tenant deployment - [Step 7. Install and configure content](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-saas/multi-tenant/onboard-cortex-xsoar-multi-tenant/step-7.-install-and-configure-content.md): Install and configure content when onboarding Cortex XSOAR. This step applies to Multi-tenant and MSSP environments. - [Child tenant management](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-saas/multi-tenant/child-tenant-management.md): You can change the subdomain of a child tenant, change the name of a child tenant, and delete a child tenant, in the Cortex Gateway. - [Content management in multi-tenant](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-saas/multi-tenant/child-tenant-management/content-management-in-multi-tenant.md): Content is pushed from the Main Tenant to child tenants by applying corresponding propagation labels to content and child tenants. - [Add propagation labels to content](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-saas/multi-tenant/child-tenant-management/content-management-in-multi-tenant/add-propagation-labels-to-content.md) - [Add propagation labels to a child tenant](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-saas/multi-tenant/child-tenant-management/content-management-in-multi-tenant/add-propagation-labels-to-a-child-tenant.md) - [Sync content to child tenants](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-saas/multi-tenant/child-tenant-management/content-management-in-multi-tenant/sync-content-to-child-tenants.md) - [Manage content using a remote repository](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-saas/multi-tenant/child-tenant-management/content-management-in-multi-tenant/manage-content-using-a-remote-repository.md) - [Incident management on the Main Tenant](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-saas/multi-tenant/incident-management-on-the-main-tenant.md): Open an incident in Cortex XSOAR and take action on child tenants - [Manage main tenant users in an investigation](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-saas/multi-tenant/incident-management-on-the-main-tenant/manage-main-tenant-users-in-an-investigation.md): Open an incident in Cortex XSOAR and take action on child tenants - [Run a command on multiple tenants](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-saas/multi-tenant/incident-management-on-the-main-tenant/run-a-command-on-multiple-tenants.md): Run a command on incidents residing on multiple tenants in a Cortex XSOAR multi-tenant deployment - [Indicator management on the Main Tenant](https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-saas/multi-tenant/indicator-management-on-the-main-tenant.md): View and take action on indicators on the Main Tenant. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://cortex-docs.paloaltonetworks.com/cortex-xsoar-8-saas/multi-tenant.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.