Cortex XSOAR Integration

The Cyberpion content pack allows you to seamlessly receive all your Cyberpion security solution Action Items and supportive information into your Cortex XSOAR, and thus create and view dashboards, create custom alerts, streamline remediations and improve investigations. Integration between Cyberpion and Cortex XSOAR makes use of REST API.

Cortex XSOAR Integration

The Cyberpion content pack allows you to seamlessly receive all your Cyberpion security solution Action Items and supportive information into your Cortex XSOAR, and thus create and view dashboards, create custom alerts, streamline remediations and improve investigations. Integration between Cyberpion and Cortex XSOAR makes use of REST API.

Integration guide – Cortex XSOAR:

Cyberpion can integrate and export incidents and relevant information directly to Cortex XSOAR.

Generating a Cyberpion API key for the integration

The integration involves having the Cortex XSOAR make calls to Cyberpion API endpoints in order to retrieve the information. Thus, you will need to enter the Cyberpion Server URL as well as a valid Cyberpion API key to Cortex.

The server URL is https://<your portal’s name at Cyberpion>.cyberpion.com, e.g., https://hportal.cyberpion.com

To generate a new API key,

1.

Log into the Cyberpion portal

2.

Click the settings buttonàAPI Settings

3.

Provide a name for the token, specify if the token is read-write or read-only (only the latter is necessary), and set an expiry date.

4.

Click “Create Token”

5.

Copy the generated token to a secure file. You’ll need it later.

Configuring your Cortex XSOAR:

1.

Head to the XSOAR Marketplace:

2.

Find and install Cyberpion:

3.

Go to Settings:

4.

Search for Cyberpion and click on “Add Instance”:

5.

Fill in the server URL and API key that were provided by the Cyberpion portal (located within setting -> Integration settings):

6.

Form field names, explanations and tips:

Field  Explanation 
Fetches incidents Should be checked (this determines whether to get Cyberpion’s action items from the server)
Make sure “Fetches incidents” is enabled
Do not fetch Should be false
Classifier Should be (by default) Cyberpion – Classifier
Incident type (if classifier doesn’t exist) Should be (by default) N/A
Mapper (incoming) Should be (by default) Cyberpion – Mapper
Server URL Paste here the Cyberpion URL as described above
API Key Paste here the Cyberpion API key as described above
Maximum number of incidents per fetch Determines how many action items are fetched every minute The default is set for 200 and we recommend leaving it as such
Action items category to fetch as incidents Action items categories to fetch
Options are DNS, PKI, Cloud and Vulnerabilities
Default is set to include all Action Item types
Show only active issues We recommend that this checkbox be marked

If not enabled, closed issues (resolved action items) will be fetched in addition to the active ones

Trust any certificate N/A
Use system proxy settings N/A
Do not use by default N/A
7.

After clicking “save”, Action items will start to appear at the ‘incidents’ section:

8.

Cortex XSOAR pulls Action Items at a rate of 200 every minute until all Action Items are uploaded

9.

Click on “Investigate” to see the Action Item details:

10.

Action Items will include the following information:

  • Cyberpion title
  • Cyberpion category
  • Cyberpion domain (AKA asset)
  • Cyberpion incident description
  • Technical data
  • Cyberpion Solution
11.

Playbook

The playbook added within this content package will allow you to request additional information relating to the Action Items that were reported, in order to help with context, investigation, and effective remediation.

The default playbooks intention is basic, it allows the user to create customized playbooks and/or connect the offered playbook template to a more general playbook.

Users can view the playbook within an incident by clicking the “Work Plan” tab and following the steps presented:

Let Us
Show You.

What Do You Really Know About The
Security Posture Of Your Digital Ecosystem?

See the risks you’re exposed to with a vulnerability assessment.