NetQuestOMX

NetQuest’s products are high-capacity service nodes that help security teams access and analyze network traffic. Powerful packet and flow processing features assist security tools in detecting and mitigating security threats as cost effectively as possible.

Utilities · NetQuest OMX

Details

IDNetQuestOMX
ProviderNetQuest Corporation
CategoryUtilities
From Version6.10.0
Docker Imagedemisto/python3:3.12.13.10116658
Supported ModulesAgentix XSIAM

README

NetQuest’s products are high-capacity service nodes that help security teams access and analyze network traffic. Powerful packet and flow processing features assist security tools in detecting and mitigating security threats as cost effectively as possible.
This integration was integrated and tested with version 3.7.5a of NetQuest OMX.

Configure NetQuest OMX in Cortex

Parameter Description Required
Server URL The IP of the 5G device using NetQuest OMX, formatted as https://X.X.X.X True
Username   True
Password   True
Slot number Target NetQuest device slot number. True
Port number Target NetQuest device port number. True
Fetch Events Whether to collect events. False
Statistic types to fetch   True
Use system proxy settings   False
Trust any certificate (not secure)   False

Commands

You can execute these commands from the 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.

netquest-address-list-upload


Uploads a .txt file with the address list to the appliance. The appliance temporarily stores the file until it is saved to the Library and replaces any previously loaded list file.

Base Command

netquest-address-list-upload

Input

Argument Name Description Required
entry_id The entry ID of the file to upload. Required

Context Output

There is no context output for this command.

netquest-address-list-optimize


Optimizes the updated address list. If the traffic elements are IP addresses, the integration will optimize the list by compressing IP addresses into CIDR groups.

Base Command

netquest-address-list-optimize

Input

There are no input arguments for this command.

Context Output

Path Type Description
NetQuest.AddressList.OverlappingAddresses list A list of overlapping addresses in the address list.
NetQuest.AddressList.OverlapsPresent boolean A boolean field that indicates whether overlapping IP address ranges are present in the address list.
NetQuest.AddressList.MergedAddresses list A list that contains consolidated IP address ranges, combining overlapping or contiguous addresses into a unified set.
NetQuest.AddressList.MergesPresent boolean A boolean field that indicates whether any address ranges in the list have been merged to eliminate overlaps or contiguous entries.
NetQuest.AddressList.CountsBefore Dictionary A dictionary that stores the number of occurrences of each IP address or address range before any processing or modifications were applied.
NetQuest.AddressList.CountsAfter Dictionary A dictionary that stores the number of occurrences of each IP address or address range after processing or modifications have been applied.

netquest-address-list-create


Creates a new address list. This list will replace and override the old list entity.

Base Command

netquest-address-list-create

Input

Argument Name Description Required
name The name for the new address list. Required

Context Output

There is no context output for this command.

netquest-address-list-rename


Renames an address list. This is only meant to change the name of the list. If you try to give the value of the new_name argument to an existing address list, the command will fail.

Base Command

netquest-address-list-rename

Input

Argument Name Description Required
new_name The new name for an existing address list. Required
existing_name The name of the address list that you want to modify. Required

Context Output

There is no context output for this command.

netquest-address-list-delete


Deletes the address list of the name provided.

Base Command

netquest-address-list-delete

Input

Argument Name Description Required
name The name of the address list to delete. Required

Context Output

There is no context output for this command.

get-events


Gets events from NetQuest OMX. Each event is a report for the specified statistic type. Available only for Cortex XSIAM.

Base Command

get-events

Input

Argument Name Description Required
should_push_events When true, the integration creates Cortex XSIAM events. Otherwise, they will only be displayed. Possible values are: true, false. Default is false. Required
statistic_types_to_fetch Comma-separated list of statistic types to return. Default is Metering Stats,Export Stats,Export Peaks FPS,Optimization Stats. Required

Context Output

There is no context output for this command.

<~PLATFORM>

License Requirements

The following configuration parameters require the Cortex XSIAM license:

  • Fetch Events

</~PLATFORM>

Configuration parameters

  • url — Server URL (required)
  • credentials — Username (required)
  • slot — Slot number (required)
  • port — Port number (required)
  • isFetchEvents — Fetch Events
  • eventFetchInterval — Events Fetch Interval
  • statistic_types_to_fetch — Statistic types to fetch (required)
  • proxy — Use system proxy settings
  • insecure — Trust any certificate (not secure)

Commands (6)

  • get-events

    Gets events from NetQuest OMX. Each event is a report for the specified statistic type. Available only for Cortex XSIAM.

  • netquest-address-list-create

    Creates a new address list. This list will replace and override the old list entity.

  • netquest-address-list-delete

    Deletes the address list of the name provided.

  • netquest-address-list-optimize

    Optimizes the updated address list. If the traffic elements are IP addresses, the integration will optimize the list by compressing IP addresses into CIDR groups.

  • netquest-address-list-rename

    Renames an address list. This is only meant to change the name of the list. If you try to give the value of the new_name argument to an existing address list, the command will fail.

  • netquest-address-list-upload

    Uploads a .txt file with the address list to the appliance. The appliance temporarily stores the file until it is saved to the Library and replaces any previously loaded list file.

category: Utilities
provider: NetQuest Corporation
sectionorder:
- Connect
- Collect
commonfields:
  id: NetQuestOMX
  version: -1
configuration:
- display: Server URL
  name: url
  required: true
  section: Connect
  type: 0
  additionalinfo: The IP of the 5G device using NetQuest OMX, formatted as https://X.X.X.X
- display: Username
  name: credentials
  type: 9
  required: true
  section: Connect
- display: Slot number
  name: slot
  type: 0
  required: true
  section: Collect
  additionalinfo: Target NetQuest device slot number.
  defaultvalue: '1'
- display: Port number
  name: port
  type: 0
  required: true
  section: Collect
  additionalinfo: Target NetQuest device port number.
- display: Fetch Events
  name: isFetchEvents
  type: 8
  required: false
  section: Collect
  hidden:
  - xsoar
  supportedModules:
  - xsiam
  additionalinfo: Whether to collect events.
- display: Events Fetch Interval
  name: eventFetchInterval
  type: 19
  required: false
  defaultvalue: '1'
  advanced: true
  section: Collect
  hidden:
  - xsoar
  supportedModules:
  - xsiam
- display: Statistic types to fetch
  name: statistic_types_to_fetch
  options:
  - Metering Stats
  - Export Stats
  - Export Peaks FPS
  - Optimization Stats
  type: 16
  defaultvalue: Metering Stats,Export Stats,Export Peaks FPS,Optimization Stats
  section: Collect
  required: true
  supportedModules:
  - xsiam
- name: proxy
  display: Use system proxy settings
  type: 8
  required: false
  section: Connect
- name: insecure
  display: Trust any certificate (not secure)
  type: 8
  required: false
  section: Connect
description: NetQuest’s products are high-capacity service nodes that help security teams access and analyze network traffic. Powerful packet and flow processing features assist security tools in detecting and mitigating security threats as cost effectively as possible.
display: NetQuest OMX
name: NetQuestOMX
script:
  commands:
  - arguments:
    - description: The entry ID of the file to upload.
      name: entry_id
      required: true
    description: Uploads a .txt file with the address list to the appliance. The appliance temporarily stores the file until it is saved to the Library and replaces any previously loaded list file.
    name: netquest-address-list-upload
  - description: Optimizes the updated address list. If the traffic elements are IP addresses, the integration will optimize the list by compressing IP addresses into CIDR groups.
    name: netquest-address-list-optimize
    outputs:
    - contextPath: NetQuest.AddressList.OverlappingAddresses
      description: A list of overlapping addresses in the address list.
      type: list
    - contextPath: NetQuest.AddressList.OverlapsPresent
      description: A boolean field that indicates whether overlapping IP address ranges are present in the address list.
      type: boolean
    - contextPath: NetQuest.AddressList.MergedAddresses
      description: A list that contains consolidated IP address ranges, combining overlapping or contiguous addresses into a unified set.
      type: list
    - contextPath: NetQuest.AddressList.MergesPresent
      description: A boolean field that indicates whether any address ranges in the list have been merged to eliminate overlaps or contiguous entries.
      type: boolean
    - contextPath: NetQuest.AddressList.CountsBefore
      description: A dictionary that stores the number of occurrences of each IP address or address range before any processing or modifications were applied.
      type: Dictionary
    - contextPath: NetQuest.AddressList.CountsAfter
      description: A dictionary that stores the number of occurrences of each IP address or address range after processing or modifications have been applied.
      type: Dictionary
  - arguments:
    - description: The name for the new address list.
      name: name
      required: true
    description: Creates a new address list.  This list will replace and override the old list entity.
    name: netquest-address-list-create
  - arguments:
    - description: The new name for an existing address list.
      name: new_name
      required: true
    - description: The name of the address list that you want to modify.
      name: existing_name
      required: true
    description: Renames an address list. This is only meant to change the name of the list. If you try to give the value of the new_name argument to an existing address list, the command will fail.
    name: netquest-address-list-rename
  - arguments:
    - description: 'The name of the address list to delete.'
      name: name
      required: true
    description: Deletes the address list of the name provided.
    name: netquest-address-list-delete
  - arguments:
    - auto: PREDEFINED
      defaultValue: 'false'
      description: When true, the integration creates Cortex XSIAM events. Otherwise, they will only be displayed.
      name: should_push_events
      predefined:
      - 'true'
      - 'false'
      required: true
    - name: statistic_types_to_fetch
      description: Comma-separated list of statistic types to return.
      isArray: true
      defaultValue: "Metering Stats,Export Stats,Export Peaks FPS,Optimization Stats"
      required: true
    description: Gets events from NetQuest OMX. Each event is a report for the specified statistic type. Available only for Cortex XSIAM.
    execution: false
    name: get-events
  runonce: false
  script: '-'
  type: python
  subtype: python3
  dockerimage: demisto/python3:3.12.13.10116658
  isfetchevents: true
  isfetchevents:xsoar: false
fromversion: 6.10.0
tests:
- No tests (auto formatted)