VectraAIEventCollector

Collects Vectra Detections and Audits into XSIAM Events.

Network Security · Vectra AI

Details

IDVectraAIEventCollector
ProviderVectra AI
CategoryNetwork Security
From Version6.10.0
Docker Imagedemisto/python3:3.12.13.10116658
Supported ModulesAgentix XSIAM

README

Collects Vectra Detections and Audits into XSIAM Events.
This integration was integrated and tested with version 2.2 of Vectra.

This is the default integration for this content pack when configured by the Data Onboarder in Cortex XSIAM.

Configure Vectra Event Collector in Cortex

Parameter Description Required
Your server URL   True
API Token The API Token to use for authentication. True
First fetch time   False
Fetch Limit Maximum amount of detections to fetch. Audits API does not include a fetch limit therefore this configuration is only relevant to detections. False
Trust any certificate (not secure)   False
Use system proxy settings   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.

vectra-get-events


Fetches events (detections and audits) from Vectra.

Base Command

vectra-get-events

Input

Argument Name Description Required
should_push_events If true, the command will create events, otherwise it will only display them. Possible values are: true, false. Required

Context Output

There is no context output for this command.

Configuration parameters

  • url — Your server URL (required)
  • credentials — (required)
  • first_fetch — First fetch time
  • fetch_limit — Fetch Limit
  • insecure — Trust any certificate (not secure)
  • proxy — Use system proxy settings

Commands (1)

  • vectra-get-events

    Fetches events (detections and audits) from Vectra.

category: Network Security
provider: Vectra AI
commonfields:
  id: VectraAIEventCollector
  version: -1
configuration:
- name: url
  defaultvalue: https://dev.vectra.ai/
  display: Your server URL
  required: true
  type: 0
- name: credentials
  displaypassword: API Token
  additionalinfo: The API Token to use for authentication.
  required: true
  hiddenusername: true
  type: 9
- name: first_fetch
  defaultvalue: 3 days
  display: First fetch time
  type: 0
  section: Collect
  advanced: true
  required: false
- name: fetch_limit
  defaultvalue: '1000'
  display: Fetch Limit
  additionalinfo: Maximum amount of detections to fetch. Audits API does not include a fetch limit therefore this configuration is only relevant to detections.
  type: 0
  section: Collect
  advanced: true
  required: false
- name: insecure
  display: Trust any certificate (not secure)
  type: 8
  required: false
- name: proxy
  display: Use system proxy settings
  type: 8
  required: false
description: 'Collects Vectra Detections and Audits into XSIAM Events.'
display: 'Vectra AI Event Collector'
name: VectraAIEventCollector
supportlevelheader: xsoar
script:
  commands:
  - name: vectra-get-events
    description: Fetches events (detections and audits) from Vectra.
    arguments:
    - name: should_push_events
      auto: PREDEFINED
      description: If true, the command will create events, otherwise it will only display them. Default is false.
      predefined:
      - 'true'
      - 'false'
      required: true
  isfetchevents: true
  script: '-'
  type: python
  subtype: python3
  dockerimage: demisto/python3:3.12.13.10116658
marketplaces:
- marketplacev2
- platform
fromversion: 6.10.0
tests:
- No tests (auto formatted)
supportedModules:
- xsiam