Manage Content Overview
Content is pushed from the master account to tenant accounts
by applying corresponding propagation labels to content and tenant
accounts. Cortex XSOAR
Content, including integrations, can be configured on
the main account or on tenant accounts.
In most cases, if the content applies to all tenants, it should
be configured on the main account and pushed to the tenants. In
some cases, you may need to configure an integration on the tenant
level. For example, you might have a situation where only the customer
has the information needed to configure a specific integration and
they do not want that information stored at the main account level.
In addition, any integration that fetches incidents or indicators
(feeds) must be configured on the tenant level, since incidents
are not stored on the main account. If an integration has the same
settings for multiple tenants, you have the option, with selective
propagation, to configure the integration on the main account level
and propagate to specific tenants.
In order for a content item to be synced to a
tenant account, both the content and tenant account must have the
same propagation label.
For example, if you want Playbook ABC to sync
to Tenant 123, they both need to have the same propagation label,
such as
Premium
.
When using a remote repository with a multi-tenant deployment, the
remote repository must be configured and a machine must be set as
the development environment, before you can view propagation labels.
As of version 6.0, if there is no relevant propagation
tag on your content, for example, a script or playbook, but it is
a dependency of a package that you do propagate to a tenant, the
unlabeled content is still synced to the tenant.
There are several types of propagation labels that you can use
for syncing content to tenant accounts.
All
: Content items with the label
all
will
be synced to all tenants, whether or not the tenants have labels.
This is the default label for content items.
Custom
: You can add custom labels by typing a label
name in the
Propagation Label
field when
adding or editing a content item or a tenant.
None
: If a content item does not have any labels,
it will not be synced to any tenants. If a tenant does not have
any labels, only content items with the
all
propagation
label will sync to it.
We recommend that you first apply
propagation labels to your tenant accounts and then add the corresponding
labels to the content items that you want to sync to the tenants.
If you sync a content item from the main account to a tenant account,
and a content item with that same name already exists on the tenant account,
the content on the tenant account will be overwritten. This applies
to integrations, fields, incident types, and Threat Intel report
types.
To remove propagation labels, use the API call
DELETE /propagationlabels/
<label-name>
.