Assets API - User Guide - 1.0 - Cortex XPANSE - Cortex - Security Operations

Cortex Xpanse User Guide

Product
Cortex XPANSE
Version
1.0
Creation date
2022-08-25
Last date published
2024-03-14
End_of_Life
EoL
Category
User Guide
Abstract

Overview of Cortex Xpanse Expander Assets APIs.

The Cortex Xpanse Expander APIs facilitate tight integration into your security ecosystem. Xpanse currently supports two active versions of the Asset API. For all new customers or customers doing new development utilizing Xpanse assets, we highly recommend using the Assets v3 API.

  • The Assets v3 API supports all asset types currently in Xpanse (IP Ranges, Domains, Certificates, Cloud Resources, Networks, and Devices) and will be extended to support any new types of assets added in the future. The Assets v3 API exposes all asset types through a common interface with a generic model - reducing friction for developing against multiple asset types. Assets v3 endpoints can be identified by the path prefix “api/v3/assets”.

  • The Assets v2 API, as the legacy version is known, supports IP Ranges, Domains, Certificates, and Cloud Resources. We do not recommend the Assets v2 API for new development unless Custom IP Ranges are required since this capability is not supported in the v3 API. Assets v2 endpoints can be identified by the path prefix “api/v2/assets”.