SumoLogicSEC

Freeing the analyst with autonomous decisions.

Analytics & SIEM · Sumo Logic Cloud SIEM

Details

IDSumoLogicSEC
ProviderFrancisco Partners
CategoryAnalytics & SIEM
From Version5.0.0
Docker Imagedemisto/python3:3.12.13.10116658
Supported ModulesAgentix XSIAM

README

Freeing the analyst with autonomous decisions.
This integration was integrated and tested with version 6.1.0 of SumoLogicSEC.

Prerequisites

Only use this integration if your Cloud SIEM portal url ends with .sumologic.com - this can be verified via the url in your browser when logged into Cloud SIEM.

You’ll need an access key in order to complete the instance setup. Instructions on how to generate access keys can be found here.

Configure SumoLogicSEC in Cortex

Parameter Description Required
Sumo Logic API Endpoint https://api.<deployment>.sumologic.com/api True
Sumo Logic Instance Endpoint https://<yoursubdomain>.<deployment>.sumologic.com False
Fetch incidents   False
Incident type   False
Access ID   True
Access Key   True
Incidents Fetch Interval   False
Fetch Limit Fetch limit must not be greater than 200 False
Override default fetch query Default fetch query is status:in(“new”, “inprogress”) False
First fetch time   False
Pull associated Sumo Logic Signals as Incidents Pull Sumo Logic signals associated with detected Sumo Logic Insights as XSOAR incidents False
Incident Mirroring Direction Choose the direction to mirror the incident: Incoming (from Sumo Logic SIEM to Cortex XSOAR), Outgoing (from Cortex XSOAR to Sumo Logic SIEM), or Incoming and Outgoing (from/to Cortex XSOAR and Sumo Logic SIEM). Cortex XSOAR only parameter. False
Close Mirrored XSOAR Incident When selected, closing the Sumo Logic SIEM Insight is mirrored in Cortex XSOAR. Cortex XSOAR only parameter. False
Close Mirrored Sumo Logic Insight When selected, closing the Cortex XSOAR incident is mirrored in Sumo Logic SIEM. False
Override Record Summary Fields Record Summary Fields included when fetching Insights False

API documentation and query examples

For commands with query parameter input the available fields and operators are documented in API docs. These docs are useful when executing queries using the following commands:

  • sumologic-sec-insight-search
  • sumologic-sec-signal-search
  • sumologic-sec-entity-search

To access the API documentation, select the link for your deployment from here. Add sec to the end of the url to access Cloud SIEM API docs - e.g. https://api.us2.sumologic.com/docs/sec/.

Example: Insight search query ‘q’ parameter:

The search query string in our custom DSL that is used to filter the results.

Operators:

  • exampleField:"bar": The value of the field is equal to “bar”.
  • exampleField:in("bar", "baz", "qux"): The value of the field > is equal to either “bar”, “baz”, or “qux”.
  • exampleTextField:contains("foo bar"): The value of the field > contains the phrase “foo bar”.
  • exampleNumField:>5: The value of the field is greater than 5. There are similar <, <=, and >= operators.
  • exampleNumField:5..10: The value of the field is between 5 and 10 (inclusive).
  • exampleDateField:>2019-02-01T05:00:00+00:00: The value of the date field is after 5 a.m. UTC time on February 2, 2019.
  • exampleDateField:2019-02-01T05:00:00+00:00..2019-02-01T08:00:00+00:00: The value of the date field is between 5 a.m. and 8 a.m. UTC time on February 2, 2019.

Fields:

  • id
  • readableId
  • status
  • name
  • insightId
  • description
  • created
  • timestamp
  • closed
  • assignee
  • entity.ip
  • entity.hostname
  • entity.username
  • entity.type
  • enrichment
  • tag
  • severity
  • resolution
  • ruleId
  • records

Migrating from JASK content pack

The table below shows differences between this integration and the legacy JASK integration:

JASK (legacy) Sumo Logic Cloud SIEM Notes
jask-get-insight-details sumologic-sec-insight-get-details  
jask-get-insight-comments sumologic-sec-insight-get-comments  
jask-get-signal-details sumologic-sec-signal-get-details  
jask-get-entity-details sumologic-sec-entity-get-details  
jask-get-related-entities   Deprecated
jask-get-whitelisted-entities   Deprecated - use command sumologic-sec-entity-search with filter whitelisted:"true"
jask-search-insights sumologic-sec-insight-search  
jask-search-entities sumologic-sec-entity-search  
jask-search-signals sumologic-sec-signal-search  

New commands introduced in Sumo Logic Cloud SIEM pack

  • sumologic-sec-insight-set-status
  • sumologic-sec-match-list-get
  • sumologic-sec-match-list-update
  • sumologic-sec-threat-intel-search-indicators
  • sumologic-sec-threat-intel-get-sources
  • sumologic-sec-threat-intel-update-source

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.

sumologic-sec-insight-get-details


Get Insight details for a specific Insight ID.

Base Command

sumologic-sec-insight-get-details

Input

Argument Name Description Required
insight_id The insight to retrieve details for. Required
record_summary_fields Record Summary Fields to include in the output (override default fields). Optional

Context Output

Path Type Description
SumoLogicSec.Insight.Assignee string User or team assigned to the Insight
SumoLogicSec.Insight.Closed Date Closed date
SumoLogicSec.Insight.ClosedBy String Closed by user
SumoLogicSec.Insight.Created Date Created date
SumoLogicSec.Insight.Description String Description of the Insight
SumoLogicSec.Insight.Entity String Entity name associated with the Insight
SumoLogicSec.Insight.Id String The ID of the Insight
SumoLogicSec.Insight.LastUpdated Date The time the Insight was last updated
SumoLogicSec.Insight.LastUpdatedBy string The last user to update the Insight
SumoLogicSec.Insight.Name String The name of the Insight
SumoLogicSec.Insight.ReadableId String The ID of the Insight in readable form
SumoLogicSec.InsightList.RecordSummaryFields Array Record Summary Fields associated with the Insight
SumoLogicSec.Insight.Resolution String Resolution for closed Insight
SumoLogicSec.Insight.Severity String The severity of the Insight
SumoLogicSec.Insight.Signals.contentType String Type of content that triggered the Signal
SumoLogicSec.Insight.Signals.description String Description of the Signal
SumoLogicSec.Insight.Signals.id String The ID of the Signal
SumoLogicSec.Insight.Signals.name String The name of the Signal
SumoLogicSec.Insight.Signals.recordCount Number Number of records associated with the Signal
SumoLogicSec.Insight.Signals.ruleId String Rule ID associated with the Signal
SumoLogicSec.Insight.Signals.severity Number The severity of the Signal
SumoLogicSec.Insight.Signals.stage String The stage of the Signal
SumoLogicSec.Insight.Signals.timestamp Date Signal timestamp
SumoLogicSec.Insight.Source String The source of the Insight
SumoLogicSec.Insight.Status String The status of the Insight
SumoLogicSec.Insight.TimeToDetection Number Insight time to detection
SumoLogicSec.Insight.TimeToRemediation Number Insight time to remediation
SumoLogicSec.Insight.TimeToResponse Number Insight time to response
SumoLogicSec.Insight.Timestamp Date Insight timestamp

Command Example

!sumologic-sec-insight-get-details insight-id=INSIGHT-116

Human Readable Output

Insight Details:

Id Readable Id Name Action Status Assignee Description Last Updated Last Updated By Severity Closed Closed By Timestamp Entity Resolution
c6c97d84-983d-303e-a03b-86f53d657fc8 INSIGHT-116 Lateral Movement with Discovery and Credential Access   Closed   Initial Access, Lateral Movement, Discovery, Initial Access, Credential Access 2021-05-10T23:48:10.016204   HIGH 2021-05-10T23:48:09.961023 obfuscated@email.com 2021-02-18T22:04:08.330000 1.2.3.4 No Action

sumologic-sec-insight-get-comments


Get comments for a specific Insight ID. (Users can post and update comments on the Sumo Logic Cloud SIEM portal for any Insight ID.)

Base Command

sumologic-sec-insight-add-comment

Input

Argument Name Description Required
insight_id The insight ID for which to add a comment. Required
comment The comment to be added. Required

Context Output

Path Type Description
SumoLogicSec.InsightComments.Id String ID of comment
SumoLogicSec.InsightComments.Body String Comment contents
SumoLogicSec.InsightComments.Author String User that created the comment
SumoLogicSec.InsightComments.Timestamp Date Comment created timestamp
SumoLogicSec.InsightComments.InsightId String The ID of the Insight

Command Example

!sumologic-sec-insight-add-comment insight-id=INSIGHT-116 comment="This is an example comment"

Human Readable Output

Insight Comment:

Id Insight Id Author Body Last Updated Timestamp
2 INSIGHT-116 obfuscated@email.com This is an example comment   2021-04-23T00:38:43.977543

sumologic-sec-insight-get-comments


Get comments for a specific Insight ID. (Users can post and update comments on the Sumo Logic Cloud SIEM portal for any Insight ID.)

Base Command

sumologic-sec-insight-get-comments

Input

Argument Name Description Required
insight_id The insight ID for which to retrieve comments. Required

Context Output

Path Type Description
SumoLogicSec.InsightComments.Id String ID of comment
SumoLogicSec.InsightComments.Body String Comment contents
SumoLogicSec.InsightComments.Author String User that created the comment
SumoLogicSec.InsightComments.Timestamp Date Comment created timestamp
SumoLogicSec.InsightComments.InsightId String The ID of the Insight

Command Example

!sumologic-sec-insight-get-comments insight-id=INSIGHT-116

Human Readable Output

Insight Comments:

Id Insight Id Author Body Last Updated Timestamp
2 INSIGHT-116 obfuscated@email.com This is an example comment   2021-04-23T00:38:43.977543

sumologic-sec-signal-get-details


Get Signal details for a specific Signal ID. Signal details command references signals in Sumo Logic Cloud SIEM which are created when records exhibit suspicious properties and mate with patterns or other detection logic.

Base Command

sumologic-sec-signal-get-details

Input

Argument Name Description Required
signal_id The signal to retrieve details for. Required

Context Output

Path Type Description
SumoLogicSec.Signal.ContentType String Type of content that triggered the Signal
SumoLogicSec.Signal.Description String Description of the Signal
SumoLogicSec.Signal.Entity String Entity name associated with the Signal
SumoLogicSec.Signal.Id String The ID of the Signal
SumoLogicSec.Signal.Name String The name of the Signal
SumoLogicSec.Signal.RecordCount Number Number of records associated with the Signal
SumoLogicSec.Signal.RuleId String Rule ID associated with the Signal
SumoLogicSec.Signal.Severity Number The severity of the Signal
SumoLogicSec.Signal.Stage String The stage of the Signal
SumoLogicSec.Signal.Suppressed Boolean Whether or not the Signal was suppressed
SumoLogicSec.Signal.Timestamp Date Signal timestamp

Command Example

!sumologic-sec-signal-get-details signal-id=e0e7096b-2f91-5b72-b1a2-db48ce882dfc

Human Readable Output

Signal Details:

Id Name Rule Id Description Severity Content Type Timestamp Entity
e0e7096b-2f91-5b72-b1a2-db48ce882dfc Potential malicious JVM download LEGACY-S00062 A document was downloaded and opened followed by a file download using a Java user-agent. 4 RULE 2021-02-18T22:04:08.230000 1.2.3.4

sumologic-sec-entity-get-details


Get entity details for a specific entity ID

Base Command

sumologic-sec-entity-get-details

Input

Argument Name Description Required
entity-id The entity to retrieve details for. Required

Context Output

Path Type Description
SumoLogicSec.Entity.ActivityScore Number Entity Activity Score
SumoLogicSec.Entity.FirstSeen Date When the Entity was first seen
SumoLogicSec.Entity.Hostname String Entity hostname
SumoLogicSec.Entity.Id String Entity ID
SumoLogicSec.Entity.IsWhitelisted Boolean Whether or not the Entity is on allow list
SumoLogicSec.Entity.LastSeen Date When the Entity was last seen
SumoLogicSec.Entity.Name String The Entity name
SumoLogicSec.Entity.OperatingSystem String Entity Operating System (observed or from inventory)
SumoLogicSec.Entity.InventoryData Boolean Whether or not this Entity was ingested from inventory e.g. Active Directory

Command Example

!sumologic-sec-entity-get-details entity-id=_hostname-win10--admin.obfuscated

Human Readable Output

Entity Details

Id Name First Seen Last Seen Activity Score Is Whitelisted Operating System Inventory Data
_hostname-win10–admin.obfuscated win10-admin.obfuscated   2021-04-21T14:43:38.526000 9 false Windows 10 Enterprise true

sumologic-sec-insight-search


Search insights using available filters

Base Command

sumologic-sec-insight-search

Input

Argument Name Description Required
query Use a query string to search, see API documentation for more details. Optional
created When the insight was created. Defaults to ‘All time’ if no time arguments are specified. Possible values are: All time, Last week, Last 48 hours, Last 24 hours. Optional
status Comma separated list of values from the options: new,inprogress,closed. Optional
asignee User assigned to Insights. Optional
offset The number of items to skip before starting to collect the result set. Default is 0. Optional
limit The maximum number of items to return. Default is 10. Optional
record_summary_fields Record Summary Fields to include in the output (override default fields). Optional

Context Output

Path Type Description
SumoLogicSec.InsightList.Assignee String User or team assigned to the Insight
SumoLogicSec.InsightList.Closed Date Closed date
SumoLogicSec.InsightList.ClosedBy String Closed by user
SumoLogicSec.InsightList.Created Date Created date
SumoLogicSec.InsightList.Description String Description of the Insight
SumoLogicSec.InsightList.Entity String Entity name associated with the Insight
SumoLogicSec.InsightList.Id String The ID of the Insight
SumoLogicSec.InsightList.LastUpdated Date The time the Insight was last updated
SumoLogicSec.InsightList.LastUpdatedBy String The last user to update the Insight
SumoLogicSec.InsightList.Name String The name of the Insight
SumoLogicSec.InsightList.ReadableId String The ID of the Insight in readable form
SumoLogicSec.InsightList.RecordSummaryFields Array Record Summary Fields associated with the Insight
SumoLogicSec.InsightList.Resolution String Resolution for closed Insight
SumoLogicSec.InsightList.Severity String The severity of the Insight
SumoLogicSec.InsightList.Signals.contentType String Type of content that triggered the Signal
SumoLogicSec.InsightList.Signals.description String Description of the Signal
SumoLogicSec.InsightList.Signals.id String The ID of the Signal
SumoLogicSec.InsightList.Signals.name String The name of the Signal
SumoLogicSec.InsightList.Signals.recordCount Number Number of records associated with the Signal
SumoLogicSec.InsightList.Signals.ruleId String Rule ID associated with the Signal
SumoLogicSec.InsightList.Signals.severity Number The severity of the Signal
SumoLogicSec.InsightList.Signals.stage String The stage of the Signal
SumoLogicSec.InsightList.Signals.timestamp Date Signal timestamp
SumoLogicSec.InsightList.Source String The source of the Insight
SumoLogicSec.InsightList.Status String The status of the Insight
SumoLogicSec.InsightList.TimeToDetection Number Insight time to detection
SumoLogicSec.InsightList.TimeToRemediation Number Insight time to remediation
SumoLogicSec.InsightList.TimeToResponse Number Insight time to response
SumoLogicSec.InsightList.Timestamp Date Insight timestamp

Command Example

!sumologic-sec-insight-search query="timestamp:>\"2021-02-01T05:00:00+00:00\" status:\"closed\" AND severity:>\"MEDIUM\"" limit=3

Human Readable Output

Insights:

Id Readable Id Name Action Status Assignee Description Last Updated Last Updated By Severity Closed Closed By Timestamp Entity Resolution
00853cdd-763e-3e31-a2e4-f74277922f9f INSIGHT-220 Command and Control with Defense Evasion and Execution   Closed   Initial Access, Command and Control, Defense Evasion, Execution 2021-03-23T20:06:51.565599   HIGH 2021-03-23T20:06:51.511505 obfuscated@email.com 2021-02-22T16:27:51 testcomputer.somedomain.net No Action
eefdff8d-7447-3b47-83e0-66a0b210d618 INSIGHT-219 Discovery with Credential Access and Execution   Closed   Initial Access, Credential Access, Initial Access, Execution, Discovery, Credential Access 2021-03-23T21:21:55.029798   HIGH 2021-03-23T21:21:54.914061 obfuscated@email.com 2021-02-22T16:24:07.959000 1.2.3.4 No Action
8a77d12e-5905-3401-ae7c-2e17b1fd3060 INSIGHT-221 Privilege Escalation with Persistence and Execution   Closed obfuscated@email.com Execution, Privilege Escalation, Persistence, Execution 2021-05-12T21:47:08.297222   HIGH 2021-05-12T21:47:08.132251 obfuscated@email.com 2021-02-22T16:24:07.959000 5.6.7.8 No Action

sumologic-sec-signal-search


Search signals using available filters

Base Command

sumologic-sec-signal-search

Input

Argument Name Description Required
query Use a query string to search, see API documentation for more details. Optional
created When the Signal was created. Defaults to ‘All time’ if no time arguments are specified. Possible values are: All time, Last week, Last 48 hours, Last 24 hours. Default is All time. Optional
contentType Content type associated with the signals. Options: ANOMALY, DEFAULT, THREATINTEL, RULE. Possible values are: ANOMALY, DEFAULT, THREATINTEL, RULE. Optional
offset The number of items to skip before starting to collect the result set. Default is 0. Optional
limit The maximum number of items to return. Default is 10. Optional

Context Output

Path Type Description
SumoLogicSec.SignalList.ContentType String Type of content that triggered the Signal
SumoLogicSec.SignalList.Description String Description of the Signal
SumoLogicSec.SignalList.Entity String Entity name associated with the Signal
SumoLogicSec.SignalList.Id String The ID of the Signal
SumoLogicSec.SignalList.Name String The name of the Signal
SumoLogicSec.SignalList.RecordCount Number Number of records associated with the Signal
SumoLogicSec.SignalList.RuleId String Rule ID associated with the Signal
SumoLogicSec.SignalList.Severity Number The severity of the Signal
SumoLogicSec.SignalList.Stage String The stage of the Signal
SumoLogicSec.SignalList.Suppressed Boolean Whether or not the Signal was suppressed
SumoLogicSec.SignalList.Timestamp Date Signal timestamp

Command Example

!sumologic-sec-signal-search query="timestamp:NOW-7D.NOW name:contains(\"Internal\")"

Human Readable Output

Signals:

Id Name Entity Rule Id Description Severity Stage Timestamp Content Type Tags
b50fd570-341b-576d-85b5-8b5cd17c0aee IP Address Scan - Internal 1.2.3.4 LEGACY-S00050 A scan of IP addresses 3 Discovery 2021-04-22T04:08:13.514000 RULE _mitreAttackTactic:TA0007,
_mitreAttackTactic:TA0043,
_mitreAttackTechnique:T1046,
_mitreAttackTechnique:T1595

sumologic-sec-entity-search


Search entities using the available filters

Base Command

sumologic-sec-entity-search

Input

Argument Name Description Required
query Use a query string to search, see API documentation for more details. Optional
ip IP Address to search for e.g. 1.2.3.4. Optional
hostname Hostname to search for e.g. host.example.com. Optional
username Username to search for e.g. admin. Optional
type Entity type to search for. Options: username, hostname, ip, mac. Possible values are: username, hostname, ip, mac. Optional
whitelisted Is the Entity whitelisted? true/false. Possible values are: true, false. Optional
tag Tag contains value. Optional
offset The number of items to skip before starting to collect the result set. Default is 0. Optional
limit The maximum number of items to return. Default is 10. Optional

Context Output

Path Type Description
SumoLogicSec.EntityList.ActivityScore Number Entity Activity Score
SumoLogicSec.EntityList.FirstSeen Date When the Entity was first seen
SumoLogicSec.EntityList.Id String Entity ID
SumoLogicSec.EntityList.IpHostname String Hostname associated with IP Entity
SumoLogicSec.EntityList.IsWhitelisted Boolean Whether or not the Entity is on allow list
SumoLogicSec.EntityList.LastSeen Date When the Entity was last seen
SumoLogicSec.EntityList.Name String The Entity name
SumoLogicSec.EntityList.OperatingSystem String Entity Operating System (observed or from inventory)
SumoLogicSec.EntityList.InventoryData Boolean Whether or not this Entity was ingested from inventory e.g. Active Directory
SumoLogicSec.EntityList.Hostname String Entity hostname
SumoLogicSec.EntityList.Department String Username Entity department
SumoLogicSec.EntityList.EmployeeId String Username Entity employee ID

Command Example

!sumologic-sec-entity-search query="type:\"ip\" activityScore:>=3"

Human Readable Output

Entities:

Id Name First Seen Last Seen Activity Score Is Whitelisted Operating System Inventory Data
_ip-specops_analysis_lab-1.2.3.4 1.2.3.4   2021-04-22T04:08:13.514000 3 false   false

sumologic-sec-insight-set-status


Change status of Insight

Base Command

sumologic-sec-insight-set-status

Input

Argument Name Description Required
insight_id The insight to change status for. Required
status The desired Insight status. Possible values are: new, inprogress, closed. Default is in-progress. Optional
resolution Resolution for closing Insight. Valid values are: “Resolved”, “False Positive”, “No Action”, “Duplicate”. Possible values are: Resolved, False Positive, No Action, Duplicate. Default is Resolved. Optional
sub_resolution Custom sub resolution for closing Insight. If populated, it will override the resolution field. Please make sure the resolution matches exactly your Sumo Resolutions Optional

Context Output

Path Type Description
SumoLogicSec.Insight.Assignee String User or team assigned to the Insight
SumoLogicSec.Insight.Closed Date Closed date
SumoLogicSec.Insight.ClosedBy String Closed by user
SumoLogicSec.Insight.Created Date Created date
SumoLogicSec.Insight.Description String Description of the Insight
SumoLogicSec.Insight.Entity String Entity name associated with the Insight
SumoLogicSec.Insight.Id String The ID of the Insight
SumoLogicSec.Insight.LastUpdated Date The time the Insight was last updated
SumoLogicSec.Insight.LastUpdatedBy String The last user to update the Insight
SumoLogicSec.Insight.Name String The name of the Insight
SumoLogicSec.Insight.ReadableId String The ID of the Insight in readable form
SumoLogicSec.Insight.Resolution String Resolution for closed Insight
SumoLogicSec.Insight.Severity String The severity of the Insight
SumoLogicSec.Insight.Signals.contentType String Type of content that triggered the Signal
SumoLogicSec.Insight.Signals.description String Description of the Signal
SumoLogicSec.Insight.Signals.id String The ID of the Signal
SumoLogicSec.Insight.Signals.name String The name of the Signal
SumoLogicSec.Insight.Signals.recordCount Number Number of records associated with the Signal
SumoLogicSec.Insight.Signals.ruleId String Rule ID associated with the Signal
SumoLogicSec.Insight.Signals.severity Number The severity of the Signal
SumoLogicSec.Insight.Signals.stage String The stage of the Signal
SumoLogicSec.Insight.Signals.timestamp Date Signal timestamp
SumoLogicSec.Insight.Source String The source of the Insight
SumoLogicSec.Insight.Status String The status of the Insight
SumoLogicSec.Insight.TimeToDetection Number Insight time to detection
SumoLogicSec.Insight.TimeToRemediation Number Insight time to remediation
SumoLogicSec.Insight.TimeToResponse Number Insight time to response
SumoLogicSec.Insight.Timestamp Date Insight timestamp

Command Example

!sumologic-sec-insight-set-status insight-id=INSIGHT-116 status=closed resolution="No Action"

Human Readable Output

Insight Details:

Id Readable Id Name Action Status Assignee Description Last Updated Last Updated By Severity Closed Closed By Timestamp Entity Resolution
c6c97d84-983d-303e-a03b-86f53d657fc8 INSIGHT-116 Lateral Movement with Discovery and Credential Access   Closed   Initial Access, Lateral Movement, Discovery, Initial Access, Credential Access 2021-05-13T01:28:32.648352   HIGH 2021-05-13T01:28:32.580039 obfuscated@email.com 2021-02-18T22:04:08.330000 1.2.3.4 No Action

sumologic-sec-match-list-get


Get match lists

Base Command

sumologic-sec-match-list-get

Input

Argument Name Description Required
offset The number of items to skip before starting to collect the result set. Default is 0. Optional
limit Number of match lists returned. Default is 10. Optional
sort Sort expression. Default is name. Optional
sortDir Sort direction. Possible values are: ASC, DESC. Default is ASC. Optional

Context Output

Path Type Description
SumoLogicSec.MatchLists.Created String When the Match List was created
SumoLogicSec.MatchLists.CreatedBy String User that created the Match List
SumoLogicSec.MatchLists.DefaultTtl Number Default TTL for entries in the Match List
SumoLogicSec.MatchLists.Description String Description of the Match List
SumoLogicSec.MatchLists.Id String ID of the Match List
SumoLogicSec.MatchLists.LastUpdated String When the Match List was last updated
SumoLogicSec.MatchLists.LastUpdatedBy String The last user to update the Match List
SumoLogicSec.MatchLists.Name String Name of Match List
SumoLogicSec.MatchLists.TargetColumn String Match List Target Column

Command Example

!sumologic-sec-match-list-get limit=3

Human Readable Output

Match lists:

Id Name Target Column Default Ttl
173 admin_ips SrcIp 0
24 auth_servers Ip  
162 auth_servers_dst DstIp  

sumologic-sec-match-list-update


Add item to match list

Base Command

sumologic-sec-match-list-update

Input

Argument Name Description Required
match_list_id ID of match list. Required
active Item active or disabled. Required
description Description of match list item. Required
expiration Expiration of match list item, e.g. “2021-03-25T23:52:23.508Z”. Required
value Value of match list item. Required

Context Output

Path Type Description
SumoLogicSec.UpdateResult.Result String Result (Success or Failed)
SumoLogicSec.UpdateResult.Server response Boolean Server response (True or False)

Command Example

!sumologic-sec-match-list-update match-list-id=166 description="My description" expiration=2021-04-25T22:36:10.925Z value="10.20.30.40" active=true

Human Readable Output

Result:

Result Server Response
Success true

sumologic-sec-threat-intel-search-indicators


Search Threat Intel Indicators

Base Command

sumologic-sec-threat-intel-search-indicators

Input

Argument Name Description Required
q Use a query string to search, see API documentation for more details. Optional
value The value to search for. Required
offset The number of items to skip before starting to collect the result set. Default is 0. Optional
limit The numbers of items to return. Default is 10. Optional
sourceIds Comma separated list of threat intelligence source IDs to search, e.g. 1,2,3. Required

Context Output

Path Type Description
SumoLogicSec.ThreatIntelIndicators.Active Boolean Whether or not the Threat Intel Indicator is Active
SumoLogicSec.ThreatIntelIndicators.Expiration Date Date and time the Threat Intel Indicator is set to expire
SumoLogicSec.ThreatIntelIndicators.Id String ID of Threat Intel Indicator
SumoLogicSec.ThreatIntelIndicators.Meta.created.username String User that created the Threat Intel Indicator
SumoLogicSec.ThreatIntelIndicators.Meta.created.when Date When the Threat Intel Indicator was created
SumoLogicSec.ThreatIntelIndicators.Meta.description String Description of Threat Intel Indicator
SumoLogicSec.ThreatIntelIndicators.Meta.updated Date When the Threat Intel Indicator was last updated
SumoLogicSec.ThreatIntelIndicators.Value String Value of Threat Intel Indicator

Command Example

!sumologic-sec-threat-intel-search-indicators value=1.2.3.4 sourceIds=54

Human Readable Output

Threat Intel Indicators:

Id Value Active Expiration
f396ae69aa223c049ff639b3649ba1dd6465ec74397c3126916786bbcd6d76017468726561745f49705f44656d6973746f5f54657374 1.2.3.4 true 2021-04-29T00:00:00

sumologic-sec-threat-intel-get-sources


Get Threat Intel Sources

Base Command

sumologic-sec-threat-intel-get-sources

Input

Argument Name Description Required
offset The number of items to skip before starting to collect the result set. Default is 0. Optional
limit The numbers of items to return. Default is 10. Optional
sort Sort expression. Default is name. Optional
sortDir Sort direction. Possible values are: ASC, DESC. Default is ASC. Optional

Context Output

Path Type Description
SumoLogicSec.ThreatIntelSources.Created String When the Threat Intel Source was created
SumoLogicSec.ThreatIntelSources.CreatedBy String User that created the Threat Intel Source
SumoLogicSec.ThreatIntelSources.Description String Description of Threat Intel Source
SumoLogicSec.ThreatIntelSources.Id String ID of Threat Intel Source
SumoLogicSec.ThreatIntelSources.LastUpdated String When the Threat Intel Source was last updated
SumoLogicSec.ThreatIntelSources.LastUpdatedBy String User that last updated the Threat Intel Source
SumoLogicSec.ThreatIntelSources.Name String Name of Threat Intel Source
SumoLogicSec.ThreatIntelSources.SourceType String Source type of Threat Intel Source

Command Example

!sumologic-sec-threat-intel-get-sources limit=3

Human Readable Output

Threat intel sources:

Id Name Description Source Type
35 abuse.ch   CUSTOM
25 Alienvault OTX Alienvault TAXII
24 Anomali   TAXII

sumologic-sec-threat-intel-update-source


Add Threat Intel Indicator to Threat Intel Source

Base Command

sumologic-sec-threat-intel-update-source

Input

Argument Name Description Required
threat-intel-source-id ID of Threat Intel Source. Required
active Indicator active or disabled. Default is true. Required
description Description of indicator. Required
expiration Expiration of match list item, e.g. “2021-03-25T23:52:23.508Z”. Required
value Indicator value. Required

Context Output

Path Type Description
SumoLogicSec.UpdateResult.Result String Result (Success or Failed)
SumoLogicSec.UpdateResult.Server response Boolean Server response (True or False)

Command Example

!sumologic-sec-threat-intel-update-source threat-intel-source-id=54 active=true value=1.2.3.4 description=test expiration=2021-04-29T00:00:00.000Z

Human Readable Output

Result:

Result Server Response
Success true

Configuration parameters

  • api_endpoint — Sumo Logic API Endpoint (required)
  • instance_endpoint — Sumo Logic Instance Endpoint
  • isFetch — Fetch incidents
  • incidentType — Incident type
  • access_id — Access ID (required)
  • access_key — Access Key (required)
  • incidentFetchInterval — Incidents Fetch Interval
  • max_fetch — Fetch Limit
  • fetch_query — Override default fetch query
  • first_fetch — First fetch time
  • pull_signals — Pull associated Sumo Logic Signals as Incidents
  • mirror_direction — Incident Mirroring Direction
  • close_incident — Close Mirrored XSOAR Incident
  • close_insight — Close Mirrored Sumo Logic Insight
  • record_summary_fields — Override Record Summary Fields

Commands (14)

  • sumologic-sec-entity-get-details

    Get entity details for a specific entity ID.

  • sumologic-sec-entity-search

    Search entities using the available filters.

  • sumologic-sec-insight-add-comment

    Add a comment for a specific Insight ID (Users can post and update comments on the Sumo Logic Cloud SIEM portal for any Insight ID).

  • sumologic-sec-insight-get-comments

    Get comments for a specific Insight ID (Users can post and update comments on the Sumo Logic Cloud SIEM portal for any Insight ID).

  • sumologic-sec-insight-get-details

    Get Insight details for a specific Insight ID.

  • sumologic-sec-insight-search

    Search insights using available filters.

  • sumologic-sec-insight-set-status

    Change the status of an Insight.

  • sumologic-sec-match-list-get

    Get match lists.

  • sumologic-sec-match-list-update

    Add an item to a match list.

  • sumologic-sec-signal-get-details

    Get Signal details for a specific Signal ID. Signal details command references signals in Sumo Logic Cloud SIEM which are created when records exhibit suspicious properties and mate with patterns or other detection logic.

  • sumologic-sec-signal-search

    Search signals using available filters.

  • sumologic-sec-threat-intel-get-sources

    Get Threat Intel Sources.

  • sumologic-sec-threat-intel-search-indicators

    Search Threat Intel Indicators.

  • sumologic-sec-threat-intel-update-source

    Add a Threat Intel Indicator to an Threat Intel Source.

commonfields:
  id: SumoLogicSEC
  version: -1
sectionorder:
- Collect
- Connect  
name: SumoLogicSEC
display: Sumo Logic Cloud SIEM
category: Analytics & SIEM
provider: Francisco Partners
description: Freeing the analyst with autonomous decisions.
configuration:
- display: Sumo Logic API Endpoint
  name: api_endpoint
  type: 0
  required: true
  additionalinfo: https://api.<deployment>.sumologic.com/api
  section: Connect
- display: Sumo Logic Instance Endpoint
  name: instance_endpoint
  type: 0
  additionalinfo: https://<yoursubdomain>.<deployment>.sumologic.com
  required: false
  section: Connect
- display: Fetch incidents
  name: isFetch
  type: 8
  required: false
  section: Collect
- display: Incident type
  name: incidentType
  type: 13
  required: false
  section: Collect
- display: Access ID
  name: access_id
  type: 0
  required: true
  section: Connect
- display: Access Key
  name: access_key
  type: 4
  required: true
  section: Connect
- display: Incidents Fetch Interval
  name: incidentFetchInterval
  defaultvalue: "1"
  type: 19
  required: false
  section: Collect
- display: Fetch Limit
  name: max_fetch
  defaultvalue: "20"
  type: 0
  additionalinfo: Fetch limit must not be greater than 200
  required: false
  section: Collect
- display: Override default fetch query
  name: fetch_query
  type: 0
  additionalinfo: Default fetch query is status:in("new", "inprogress")
  required: false
  section: Collect
- display: First fetch time
  name: first_fetch
  defaultvalue: 1 day
  type: 0
  required: false
  section: Collect
- display: Pull associated Sumo Logic Signals as Incidents
  additionalinfo: Pull Sumo Logic signals associated with detected Sumo Logic Insights as XSOAR incidents
  defaultvalue: "false"
  name: pull_signals
  type: 8
  required: false
  section: Collect
- display: Incident Mirroring Direction
  additionalinfo: 'Choose the direction to mirror the incident: Incoming (from Sumo Logic SIEM to Cortex XSOAR), Outgoing (from Cortex XSOAR to Sumo Logic SIEM), or Incoming and Outgoing (from/to Cortex XSOAR and Sumo Logic SIEM). Cortex XSOAR only parameter.'
  defaultvalue: None
  name: mirror_direction
  options:
  - None
  - Incoming
  - Outgoing
  - Incoming And Outgoing
  type: 15
  section: Collect
  required: false
  hidden:
  - marketplacev2
  - platform
- display: Close Mirrored XSOAR Incident
  additionalinfo: When selected, closing the Sumo Logic SIEM Insight is mirrored in Cortex XSOAR. Cortex XSOAR only parameter.
  defaultvalue: 'false'
  name: close_incident
  type: 8
  section: Collect
  advanced: true
  required: false
  hidden:
  - marketplacev2
  - platform
- display: Close Mirrored Sumo Logic Insight
  additionalinfo: When selected, closing the Cortex XSOAR incident is mirrored in Sumo Logic SIEM.
  defaultvalue: 'false'
  name: close_insight
  type: 8
  section: Collect
  advanced: true
  required: false
- display: Override Record Summary Fields
  name: record_summary_fields
  defaultvalue: "action,description,device_hostname,device_ip,dstDevice_hostname,dstDevice_ip,email_sender,file_basename,file_hash_md5,file_hash_sha1,file_hash_sha256,srcDevice_hostname,srcDevice_ip,threat_name,threat_category,threat_identifier,user_username,threat_url,listMatches"
  type: 0
  additionalinfo: Record Summary Fields included when fetching Insights
  required: false
  section: Collect
script:
  script: ''
  type: python
  commands:
  - name: sumologic-sec-insight-get-details
    arguments:
    - name: insight_id
      required: true
      default: true
      description: The insight to retrieve details for.
    - name: record_summary_fields
      description: Record Summary Fields included with the Insight.
      defaultValue: "action,description,device_hostname,device_ip,dstDevice_hostname,dstDevice_ip,email_sender,file_basename,file_hash_md5,file_hash_sha1,file_hash_sha256,srcDevice_hostname,srcDevice_ip,threat_name,threat_category,threat_identifier,user_username,threat_url,listMatches"
    outputs:
    - contextPath: SumoLogicSec.Insight.Assignee
      description: User or team assigned to the Insight.
      type: string
    - contextPath: SumoLogicSec.Insight.Closed
      description: Closed date.
      type: Date
    - contextPath: SumoLogicSec.Insight.ClosedBy
      description: Closed by user.
      type: String
    - contextPath: SumoLogicSec.Insight.Created
      description: Created date.
      type: Date
    - contextPath: SumoLogicSec.Insight.Description
      description: Description of the Insight.
      type: String
    - contextPath: SumoLogicSec.Insight.Entity
      description: Entity name associated with the Insight.
      type: String
    - contextPath: SumoLogicSec.Insight.Id
      description: The ID of the Insight.
      type: String
    - contextPath: SumoLogicSec.Insight.LastUpdated
      description: The time the Insight was last updated.
      type: Date
    - contextPath: SumoLogicSec.Insight.LastUpdatedBy
      description: The last user to update the Insight.
      type: string
    - contextPath: SumoLogicSec.Insight.Name
      description: The name of the Insight.
      type: String
    - contextPath: SumoLogicSec.Insight.ReadableId
      description: The ID of the Insight in readable form.
      type: String
    - contextPath: SumoLogicSec.InsightList.RecordSummaryFields
      description: Record Summary Fields associated with the Insight.
      type: Unknown
    - contextPath: SumoLogicSec.Insight.Resolution
      description: Resolution for closed Insight.
      type: String
    - contextPath: SumoLogicSec.Insight.Severity
      description: The severity of the Insight.
      type: String
    - contextPath: SumoLogicSec.Insight.Signals.contentType
      description: Type of content that triggered the Signal.
      type: String
    - contextPath: SumoLogicSec.Insight.Signals.description
      description: Description of the Signal.
      type: String
    - contextPath: SumoLogicSec.Insight.Signals.id
      description: The ID of the Signal.
      type: String
    - contextPath: SumoLogicSec.Insight.Signals.name
      description: The name of the Signal.
      type: String
    - contextPath: SumoLogicSec.Insight.Signals.recordCount
      description: Number of records associated with the Signal.
      type: Number
    - contextPath: SumoLogicSec.Insight.Signals.ruleId
      description: Rule ID associated with the Signal.
      type: String
    - contextPath: SumoLogicSec.Insight.Signals.severity
      description: The severity of the Signal.
      type: Number
    - contextPath: SumoLogicSec.Insight.Signals.stage
      description: The stage of the Signal.
      type: String
    - contextPath: SumoLogicSec.Insight.Signals.timestamp
      description: Signal timestamp.
      type: Date
    - contextPath: SumoLogicSec.Insight.Source
      description: The source of the Insight.
      type: String
    - contextPath: SumoLogicSec.Insight.Status
      description: The status of the Insight.
      type: String
    - contextPath: SumoLogicSec.Insight.TimeToDetection
      description: Insight time to detection.
      type: Number
    - contextPath: SumoLogicSec.Insight.TimeToRemediation
      description: Insight time to remediation.
      type: Number
    - contextPath: SumoLogicSec.Insight.TimeToResponse
      description: Insight time to response.
      type: Number
    - contextPath: SumoLogicSec.Insight.Timestamp
      description: Insight timestamp.
      type: Date
    description: Get Insight details for a specific Insight ID.
  - name: sumologic-sec-insight-get-comments
    arguments:
    - name: insight_id
      required: true
      description: The insight ID for which to retrieve comments.
    outputs:
    - contextPath: SumoLogicSec.InsightComments.Id
      description: ID of comment.
      type: String
    - contextPath: SumoLogicSec.InsightComments.Body
      description: Comment contents.
      type: String
    - contextPath: SumoLogicSec.InsightComments.Author
      description: User that created the comment.
      type: String
    - contextPath: SumoLogicSec.InsightComments.Timestamp
      description: Comment created timestamp.
      type: Date
    - contextPath: SumoLogicSec.InsightComments.InsightId
      description: The ID of the Insight.
      type: String
    description: Get comments for a specific Insight ID (Users can post and update comments on the Sumo Logic Cloud SIEM portal for any Insight ID).
  - name: sumologic-sec-insight-add-comment
    arguments:
    - name: insight_id
      required: true
      description: The insight ID for which to retrieve comments.
    - name: comment
      required: true
      description: The comment to be added to the Insight ID.
    outputs:
    - contextPath: SumoLogicSec.InsightComments.Id
      description: ID of comment.
      type: String
    - contextPath: SumoLogicSec.InsightComments.Body
      description: Comment contents.
      type: String
    - contextPath: SumoLogicSec.InsightComments.Author
      description: User that created the comment.
      type: String
    - contextPath: SumoLogicSec.InsightComments.Timestamp
      description: Comment created timestamp.
      type: Date
    - contextPath: SumoLogicSec.InsightComments.InsightId
      description: The ID of the Insight.
      type: String
    description: Add a comment for a specific Insight ID (Users can post and update comments on the Sumo Logic Cloud SIEM portal for any Insight ID).
  - name: sumologic-sec-signal-get-details
    arguments:
    - name: signal_id
      required: true
      default: true
      description: The signal to retrieve details for.
    outputs:
    - contextPath: SumoLogicSec.Signal.ContentType
      description: Type of content that triggered the Signal.
      type: String
    - contextPath: SumoLogicSec.Signal.Description
      description: Description of the Signal.
      type: String
    - contextPath: SumoLogicSec.Signal.Entity
      description: Entity name associated with the Signal.
      type: String
    - contextPath: SumoLogicSec.Signal.Id
      description: The ID of the Signal.
      type: String
    - contextPath: SumoLogicSec.Signal.Name
      description: The name of the Signal.
      type: String
    - contextPath: SumoLogicSec.Signal.RecordCount
      description: Number of records associated with the Signal.
      type: Number
    - contextPath: SumoLogicSec.Signal.RuleId
      description: Rule ID associated with the Signal.
      type: String
    - contextPath: SumoLogicSec.Signal.Severity
      description: The severity of the Signal.
      type: Number
    - contextPath: SumoLogicSec.Signal.Stage
      description: The stage of the Signal.
      type: String
    - contextPath: SumoLogicSec.Signal.Suppressed
      description: Whether or not the Signal was suppressed.
      type: Boolean
    - contextPath: SumoLogicSec.Signal.Timestamp
      description: Signal timestamp.
      type: Date
    description: Get Signal details for a specific Signal ID. Signal details command references signals in Sumo Logic Cloud SIEM which are created when records exhibit suspicious properties and mate with patterns or other detection logic.
  - name: sumologic-sec-entity-get-details
    arguments:
    - name: entity-id
      required: true
      default: true
      description: The entity to retrieve details for.
    outputs:
    - contextPath: SumoLogicSec.Entity.ActivityScore
      description: Entity Activity Score.
      type: Number
    - contextPath: SumoLogicSec.Entity.FirstSeen
      description: When the Entity was first seen.
      type: Date
    - contextPath: SumoLogicSec.Entity.Hostname
      description: Entity hostname.
      type: String
    - contextPath: SumoLogicSec.Entity.Id
      description: Entity ID.
      type: String
    - contextPath: SumoLogicSec.Entity.IsWhitelisted
      description: Whether or not the Entity is on allow list.
      type: Boolean
    - contextPath: SumoLogicSec.Entity.LastSeen
      description: When the Entity was last seen.
      type: Date
    - contextPath: SumoLogicSec.Entity.Name
      description: The Entity name.
      type: String
    - contextPath: SumoLogicSec.Entity.OperatingSystem
      description: Entity Operating System (observed or from inventory).
      type: String
    - contextPath: SumoLogicSec.Entity.InventoryData
      description: Whether or not this Entity was ingested from inventory e.g. Active Directory.
      type: Boolean
    description: Get entity details for a specific entity ID.
  - name: sumologic-sec-insight-search
    arguments:
    - name: query
      description: Use a query string to search, see API documentation for more details.
    - name: created
      auto: PREDEFINED
      predefined:
      - All time
      - Last week
      - Last 48 hours
      - Last 24 hours
      description: When the insight was created. Defaults to 'All time' if no time arguments are specified.
    - name: status
      description: 'Comma separated list of values from the options: new,inprogress,closed.'
    - name: asignee
      description: User assigned to Insights.
    - name: offset
      description: The number of items to skip before starting to collect the result set.
      defaultValue: "0"
    - name: limit
      description: The maximum number of items to return.
      defaultValue: "10"
    - name: record_summary_fields
      description: Record Summary Fields included with the Insight.
      defaultValue: "action,description,device_hostname,device_ip,dstDevice_hostname,dstDevice_ip,email_sender,file_basename,file_hash_md5,file_hash_sha1,file_hash_sha256,srcDevice_hostname,srcDevice_ip,threat_name,threat_category,threat_identifier,user_username,threat_url,listMatches"
    outputs:
    - contextPath: SumoLogicSec.InsightList.Assignee
      description: User or team assigned to the Insight.
      type: String
    - contextPath: SumoLogicSec.InsightList.Closed
      description: Closed date.
      type: Date
    - contextPath: SumoLogicSec.InsightList.ClosedBy
      description: Closed by user.
      type: String
    - contextPath: SumoLogicSec.InsightList.Created
      description: Created date.
      type: Date
    - contextPath: SumoLogicSec.InsightList.Description
      description: Description of the Insight.
      type: String
    - contextPath: SumoLogicSec.InsightList.Entity
      description: Entity name associated with the Insight.
      type: String
    - contextPath: SumoLogicSec.InsightList.Id
      description: The ID of the Insight.
      type: String
    - contextPath: SumoLogicSec.InsightList.LastUpdated
      description: The time the Insight was last updated.
      type: Date
    - contextPath: SumoLogicSec.InsightList.LastUpdatedBy
      description: The last user to update the Insight.
      type: String
    - contextPath: SumoLogicSec.InsightList.Name
      description: The name of the Insight.
      type: String
    - contextPath: SumoLogicSec.InsightList.ReadableId
      description: The ID of the Insight in readable form.
      type: String
    - contextPath: SumoLogicSec.InsightList.RecordSummaryFields
      description: Record Summary Fields associated with the Insight.
      type: Unknown
    - contextPath: SumoLogicSec.InsightList.Resolution
      description: Resolution for closed Insight.
      type: String
    - contextPath: SumoLogicSec.InsightList.Severity
      description: The severity of the Insight.
      type: String
    - contextPath: SumoLogicSec.InsightList.Signals.contentType
      description: Type of content that triggered the Signal.
      type: String
    - contextPath: SumoLogicSec.InsightList.Signals.description
      description: Description of the Signal.
      type: String
    - contextPath: SumoLogicSec.InsightList.Signals.id
      description: The ID of the Signal.
      type: String
    - contextPath: SumoLogicSec.InsightList.Signals.name
      description: The name of the Signal.
      type: String
    - contextPath: SumoLogicSec.InsightList.Signals.recordCount
      description: Number of records associated with the Signal.
      type: Number
    - contextPath: SumoLogicSec.InsightList.Signals.ruleId
      description: Rule ID associated with the Signal.
      type: String
    - contextPath: SumoLogicSec.InsightList.Signals.severity
      description: The severity of the Signal.
      type: Number
    - contextPath: SumoLogicSec.InsightList.Signals.stage
      description: The stage of the Signal.
      type: String
    - contextPath: SumoLogicSec.InsightList.Signals.timestamp
      description: Signal timestamp.
      type: Date
    - contextPath: SumoLogicSec.InsightList.Source
      description: The source of the Insight.
      type: String
    - contextPath: SumoLogicSec.InsightList.Status
      description: The status of the Insight.
      type: String
    - contextPath: SumoLogicSec.InsightList.TimeToDetection
      description: Insight time to detection.
      type: Number
    - contextPath: SumoLogicSec.InsightList.TimeToRemediation
      description: Insight time to remediation.
      type: Number
    - contextPath: SumoLogicSec.InsightList.TimeToResponse
      description: Insight time to response.
      type: Number
    - contextPath: SumoLogicSec.InsightList.Timestamp
      description: Insight timestamp.
      type: Date
    description: Search insights using available filters.
  - name: sumologic-sec-signal-search
    arguments:
    - name: query
      description: Use a query string to search, see API documentation for more details.
    - name: created
      auto: PREDEFINED
      predefined:
      - All time
      - Last week
      - Last 48 hours
      - Last 24 hours
      description: When the Signal was created. Defaults to 'All time' if no time arguments are specified.
      defaultValue: All time
    - name: contentType
      auto: PREDEFINED
      predefined:
      - ANOMALY
      - DEFAULT
      - THREATINTEL
      - RULE
      description: 'Content type associated with the signals. Options: ANOMALY, DEFAULT, THREATINTEL, RULE.'
    - name: offset
      description: The number of items to skip before starting to collect the result set.
      defaultValue: "0"
    - name: limit
      description: The maximum number of items to return.
      defaultValue: "10"
    outputs:
    - contextPath: SumoLogicSec.SignalList.ContentType
      description: Type of content that triggered the Signal.
      type: String
    - contextPath: SumoLogicSec.SignalList.Description
      description: Description of the Signal.
      type: String
    - contextPath: SumoLogicSec.SignalList.Entity
      description: Entity name associated with the Signal.
      type: String
    - contextPath: SumoLogicSec.SignalList.Id
      description: The ID of the Signal.
      type: String
    - contextPath: SumoLogicSec.SignalList.Name
      description: The name of the Signal.
      type: String
    - contextPath: SumoLogicSec.SignalList.RecordCount
      description: Number of records associated with the Signal.
      type: Number
    - contextPath: SumoLogicSec.SignalList.RuleId
      description: Rule ID associated with the Signal.
      type: String
    - contextPath: SumoLogicSec.SignalList.Severity
      description: The severity of the Signal.
      type: Number
    - contextPath: SumoLogicSec.SignalList.Stage
      description: The stage of the Signal.
      type: String
    - contextPath: SumoLogicSec.SignalList.Suppressed
      description: Whether or not the Signal was suppressed.
      type: Boolean
    - contextPath: SumoLogicSec.SignalList.Timestamp
      description: Signal timestamp.
      type: Date
    description: Search signals using available filters.
  - name: sumologic-sec-entity-search
    arguments:
    - name: query
      default: true
      description: Use a query string to search, see API documentation for more details.
    - name: ip
      description: IP Address to search for, e.g. 1.2.3.4.
    - name: hostname
      description: Hostname to search for, e.g. host.example.com.
    - name: username
      description: Username to search for, e.g. admin.
    - name: type
      auto: PREDEFINED
      predefined:
      - username
      - hostname
      - ip
      - mac
      description: 'Entity type to search for. Options: username, hostname, ip, mac.'
    - name: whitelisted
      auto: PREDEFINED
      predefined:
      - "true"
      - "false"
      description: Whether or not the Entity is on allow list.
    - name: tag
      description: Tag contains value.
    - name: offset
      description: The number of items to skip before starting to collect the result set.
      defaultValue: "0"
    - name: limit
      description: The maximum number of items to return.
      defaultValue: "10"
    outputs:
    - contextPath: SumoLogicSec.EntityList.ActivityScore
      description: Entity Activity Score.
      type: Number
    - contextPath: SumoLogicSec.EntityList.FirstSeen
      description: When the Entity was first seen.
      type: Date
    - contextPath: SumoLogicSec.EntityList.Id
      description: Entity ID.
      type: String
    - contextPath: SumoLogicSec.EntityList.IpHostname
      description: Hostname associated with IP Entity.
      type: String
    - contextPath: SumoLogicSec.EntityList.IsWhitelisted
      description: Whether or not the Entity is on allow list.
      type: Boolean
    - contextPath: SumoLogicSec.EntityList.LastSeen
      description: When the Entity was last seen.
      type: Date
    - contextPath: SumoLogicSec.EntityList.Name
      description: The Entity name.
      type: String
    - contextPath: SumoLogicSec.EntityList.OperatingSystem
      description: Entity Operating System (observed or from inventory).
      type: String
    - contextPath: SumoLogicSec.EntityList.InventoryData
      description: Whether or not this Entity was ingested from inventory e.g. Active Directory.
      type: Boolean
    - contextPath: SumoLogicSec.EntityList.Hostname
      description: Entity hostname.
      type: String
    - contextPath: SumoLogicSec.EntityList.Department
      description: Username Entity department.
      type: String
    - contextPath: SumoLogicSec.EntityList.EmployeeId
      description: Username Entity employee ID.
      type: String
    description: Search entities using the available filters.
  - name: sumologic-sec-insight-set-status
    arguments:
    - name: insight_id
      required: true
      description: The insight to change status for.
    - name: status
      default: true
      auto: PREDEFINED
      predefined:
      - new
      - inprogress
      - closed
      description: The desired Insight status.
      defaultValue: in-progress
    - name: resolution
      auto: PREDEFINED
      predefined:
      - Resolved
      - False Positive
      - No Action
      - Duplicate
      description: 'Resolution for closing Insight. Valid values are: "Resolved", "False Positive", "No Action", "Duplicate".'
      defaultValue: Resolved
    outputs:
    - contextPath: SumoLogicSec.Insight.Assignee
      description: User or team assigned to the Insight.
      type: String
    - contextPath: SumoLogicSec.Insight.Closed
      description: Closed date.
      type: Date
    - contextPath: SumoLogicSec.Insight.ClosedBy
      description: Closed by user.
      type: String
    - contextPath: SumoLogicSec.Insight.Created
      description: Created date.
      type: Date
    - contextPath: SumoLogicSec.Insight.Description
      description: Description of the Insight.
      type: String
    - contextPath: SumoLogicSec.Insight.Entity
      description: Entity name associated with the Insight.
      type: String
    - contextPath: SumoLogicSec.Insight.Id
      description: The ID of the Insight.
      type: String
    - contextPath: SumoLogicSec.Insight.LastUpdated
      description: The time the Insight was last updated.
      type: Date
    - contextPath: SumoLogicSec.Insight.LastUpdatedBy
      description: The last user to update the Insight.
      type: String
    - contextPath: SumoLogicSec.Insight.Name
      description: The name of the Insight.
      type: String
    - contextPath: SumoLogicSec.Insight.ReadableId
      description: The ID of the Insight in readable form.
      type: String
    - contextPath: SumoLogicSec.Insight.Resolution
      description: Resolution for closed Insight.
      type: String
    - contextPath: SumoLogicSec.Insight.Severity
      description: The severity of the Insight.
      type: String
    - contextPath: SumoLogicSec.Insight.Signals.contentType
      description: Type of content that triggered the Signal.
      type: String
    - contextPath: SumoLogicSec.Insight.Signals.description
      description: Description of the Signal.
      type: String
    - contextPath: SumoLogicSec.Insight.Signals.id
      description: The ID of the Signal.
      type: String
    - contextPath: SumoLogicSec.Insight.Signals.name
      description: The name of the Signal.
      type: String
    - contextPath: SumoLogicSec.Insight.Signals.recordCount
      description: Number of records associated with the Signal.
      type: Number
    - contextPath: SumoLogicSec.Insight.Signals.ruleId
      description: Rule ID associated with the Signal.
      type: String
    - contextPath: SumoLogicSec.Insight.Signals.severity
      description: The severity of the Signal.
      type: Number
    - contextPath: SumoLogicSec.Insight.Signals.stage
      description: The stage of the Signal.
      type: String
    - contextPath: SumoLogicSec.Insight.Signals.timestamp
      description: Signal timestamp.
      type: Date
    - contextPath: SumoLogicSec.Insight.Source
      description: The source of the Insight.
      type: String
    - contextPath: SumoLogicSec.Insight.Status
      description: The status of the Insight.
      type: String
    - contextPath: SumoLogicSec.Insight.TimeToDetection
      description: Insight time to detection.
      type: Number
    - contextPath: SumoLogicSec.Insight.TimeToRemediation
      description: Insight time to remediation.
      type: Number
    - contextPath: SumoLogicSec.Insight.TimeToResponse
      description: Insight time to response.
      type: Number
    - contextPath: SumoLogicSec.Insight.Timestamp
      description: Insight timestamp.
      type: Date
    description: Change the status of an Insight.
  - name: sumologic-sec-match-list-get
    arguments:
    - name: offset
      description: The number of items to skip before starting to collect the result. set.
      defaultValue: "0"
    - name: limit
      default: true
      description: The number of match lists returned.
      defaultValue: "10"
    - name: sort
      description: The sort expression.
      defaultValue: name
    - name: sortDir
      auto: PREDEFINED
      predefined:
      - ASC
      - DESC
      description: The sort direction.
      defaultValue: ASC
    outputs:
    - contextPath: SumoLogicSec.MatchLists.Created
      description: When the Match List was created.
      type: String
    - contextPath: SumoLogicSec.MatchLists.CreatedBy
      description: User that created the Match List.
      type: String
    - contextPath: SumoLogicSec.MatchLists.DefaultTtl
      description: Default TTL for entries in the Match List.
      type: Number
    - contextPath: SumoLogicSec.MatchLists.Description
      description: Description of the Match List.
      type: String
    - contextPath: SumoLogicSec.MatchLists.Id
      description: ID of the Match List.
      type: String
    - contextPath: SumoLogicSec.MatchLists.LastUpdated
      description: When the Match List was last updated.
      type: String
    - contextPath: SumoLogicSec.MatchLists.LastUpdatedBy
      description: The last user to update the Match List.
      type: String
    - contextPath: SumoLogicSec.MatchLists.Name
      description: Name of Match List.
      type: String
    - contextPath: SumoLogicSec.MatchLists.TargetColumn
      description: Match List Target Column.
      type: String
    description: Get match lists.
  - name: sumologic-sec-match-list-update
    arguments:
    - name: match_list_id
      required: true
      description: ID of match list.
    - name: active
      required: true
      description: Item active or disabled.
    - name: description
      required: true
      description: Description of match list item.
    - name: expiration
      required: true
      description: Expiration of match list item, e.g. "2021-03-25T23:52:23.508Z".
    - name: value
      required: true
      description: Value of match list item.
    outputs:
    - contextPath: SumoLogicSec.UpdateResult.Result
      description: Result (Success or Failed).
      type: String
    - contextPath: SumoLogicSec.UpdateResult.Server response
      description: Server response (True or False).
      type: Boolean
    description: Add an item to a match list.
  - name: sumologic-sec-threat-intel-search-indicators
    arguments:
    - name: q
      description: Use a query string to search, see API documentation for more details.
    - name: value
      required: true
      description: The value to search for.
    - name: offset
      description: The number of items to skip before starting to collect the result set.
      defaultValue: "0"
    - name: limit
      description: The numbers of items to return.
      defaultValue: "10"
    - name: sourceIds
      required: true
      description: A comma-separated list of threat intelligence source IDs to search, e.g. 1,2,3.
    outputs:
    - contextPath: SumoLogicSec.ThreatIntelIndicators.Active
      description: Whether or not the Threat Intel Indicator is Active.
      type: Boolean
    - contextPath: SumoLogicSec.ThreatIntelIndicators.Expiration
      description: Date and time the Threat Intel Indicator is set to expire.
      type: Date
    - contextPath: SumoLogicSec.ThreatIntelIndicators.Id
      description: ID of Threat Intel Indicator.
      type: String
    - contextPath: SumoLogicSec.ThreatIntelIndicators.Meta.created.username
      description: User that created the Threat Intel Indicator.
      type: String
    - contextPath: SumoLogicSec.ThreatIntelIndicators.Meta.created.when
      description: When the Threat Intel Indicator was created.
      type: Date
    - contextPath: SumoLogicSec.ThreatIntelIndicators.Meta.description
      description: Description of Threat Intel Indicator.
      type: String
    - contextPath: SumoLogicSec.ThreatIntelIndicators.Meta.updated
      description: When the Threat Intel Indicator was last updated.
      type: Date
    - contextPath: SumoLogicSec.ThreatIntelIndicators.Value
      description: Value of Threat Intel Indicator.
      type: String
    description: Search Threat Intel Indicators.
  - name: sumologic-sec-threat-intel-get-sources
    arguments:
    - name: offset
      description: The number of items to skip before starting to collect the result set.
      defaultValue: "0"
    - name: limit
      description: The numbers of items to return.
      defaultValue: "10"
    - name: sort
      description: The sort expression.
      defaultValue: name
    - name: sortDir
      auto: PREDEFINED
      predefined:
      - ASC
      - DESC
      description: The sort direction.
      defaultValue: ASC
    outputs:
    - contextPath: SumoLogicSec.ThreatIntelSources.Created
      description: When the Threat Intel Source was created.
      type: String
    - contextPath: SumoLogicSec.ThreatIntelSources.CreatedBy
      description: User that created the Threat Intel Source.
      type: String
    - contextPath: SumoLogicSec.ThreatIntelSources.Description
      description: Description of Threat Intel Source.
      type: String
    - contextPath: SumoLogicSec.ThreatIntelSources.Id
      description: ID of Threat Intel Source.
      type: String
    - contextPath: SumoLogicSec.ThreatIntelSources.LastUpdated
      description: When the Threat Intel Source was last updated.
      type: String
    - contextPath: SumoLogicSec.ThreatIntelSources.LastUpdatedBy
      description: User that last updated the Threat Intel Source.
      type: String
    - contextPath: SumoLogicSec.ThreatIntelSources.Name
      description: Name of Threat Intel Source.
      type: String
    - contextPath: SumoLogicSec.ThreatIntelSources.SourceType
      description: Source type of Threat Intel Source.
      type: String
    description: Get Threat Intel Sources.
  - name: sumologic-sec-threat-intel-update-source
    arguments:
    - name: threat-intel-source-id
      required: true
      description: ID of Threat Intel Source.
    - name: active
      required: true
      description: Indicator active or disabled.
      defaultValue: "true"
    - name: description
      required: true
      description: The description of the indicator.
    - name: expiration
      required: true
      description: Expiration of match list item, e.g. "2021-03-25T23:52:23.508Z".
    - name: value
      required: true
      description: The indicator value.
    outputs:
    - contextPath: SumoLogicSec.UpdateResult.Result
      description: Result (Success or Failed).
      type: String
    - contextPath: SumoLogicSec.UpdateResult.Server response
      description: Server response (True or False).
      type: Boolean
    description: Add a Threat Intel Indicator to an Threat Intel Source.
  dockerimage: demisto/python3:3.12.13.10116658
  isfetch: true
  isremotesyncin: true
  isremotesyncout: true
  subtype: python3
fromversion: 5.0.0
tests:
- No tests (auto formatted)