Skip to main content

OctoxLabs

This Integration is part of the OctoxLabs Pack.#

Supported versions

Supported Cortex XSOAR versions: 6.0.0 and later.

This integration is for search your assets and fetch details them in OctoxLabs Asset Management Platform. This integration was integrated and tested with version 3.0.1 of OctoxLabs

Configure OctoxLabs on Cortex XSOAR#

  1. Navigate to Settings > Integrations > Servers & Services.

  2. Search for OctoxLabs.

  3. Click Add instance to create and configure a new integration instance.

    ParameterDescriptionRequired
    IPYour Octox Labs Platform IPTrue
    API KeyYour Octox Labs API Key. (https://github.com/octoxlabs/py-octoxlabs\#getting-started\)True
  4. Click Test to validate the URLs, token, and connection.

Commands#

You can execute these commands from the Cortex XSOAR CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.

octoxlabs-get-adapters#


Fetch octoxlabs all adapters

Base Command#

octoxlabs-get-adapters

Input#

There are no input arguments for this command.

Context Output#

PathTypeDescription
OctoxLabs.Adapters.countNumberAdapters count
OctoxLabs.Adapters.results.idNumberAdapter id
OctoxLabs.Adapters.results.nameStringAdapter name
OctoxLabs.Adapters.results.slugStringAdapter slug
OctoxLabs.Adapters.results.descriptionStringAdapter description
OctoxLabs.Adapters.results.groupsUnknownList<string> Adapter groups
OctoxLabs.Adapters.results.betaBooleanAdapter is beta?
OctoxLabs.Adapters.results.statusNumberAdapter status
OctoxLabs.Adapters.results.hr_statusStringAdapter human readable status

octoxlabs-get-connections#


Fetch octoxlabs connections

Base Command#

octoxlabs-get-connections

Input#

Argument NameDescriptionRequired
pagePage number.Optional

Context Output#

PathTypeDescription
OctoxLabs.Connections.countNumberConnections count
OctoxLabs.Connections.results.idNumberConnection id
OctoxLabs.Connections.results.adapter_idNumberConnection adapter id
OctoxLabs.Connections.results.adapter_nameStringConnection adapter name
OctoxLabs.Connections.results.nameStringConnection name
OctoxLabs.Connections.results.statusBooleanConnection status
OctoxLabs.Connections.results.descriptionStringConnection description
OctoxLabs.Connections.results.enabledBooleanConnection is enabled?

octoxlabs-get-discoveries#


Fetch octoxlabs discoveries

Base Command#

octoxlabs-get-discoveries

Input#

Argument NameDescriptionRequired
pagePage number.Optional

Context Output#

PathTypeDescription
OctoxLabs.Discoveries.countNumberTotal discovery count
OctoxLabs.Discoveries.results.idNumberDiscovery id
OctoxLabs.Discoveries.results.start_timeStringDiscovery start time
OctoxLabs.Discoveries.results.end_timeStringDiscovery end time
OctoxLabs.Discoveries.results.statusNumberDiscovery status
OctoxLabs.Discoveries.results.hr_statusStringDiscovery human readable status
OctoxLabs.Discoveries.results.progressNumberDiscovery progress

octoxlabs-get-last-discovery#


Get last success discovery

Base Command#

octoxlabs-get-last-discovery

Input#

There are no input arguments for this command.

Context Output#

PathTypeDescription
OctoxLabs.Discovery.idNumberLast discovery id
OctoxLabs.Discovery.start_timeStringLast discovery start time
OctoxLabs.Discovery.end_timeStringLast discovery end time
OctoxLabs.Discovery.statusNumberLast discovery status
OctoxLabs.Discovery.hr_statusStringLast discovery human readable status
OctoxLabs.Discovery.progressNumberLast discovery progress

octoxlabs-search-devices#


Search in your devices

Base Command#

octoxlabs-search-devices

Input#

Argument NameDescriptionRequired
queryQuery.Optional
fieldsFields.Optional
pagePage.Optional
sizeSize.Optional
discovery_idSpecific Discovery Id.Optional

Context Output#

PathTypeDescription
OctoxLabs.Devices.countNumberTotal devices count
OctoxLabs.Devices.resultsUnknownList<Dict> Device information

octoxlabs-get-device#


Fetch your device

Base Command#

octoxlabs-get-device

Input#

Argument NameDescriptionRequired
hostnameYour device hostname.Required
discovery_idYour device at specific discovery.Optional

Context Output#

PathTypeDescription
OctoxLabs.DeviceUnknown<Dict> Octoxlabs Device