Cortex Xpanse Python SDK
Overview
This library is intended to be an interface to the Cortex Xpanse Public API.
Install
pip install xpanse
Requirements
Python 3.7+
Usage
Cortex Xpanse Public API Documentation
# Import client
from xpanse.client import XpanseClient
# Initialize client
client = XpanseClient()
# Get assets iterator object and dump to a list
assets = client.assets.list().dump()
You can view more example code in the examples directory.
Configuration
A valid API Key
, API Key ID
, and Fully Qualified Domain Name (FQDN)
are required for use.
Reference the docs for more information with Getting Started.
RECOMMENDED
You can supply them as environment variables.
export CORTEX_FQDN=<Your Xpanse Instance URL>
export CORTEX_API_KEY=<API Key>
export CORTEX_API_KEY_ID=<API Key ID>
NOT RECOMMENDED
The following parameters can be set inline using the XpanseClient
constructor.
This is not recommended, as it easily exposes sensitive credentials in your source code.
# Import client
from xpanse.client import XpanseClient
# Initialize client - THIS IS NOT RECOMMENDED, SET ENVIRONMENT VARIABLES INSTEAD
client = XpanseClient(url="https://my-company.crtx.us.paloaltonetworks.com",
api_key="xxxxxxxxxxxxxxxApiKeyxxxxxxxxxxxxxxx",
api_key_id=1)
Logging
Logging is handled through the python logging package. To enable different levels of verbosity in your scripts you can do the following:
import logging
# Set the logging level
logging.basicConfig(level=logging.DEBUG)
You can read more at https://docs.python.org/3/library/logging.html.