Skip to content

Commit

Permalink
Merge pull request #18 from splunk-soar-connectors/next
Browse files Browse the repository at this point in the history
Merging next to main for release 1.0.6
  • Loading branch information
tapishj-splunk authored Jan 30, 2025
2 parents 9ea76b8 + 9a7188c commit 2759059
Show file tree
Hide file tree
Showing 5 changed files with 84 additions and 69 deletions.
2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
Expand Up @@ -198,4 +198,4 @@
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
limitations under the License.
144 changes: 79 additions & 65 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,29 +1,13 @@
[comment]: # "Auto-generated SOAR connector documentation"
# Cisco Talos Intelligence

Publisher: Splunk
Connector Version: 1.0.5
Product Vendor: Cisco
Product Name: Talos Intelligence
Product Version Supported (regex): ".\*"
Minimum Product Version: 6.2.2
Publisher: Splunk \
Connector Version: 1.0.6 \
Product Vendor: Cisco \
Product Name: Talos Intelligence \
Minimum Product Version: 6.2.2

This app provides investigative actions for Cisco Talos Intelligence. It is only supported on Splunk SOAR Cloud

[comment]: # " File: README.md"
[comment]: # "Copyright (c) 2025 Splunk Inc."
[comment]: # ""
[comment]: # "Licensed under the Apache License, Version 2.0 (the 'License');"
[comment]: # "you may not use this file except in compliance with the License."
[comment]: # "You may obtain a copy of the License at"
[comment]: # ""
[comment]: # " http://www.apache.org/licenses/LICENSE-2.0"
[comment]: # ""
[comment]: # "Unless required by applicable law or agreed to in writing, software distributed under"
[comment]: # "the License is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,"
[comment]: # "either express or implied. See the License for the specific language governing permissions"
[comment]: # "and limitations under the License."
[comment]: # ""
## Cisco Talos Intelligence license for Splunk SOAR (Cloud)

The Cisco Talos Intelligence license is included with your Splunk SOAR (Cloud) license.
Expand All @@ -34,105 +18,135 @@ This app uses the Cisco Talos API that specializes in identifying, analyzing, an

For additional details, see the [Cisco Talos Intelligence article](https://docs.splunk.com/Documentation/SOAR/current/Playbook/Talos) in the Splunk SOAR documentation.

**Note:** The Cisco Talos Intelligence asset is already configured in your Splunk SOAR (Cloud) deployment.
**Note:** The Cisco Talos Intelligence asset is already configured in your Splunk SOAR (Cloud) deployment.

### Supported Actions
[test connectivity](#action-test-connectivity) - Validate the asset configuration for connectivity using supplied configuration
[ip reputation](#action-ip-reputation) - Look up Cisco Talos threat intelligence for a given IP address
[domain reputation](#action-domain-reputation) - Look up Cisco Talos threat intelligence for a given domain
[url reputation](#action-url-reputation) - Look up Cisco Talos threat intelligence for a given URL
### Supported Actions

[test connectivity](#action-test-connectivity) - Validate the asset configuration for connectivity using supplied configuration \
[ip reputation](#action-ip-reputation) - Look up Cisco Talos threat intelligence for a given IP address \
[domain reputation](#action-domain-reputation) - Look up Cisco Talos threat intelligence for a given domain \
[url reputation](#action-url-reputation) - Look up Cisco Talos threat intelligence for a given URL

## action: 'test connectivity'

Validate the asset configuration for connectivity using supplied configuration

Type: **test**
Type: **test** \
Read only: **True**

Action uses the Cisco Talos API to get a list of the Acceptable Use Policy Categories used to classify website content.

#### Action Parameters

No parameters are required for this action

#### Action Output
No Output

No Output

## action: 'ip reputation'

Look up Cisco Talos threat intelligence for a given IP address

Type: **investigate**
Type: **investigate** \
Read only: **True**

Provides intelligence about an IP, so you can take appropriate actions against untrusted or unwanted resources.

#### Action Parameters

PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS
--------- | -------- | ----------- | ---- | --------
**ip** | required | IP to query | string | `ip` `ipv6`
**ip** | required | IP to query | string | `ip` `ipv6` |

#### Action Output

DATA PATH | TYPE | CONTAINS | EXAMPLE VALUES
--------- | ---- | -------- | --------------
action_result.parameter.ip | string | `ip` `ipv6` |
action_result.status | string | |
action_result.message | string | |
summary.total_objects | numeric | |
summary.total_objects_successful | numeric | |
action_result.data.\*.Observable | string | |
action_result.data.\*.Threat_Level | string | |
action_result.data.\*.Threat_Categories | string | |
action_result.data.\*.AUP | string | |
action_result.summary.message | string | | 72.163.4.185 has a Favorable threat level
action_result.parameter.ip | string | `ip` `ipv6` | |
action_result.status | string | | |
action_result.message | string | | |
summary.total_objects | numeric | | |
summary.total_objects_successful | numeric | | |
action_result.data.\*.Observable | string | | |
action_result.data.\*.Threat_Level | string | | |
action_result.data.\*.Threat_Categories | string | | |
action_result.data.\*.AUP | string | | |
action_result.summary.message | string | | 72.163.4.185 has a Favorable threat level |

## action: 'domain reputation'

Look up Cisco Talos threat intelligence for a given domain

Type: **investigate**
Type: **investigate** \
Read only: **True**

Provides intelligence about a domain, so you can take appropriate actions against untrusted or unwanted resources.

#### Action Parameters

PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS
--------- | -------- | ----------- | ---- | --------
**domain** | required | Domain to query | string | `domain`
**domain** | required | Domain to query | string | `domain` |

#### Action Output

DATA PATH | TYPE | CONTAINS | EXAMPLE VALUES
--------- | ---- | -------- | --------------
action_result.parameter.domain | string | `domain` |
action_result.status | string | |
action_result.message | string | |
summary.total_objects | numeric | |
summary.total_objects_successful | numeric | |
action_result.data.\*.Observable | string | |
action_result.data.\*.Threat_Level | string | |
action_result.data.\*.Threat_Categories | string | |
action_result.data.\*.AUP | string | |
action_result.summary.message | string | | splunk.com has a Favorable threat level
action_result.parameter.domain | string | `domain` | |
action_result.status | string | | |
action_result.message | string | | |
summary.total_objects | numeric | | |
summary.total_objects_successful | numeric | | |
action_result.data.\*.Observable | string | | |
action_result.data.\*.Threat_Level | string | | |
action_result.data.\*.Threat_Categories | string | | |
action_result.data.\*.AUP | string | | |
action_result.summary.message | string | | splunk.com has a Favorable threat level |

## action: 'url reputation'

Look up Cisco Talos threat intelligence for a given URL

Type: **investigate**
Type: **investigate** \
Read only: **True**

Provides intelligence about a URL, so you can take appropriate actions against untrusted or unwanted resources.

#### Action Parameters

PARAMETER | REQUIRED | DESCRIPTION | TYPE | CONTAINS
--------- | -------- | ----------- | ---- | --------
**url** | required | URL to query | string | `url`
**url** | required | URL to query | string | `url` |

#### Action Output

DATA PATH | TYPE | CONTAINS | EXAMPLE VALUES
--------- | ---- | -------- | --------------
action_result.parameter.url | string | `url` |
action_result.status | string | |
action_result.message | string | |
summary.total_objects | numeric | |
summary.total_objects_successful | numeric | |
action_result.data.\*.Observable | string | |
action_result.data.\*.Threat_Level | string | |
action_result.data.\*.Threat_Categories | string | |
action_result.data.\*.AUP | string | |
action_result.summary.message | string | | https://splunk.com has a Favorable threat level
action_result.parameter.url | string | `url` | |
action_result.status | string | | |
action_result.message | string | | |
summary.total_objects | numeric | | |
summary.total_objects_successful | numeric | | |
action_result.data.\*.Observable | string | | |
action_result.data.\*.Threat_Level | string | | |
action_result.data.\*.Threat_Categories | string | | |
action_result.data.\*.AUP | string | | |
action_result.summary.message | string | | https://splunk.com has a Favorable threat level |

______________________________________________________________________

Auto-generated Splunk SOAR Connector documentation.

Copyright 2025 Splunk Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and limitations under the License.
4 changes: 2 additions & 2 deletions ciscotalosintelligence.json
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
"product_version_regex": ".*",
"publisher": "Splunk",
"license": "Copyright (c) 2025 Splunk Inc.",
"app_version": "1.0.5",
"app_version": "1.0.6",
"utctime_updated": "2025-01-17T22:32:42.000000Z",
"package_name": "phantom_ciscotalosintelligence",
"fips_compliant": false,
Expand Down Expand Up @@ -403,4 +403,4 @@
"executable": "spawn3",
"disabled": false,
"custom_made": true
}
}
2 changes: 1 addition & 1 deletion ciscotalosintelligence_connector.py
Original file line number Diff line number Diff line change
Expand Up @@ -500,7 +500,7 @@ def insert_newlines(string, every=64):
"product_version": self.get_app_json()["app_version"],
"perf_testing": False,
}
if is_dev_env:
if is_dev_env():
self._appinfo["perf_testing"] = True

with tempfile.NamedTemporaryFile(mode="w+", delete=False, suffix="test") as temp_file:
Expand Down
1 change: 1 addition & 0 deletions release_notes/1.0.6.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
* Fix to setting perf_testing variable

0 comments on commit 2759059

Please sign in to comment.