Edit and Push Content to a Remote Repository - Administrator Guide - 6.9 - Cortex XSOAR - Cortex - Security Operations

Cortex XSOAR Administrator Guide

Product
Cortex XSOAR
Version
6.9
Creation date
2022-09-29
Last date published
2024-03-28
End_of_Life
EoL
Category
Administrator Guide
Abstract

Push content to a remote repository and control access for pushing content.

Once you develop your content, for it to be available as part of a content update for the production environment, you must push the changes to the remote repository.

Caution

You should not manually push content to the remote repository. Use only the procedures outlined in the documentation to ensure that your content is properly updated in the production environment

You can save versions and manage revisions locally using the Save Version feature. If you don't want to save versions, you can click and save the changes.

multi-tenant-remote-rep.png

These options are only available for the following content types:

  • Automation

  • Playbooks

  • Integrations

  • Classifiers

  • Layouts

  • Reports

  • Dashboards

  • Incident types

  • Fields

  • Preprocess rules

  • Lists

  • Jobs

For all other content types, your changes are automatically saved locally.

You can push individual items such as a playbook, or content packs as a whole. If you want to have more granular control over the items in the content packs that you push, add the following server configuration.

Key

Value

ui.version.control.push.partial.packs

true

Exclude Content

In some cases, you may want to exclude items from being included in the local changes list, preventing them from being pushed to production, on a temporary or permanent basis. To exclude items, go to Settings → LOCAL CHANGES. Select the item(s) and click Exclude. Excluded items do not appear in the Local Changes list. To move items back to the Local Changes list, click on the Excluded Changes tab, select the item(s), and click Include.

Note

  • You can only exclude individual content items, not content packs.

  • When working with remote repositories and upgrading to v6.0 and above, push your classifiers and mappers on the development environment before upgrading the production environment.

RBAC Control

To restrict access when pushing content on the remote repository, add the following server configuration.

Key

Value

UI.version.control.admin.only

true

Note

This key also removes the Save Version feature, which prevents users, who don't have administration permissions, from pushing content changes to the remote repository.

Push and Install Content

  1. Push content to the Remote Repository.

    1. Go to Settings → Local Changes. Push the following content according to the tabs:

      • Items: Content that is not related specifically to a content pack. For example, customized automations or playbooks.

        If you have already pushed a content pack and later edit one of its content items, the edited items will appear in the Items tab, not the Packs tab.

      • Packs: All of the content that is specific to the content packs you installed from Marketplace.

      remote-manage.png
    2. Select the changes that you want to push to the remote repository, and click Push.

    3. In the dialog box, add an optional message and click Push.

    4. If the items have dependencies, review the contents and click Push.

      Sometimes you may not want to push all content, content pack dependencies, etc. For example, when a user makes a change in a playbook that includes an automation dependency to which another user is adding a feature, and the change does not require the new feature (version) of the automation, you can push the playbook without the new automation.

  2. On the remote repository, install the new content.

    1. At the top of any page, click Install New Content.

    2. In the dialog box, click Install Content.

      You can also check for new content that has been pushed.

    3. If conflicts appear, click Resolve conflicts.

    4. In the Action column, select one of the following:

      • Skip: Keeps the local content in your production environment.

      • Replace: Deletes the local content and installs the content from the remote repository.

    5. Click OK to save the changes.