Overview

-
-

Use the ArcSight XML integration to fetch cases from ArcSight and create incidents Cortex XSOAR using XML files. ArcSight exports cases and security events as XML to a specified folder and Cortex XSOAR fetches the emails from the folder and creates an incident in Cortex XSOAR for each case.

-

Important: The integration should be executed in native Python, not Docker, because the program must have direct access to the folder, otherwise will not be fetched. You can use an engine, but make sure the engine does not use Docker. If the folder is on the Cortex XSOAR server then you can use python.executable=python.

-

Configure ArcSight XML on Cortex XSOAR

-
-
    -
  1. Navigate to Settings > Integrations > Servers & Services.
  2. -
  3. Search for ArcSight XML.
  4. -
  5. Click Add instance to create and configure a new integration instance.
    -
      -
    • Name: a textual name for the integration instance.
    • -
    • Fetch incidents
    • -
    • Incident type
    • -
    • Directory from which to get XML files and create incidents.
    • -
    • Directory to which put command XML files.
    • -
    -
  6. -
  7. Click Test to validate the URLs, token, and connection.
  8. -
-

Fetched Incidents Data

-
-

The integration polls the specified folder every minute. When there is an XML file in the folder, the integration loads that file, parses the Security Events/Cases, and converts the cases to incidents in Cortex XSOAR. The integration will delete those XML files.

-

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.

-
    -
  1. Update a case: arcsight-update-case
  2. -
-

1. Update a case

-
-

Creates an XML file to update a case.

-
Base Command
-
arcsight-update-case
-
Input
- - - - - - - - - - - - - - - - - - - - - - - - - -
Argument NameDescriptionRequired
caseIdID of the caseRequired
nameName of the caseRequired
stageThe stage of the caseRequired
-
-
Context Output
-

There is no context output for this command.

-
Command Example
-
!arcsight-update-case stage=CLOSED caseId=7-XAMnF8BABDCGttHdj30lA==
-
Human Readable Output
-

Modified stage to CLOSED in case 7-XAMnF8BABDCGttHdj30lA==

-

-

Export XML to a Folder in ArcSight

-
-
    -
  1. In the navigator pane, (left bar) select rules in the resources.
  2. -
  3. Double click the rule that you want to initiate the export.
  4. -
  5. In the right pane, (Inspect/Edit) click the Actions tab.
  6. -
  7. Right-click the relevant type, for example on every event, first event, and so on.
  8. -
  9. Select Add > Execute to External System.
  10. -
  11. Click Save.
  12. -
-

An XML file will is generated in the ArcSight server under /opt/arcsight/manager/archive/exports.