Set up a remote repository - Administrator Guide - Cortex XSIAM - Cortex - Security Operations

Cortex XSIAM Documentation

Product
Cortex XSIAM
Creation date
2024-03-06
Last date published
2024-04-25
Category
Administrator Guide
Abstract

Creating a development tenant automatically creates a private content repository. Activate the content repository feature on the production tenant.

When you set up a remote repository, you can use the Cortex XSIAM built-in remote repository, add any private remote repository that is Git-based, or use an on-prem repository.

Considerations
  • When you activate a tenant and enable the content repository in Cortex Gateway, Cortex XSIAM by default uses the the built-in repository. The built-in remote repository requires fewer configurations than using a private remote repository and cannot be accessed directly. If you want to use a private remote repository, you need to configure it when you enable the remote repository in the tenant.

  • When activating a new development tenant in Cortex Gateway for remote repository (adding it to a cluster), all tenants already in the cluster need to be already activated and enabled for push/pull.

  • After the remote repository is enabled in the production tenant as a pull tenant, by default the first activated development tenant is set to push content to the remote repository. When you add additional development tenants, they are automatically set to pull content from the remote repository.

  • If the content repository option is disabled for the production or development tenant (under SettingsConfigurationsGeneralRemote Repository Settings, toggle the Content repository slider to off), the tenant becomes standalone and does not push or pull content.

    If you disable the remote repository feature, content on the tenant is not deleted. If you enable the remote repository feature again and the remote repository contains content, you need to choose which content to keep, either the content on the tenant or the content on the remote repository. We recommend backing up any content that you want to keep before enabling again.

  • When enabling a remote repository in a tenant:

    • If the relevant repository branch is empty, it inherits the content of the tenant.

    • If the relevant branch is not empty, you can select which content to keep, either the existing content on your tenant or the existing content on the specified repository. If you want to keep the content on the tenant, you need to first disable the remote repository in the other tenants in the cluster (making them standalone). If even one tenant has remote repository enabled, you can only keep the existing content on the specified repository.

  • For a simple one-branch deployment, we recommend using the built-in repository. If you want to use multiple branches, or if you need access to the content repository outside the Cortex XSIAM platform (for example to implement some scanners) you must use a private repository.

    If you want to use a private remote repository with one or more branches, you need to enable the remote repository in each tenant and then set up the different branches you want to use in each tenant.

  • Activation may take some time. You should receive notification by email that the production or development tenant has completed the activation process.

  • Once the activation completes, you can only change content repository settings within the tenant.

Before you begin
  • If you are changing your remote repository settings, back up existing content to your local computer by navigating to SettingsConfigurationsGeneralServer SettingsCustom Content and click Export all custom content.

  • You must have Instance Administrator or Account Admin permission.