Upload assets - User Guide - 2 - Cortex XPANSE - Cortex - Security Operations

Cortex Xpanse Expander User Guide

Product
Cortex XPANSE
Version
2
Creation date
2024-12-02
Last date published
2025-02-02
Category
User Guide
Solution
Cloud
Abstract

Add assets to your inventory through the UI.

You can add assets to your inventory by submitting an asset upload request, in the form of a CSV file, through the Cortex Xpanse UI. After you've submitted an asset upload request, the requested assets appear in the Asset Uploads/Removal table with the status Pending Review. Cortex Xpanse will respond to your upload request within five days of submission. The status of each asset will be updated in the Asset Uploads/Removal table to either Accepted, which indicates that the asset has been added to your inventory, or Rejected. Rejected assets will have an explanation for the rejection.

Guidelines and restrictions for asset uploads

Before you submit an asset upload request, familiarize yourself with the following guidelines and restrictions:

  • You can upload domains (paid-level domains and subdomains) and IPv4 ranges. You can upload a single IPv4 address, but it must be submitted as an IPv4 range asset type. Upload of certificates and IPv6 ranges is not yet supported.

  • An asset upload request can include up to 500 assets.

  • The asset upload request must follow the CSV formatting requirements described in the CSV format for upload requests section.

  • You cannot upload an asset that was added or rejected in a previous upload request. This will cause an error that must be fixed before you can submit the upload request.

  • You cannot upload an asset that was previously removed in an asset removal request. Instead you can undo an asset removal request, which will result in the asset being added back to your inventory. See Remove assets for details.

Note

If an asset upload request has an invalid CSV or includes one or more invalid assets, the entire request will fail, and none of the assets will be uploaded. If this happens, Cortex Xpanse will display an error message indicating what caused the error, so you can fix the problem and resubmit if you choose.

How to submit an asset upload request
  1. Create and save a CSV file that lists the assets you want to add to your inventory. It is important to format the CSV file correctly, or the upload might fail. Refer to CSV format for upload requests for an example and details about upload request CSV file formatting.

  2. Navigate to SettingsConfigurationsAsset ManagementAsset Uploads/Removals.

  3. Click the Asset Upload/Removal button and select Add Asset(s).

  4. Drag and drop or browse to your CSV file to upload it to Cortex Xpanse.

    The assets will be added to the Asset Uploads/Removals table with the status Pending,

  5. Check the status of your asset upload request as needed on the Asset Uploads/Removals page.

    Within five days of submitting your request, each asset will be Accepted and added to the inventory or Rejected. Assets that were rejected will include an explanation in the Decision Reason field.

An asset upload request is a CSV file that lists the assets you want to add along with the asset types and business units they will be assigned to. It is important to format the CSV file to match the following requirements. Incorrect formatting or typos may cause the upload to fail.

Upload request example

This example shows the correct CSV format for an asset upload request, including the supported values for asset types and supported IP range notation. The headers in your CSV must match the headers shown here.

BusinessUnits

AssetType

Asset

BU1, BU2

Domain

example.com

BU3

Domain

example1.com

BU1

IPv4_Range

192.0.2.0/32

BU2

IPv4_Range

192.0.2.0-192.0.2.0

BU1, BU3

IPv4_Range

192.0.2.0-192.0.2.24

BU2, BU3

IPv4_Range

192.0.2.0/27

Upload request CSV details

The following table provides details about each field that is required in an asset upload request CSV file.

Field

Details

Business Units

This is the business unit you want to assign to the asset upon upload.

The header for this field must be written as BusinessUnits.

The business units in your CSV must already exist in Cortex Xpanse and must use the exact same spelling and capitalization.

If you aren't sure which business units are available in your tenant, follow these steps to download the complete list of business units:

  1. Go to SettingsConfigurationsAsset ManagementAsset Uploads/Removals.

  2. In the upper righthand corner, click the Asset Upload/Removal button and select Asset Upload.

  3. In the Add List of Assets dialog box, click on Business Unit Directory to download the list of business units.

Asset Type

The header for this field must be written as AssetType.

Supported values are Domain and IPv4_Range.

Asset

This is the specific domain or IPv4 range you want to add to your inventory.

The header for this field must be written as Asset.

IP ranges can be specified using the following types of notation:

  • CIDR notation

  • <First IP address>-<Last IP address>

Individual IP addresses can be specified using the following notation:

  • 192.0.2.0/32

  • 192.0.2.0-192.0.2.0

After submitting an upload request, Cortex Xpanse will accept or reject each individual asset. Rejected assets will indicate the reason for the rejection in the Decision Reason column of the Asset Uploads/Removal table. Rejection reasons include the following:

  • The asset you uploaded shows registration information that is attributable to an unrelated organization.

  • The asset you uploaded is currently for sale.

  • The asset you uploaded is a cloud IP address or the asset you uploaded is a cloud or reserved internal IANA IP address. We do not add these asset types to customer maps.

  • The asset you uploaded contains your customer’s content. Cortex Xpanse focuses on corporate infrastructure for our telecommunications, ISPs, and other customer leasing organizations.