SailPointIdentityNowEventCollector

Details

ID	`SailPointIdentityNowEventCollector`
Provider	SailPoint Technologies
Category	Analytics & SIEM
From Version	8.4.0
Docker Image	`demisto/python3:3.12.13.10116658`
Supported Modules	Agentix XSIAM EDR Cortex Cloud Cloud Runtime Security

README

This is the SailPoint IdentityNow event collector integration for Cortex XSIAM.
This integration was integrated and tested with version 3 of SailPoint API.

Configure SailPoint IdentityNow Event Collector in Cortex

Parameter	Required
IdentityNow Server URL (e.g., https://{tenant}.api.identitynow.com) In order to get the tenant name, follow this link.	True
Client ID In order to generate the Client ID and Client Secret, follow this link.	True
Client Secret	True
Max number of events per fetch	False
Minutes to look back when fetching	False
Trust any certificate (not secure)	False
Use system proxy settings	False

Note: The Minutes to look back when fetching parameter is recommended when missing events due to API indexing delay. It should be increased with caution, since in cases of dense events within a minute, increasing the lookback for several minutes can affect performance.

Note: After generating client credentials, it is required to allow the following scopes: sp, search, read.

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.

identitynow-get-events

Gets events from SailPoint IdentityNow. This command is used for developing/debugging and is to be used with caution, as it can create events, leading to event duplication and exceeding API request limitations.

Base Command

identitynow-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. Default is false.	Optional
limit	Maximum number of results to return. Default is 50.	Optional
from_date	Date from which to get events in the format of %Y-%m-%dT%H:%M:%S.	Optional
from_id	An ID of the event to retrieve events from.	Optional

Context Output

There is no context output for this command.

Configuration parameters

url — IdentityNow Server URL (e.g., https://{tenant}.api.identitynow.com) (required)
credentials — Client ID (required)
limit — Max number of events per fetch
insecure — Trust any certificate (not secure)
proxy — Use system proxy settings
look_back — Minutes to look back when fetching

Commands (1)

identitynow-get-events
Gets events from SailPoint IdentityNow. This command is used for developing/debugging and is to be used with caution, as it can create events, leading to event duplication and exceeding API request limitations.

Source

SailPointIdentityNowEventCollector.py SailPointIdentityNowEventCollector_test.py SailPointIdentityNowEventCollector.yml SailPointIdentityNowEventCollector_description.md

Download History Raw

category: Analytics & SIEM
provider: SailPoint Technologies
sectionorder:
- Connect
- Collect
commonfields:
  id: SailPointIdentityNowEventCollector
  version: -1
configuration:
- display: IdentityNow Server URL (e.g., https://{tenant}.api.identitynow.com)
  name: url
  required: true
  type: 0
  section: Connect
- display: Client ID
  name: credentials
  type: 9
  required: true
  displaypassword: Client Secret
  section: Connect
- defaultvalue: 50000
  section: Collect
  display: Max number of events per fetch
  name: limit
  required: false
  type: 0
- display: Trust any certificate (not secure)
  name: insecure
  required: false
  type: 8
  section: Connect
- display: Use system proxy settings
  name: proxy
  required: false
  type: 8
  section: Connect
- display: Minutes to look back when fetching
  name: look_back
  additionalinfo: Helps avoid missing events due to vendor-side indexing delays. Use caution when increasing this value as significant increases may result in performance degradation.
  required: false
  defaultvalue: 0
  type: 0
  section: Collect
  advanced: true
description: This is the SailPoint IdentityNow event collector integration for Cortex XSIAM.
display: SailPoint IdentityNow Event Collector
name: SailPointIdentityNowEventCollector
supportlevelheader: xsoar
script:
  commands:
  - arguments:
    - auto: PREDEFINED
      defaultValue: 'false'
      description: If true, the command will create events, otherwise it will only display them.
      name: should_push_events
      predefined:
      - 'true'
      - 'false'
      required: false
    - description: Maximum number of results to return.
      name: limit
      required: false
      defaultValue: 50
    - description: An ID of the event to retrieve events from.
      name: from_id
      required: false
    - default: false
      description: Date from which to get events.
      name: from_date
    deprecated: false
    description: Gets events from SailPoint IdentityNow. This command is used for developing/debugging and is to be used with caution, as it can create events, leading to event duplication and exceeding API request limitations.

    name: identitynow-get-events
  dockerimage: demisto/python3:3.12.13.10116658
  isfetchevents: true
  runonce: false
  script: '-'
  subtype: python3
  type: python
marketplaces:
- marketplacev2
- platform
fromversion: 8.4.0
tests:
- No tests (auto formatted)
supportedModules:
- xsiam