ThreatGridv2
Query and upload samples to Cisco threat grid.
Forensics & Malware Analysis · Cisco Secure Malware Analytics
Details
| ID | ThreatGridv2 |
|---|---|
| Provider | Cisco Systems |
| Category | Forensics & Malware Analysis |
| From Version | 5.0.0 |
| Docker Image | demisto/python3:3.12.13.10325753 |
| Supported Modules | Agentix XSIAM EDR Cortex Cloud Cloud Runtime Security |
README
Query and upload samples to Cisco threat grid.
This integration was integrated and tested with version 2 of Cisco Secure Malware Analytics (Threat Grid)
Configure Cisco Secure Malware Analytics (Threat Grid) in Cortex
| Parameter | Description | Required |
|---|---|---|
| Server URL (e.g. https://192.168.0.1) | True | |
| API token | True | |
| Source Reliability | Reliability of the source providing the intelligence data. | True |
| Trust any certificate (not secure) | False | |
| Use system proxy settings | False |
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.
threat-grid-sample-list
Search samples on the Threat Grid platform. Input parameters are ANDed together. Only finished samples can be searched (that is, the ones that are having a status of succ or fail.)
Base Command
threat-grid-sample-list
Input
| Argument Name | Description | Required |
|---|---|---|
| sample_id | The sample ID. | Optional |
| artifact | The artifact to download. Sample ID is required when choosing ‘artifact’. Possible values are: video.webm, network-artifacts.zip, report.html, sample.zip, screenshot.png, extracted-artifacts.zip, timeline.json, analysis.json, processes.json, network.pcap. | Optional |
| sha1 | A sha1 of the submitted sample, only matches samples, not their artifacts. | Optional |
| sha256 | A SHA256 of the submitted sample, only matches samples, not their artifacts. | Optional |
| md5 | A MD5 checksum of the submitted sample, only matches samples, not their artifacts. | Optional |
| user_only | It ‘True’ - Only display samples created by the current user, as determined by the value of api_key. | Optional |
| org_only | It ‘True’ - Only display samples created by the current user’s organization, as determined by the value of api_key. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.Sample.id | String | The sample id |
| ThreatGrid.Sample.filename | String | The sample filename |
| ThreatGrid.Sample.state | String | The state of the sample, one of a stable set of strings “wait, prep, run, proc, succ, fail” |
| ThreatGrid.Sample.status | String | The sample status, one of a stable set of strings “succ, fail” |
| ThreatGrid.Sample.md5 | String | The sample md5 |
| ThreatGrid.Sample.sha1 | String | The sample sha1 |
| ThreatGrid.Sample.sha256 | String | The sample sha256 |
| ThreatGrid.Sample.os | String | The sample os |
| ThreatGrid.Sample.submitted_at | String | The sample submission time |
| ThreatGrid.Sample.started_at | String | The sample analysis starting time |
| ThreatGrid.Sample.completed_at | String | The sample completion time |
| InfoFile.Name | String | The file name |
| InfoFile.EntryID | String | The ID for locating the file in the War Room |
| InfoFile.Size | String | The size of the file (in bytes) |
| InfoFile.Type | String | The file type, as determined by libmagic (same as displayed in file entries) |
| InfoFile.Extension | String | The file extension |
| InfoFile.Info | String | Basic information about the file |
Command example
#### Context Example
```json
{
"ThreatGrid": {
"Sample": [
{
"completed_at": "ThreatGrid_Sample[0]_completed_at",
"filename": "md5",
"id": "id",
"md5": "md5",
"os": "os",
"sha1": "sha1",
"sha256": "sha256",
"started_at": "ThreatGrid_Sample[0]_started_at",
"state": "succ",
"status": "job_done",
"submission_id": 1538519424,
"submitted_at": "ThreatGrid_Sample[0]_submitted_at",
"tags": [],
"vm": "win7-x64"
},
{
"completed_at": "ThreatGrid_Sample[1]_completed_at",
"filename": "sha256",
"id": "id",
"md5": "md5",
"os": "os",
"sha1": "sha1",
"sha256": "sha256",
"started_at": "ThreatGrid_Sample[1]_started_at",
"state": "succ",
"status": "job_done",
"submission_id": 1531508494,
"submitted_at": "ThreatGrid_Sample[1]_submitted_at",
"tags": [
"s",
"talos",
"gravity"
],
"vm": "win7-x64"
},
]
}
}
Human Readable Output
Sample details
Completed At Filename Id Md5 Os Sha1 Sha256 Started At State Status Submission Id Submitted At Tags Vm 2022-12-05T04:17:00Z md5 id md5 os sha1 sha256 2022-12-05T04:10:44Z succ job_done 1538519424 2022-12-05T04:10:44Z win7-x64 2022-11-24T01:04:39Z sha256 id md5 os sha1 sha256 2022-11-24T00:58:22Z succ job_done 1531508494 2022-11-24T00:58:22Z s,
talos,
gravitywin7-x64
threat-grid-sample-upload
Submits a sample to threat grid for analysis. URL or file, not both.
Base Command
threat-grid-sample-upload
Input
| Argument Name | Description | Required |
|---|---|---|
| file_id | The file ID. Click on the chain-like icon after you upload a file in d__ to find the file_id. | Optional |
| url | The URL to upload. . | Optional |
| interval_in_seconds | Indicates how long to wait between command execution (in seconds) when ‘polling’ argument is true. Minimum value is 10 seconds. Default is 10. Default is 10. | Optional |
| timeout_in_seconds | Indicates the time in seconds until the polling sequence timeouts. Default is 60. Default is 60. | Optional |
| sample_id | The uploaded sample ID. | Optional |
| private | Whether to mark the sample as private. | Optional |
| hide_polling_output | Whether to hide the polling result (automatically filled by polling). | Optional |
| vm | a string identifying a specific VM to use. Options: win7-x64: Windows 7 64bit, win7-x64-2: Windows 7 64-bit Profile 2, win10-x64-2-beta: Windows 10 LTSC 2019 (beta), win10-x64-browser: Windows 10 Browser, win10-x64-jp: Windows 10 Japanese, win10-x64-kr: Windows 10 Korean, win10-x64-phishing-beta: Windows 10 (Phishing), win10: Windows 10 (Not available on Threat Grid appliances). NOTE: The standard (English) VMs default to UTF-8 encoding. To support Korean and Japanese character sets, such as S-JIS, submit to the appropriate VM. | Optional |
| playbook | Name of a playbook to apply to this sample run. none: Explicitly disables playbooks, default: Default Playbook, alt_tab_programs: Conduct Active Window Change, open_word_embedded_object: Open Embedded Object in Word Document, use_best_option: allows Malware Analytics to select the best Playbook option based on the submitted sample, visit_site: Visit Website Using Internet Explorer, close_file: Close Active Window. The current list of playbooks endpoints can be obtained by querying /api/v3/configuration/playbooks. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.Sample.id | String | The sample id |
| ThreatGrid.Sample.filename | String | The sample filename |
| ThreatGrid.Sample.state | String | The state of the sample, one of a stable set of strings “wait, prep, run, proc, succ, fail” |
| ThreatGrid.Sample.status | String | The sample status |
| ThreatGrid.Sample.md5 | String | The sample md5 |
| ThreatGrid.Sample.sha1 | String | The sample sha1 |
| ThreatGrid.Sample.sha256 | String | The sample sha256 |
| ThreatGrid.Sample.os | String | The sample os |
| ThreatGrid.Sample.submitted_at | String | The sample submission time |
Command example
!threat-grid-sample-upload url=http://domain_example:80/ private=True
Human Readable Output
Upload sample is executing
threat-grid-submissions-search
Search threat grid submissions
Base Command
threat-grid-submissions-search
Input
| Argument Name | Description | Required |
|---|---|---|
| query | Query text. If you wish to work with an elasticsearch query please set ‘advanced’ argument to true. | Optional |
| user_only | Only display submissions created by the current user, as determined by the value of api_key. Possible values are: True, False. | Optional |
| org_only | Only display submissions created by the current user’s organization, as determined by the value of api_key. Possible values are: True, False. | Optional |
| term | Restrict matches to a subset of submission fields. The value of ‘term’ is a comma-delimited list of strings which select groups of fields. Possible values are: antivirus, analysis.artifacts.av_signatures.product, analysis.artifacts.av_signatures.signature, behavior, analysis.behaviors.name, analysis.behaviors.title, analysis.artifacts.av_signatures.signature, domain, analysis.domains.domain, analysis.domains.domain.component, mutant, analysis.processes.mutants, analysis.processes.mutants.whole, analysis.processes.mutants.component, path, filename, analysis.paths.path, analysis.paths.path.whole, analysis.processes.paths, process, analysis.processes.process_name, analysis.processes.startup_info.command_line, analysis.processes.startup_info.image_pathname, analysis.processes.startup_info.window_title, registry_key, analysis.registry_keys.key, analysis.registry_keys.key.whole, analysis.registry_keys.key.component, analysis.processes.registry_keys, analysis.processes.registry_keys.whole, analysis.registry_keys.value_names, sample, filename, url, analysis.urls.url, analysis.urls.url.whole.. | Optional |
| before | “A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| after | “A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| state | Restrict match to submissions in specific state or states. Possible values are: wait, prep, run, proc, succ, fail. | Optional |
| sort_by | If not specified, results will be sorted by the search score, which is based on which fields match the query most accurately, and their weight. Possible values are: timestamp, submitted_at, analyzed_at, filename, type, state, threat or threat_score, login. | Optional |
| sort_order | desc or asc. Possible values are: desc, asc. | Optional |
| highlight | Provide a ‘matches’ field in results, indicating which fields were matched. Possible values are: True, False. | Optional |
| page | Page number of paginated results. Minimum value: 1. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.Sample.sample | String | The sample ID |
| ThreatGrid.Sample.filename | String | The name of the sample file |
| ThreatGrid.Sample.state | String | The state of the sample, one of a stable set of strings “wait, prep, run, proc, succ, fail” |
| ThreatGrid.Sample.status | String | The status of the sample |
| ThreatGrid.Sample.md5 | String | The MD5 id of the sample |
| ThreatGrid.Sample.sha1 | String | The SHA1 id of the sample |
| ThreatGrid.Sample.sha256 | String | The SHA256 id of the sample |
| ThreatGrid.Sample.submitted_at | Date | Time of submission for the sample |
| ThreatGrid.Sample.threat_score | Number | The threat score of the sample |
Command example
#### Context Example
```json
{
"ThreatGrid": {
"Sample": [
{
"filename": "md5",
"md5": "md5",
"private": false,
"sample": "sample",
"sha1": "sha1",
"sha256": "sha256",
"state": "wait",
"status": "pending",
"submitted_at": "ThreatGrid_Sample[0]_submitted_at"
},
{
"filename": "md5",
"md5": "md5",
"private": false,
"sample": "sample",
"sha1": "sha1",
"sha256": "sha256",
"state": "wait",
"status": "pending",
"submitted_at": "ThreatGrid_Sample[1]_submitted_at"
},
]
}
}
Human Readable Output
Samples Submissed
Showing page 1.
Current page size: 50
Filename Md5 Private Sample Sha1 Sha256 State Status Submitted At md5 md5 false sample sha1 sha256 wait pending 2022-12-22T08:40:47Z md5 md5 false sample sha1 sha256 wait pending 2022-12-22T08:40:47Z
threat-grid-sample-summary-get
Returns summary analysis information
Base Command
threat-grid-sample-summary-get
Input
| Argument Name | Description | Required |
|---|---|---|
| sample_id | The sample id. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.SampleAnalysisSummary.sample | String | The sample ID. |
| ThreatGrid.SampleAnalysisSummary.registry_count | Number | The registry count of the sample. |
| ThreatGrid.SampleAnalysisSummary.filename | String | The Filename of the sample. |
| ThreatGrid.SampleAnalysisSummary.sha256 | String | The SHA256 hash of the sample. |
| ThreatGrid.SampleAnalysisSummary.magic_type | String | The sample type. |
| ThreatGrid.SampleAnalysisSummary.first_seen | Date | The timestamp when the sample was first seen. |
| ThreatGrid.SampleAnalysisSummary.last_seen | Date | The timestamp when the sample was last seen. |
Command example
!threat-grid-sample-summary-get sample_id=sample_id
Context Example
{
"ThreatGrid": {
"SampleAnalysisSummary": {
"artifacts": {
"disk": 6,
"memory": 9,
"network": 1
},
"filename": "www.domain_example_.url",
"first_seen": "ThreatGrid_SampleAnalysisSummary_first_seen",
"iocs": [
{
"category": [
"static-anomaly"
],
"confidence": 100,
"ioc": "html-small-file-redirect",
"score": 50,
"severity": 50,
"tags": [
"html",
"redirect"
]
},
{
"category": [
"network-information"
],
"confidence": 50,
"ioc": "http-response-redirect",
"score": 25,
"severity": 50,
"tags": [
"network",
"http",
"redirect"
]
},
{
"category": [
"domain"
],
"confidence": 95,
"ioc": "network-only-safe-domains-contacted",
"score": 19,
"severity": 20,
"tags": [
"umbrella",
"dns"
]
},
{
"category": [
"network-information"
],
"confidence": 25,
"ioc": "network-communications-http-get-url",
"score": 6,
"severity": 25,
"tags": [
"network",
"http",
"get"
]
}
],
"last_seen": "ThreatGrid_SampleAnalysisSummary_last_seen",
"magic_type": "ThreatGrid_SampleAnalysisSummary_magic_type",
"md5": "md5",
"registry_count": 143,
"run_start": "ThreatGrid_SampleAnalysisSummary_run_start",
"run_stop": "ThreatGrid_SampleAnalysisSummary_run_stop",
"run_type": "url",
"sample": "sample_id",
"sha1": "sha1",
"sha256": "sha256",
"stream_count": 44,
"tags": [],
"times_seen": 85
}
}
}
Human Readable Output
Sample summary
Artifacts Filename First Seen Iocs Last Seen Magic Type Md5 Registry Count Run Start Run Stop Run Type Sample Sha1 Sha256 Stream Count Tags Times Seen disk: 6
memory: 9
network: 1www.domain_example_.url 2021-12-29T15:43:00Z {‘category’: [‘static-anomaly’], ‘confidence’: 100, ‘ioc’: ‘html-small-file-redirect’, ‘severity’: 50, ‘tags’: [‘html’, ‘redirect’], ‘score’: 50},
{‘category’: [‘network-information’], ‘confidence’: 50, ‘ioc’: ‘http-response-redirect’, ‘severity’: 50, ‘tags’: [‘network’, ‘http’, ‘redirect’], ‘score’: 25},
{‘category’: [‘domain’], ‘confidence’: 95, ‘ioc’: ‘network-only-safe-domains-contacted’, ‘severity’: 20, ‘tags’: [‘umbrella’, ‘dns’], ‘score’: 19},
{‘category’: [‘network-information’], ‘confidence’: 25, ‘ioc’: ‘network-communications-http-get-url’, ‘severity’: 25, ‘tags’: [‘network’, ‘http’, ‘get’], ‘score’: 6}2022-12-21T12:09:33Z MS Windows 95 Internet shortcut text (URL=http:<span//</span>www.domain_example>), ASCII text md5 143 2022-12-21T12:09:33Z 2022-12-21T12:16:27Z url sample_id sha1 sha256 44 85
threat-grid-who-am-i
Get logged in user
Base Command
threat-grid-who-am-i
Input
There are no input arguments for this command.
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.User.email | string | Current user mail. |
| ThreatGrid.User.login | string | Current user login name. |
Command example
#### Context Example
```json
{
"ThreatGrid": {
"User": {
"active": true,
"api_key": "key",
"api_only": false,
"device": false,
"email": "ThreatGrid_User_email",
"integration_id": "id",
"login": "login_name",
"name": "name",
"organization_id": 485008,
"role": "org-admin",
"title": ""
}
}
}
Human Readable Output
Who am I ?
Active Api Key Api Only Device Integration Id Login Name Organization Id Role Title true key false false z1ci login_name name id org-admin
threat-grid-rate-limit-get
Get rate limit for a specific user name. ThreatGrid employs a simple rate limiting method for sample submissions by specifying the number of samples which can be submitted within some variable time period by a user. Multiple rate limits can be employed to form overlapping submission limits. For example, 20 submissions per hour AND 400 per day.
Base Command
threat-grid-rate-limit-get
Input
| Argument Name | Description | Required |
|---|---|---|
| login | User login name. | Required |
| entity_type | User or Organization. Possible values are: user, organization. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.RateLimit.submission-rate-limit | number | Array of array(s) representing submission(s) per minute(s) or the string”nil” to clear the value. Example: [[5, 1440]] which represents 5 samples per day. This field represent the number of samples allowed. |
| ThreatGrid.RateLimit.submission-wait-seconds | number | The number of seconds to wait for a submission to get uploaded on the platform. |
| ThreatGrid.RateLimit.submissions-available | number | The number of submissions available for the specified username |
Command example
!threat-grid-rate-limit-get login=login_name entity_type=user
Context Example
{
"ThreatGrid": {
"RateLimit": {
"submission-rate-limit": [],
"submission-wait-seconds": 0,
"submissions-available": null
}
}
}
Human Readable Output
user rate limit
Submission-rate-limit Submission-wait-seconds Submissions-available 0
threat-grid-feed-specific-get
Gets a specific threat feed
Base Command
threat-grid-feed-specific-get
Input
| Argument Name | Description | Required |
|---|---|---|
| feed_name | The feed name. Possible values are: autorun-registry, banking-dns, dga-dns, dll-hijacking-dns, doc-net-com-dns, downloaded-pe-dns, dynamic-dns, irc-dns, modified-hosts-dns, parked-dns, public-ip-check-dns, ransomware-dns, rat-dns, scheduled-tasks, sinkholed-ip-dns, stolen-cert-dns. | Required |
| output_type | The output type. Possible values are: json, csv, stix, snort, txt. Default is json. | Optional |
| before | “A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| after | “A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.Feed.sample | String | Feed sample. |
| ThreatGrid.Feed.description | String | Feed description. |
Command example
!threat-grid-feed-specific-get feed_name=doc-net-com-dns
Context Example
{
"ThreatGrid": {
"Feed": [
{
"description": "DNS response information from requests made by document samples performing network communications.",
"domain": "login.gogie.com.000000000000.phish.farm",
"info": "ThreatGrid_Feed[0]_info",
"ips": [
"ThreatGrid_Feed[0]_ips_0",
"ThreatGrid_Feed[0]_ips_1"
],
"sample": "ThreatGrid_Feed[0]_sample",
"sample_md5": "sample_md5",
"sample_sha1": "sample_sha1",
"sample_sha256": "sample_sha256",
"timestamp": "ThreatGrid_Feed[0]_timestamp"
},
{
"description": "DNS response information from requests made by document samples performing network communications.",
"domain": "spamchallenge.msftemail.com",
"info": "ThreatGrid_Feed[1]_info",
"ips": [
"ThreatGrid_Feed[1]_ips_0",
"ThreatGrid_Feed[1]_ips_1"
],
"sample": "ThreatGrid_Feed[1]_sample",
"sample_md5": "sample_md5",
"sample_sha1": "sample_sha1",
"sample_sha256": "sample_sha256",
"timestamp": "ThreatGrid_Feed[1]_timestamp"
},
]
}
}
Human Readable Output
Specific feed
Sample Description https://panacea.threatgrid.com/feeds/doc-net-com-dns/samples/4007c79d4db4af076e67a32b9aa9eae8 DNS response information from requests made by document samples performing network communications. https://panacea.threatgrid.com/feeds/doc-net-com-dns/samples/9df95de1e738730ea3eb9c2ec122afa7 DNS response information from requests made by document samples performing network communications.
threat-grid-ip-search
Search IPs. Please provide a single argument (only one) to use this command, as the API supports 1 filter at a time.
Base Command
threat-grid-ip-search
Input
| Argument Name | Description | Required |
|---|---|---|
| ip | The IP to search for. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.search.ip | string | IP item. |
| ThreatGrid.search.asn | string | IP asn. |
| ThreatGrid.search.location | string | IP location details. |
Command example
!threat-grid-ip-search ip=8.8.8.8
Context Example
{
"ThreatGrid": {
"search": {
"asn": {
"asn": 15169,
"org": "Google"
},
"flags": [
{
"created_at": "ThreatGrid_search_flags[0]_created_at",
"expiration": "ThreatGrid_search_flags[0]_expiration",
"flag": 1,
"login": "admin",
"mine": false,
"reason": "Content Delivery Network"
},
],
"ip": "ThreatGrid_search_ip",
"location": {
"city": "Los Angeles",
"country": "US",
"region": "CA"
},
"rev": "dns.google",
"tags": []
}
}
}
Human Readable Output
ip data
Asn Flags Ip Location Rev Tags org: Google
asn: 15169{‘created_at’: ‘2013-11-15T18:16:33Z’, ‘expiration’: ‘2025-01-01T00:00:00Z’, ‘flag’: 1, ‘login’: ‘admin’, ‘reason’: ‘Content Delivery Network’, ‘mine’: False},
{‘created_at’: ‘2013-11-15T18:16:34Z’, ‘expiration’: ‘2025-01-01T00:00:00Z’, ‘flag’: 1, ‘login’: ‘admin’, ‘reason’: ‘resolves to google-public-dns-a.domain_example’, ‘mine’: False},
{‘created_at’: ‘2013-07-25T14:08:34Z’, ‘expiration’: ‘2025-01-01T00:00:00Z’, ‘flag’: 1, ‘login’: ‘dean’, ‘reason’: ‘Whitelisted’, ‘mine’: False}8.8.8.8 country: US
region: CA
city: Los Angelesdns.google
threat-grid-analysis-annotations-get
Returns data regarding the annotations of the analysis
Base Command
threat-grid-analysis-annotations-get
Input
| Argument Name | Description | Required |
|---|---|---|
| sample_id | The sample ID. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.SampleAnnotations.network | String | IP address & timestamp in the annotation. |
Command example
!threat-grid-analysis-annotations-get sample_id=sample_id
Context Example
{
"ThreatGrid": {
"SampleAnnotations": {
"network": {
"ip1": {
"ts": "ThreatGrid_SampleAnnotations_network_ip1_ts"
},
"ip2": {
"asn": 15169,
"city": "c",
"country": "US",
"country_name": "United States",
"org": "Google",
"region": "NY",
"region_name": "New York",
"reverse_dns": [
"lga34s32-in-f3.1e100.net"
],
"ts": "ThreatGrid_SampleAnnotations_network_ip2_ts"
},
}
}
}
}
Human Readable Output
List of samples analysis
ip1 ip2 ts: 2022-12-21T12:15:59Z org: Google
ts: 2022-12-21T12:15:59Z
country: US
city: c
region_name: New York
region: NY
reverse_dns: lga34s32-in-f3.1e100.net
country_name: United States
asn: 15169org: Google
ts: 2022-12-21T12:15:59Z
country: US
city: Wantagh
region_name: New York
region: NY
reverse_dns: lga34s34-in-f14.1e100.net
country_name: United States
asn: 15169org: Google
ts: 2022-12-21T12:15:59Z
country: US
city: Glen Cove
threat-grid-url-search
Search urls. Please provide the URL in the format http://example.com:80/ (note that ThreatGrid only support ‘.com’ domains).
Base Command
threat-grid-url-search
Input
| Argument Name | Description | Required |
|---|---|---|
| url | The URL to search for (please provide the URL in the format http://example.com:80/. note that ThreatGrid only support ‘.com’ domains). | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.search.url | String | URL item |
Command example
!threat-grid-url-search url=http://domain_example:80/
Context Example
{
"ThreatGrid": {
"search": {
"host": "domain_example",
"path": "/",
"port": 80,
"protocol": "http",
"query": null,
"query-params": null,
"reference": null,
"url": "ThreatGrid_search_url"
}
}
}
Human Readable Output
url data
Host Path Port Protocol Query Query-params Reference Url domain_example / 80 http http://domain_example:80/
threat-grid-feeds-artifact
Get artifacts threat feed
Base Command
threat-grid-feeds-artifact
Input
| Argument Name | Description | Required |
|---|---|---|
| sha256 | Restrict returned records with this sha256. | Optional |
| sha1 | Restrict returned records with this sha1. | Optional |
| md5 | Restrict returned records with this md5. | Optional |
| path | Restrict returned records to this path or path fragment. | Optional |
| before | “A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| after | “A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| confidence | Restrict to IOCs with this confidence score or higher, defaults to 80. Default is 80. | Optional |
| severity | Restrict to IOCs with this severity score or higher, defaults to 80. Default is 80. | Optional |
| ioc | Restrict returned records to events of this type. | Optional |
| org_only | If “true”, will only match against samples submitted by your organization. Possible values are: True, False. | Optional |
| user_only | If “true”, will only match against samples you submitted. Possible values are: True, False. | Optional |
| sample_id | A comma-separated list of sample IDs. Restrict results to these samples. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| page_size | The number of items per page. | Optional |
| page | Page number of paginated results. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.Artifact.confidence | Number | Artifact confidence |
| ThreatGrid.Artifact.severity | Number | Artifact severity |
| ThreatGrid.Artifact.ioc | String | Artifact IOC |
| ThreatGrid.Artifact.artifact_sha256 | String | Artifact sha256 |
| ThreatGrid.Artifact.artifact_md5 | String | Artifact md5 |
| ThreatGrid.Artifact.sample_id | String | Artifact sample ID |
Command example
#### Context Example
```json
{
"ThreatGrid": {
"Artifact": [
{
"aid": 1,
"artifact_md5": "md5",
"artifact_sha256": "sha256",
"confidence": 95,
"ioc": "antivirus-service-flagged-artifact",
"path": "md5.exe",
"sample_id": "id",
"severity": 100,
"timestamp": "ThreatGrid_Artifact[0]_timestamp"
},
{
"aid": 11,
"artifact_md5": "artifact_md5",
"artifact_sha256": "artifact_sha256",
"confidence": 90,
"ioc": "sample-pe-modified-on-disk",
"path": "ThreatGrid_Artifact[1]_path",
"sample_id": "id",
"severity": 90,
"timestamp": "ThreatGrid_Artifact[1]_timestamp"
},
]
}
}
Human Readable Output
Feeds IOCs list artifact
Showing page 1.
Current page size: 50
Aid Artifact Md5 Artifact Sha256 Confidence Ioc Path Sample Id Severity Timestamp 3 md5 sha256 90 antivirus-flagged-artifact \Users\Administrator.exe id 80 2022-12-05T04:10:44Z 9 md5 sha256 90 antivirus-flagged-artifact 912-.exe id 80 2022-12-05T04:10:44Z
threat-grid-feeds-domain
Get domain threat feed
Base Command
threat-grid-feeds-domain
Input
| Argument Name | Description | Required |
|---|---|---|
| domain | Restrict returned records to this domain or hostname. | Optional |
| before | “A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| after | “A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| confidence | Restrict to IOCs with this confidence score or higher, defaults to 80. Default is 80. | Optional |
| severity | Restrict to IOCs with this severity score or higher, defaults to 80. Default is 80. | Optional |
| ioc | Restrict returned records to events of this type. | Optional |
| org_only | If “true”, will only match against samples submitted by your organization. Possible values are: True, False. | Optional |
| user_only | If “true”, will only match against samples you submitted. Possible values are: True, False. | Optional |
| sample_id | A comma-separated list of sample IDs. Restrict results to these samples. | Optional |
| page | Page number of paginated results. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.Domain.confidence | Number | Domain confidence |
| ThreatGrid.Domain.severity | Number | Domain severity |
| ThreatGrid.Domain.ioc | String | Domain IOC |
| ThreatGrid.Domain.sample_sha256 | String | Domain sha256 |
| ThreatGrid.Domain.sample_id | String | Domain sample ID |
| ThreatGrid.Domain.domain | String | The Domain |
Command example
#### Context Example
```json
{
"ThreatGrid": {
"Domain": [
{
"confidence": 95,
"domain": "hookworm.capitaly.ru",
"ioc": "network-snort-pua",
"sample_id": "sample_id",
"sample_sha256": "sample_sha256",
"severity": 90,
"timestamp": "ThreatGrid_Domain[0]_timestamp"
},
{
"confidence": 100,
"domain": "augustawa.com",
"ioc": "suspicious-user-agent",
"sample_id": "sample_id",
"sample_sha256": "sample_sha256",
"severity": 80,
"timestamp": "ThreatGrid_Domain[1]_timestamp"
},
]
}
}
Human Readable Output
Feeds IOCs list domain
Showing page 1.
Current page size: 50
Confidence Domain Ioc Sample Id Sample Sha256 Severity Timestamp 95 hookworm.capitaly.ru network-snort-pua sample_id sample_sha256 90 2022-12-22T07:46:38Z 100 augustawa.com suspicious-user-agent sample_id sample_sha256 80 2022-11-28T23:51:27Z
threat-grid-feeds-url
Get url threat feed
Base Command
threat-grid-feeds-url
Input
| Argument Name | Description | Required |
|---|---|---|
| url | Restrict returned records to this url. | Optional |
| before | “A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| after | “A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| confidence | Restrict to IOCs with this confidence score or higher, defaults to 80. Default is 80. | Optional |
| severity | Restrict to IOCs with this severity score or higher, defaults to 80. Default is 80. | Optional |
| ioc | Restrict returned records to events of this type. | Optional |
| org_only | If “true”, will only match against samples submitted by your organization. Possible values are: True, False. | Optional |
| user_only | If “true”, will only match against samples you submitted. Possible values are: True, False. | Optional |
| sample_id | A comma-separated list of sample IDs. Restrict results to these samples. | Optional |
| page | Page number of paginated results. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.Url.confidence | Number | url confidence |
| ThreatGrid.Url.severity | Number | url severity |
| ThreatGrid.Url.ioc | String | url IOC |
| ThreatGrid.Url.sample_sha256 | String | url sha256 |
| ThreatGrid.Url.sample_id | String | url sample ID |
| ThreatGrid.Url.url | String | The url |
Command example
#### Context Example
```json
{
"ThreatGrid": {
"url": [
{
"confidence": 95,
"url": "hookworm.capitaly.ru",
"ioc": "network-snort-pua",
"sample_id": "sample_id",
"sample_sha256": "sample_sha256",
"severity": 90,
"timestamp": "ThreatGrid_url[0]_timestamp"
},
{
"confidence": 100,
"url": "augustawa.com",
"ioc": "suspicious-user-agent",
"sample_id": "sample_id",
"sample_sha256": "sample_sha256",
"severity": 80,
"timestamp": "ThreatGrid_url[1]_timestamp"
},
]
}
}
Human Readable Output
Feeds IOCs list url
Showing page 1.
Current page size: 50
Confidence url Ioc Sample Id Sample Sha256 Severity Timestamp 95 hookworm.capitaly.ru network-snort-pua sample_id sample_sha256 90 2022-12-22T07:46:38Z 100 augustawa.com suspicious-user-agent sample_id sample_sha256 80 2022-11-28T23:51:27Z
threat-grid-feeds-ip
Get ips threat feed
Base Command
threat-grid-feeds-ip
Input
| Argument Name | Description | Required |
|---|---|---|
| ip | Restrict returned records to this IP or CIDR block. | Optional |
| before | “A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| after | “A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| confidence | Restrict to IOCs with this confidence score or higher, defaults to 80. Default is 80. | Optional |
| severity | Restrict to IOCs with this severity score or higher, defaults to 80. Default is 80. | Optional |
| ioc | Restrict returned records to events of this type. | Optional |
| org_only | If “true”, will only match against samples submitted by your organization. Possible values are: True, False. | Optional |
| user_only | If “true”, will only match against samples you submitted. Possible values are: True, False. | Optional |
| sample_id | A comma-separated list of sample IDs. Restrict results to these samples. | Optional |
| page | Page number of paginated results. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.Ip.confidence | Number | IP confidence |
| ThreatGrid.Ip.severity | Number | IP severity |
| ThreatGrid.Ip.ioc | String | IP IOC |
| ThreatGrid.Ip.sample_sha256 | String | IP sha256 |
| ThreatGrid.Ip.sample_id | String | IP sample ID |
| ThreatGrid.Ip.ip | String | The IP |
| ThreatGrid.Ip.port | Number | The IP port |
Command example
#### Context Example
```json
{
"ThreatGrid": {
"Ip": [
{
"confidence": 95,
"ioc": "network-snort-pua",
"ip": "ThreatGrid_Ip[0]_ip",
"port": null,
"sample_id": "sample_id",
"sample_sha256": "sample_sha256",
"severity": 90,
"timestamp": "ThreatGrid_Ip[0]_timestamp"
},
{
"confidence": 90,
"ioc": "network-snort-indicator-compromise",
"ip": "ThreatGrid_Ip[1]_ip",
"port": null,
"sample_id": "sample_id",
"sample_sha256": "sample_sha256",
"severity": 95,
"timestamp": "ThreatGrid_Ip[1]_timestamp"
},
]
}
}
Human Readable Output
Feeds IOCs list ip
Showing page 1.
Current page size: 50
Confidence Ioc Ip Port Sample Id Sample Sha256 Severity Timestamp 95 network-snort-pua ip sample_id sample_sha256 90 2022-12-22T07:46:38Z 90 network-snort-indicator-compromise 192.168.1.1 sample_id sample_sha256 95 2022-12-09T14:22:54Z
threat-grid-feeds-network-stream
Get network stream threat feed
Base Command
threat-grid-feeds-network-stream
Input
| Argument Name | Description | Required |
|---|---|---|
| ip | Restrict returned records to this IP address. | Optional |
| port | Restrict returned records to this port number. | Optional |
| before | “A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| after | “A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| confidence | Restrict to IOCs with this confidence score or higher, defaults to 80. Default is 80. | Optional |
| severity | Restrict to IOCs with this severity score or higher, defaults to 80. Default is 80. | Optional |
| ioc | Restrict returned records to events of this type. | Optional |
| org_only | If “true”, will only match against samples submitted by your organization. Possible values are: True, False. | Optional |
| user_only | If “true”, will only match against samples you submitted. Possible values are: True, False. | Optional |
| sample_id | A comma-separated list of sample IDs. Restrict results to these samples. | Optional |
| page | Page number of paginated results. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.NetworkStreams.confidence | Number | Network Streams confidence |
| ThreatGrid.NetworkStreams.severity | Number | Network Streams severity |
| ThreatGrid.NetworkStreams.ioc | String | Network Streams IOC |
| ThreatGrid.NetworkStreams.sample_sha256 | String | Network Streams sha256 |
| ThreatGrid.NetworkStreams.sample_id | String | Network Streams sample ID |
| ThreatGrid.NetworkStreams.src | String | The Network Streams source |
| ThreatGrid.NetworkStreams.src_port | Number | The Network Streams source port |
| ThreatGrid.NetworkStreams.dst | String | The Network Streams destination |
| ThreatGrid.NetworkStreams.dst_port | Number | The Network Streams destination port |
Command example
#### Context Example
```json
{
"ThreatGrid": {
"NetworkStreams": [
{
"confidence": 95,
"dst": "ThreatGrid_NetworkStreams[0]_dst",
"dst_port": 80,
"ioc": "network-snort-pua",
"sample_id": "sample_id",
"sample_sha256": "sample_sha256",
"severity": 90,
"src": "ThreatGrid_NetworkStreams[0]_src",
"src_port": 49166,
"timestamp": "ThreatGrid_NetworkStreams[0]_timestamp"
},
{
"confidence": 100,
"dst": "ThreatGrid_NetworkStreams[1]_dst",
"dst_port": 80,
"ioc": "suspicious-user-agent",
"sample_id": "sample_id",
"sample_sha256": "sample_sha256",
"severity": 80,
"src": "ThreatGrid_NetworkStreams[1]_src",
"src_port": 49160,
"timestamp": "ThreatGrid_NetworkStreams[1]_timestamp"
},
]
}
}
Human Readable Output
Feeds IOCs list network_stream
Showing page 1.
Current page size: 50
Confidence Dst Dst Port Ioc Sample Id Sample Sha256 Severity Src Src Port Timestamp 95 ip 80 network-snort-pua sample_id sample_sha256 90 ip 49164 2022-12-22T07:46:38Z 95 ip 80 network-snort-pua sample_id sample_sha256 90 ip 49158 2022-12-22T07:46:38Z
threat-grid-feeds-path
Get path threat feed
Base Command
threat-grid-feeds-path
Input
| Argument Name | Description | Required |
|---|---|---|
| path | Restrict returned records to this path or path fragment. | Optional |
| before | “A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| after | “A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| confidence | Restrict to IOCs with this confidence score or higher, defaults to 80. Default is 80. | Optional |
| severity | Restrict to IOCs with this severity score or higher, defaults to 80. Default is 80. | Optional |
| ioc | Restrict returned records to events of this type. | Optional |
| org_only | If “true”, will only match against samples submitted by your organization. Possible values are: True, False. | Optional |
| user_only | If “true”, will only match against samples you submitted. Possible values are: True, False. | Optional |
| sample_id | A comma-separated list of sample IDs. Restrict results to these samples. | Optional |
| page | Page number of paginated results. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.Path.confidence | Number | Path confidence |
| ThreatGrid.Path.severity | Number | Path severity |
| ThreatGrid.Path.ioc | String | Path IOC |
| ThreatGrid.Path.sample_sha256 | String | Path sha256 |
| ThreatGrid.Path.sample_id | String | Path sample ID |
Command example
#### Context Example
```json
{
"ThreatGrid": {
"Path": [
{
"confidence": 100,
"ioc": "artifact-pe-no-name",
"path": "\\Users\\Administrator\\.exe",
"sample_id": "id",
"sample_sha256": "sha256",
"severity": 90,
"timestamp": "ThreatGrid_Path[0]_timestamp"
},
{
"confidence": 100,
"ioc": "modified-file-in-system-dir",
"path": "ThreatGrid_Path[1]_path",
"sample_id": "id",
"sample_sha256": "sha256",
"severity": 85,
"timestamp": "ThreatGrid_Path[1]_timestamp"
},
]
}
}
Human Readable Output
Feeds IOCs list path
Showing page 1.
Current page size: 50
Confidence Ioc Path Sample Id Sample Sha256 Severity Timestamp 90 antivirus-flagged-artifact \Users\Administrator.exe id sha256 80 2022-12-05T04:10:44Z 90 antivirus-flagged-artifact 912-.exe id sha256 80 2022-12-05T04:10:44Z
threat-grid-feeds-url
Get url threat feed
Base Command
threat-grid-feeds-url
Input
| Argument Name | Description | Required |
|---|---|---|
| url | Restrict returned records to this URL or URL fragment. | Optional |
| before | “A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| after | “A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| confidence | Restrict to IOCs with this confidence score or higher, defaults to 80. Default is 80. | Optional |
| severity | Restrict to IOCs with this severity score or higher, defaults to 80. Default is 80. | Optional |
| ioc | Restrict returned records to events of this type. | Optional |
| org_only | If “true”, will only match against samples submitted by your organization. Possible values are: True, False. | Optional |
| user_only | If “true”, will only match against samples you submitted. Possible values are: True, False. | Optional |
| sample_id | A comma-separated list of sample IDs. Restrict results to these samples. | Optional |
| page | Page number of paginated results. | Optional |
| page_size | The number of items per page. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.Url.confidence | Number | URL confidence |
| ThreatGrid.Url.severity | Number | URL severity |
| ThreatGrid.Url.ioc | String | URL IOC |
| ThreatGrid.Url.sample_sha256 | String | URL sha256 |
| ThreatGrid.Url.sample_id | String | URL sample ID |
| ThreatGrid.Url.url | String | The URL |
threat-grid-analysis-artifacts-get
Returns the sample id artifact with artifact id
Base Command
threat-grid-analysis-artifacts-get
Input
| Argument Name | Description | Required |
|---|---|---|
| sample_id | the sample id. | Required |
| artifact_id | The artifact id requested. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.ArtifactAnalysis.items | Unknown | Analysis files of the sample and the artifact |
Command example
!threat-grid-analysis-artifacts-get sample_id=sample_id
Context Example
{
"ThreatGrid": {
"ArtifactAnalysis": {
"1": {
"antivirus": {
"reversing_labs": {
"first_seen": "ThreatGrid_ArtifactAnalysis_1_antivirus_reversing_labs_first_seen",
"last_seen": "ThreatGrid_ArtifactAnalysis_1_antivirus_reversing_labs_last_seen",
"query_hash": {
"sha256": "sha256"
},
"scanner_count": 25,
"scanner_match": 0,
"status": "KNOWN",
"threat_level": 0,
"threat_name": "",
"trust_factor": 5
},
"virustotal": {
"engines": 55,
"hits": 0,
"results": {},
"scanned": "ThreatGrid_ArtifactAnalysis_1_antivirus_virustotal_scanned",
"score": 0
}
},
"created-time": 0,
"created_by": [],
"entropy": 4.402529762804034,
"executed_from": [],
"forensics": {
"sections": {
"InternetShortcut": {
"properties": {
"URL": "ThreatGrid_ArtifactAnalysis_1_forensics_sections_InternetShortcut_properties_URL"
}
}
}
},
"magic-type": "ThreatGrid_ArtifactAnalysis_1_magic-type",
"md5": "md5",
"mime-type": "text/plain; charset=us-ascii",
"modified_by": [],
"origin": "submitted",
"path": "www.domain_example_.url",
"read_by": [],
"relation": {
"contains": null,
"extracted_from": null,
"network": null,
"process": null
},
"sha1": "sha1",
"sha256": "sha256",
"size": 45,
"type": "url",
"whitelist": []
},
"10": {
"antivirus": {
"reversing_labs": {
"first_seen": "",
"last_seen": "",
"query_hash": {
"sha256": "sha256"
},
"scanner_count": 0,
"scanner_match": 0,
"status": "UNKNOWN",
"threat_level": 0,
"threat_name": "",
"trust_factor": 0
}
},
"created-time": 1671624958,
"created_by": [
24
],
"entropy": 0,
"executed_from": [],
"forensics": null,
"magic-type": "data",
"md5": "md5",
"mime-type": "application/octet-stream; charset=binary",
"modified_by": [],
"origin": "disk",
"path": "path",
"read_by": [],
"relation": {
"contains": null,
"extracted_from": null,
"network": null,
"process": null
},
"sha1": "sha1",
"sha256": "sha256",
"size": 276959,
"type": "",
"whitelist": []
},
"11": {
"antivirus": {
"reversing_labs": {
"first_seen": "ThreatGrid_ArtifactAnalysis_11_antivirus_reversing_labs_first_seen",
"last_seen": "ThreatGrid_ArtifactAnalysis_11_antivirus_reversing_labs_last_seen",
"query_hash": {
"sha256": "sha256"
},
"scanner_count": 42,
"scanner_match": 0,
"status": "KNOWN",
"threat_level": 0,
"threat_name": "",
"trust_factor": 0
}
},
"created-time": 1671624958,
"created_by": [
24
],
"entropy": 0,
"executed_from": [],
"forensics": null,
"magic-type": "data",
"md5": "md5",
"mime-type": "application/octet-stream; charset=binary",
"modified_by": [],
"origin": "disk",
"path": "path",
"read_by": [],
"relation": {
"contains": null,
"extracted_from": null,
"network": null,
"process": null
},
"sha1": "sha1",
"sha256": "sha256",
"size": 21700,
"type": "",
"whitelist": []
},
"12": {
"antivirus": {
"reversing_labs": {
"first_seen": "",
"last_seen": "",
"query_hash": {
"sha256": "sha256"
},
"scanner_count": 0,
"scanner_match": 0,
"status": "UNKNOWN",
"threat_level": 0,
"threat_name": "",
"trust_factor": 0
}
},
"created-time": 1671624958,
"created_by": [
24
],
"entropy": 0.006721586530775835,
"executed_from": [],
"forensics": null,
"magic-type": "data",
"md5": "md5",
"mime-type": "application/octet-stream; charset=binary",
"modified_by": [],
"origin": "disk",
"path": "path",
"read_by": [],
"relation": {
"contains": null,
"extracted_from": null,
"network": null,
"process": null
},
"sha1": "sha1",
"sha256": "sha256",
"size": 262512,
"type": "",
"whitelist": []
},
}
}
}
Human Readable Output
List of samples analysis
1 10 origin: submitted
executed_from:
path: www.domain_example_.url
mime-type: text/plain; charset=us-ascii
whitelist:
created-time: 0
read_by:
created_by:
sha256: sha256
sha1: sha1
md5: md5
entropy: x
type: url
size: 45
modified_by:
magic-type: MS Windows 95 Internet shortcut text (URL=http:<span//</span>www.domain_example>), ASCII text
relation: {“contains”: null, “extracted_from”: null, “network”: null, “process”: null}origin: disk
executed_from:
path: path
mime-type: application/octet-stream; charset=binary
whitelist:
created-time: 1671624958
read_by:
created_by: 24
sha256: sha256
sha1: sha1
md5: md5
entropy: 0
type:
size: 276959
modified_by:
magic-type: data
relation: {“contains”: null, “extracted_from”: null, “network”: null, “process”: null}origin: disk
executed_from:
path: path
mime-type: application/octet-stream; charset=binary
whitelist:
created-time: 1671624958
read_by:
created_by: 24
sha256: sha256
sha1: sha1
md5: md5
entropy: 0
type:
size: 21700
modified_by:
magic-type: data
relation: {“contains”: null, “extracted_from”: null, “network”: null, “process”: null}origin: disk
executed_from:
path: path
mime-type: application/octet-stream; charset=binary
whitelist:
created-time: 1671624958
read_by:
created_by: 24
sha256: sha256
sha1: sha1
md5: md5
entropy: 0.006721586530775835
type:
size: 262512
modified_by:
magic-type: data
relation: {“contains”: null, “extracted_from”: null, “network”: null, “process”: null}origin: disk
executed_from:
path: /Users/Administrator/AppData/Local/Google/Chrome/User Data/Default/Code Cache/js/1500928ccce7b989_0
mime-type: application/octet-stream; charset=binary
whitelist:
created-time: 1671624958
read_by:
created_by:
sha256: sha256
sha1: sha1
md5: md5
entropy: 0.09552689517008506
type:
size: 1917
modified_by:
magic-type: data
relation: {“contains”: null, “extracted_from”: null, “network”: null, “process”: null}
threat-grid-analysis-iocs-get
Returns data regarding the specified Indicator of Compromise
Base Command
threat-grid-analysis-iocs-get
Input
| Argument Name | Description | Required |
|---|---|---|
| sample_id | the sample id. | Required |
| ioc | the IOC requested. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.IOCAnalysis.title | String | The title of the IOC |
| ThreatGrid.IOCAnalysis.confidence | Number | The confidence of the IOC |
| ThreatGrid.IOCAnalysis.severity | String | The severity of the IOC |
| ThreatGrid.IOCAnalysis.ioc | String | Threat grid’s IOC |
| ThreatGrid.IOCAnalysis.category | String | The IOC category of the IOC |
| ThreatGrid.IOCAnalysis.sha256 | String | The SHA256 value of the IOC |
| ThreatGrid.IOCAnalysis.tags | String | The tags of the IOC |
Command example
!threat-grid-analysis-iocs-get sample_id=sample_id
Context Example
{
"ThreatGrid": {
"IOCAnalysis": [
{
"analysis-envs": [
"win",
"mac"
],
"category": [
"network-information"
],
"confidence": 50,
"data": [
{
"Code": 302,
"Method": "GET",
"Network_Stream": 11,
"Status": "Found",
"Trans_ID": 0,
"URL": "ThreatGrid_IOCAnalysis[0]_data[0]_URL"
}
],
"description": "An HTTP message indicating a redirection notice was detected in a network stream. The HTTP response codes are used as a means of conveying the status of the connection with the server to the client. Items within the 300 range indicate a redirection notice. These occur when a page has been temporarily or permanently moved.",
"heuristic_coefficient": -0.0987738978328,
"hits": 1,
"ioc": "http-response-redirect",
"mitre": [],
"mitre-tactics": [],
"mitre-techniques": [],
"orbital-queries": [],
"severity": 50,
"suspected-sample-categories": [],
"tags": [
"network",
"http",
"redirect"
],
"title": "HTTP Redirection Response",
"truncated": false
},
{
"analysis-envs": [
"win",
"mac",
"browser"
],
"category": [
"network-information"
],
"confidence": 25,
"data": [
{
"Method": "GET",
"Network_Stream": 11,
"URL": "ThreatGrid_IOCAnalysis[1]_data[0]_URL"
}
],
"description": "Outbound HTTP GET to a remote server was detected. This is not inherently suspicious but malware will often use Gets in order to check in to the Command and Control servers upon infection or to download or exfiltrate data. Please view the 'HTTP' section under 'Network Analysis' for the associated traffic/communications. Additionally, the provided network PCAP will provide more details on the traffic stream.",
"heuristic_coefficient": -26.131188198,
"hits": 1,
"ioc": "network-communications-http-get-url",
"mitre": [
{
"tactic": "command and control",
"techniques": [
{
"subtechniques": [],
"technique": "application layer protocol"
}
]
}
],
"mitre-tactics": [
"command and control"
],
"mitre-techniques": [
"application layer protocol"
],
"orbital-queries": [],
"severity": 25,
"suspected-sample-categories": [],
"tags": [
"network",
"http",
"get"
],
"title": "Outbound HTTP GET Request From URL Submission",
"truncated": false
},
]
}
}
Human Readable Output
List of samples analysis
Analysis-envs Category Confidence Data Description Heuristic Coefficient Hits Ioc Mitre Mitre-tactics Mitre-techniques Orbital-queries Severity Suspected-sample-categories Tags Title Truncated win,
macnetwork-information 50 {‘Code’: 302, ‘Method’: ‘GET’, ‘Network_Stream’: 11, ‘Status’: ‘Found’, ‘Trans_ID’: 0, ‘URL’: ‘http://www.domain_example:80/’} An HTTP message indicating a redirection notice was detected in a network stream. The HTTP response codes are used as a means of conveying the status of the connection with the server to the client. Items within the 300 range indicate a redirection notice. These occur when a page has been temporarily or permanently moved. -0.0987738978328 1 http-response-redirect 50 network,
http,
redirectHTTP Redirection Response false win,
mac,
browsernetwork-information 25 {‘Method’: ‘GET’, ‘Network_Stream’: 11, ‘URL’: ‘http://www.domain_example:80/’} Outbound HTTP GET to a remote server was detected. This is not inherently suspicious but malware will often use Gets in order to check in to the Command and Control servers upon infection or to download or exfiltrate data. Please view the ‘HTTP’ section under ‘Network Analysis’ for the associated traffic/communications. Additionally, the provided network PCAP will provide more details on the traffic stream. -26.131188198 1 network-communications-http-get-url {‘tactic’: ‘command and control’, ‘techniques’: [{‘subtechniques’: [], ‘technique’: ‘application layer protocol’}]} command and control application layer protocol 25 network,
http,
getOutbound HTTP GET Request From URL Submission false
threat-grid-analysis-metadata-get
Returns metadata about the analysis
Base Command
threat-grid-analysis-metadata-get
Input
| Argument Name | Description | Required |
|---|---|---|
| sample_id | the sample id. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.AnalysisMetadata.general_details | Unknown | The Metadata Analysis General Details |
| ThreatGrid.AnalysisMetadata.malware_desc | Unknown | The Metadata Analysis Malware Desc |
| ThreatGrid.AnalysisMetadata.sandcastle_env | Unknown | The Metadata Analysis Malware Sandcastle ENV |
Command example
!threat-grid-analysis-metadata-get sample_id=sample_id
Context Example
{
"ThreatGrid": {
"AnalysisMetadata": {
"general_details": {
"report_created": 1671624987,
"sandbox_id": "scl-work-004",
"sandbox_version": "pilot-d"
},
"malware_desc": [
{
"filename": "www.domain_example_.url",
"magic": "ThreatGrid_AnalysisMetadata_malware_desc[0]_magic",
"md5": "md5",
"sha1": "sha1",
"sha256": "sha256",
"size": 45,
"type": "url"
}
],
"sandcastle_env": {
"analysis_end": 1671624987,
"analysis_features": [],
"analysis_start": 1671624573,
"controlsubject": "win",
"current_os": "os",
"display_name": "Windows 10 Browser",
"run_time": 300,
"sample_executed": 1671624638,
"sandcastle": "3.5.124.17776.d4a3b85fe-1",
"vm": "win10-x64-browser",
"vm_id": "sample_id"
}
}
}
}
Human Readable Output
List of samples analysis
Filename Magic Md5 Sha1 Sha256 Size Type www.domain_example_.url MS Windows 95 Internet shortcut text (URL=http:<span//</span>www.domain_example>), ASCII text md5 sha1 sha256 45 url
threat-grid-analysis-network-streams-get
Returns data regarding a specific network stream
Base Command
threat-grid-analysis-network-streams-get
Input
| Argument Name | Description | Required |
|---|---|---|
| sample_id | the sample id. | Required |
| network_stream_id | The network stream id. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.NetworkAnalysis.protocol | Number | The network protocol |
| ThreatGrid.NetworkAnalysis.transport | String | The network transport |
| ThreatGrid.NetworkAnalysis.service | String | The network service |
| ThreatGrid.NetworkAnalysis.client_ip | String | The client IP |
| ThreatGrid.NetworkAnalysis.server_ip | String | The server IP |
Command example
!threat-grid-analysis-network-streams-get sample_id=sample_id
Context Example
{
"ThreatGrid": {
"NetworkAnalysis": {
"0": {
"bytes": 657,
"bytes_missed": 0,
"bytes_orig": 657,
"bytes_orig_payload": 601,
"bytes_payload": 601,
"bytes_resp": 0,
"bytes_resp_payload": 0,
"conn_state": "S0",
"dst": "ThreatGrid_NetworkAnalysis_0_dst",
"dst_port": 67,
"duration": 0.000993,
"history": "D",
"packets": 2,
"packets_orig": 2,
"service": "dhcp",
"session": 0,
"src": "ThreatGrid_NetworkAnalysis_0_src",
"src_port": 68,
"transport": "UDP",
"ts_begin": 1671624615.898952,
"ts_end": 1671624615.899945,
"uid": "id"
},
"1": {
"bytes": 664,
"bytes_missed": 0,
"bytes_orig": 0,
"bytes_orig_payload": 0,
"bytes_payload": 608,
"bytes_resp": 664,
"bytes_resp_payload": 608,
"conn_state": "SHR",
"decoded": [
{
"client_ip": "ThreatGrid_NetworkAnalysis_1_decoded[0]_client_ip",
"client_mac": "00:15:17:22:da:4d",
"dns_servers": [
"ThreatGrid_NetworkAnalysis_1_decoded[0]_dns_servers_0"
],
"lease_time": 1200,
"netmask": "ThreatGrid_NetworkAnalysis_1_decoded[0]_netmask",
"routers": [
"ThreatGrid_NetworkAnalysis_1_decoded[0]_routers_0"
],
"server_ip": "ThreatGrid_NetworkAnalysis_1_decoded[0]_server_ip",
"type": "DHCP_ACK"
}
],
"dst": "ThreatGrid_NetworkAnalysis_1_dst",
"dst_port": 67,
"duration": 0.000839,
"history": "^d",
"packets": 2,
"packets_resp": 2,
"protocol": "DHCP",
"service": "dhcp",
"session": 1,
"src": "ThreatGrid_NetworkAnalysis_1_src",
"src_port": 68,
"transport": "UDP",
"ts_begin": 1671624615.899514,
"ts_end": 1671624615.900353,
"uid": "CnmnL8FPcbmixXLv1"
},
}
}
}
Human Readable Output
List of samples analysis
0 1 transport: UDP
dst: dst
uid: d
bytes_missed: 0
src: ip1
ts_end: 1671624615.899945
dst_port: 67
packets_orig: 2
bytes_orig_payload: 601
bytes: 657
bytes_orig: 657
duration: 0.000993
history: D
bytes_resp_payload: 0
conn_state: S0
service: dhcp
session: 0
bytes_resp: 0
ts_begin: 1671624615.898952
packets: 2
src_port: 68
bytes_payload: 601decoded: {‘client_ip’: ‘192.168.1.28’, ‘client_mac’: ‘00:15:17:22:da:4d’, ‘dns_servers’: [‘192.168.1.1’], ‘lease_time’: 1200, ‘netmask’: ‘255.255.255.0’, ‘routers’: [‘192.168.1.1’], ‘server_ip’: ‘192.168.1.1’, ‘type’: ‘DHCP_ACK’}
transport: UDP
protocol: DHCP
dst: 192.168.1.1
uid: CnmnL8FPcbmixXLv1
bytes_missed: 0
src: 192.168.1.28
packets_resp: 2
ts_end: 1671624615.900353
dst_port: 67
bytes_orig_payload: 0
bytes: 664
bytes_orig: 0
duration: 0.000839
history: ^d
bytes_resp_payload: 608
conn_state: SHR
service: dhcp
session: 1
bytes_resp: 664
ts_begin: 1671624615.899514
packets: 2
src_port: 68
bytes_payload: 608transport: TCP
dst: dst
uid: CG18zQzbcnKMJ9rYh
bytes_missed: 0
src: 192.168.1.28
packets_resp: 10
ts_end: 1671624761.8172178
dst_port: 443
packets_orig: 7
bytes_orig_payload: 581
bytes: 5965
bytes_orig: 873
duration: 26.85108
history: ShADadfr
bytes_resp_payload: 4680
conn_state: RSTR
service: ssl
session: 10
bytes_resp: 5092
ts_begin: 1671624734.966138
packets: 17
src_port: 49670
bytes_payload: 5261decoded: [{‘request_path’: ‘/’, ‘url’: ‘http://www.domain_example:80/’, ‘ts’: 1671624747.411076, ‘host’: ‘www.domain_example’, ‘method’: ‘GET’, ‘request_filename’: ‘http-www.domain_example-80-11-1’, ‘sha256’: ‘sha256’, ‘port’: 80, ‘type’: ‘request’, ‘version’: ‘1.1’, ‘body_len’: 0, ‘actual_content_type’: ‘application/x-empty’, ‘decoded_url’: ‘http://www.domain_example:80/’, ‘headers’: {‘accept’: ‘text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,/;q=0.8,application/signed-exchange;v=b3;q=0.9’, ‘accept-encoding’: ‘gzip, deflate’, ‘accept-language’: ‘en-US,en;q=0.9’, ‘connection’: ‘keep-alive’, ‘host’: ‘www.domain_example’, ‘upgrade-insecure-requests’: ‘1’, ‘user-agent’: ‘Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/88.0.4324.104 Safari/537.36’}}, {‘ts’: 1671624747.505528, ‘sha256’: ‘sha256’, ‘status_code’: 302, ‘status’: ‘Found’, ‘type’: ‘response’, ‘reported_content_type’: ‘text/html; charset=UTF-8’, ‘version’: ‘1.1’, ‘body_len’: 231, ‘actual_content_type’: ‘text/html’, ‘fuids’: [‘FwgsLG2izIyrPnv7n4’], ‘headers’: {‘server’: ‘gws’, ‘origin-trial’: ‘ot’, ‘content-type’: ‘text/html; charset=UTF-8’, ‘content-length’: ‘231’, ‘bfcache-opt-in’: ‘unload’, ‘permissions-policy’: ‘unload=()’, ‘x-frame-options’: ‘SAMEORIGIN’, ‘location’: ‘https://www.domain_example/?gws_rd=ssl’, ‘set-cookie’: [‘1P_JAR=2022-12-21-12; expires=Fri, 20-Jan-2023 12:12:27 GMT; path=/; domain=.domain_example; Secure; SameSite=none’, ‘x; expires=Mon, 19-Jun-2023 12:12:27 GMT; path=/; domain=.domain_example; Secure; HttpOnly; SameSite=lax’], ‘date’: ‘Wed, 21 Dec 2022 12:12:27 GMT’, ‘cross-origin-opener-policy-report-only’: ‘same-origin-allow-popups; report-to=”gws”’, ‘x-xss-protection’: ‘0’, ‘report-to’: ‘{“group”:”gws”,”max_age”:2592000,”endpoints”:[{“url”:”https://csp.withdomain_example/csp/report-to/gws/other”}]}’, ‘cache-control’: ‘private’}}]
transport: TCP
protocol: HTTP
dst: dst
uid: C1A2px82MwQLhxvg3
bytes_missed: 0
src: 192.168.1.28
packets_resp: 4
ts_end: 1671624747.7983232
dst_port: 80
packets_orig: 4
bytes_orig_payload: 433
bytes: 3345
bytes_orig: 617
duration: 6.859333
history: ShADad
bytes_resp_payload: 1278
conn_state: S1
service: http
session: 11
bytes_resp: 2728
ts_begin: 1671624740.93899
packets: 8
src_port: 49671
bytes_payload: 1711
threat-grid-analysis-processes-get
Returns data regarding the specific process id in the analysis
Base Command
threat-grid-analysis-processes-get
Input
| Argument Name | Description | Required |
|---|---|---|
| sample_id | the sample id. | Required |
| process_id | the process id requested. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.ProcessAnalysis.process_name | String | The process name |
| ThreatGrid.ProcessAnalysis.process_id | String | The process ID |
Command example
!threat-grid-analysis-processes-get sample_id=sample_id
Context Example
{
"ThreatGrid": {
"ProcessAnalysis": {
"1": {
"analyzed_because": "Process activity after target sample started.",
"atoms_added": [
"Ud"
],
"kpid": "uid",
"monitored": true,
"mutants_created": [
"er",
],
"new": false,
"parent": "",
"pid": 1692,
"ppid": 61,
"proc": false,
"process_name": "Explorer.EXE",
"registry_keys_created": [
{
"access": [
"CREATE_SUB_KEY",
"READ_CONTROL",
"SET_VALUE"
],
"name": "REGISTRY",
"options": [
"REG_OPTION_VOLATILE"
]
}
],
"registry_keys_deleted": [
"REGISTRY",
"REGISTRY",
],
"registry_keys_modified": [
{
"data": "data",
"data_type": "BINARY",
"name": "REGISTRY",
"value_name": "VirtualDesktop"
}
],
"startup_info": {
"command_line": "info",
"current_directory": "info",
"desktop_info": "info",
"image_pathname": "info",
"incomplete": false,
"runtime_data": "",
"shell_info": "info",
"tid": "id",
"upid": 1692,
"uthread": 0,
"window_title": "Microsoft.Windows.Explorer"
},
"threads": [
{
"client_id": "id",
"create_suspended": "0x0",
"process": "0x00000000",
"process_handle": "0xffffffff",
"return": 0,
"thread": "0x00000000"
},
],
"time": "Wed, 21 Dec 2022 12:10:16 UTC"
},
"12": {
"analyzed_because": "Parent is being analyzed",
"files_checked": [
"-active.pma",
"-spare.pma"
],
"files_created": [
"-active.pma",
".pma~RF3e02b2be.TMP"
],
"files_deleted": [
".pma",
".pma~RF3e02b2be.TMP"
],
"kpid": "0xffffe00144f57080",
"monitored": true,
"new": true,
"parent": "0xffffe0014409e680",
"pid": 2680,
"ppid": 9,
"proc": false,
"process_name": "chrome.exe",
"startup_info": {
"command_line": "ThreatGrid_ProcessAnalysis_12_startup_info_command_line",
"current_directory": "D:\\",
"desktop_info": "info",
"image_pathname": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
"incomplete": false,
"runtime_data": "",
"shell_info": "",
"tid": "0xffffe00144f62400",
"upid": 2680,
"uthread": 0,
"window_title": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
},
"threads": [
{
"client_id": 6004801706494351000,
"create_suspended": "0x0",
"process": "0x00000000",
"process_handle": "0xffffffff",
"return": 0,
"thread": "0x00000000"
},
{
"client_id": 6071227511780497000,
"create_suspended": "0x0",
"process": "0x00000000",
"process_handle": "0xffffffff",
"return": 0,
"thread": "0x00000000"
}
],
"time": "Wed, 21 Dec 2022 12:10:41 UTC"
},
}
}
}
Human Readable Output
List of samples analysis
1 12 threads: {‘client_id’: “id”, ‘create_suspended’: ‘0x0’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: “id”, ‘create_suspended’: ‘0x0’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 39480025973576, ‘create_suspended’: ‘0x0’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 39480025973576, ‘create_suspended’: ‘0x0’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 39480025973576, ‘create_suspended’: ‘0x0’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 39480025973576, ‘create_suspended’: ‘0x0’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 39480025973576, ‘create_suspended’: ‘0x0’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 39480025973576, ‘create_suspended’: ‘0x0’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’}
atoms_added: ImmersiveContextMenuArray_159288160-13,
ImmersiveContextMenuArray_159288160-14,
ImmersiveContextMenuArray_159288448-11,
ImmersiveContextMenuArray_159288448-13,
ImmersiveContextMenuArray_159288448-14,
ImmersiveContextMenuArray_159288448-17,
ImmersiveContextMenuArray_159288736-10,
ImmersiveContextMenuArray_159288736-12,
ImmersiveContextMenuArray_159288736-13,
ImmersiveContextMenuArray_159288736-17,
ImmersiveContextMenuArray_159288832-12,
ImmersiveContextMenuArray_159288832-14,
ImmersiveContextMenuArray_159288832-16,
ImmersiveContextMenuArray_159288832-17,
ImmersiveContextMenuArray_159289024-11,
ImmersiveContextMenuArray_159289024-12,
ImmersiveContextMenuArray_159289600-18,
ImmersiveContextMenuArray_159289696-17,
ImmersiveContextMenuArray_159289696-18,
ImmersiveContextMenuArray_159289888-16,
ImmersiveContextMenuArray_159289888-18,
ImmersiveContextMenuArray_159289984-15,
ImmersiveContextMenuArray_4294967295,
ImmersiveContextMenuArray_60889232-10,
ImmersiveContextMenuArray_60889232-8,
ImmersiveContextMenuArray_60889232-9,
ImmersiveContextMenuArray_60890192-11,
ImmersiveContextMenuArray_60890192-7,
ImmersiveContextMenuArray_60890192-8,
ImmersiveContextMenuArray_60890192-9,
ImmersiveContextMenuArray_60891440-11,
ImmersiveContextMenuArray_60891440-12,
ImmersiveContextMenuArray_60891440-7,
ImmersiveContextMenuArray_60891440-9,
ImmersiveContextMenuArray_60891728-10,
ImmersiveContextMenuArray_60891728-6,
ImmersiveContextMenuArray_60891728-9,
ImmersiveContextMenuArray_60891824-5,
ImmersiveContextMenuArray_60891824-6,
ImmersiveContextMenuArray_60891824-7,
ImmersiveContextMenuArray_60891824-8,
ImmersiveContextMenuArray_60891920-4,
ImmersiveContextMenuArray_60891920-5,
ImmersiveContextMenuArray_60891920-6,
ImmersiveContextMenuArray_60891920-7,
ImmersiveContextMenuArray_61294096-3,
ImmersiveContextMenuArray_61294096-4,
ImmersiveContextMenuArray_61294096-6,
ImmersiveContextMenuArray_61295440-2,
ImmersiveContextMenuArray_61295440-3,
ImmersiveContextMenuArray_61295440-5,
ImmersiveContextMenuArray_61295824-131233,
ImmersiveContextMenuArray_61295824-2,
ImmersiveContextMenuArray_61295824-4,
ImmersiveContextMenuArray_61295824-5,
ImmersiveContextMenuArray_61441088-1,
ImmersiveContextMenuArray_61441088-4001,
ImmersiveContextMenuArray_61441280-4002,
ImmersiveContextMenuArray_61441568-2,
ImmersiveContextMenuArray_61441856-4003,
ImmersiveContextMenuArray_61441952-131233,
ImmersiveContextMenuArray_61442144-4001,
ImmersiveContextMenuArray_61442432-4002,
ImmersiveContextMenuArray_61442528-4000,
ImmersiveContextMenuArray_61442624-4000,
ImmersiveContextMenuArray_61442720-1,
ImmersiveContextMenuArray_61443008-1,
ImmersiveContextMenuArray_61443008-4002,
ImmersiveContextMenuArray_61443296-131233,
ImmersiveContextMenuArray_61443296-4001,
ImmersiveContextMenuArray_61443776-4000,
ImmersiveContextMenuArray_61443968-1,
ImmersiveContextMenuArray_61443968-4003,
ImmersiveContextMenuArray_61444064-4002,
ImmersiveContextMenuArray_61444160-4001,
ImmersiveContextMenuArray_61444256-3,
ImmersiveContextMenuArray_61444256-4000,
ImmersiveContextMenuArray_61444448-2,
ImmersiveContextMenuArray_61444736-131233,
ImmersiveContextMenuArray_61444832-4003,
TrayRaisedWindowProp,
uia
analyzed_because: Process activity after target sample started.
registry_keys_created: {‘access’: [‘CREATE_SUB_KEY’, ‘READ_CONTROL’, ‘SET_VALUE’], ‘name’: ‘REGISTRY\USER\S-1-5-21-3467368655-986044752-3166994390-500\SOFTWARE\MICROSOFT\WINDOWS\CURRENTVERSION\EXPLORER\SESSIONINFO\1\APPLICATIONVIEWMANAGEMENT\W32:000000000006013C’, ‘options’: [‘REG_OPTION_VOLATILE’]}
monitored: true
parent:
new: false
mutants_created: Global\C::Users:Administrator:AppData:Local:Microsoft:Windows:Explorer:iconcache_1280.db!dfMaintainer,
Global\C::Users:Administrator:AppData:Local:Microsoft:Windows:Explorer:iconcache_16.db!dfMaintainer,
Global\C::Users:Administrator:AppData:Local:Microsoft:Windows:Explorer:iconcache_1920.db!dfMaintainer,
Global\C::Users:Administrator:AppData:Local:Microsoft:Windows:Explorer:iconcache_256.db!dfMaintainer,
Global\C::Users:Administrator:AppData:Local:Microsoft:Windows:Explorer:iconcache_2560.db!dfMaintainer,
Global\C::Users:Administrator:AppData:Local:Microsoft:Windows:Explorer:iconcache_32.db!dfMaintainer,
Global\C::Users:Administrator:AppData:Local:Microsoft:Windows:Explorer:iconcache_48.db!dfMaintainer,
Global\C::Users:Administrator:AppData:Local:Microsoft:Windows:Explorer:iconcache_768.db!dfMaintainer,
Global\C::Users:Administrator:AppData:Local:Microsoft:Windows:Explorer:iconcache_96.db!dfMaintainer,
Global\C::Users:Administrator:AppData:Local:Microsoft:Windows:Explorer:iconcache_custom_stream.db!dfMaintainer,
Global\C::Users:Administrator:AppData:Local:Microsoft:Windows:Explorer:iconcache_exif.db!dfMaintainer,
Global\C::Users:Administrator:AppData:Local:Microsoft:Windows:Explorer:iconcache_idx.db!IconCacheInit,
Global\C::Users:Administrator:AppData:Local:Microsoft:Windows:Explorer:iconcache_idx.db!rwReaderRefs,
Global\C::Users:Administrator:AppData:Local:Microsoft:Windows:Explorer:iconcache_idx.db!rwWriterMutex,
Global\C::Users:Administrator:AppData:Local:Microsoft:Windows:Explorer:iconcache_sr.db!dfMaintainer,
Global\C::Users:Administrator:AppData:Local:Microsoft:Windows:Explorer:iconcache_wide.db!dfMaintainer,
Global\C::Users:Administrator:AppData:Local:Microsoft:Windows:Explorer:iconcache_wide_alternate.db!dfMaintainer
pid: 1692
kpid: uid
ppid: 61
time: Wed, 21 Dec 2022 12:10:16 UTC
registry_keys_deleted: REGISTRY\USER\S-1-5-21-3467368655-986044752-3166994390-500\SOFTWARE\MICROSOFT\WINDOWS\CURRENTVERSION\EXPLORER\SESSIONINFO\1\APPLICATIONVIEWMANAGEMENT\W32:00000000000A0232,
REGISTRY\USER\S-1-5-21-3467368655-986044752-3166994390-500\SOFTWARE\MICROSOFT\WINDOWS\CURRENTVERSION\EXPLORER\SESSIONINFO\1\APPLICATIONVIEWMANAGEMENT\W32:0000000000100036,
REGISTRY\USER\S-1-5-21-3467368655-986044752-3166994390-500\SOFTWARE\MICROSOFT\WINDOWS\CURRENTVERSION\HOMEGROUP\UISTATUSCACHE
proc: false
process_name: Explorer.EXE
registry_keys_modified: {‘data’: ‘EAAAADAwRFb0BwKtsB1qQ5DP0vmf3UYC’, ‘data_type’: ‘BINARY’, ‘name’: ‘REGISTRY\USER\S-1-5-21-3467368655-986044752-3166994390-500\SOFTWARE\MICROSOFT\WINDOWS\CURRENTVERSION\EXPLORER\SESSIONINFO\1\APPLICATIONVIEWMANAGEMENT\W32:000000000006013C’, ‘value_name’: ‘VirtualDesktop’}files_checked: \Users\Administrator\AppData\Local\Google\Chrome\User Data\CrashpadMetrics-active.pma,
\Users\Administrator\AppData\Local\Google\Chrome\User Data\CrashpadMetrics-spare.pma
files_deleted: \Users\Administrator\AppData\Local\Google\Chrome\User Data\CrashpadMetrics.pma,
\Users\Administrator\AppData\Local\Google\Chrome\User Data\CrashpadMetrics.pma~RF3e02b2be.TMP
threads: {‘client_id’: 6004801706494351000, ‘create_suspended’: ‘0x0’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 0, ‘create_suspended’: ‘0x0’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 18375121096688828000, ‘create_suspended’: ‘0x0’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 18375121096688828000, ‘create_suspended’: ‘0x0’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 6071227511780497000, ‘create_suspended’: ‘0x0’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 6071227511780497000, ‘create_suspended’: ‘0x0’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’}
analyzed_because: Parent is being analyzed
files_created: \Users\Administrator\AppData\Local\Google\Chrome\User Data\CrashpadMetrics-active.pma,
\Users\Administrator\AppData\Local\Google\Chrome\User Data\CrashpadMetrics.pma~RF3e02b2be.TMP
monitored: true
parent: 0xffffe0014409e680
new: true
pid: 2680
kpid: 0xffffe00144f57080
ppid: 9
time: Wed, 21 Dec 2022 12:10:41 UTC
proc: false
process_name: chrome.exethreads: {‘client_id’: 7820861427712559000, ‘create_suspended’: ‘0x1’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 7820861427712559000, ‘create_suspended’: ‘0x1’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 7820861427712559000, ‘create_suspended’: ‘0x1’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 7820861427712559000, ‘create_suspended’: ‘0x1’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 7820861427712559000, ‘create_suspended’: ‘0x1’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’}
analyzed_because: Process activity after target sample started.
monitored: true
parent:
new: false
pid: 840
kpid: 0xffffe0014497a840
ppid: 52
time: Wed, 21 Dec 2022 12:10:42 UTC
proc: false
process_name: svchost.exeanalyzed_because: Process activity after target sample started.
monitored: true
parent:
new: false
pid: 236
kpid: 0xffffe001434ea080
ppid: null
time: Wed, 21 Dec 2022 12:10:47 UTC
proc: false
process_name: svchost.exeanalyzed_because: Process activity after target sample started.
monitored: true
parent:
new: false
pid: 1284
kpid: 0xffffe00144a89840
ppid: 52
time: Wed, 21 Dec 2022 12:10:48 UTC
proc: false
process_name: svchost.exeanalyzed_because: Process activity after target sample started.
files_created: \Device\NamedPipe\Sessions\1\AppContainerNamedObjects\S-1-15-2-1861897761-1695161497-2927542615-642690995-327840285-2659745135-2630312742
monitored: true
parent:
new: false
pid: 580
kpid: 0xffffe0014486e340
ppid: 52
time: Wed, 21 Dec 2022 12:10:48 UTC
proc: false
process_name: svchost.exeanalyzed_because: Process activity after target sample started.
monitored: true
parent:
new: false
sockets: {‘file_handle’: ‘0x954’, ‘protocol’: ‘0’, ‘state’: 1, ‘states’: [], ‘timestamp’: 1671624708.7818744},
{‘file_handle’: ‘0x9c0’, ‘protocol’: ‘0’, ‘state’: 1, ‘states’: [], ‘timestamp’: 1671624708.830168},
{‘file_handle’: ‘0x98c’, ‘protocol’: ‘0’, ‘state’: 1, ‘states’: [], ‘timestamp’: 1671624714.8858435},
{‘file_handle’: ‘0x98c’, ‘protocol’: ‘0’, ‘state’: 1, ‘states’: [], ‘timestamp’: 1671624781.8725078},
{‘file_handle’: ‘0x98c’, ‘protocol’: ‘0’, ‘state’: 1, ‘states’: [], ‘timestamp’: 1671624792.5076175},
{‘file_handle’: ‘0x98c’, ‘protocol’: ‘0’, ‘state’: 1, ‘states’: [], ‘timestamp’: 1671624814.9515114},
{‘file_handle’: ‘0x98c’, ‘protocol’: ‘0’, ‘state’: 1, ‘states’: [], ‘timestamp’: 1671624821.0024314},
{‘file_handle’: ‘0x98c’, ‘protocol’: ‘0’, ‘state’: 1, ‘states’: [], ‘timestamp’: 1671624825.1760237},
{‘file_handle’: ‘0x968’, ‘protocol’: ‘0’, ‘state’: 1, ‘states’: [], ‘timestamp’: 1671624835.1903608},
{‘file_handle’: ‘0x95c’, ‘protocol’: ‘0’, ‘state’: 1, ‘states’: [], ‘timestamp’: 1671624835.7948673},
{‘file_handle’: ‘0x95c’, ‘protocol’: ‘0’, ‘state’: 1, ‘states’: [], ‘timestamp’: 1671624858.605007}
pid: 1100
kpid: 0xffffe00144cf1080
ppid: 52
time: Wed, 21 Dec 2022 12:10:52 UTC
proc: false
process_name: svchost.exefiles_checked: \Program Files\Google\Chrome\Application\88.0.4324.104\SwiftShader.ini
threads: {‘client_id’: 6004801706494351000, ‘create_suspended’: ‘0x0’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 6004801706494351000, ‘create_suspended’: ‘0x0’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 6004801706494351000, ‘create_suspended’: ‘0x0’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 6004801706494351000, ‘create_suspended’: ‘0x0’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 6004801706494351000, ‘create_suspended’: ‘0x0’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 0, ‘create_suspended’: ‘0x1’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0x80000b48’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 6004801706494351000, ‘create_suspended’: ‘0x0’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 6004801706494351000, ‘create_suspended’: ‘0x0’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0xffffffff’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 8397322214375721000, ‘create_suspended’: ‘0x1’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0x80000984’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 8397322214375721000, ‘create_suspended’: ‘0x1’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0x80000b40’, ‘return’: 0, ‘thread’: ‘0x00000000’},
{‘client_id’: 8397322214375721000, ‘create_suspended’: ‘0x1’, ‘process’: ‘0x00000000’, ‘process_handle’: ‘0x80000b40’, ‘return’: 0, ‘thread’: ‘0x00000000’}
atoms_added: D3D9_IdHot_Ctrl_SnapDesktop
analyzed_because: Parent is being analyzed
monitored: true
parent: 0xffffe0014409e680
new: true
pid: 2296
kpid: 0xffffe0014444a840
ppid: 9
time: Wed, 21 Dec 2022 12:10:54 UTC
proc: false
process_name: chrome.exe
file
Checks the file reputation of the specified hash.
Base Command
file
Input
| Argument Name | Description | Required |
|---|---|---|
| file | A CSV list of hashes of the file to query. Supports MD5, SHA1, and SHA256. | Required |
| long | Whether to return full response for scans. Default is “false”. Possible values are: True, False. | Optional |
| threshold | If the number of positives is higher than the threshold, the file will be considered malicious. If the threshold is not specified, the default file threshold, as configured in the instance settings, will be used. | Optional |
| wait | Time (in seconds) to wait between tries if the API rate limit is reached. Default is “60”. Default is 60. | Optional |
| retries | Number of retries for the API rate limit. Default is “0”. Default is 0. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| File.MD5 | String | Bad MD5 hash. |
| File.Name | String | File name. |
| File.SHA1 | String | Bad SHA1 hash. |
| File.sha256 | String | Bad SHA256 hash. |
| File.EntryID | String | The entry ID of the file. |
| File.Malicious.Vendor | String | The vendor that reported the file as malicious. |
| File.Malicious.Description | String | A description explaining why the file was determined to be malicious. |
| DBotScore.Indicator | String | The indicator that was tested. |
| DBotScore.Type | String | The indicator type. |
| DBotScore.Vendor | String | The vendor used to calculate the score. |
| DBotScore.Score | Number | The actual score. |
| DBotScore.Reliability | String | Reliability of the source providing the intelligence data. |
| ThreatGrid.File.PositiveDetections | number | Number of engines that positively detected the indicator as malicious. |
| ThreatGrid.File.DetectionEngines | number | Total number of engines that checked the indicator. |
| ThreatGrid.File.tgLink | string | ThreatGrid permanent link. |
ip
Checks the reputation of an IP address.
Base Command
ip
Input
| Argument Name | Description | Required |
|---|---|---|
| ip | IP address to check. | Required |
| long | Whether to return full response for detected URLs. Default is “false”. Possible values are: True, False. | Optional |
| threshold | If the number of positives is higher than the threshold, the IP address will be considered malicious. If the threshold is not specified, the default IP threshold, as configured in the instance settings, will be used. | Optional |
| sampleSize | The number of samples from each type (resolutions, detections, etc.) to display for long format. Default is “10”. Default is 10. | Optional |
| wait | Time (in seconds) to wait between tries if the API rate limit is reached. Default is “60”. Default is 60. | Optional |
| retries | Number of retries for API rate limit. Default is “0”. Default is 0. | Optional |
| fullResponse | Whether to return all results, which can be thousands. Default is “false”. We recommend that you don’t return full results in playbooks. Possible values are: True, False. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| IP.Address | String | Bad IP address. |
| IP.ASN | String | Bad IP ASN. |
| IP.Geo.Country | String | Bad IP country. |
| ThreatGrid.IP.indicator | String | IP address. |
| ThreatGrid.IP.confidence | Number | Indicator confidence between 0-99. |
| DBotScore.Indicator | String | The indicator that was tested. |
| DBotScore.Type | String | The indicator type. |
| DBotScore.Vendor | String | The vendor used to calculate the score. |
| DBotScore.Score | Number | The actual score. |
| DBotScore.Reliability | String | Reliability of the source providing the intelligence data. |
url
Checks the reputation of a URL.
Base Command
url
Input
| Argument Name | Description | Required |
|---|---|---|
| url | A comma-seperated list of URLs to check. This command will not work properly on URLs containing commas. | Required |
| sampleSize | The number of samples from each type (resolutions, detections, etc.) to display for long format. Default is 10. | Optional |
| long | Whether to return the full response for the detected URLs. Possible values are: True, False. | Optional |
| threshold | If the number of positives is higher than the threshold, the URL will be considered malicious. If the threshold is not specified, the default URL threshold, as configured in the instance settings, will be used. | Optional |
| submitWait | Time (in seconds) to wait if the URL does not exist and is submitted for scanning. Default is “0”. Default is 0. | Optional |
| wait | Time (in seconds) to wait between tries if the API rate limit is reached. Default is “60”. Default is 60. | Optional |
| retries | Number of retries for API rate limit. Default is “0”. Default is 0. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| URL.Data | String | Bad URLs found. |
| URL.Malicious.Vendor | String | For malicious URLs, the vendor that made the decision. |
| URL.Malicious.Description | String | For malicious URLs, the reason that the vendor made the decision. |
| URL.PositiveDetections | Number | Number of engines that positively detected the indicator as malicious. |
| DBotScore.Indicator | String | The indicator that was tested. |
| DBotScore.Type | String | The indicator type. |
| DBotScore.Vendor | String | The vendor used to calculate the score. |
| DBotScore.Score | Number | The actual score. |
| DBotScore.Reliability | String | Reliability of the source providing the intelligence data. |
| ThreatGrid.URL.url | String | The URL. |
| ThreatGrid.URL.detection_engines | Number | Number of engines |
| ThreatGrid.URL.positive_engines | Number | Number of positive engines |
domain
Checks the reputation of a domain.
Base Command
domain
Input
| Argument Name | Description | Required |
|---|---|---|
| domain | Domain name to check. | Required |
| long | Whether to return the full response for detected URLs. Default is “false”. Possible values are: True, False. | Optional |
| sampleSize | The number of samples from each type (resolutions, detections, etc.) to display for long format. Default is 10. | Optional |
| threshold | If the number of positives is higher than the threshold, the domain will be considered malicious. If the threshold is not specified, the default domain threshold, as configured in the instance settings, will be used. | Optional |
| wait | Time (in seconds) to wait between tries if the API rate limit is reached. Default is “60”. Default is 60. | Optional |
| retries | Number of retries for API rate limit. Default is “0”. Default is 0. | Optional |
| fullResponse | Whether to return all results, which can be thousands. Default is “false”. We recommend that you don’t return full results in playbooks. Possible values are: True, False. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| Domain.Name | String | Bad domain found. |
| Domain.Malicious.Vendor | String | For malicious domains, the vendor that made the decision. |
| Domain.Malicious.Description | String | For malicious domains, the reason that the vendor made the decision. |
| DBotScore.Indicator | String | The indicator that was tested. |
| DBotScore.Type | String | The indicator type. |
| DBotScore.Vendor | String | The vendor used to calculate the score. |
| DBotScore.Score | Number | The actual score. |
| DBotScore.Reliability | String | Reliability of the source providing the intelligence data. |
| Domain.CreationDate | Date | The date that the domain was created. |
| Domain.DNS | String | A list of IP objects resolved by DNS. |
| Domain.WHOIS.NameServers | String | Name servers of the domain. |
| Domain.WHOIS.Registrar.AbuseEmail | Unknown | The email address of the contact for reporting abuse. |
| Domain.WHOIS.Registrar.AbusePhone | Unknown | The phone number of contact for reporting abuse. |
| Domain.WHOIS.Registrar.Name | String | The name of the registrar, for example: “GoDaddy”. |
| Domain.WHOIS.ExpirationDate | Date | The expiration date of the domain. |
| Domain.WHOIS.DomainStatus | String | The status of the domain. |
| ThreatGrid.Domain.domain | String | The domain name. |
threat-grid-domain-samples-list
Returns a list of samples associated with a Domain.
Base Command
threat-grid-domain-samples-list
Input
| Argument Name | Description | Required |
|---|---|---|
| domain | The domain to search for. | Required |
| after | “A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| before | “A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| page_size | The number of items per page. | Optional |
| page | Page number of paginated results. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.DomainAssociatedSample.domain | string | The domain. |
| ThreatGrid.DomainAssociatedSample.samples | string | The associated samples. |
Command example
!threat-grid-domain-samples-list domain=domain_example
Context Example
{
"ThreatGrid": {
"DomainAssociatedSample": {
"domain": "domain_example",
"samples": [
{
"details": "/api/v2/samples/sample_e",
"filename": "domain_example_.url",
"iocs": [],
"login": "login_name",
"owner": "self",
"private": false,
"relation": null,
"sample": "sample_e",
"sha256": "sha256_example",
"timestamp": "ThreatGrid_DomainAssociatedSample_samples[0]_timestamp"
},
{
"details": "/api/v2/samples/sample_e",
"filename": "file_name",
"iocs": [],
"login": null,
"owner": null,
"private": false,
"relation": null,
"sample": "sample_e",
"sha256": "sha256_e",
"timestamp": "ThreatGrid_DomainAssociatedSample_samples[1]_timestamp"
},
]
}
}
}
Human Readable Output
List of samples associated to the domain - domain_example
Showing page 1.
Current page size: 50
Filename Login Private Sample Sha256 Timestamp domain_example_.url login_name false sample_e sha256_example 2022-12-22T08:30:57Z file_name false sample_e sha256_e 2022-12-22T08:29:38Z
threat-grid-ip-samples-list
Returns a list of samples associated with an IP.
Base Command
threat-grid-ip-samples-list
Input
| Argument Name | Description | Required |
|---|---|---|
| ip | The IP to search for. | Required |
| after | “A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| before | “A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| page_size | The number of items per page. | Optional |
| page | Page number of paginated results. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.IpAssociatedSample.ip | string | The IP. |
| ThreatGrid.IpAssociatedSample.samples | string | The associated samples. |
Command example
!threat-grid-ip-samples-list ip=8.8.8.8
Context Example
{
"ThreatGrid": {
"IpAssociatedSample": {
"ip": "ThreatGrid_IpAssociatedSample_ip",
"samples": [
{
"details": "/api/v2/samples/sample_e",
"filename": "filename",
"iocs": [
{
"confidence": 60,
"ioc": "pe-header-linker-major",
"sample": "sample_e",
"severity": 5
}
],
"login": null,
"owner": null,
"private": false,
"relation": null,
"sample": "sample_e",
"sha256": "sha256_e",
"timestamp": "ThreatGrid_IpAssociatedSample_samples[0]_timestamp"
},
{
"details": "/api/v2/samples/sample_e",
"filename": "file_name",
"iocs": [
{
"confidence": 50,
"ioc": "file-ini-read",
"sample": "sample_e",
"severity": 30
},
{
"confidence": 60,
"ioc": "pe-resource-lang-romanian",
"sample": "sample_e",
"severity": 25
},
{
"confidence": 50,
"ioc": "network-fast-flux-nameserver",
"sample": "sample_e",
"severity": 35
}
],
"login": null,
"owner": null,
"private": false,
"relation": null,
"sample": "sample_e",
"sha256": "sha256_e",
"timestamp": "ThreatGrid_IpAssociatedSample_samples[1]_timestamp"
},
]
}
}
}
Human Readable Output
List of samples associated to the ip - 8.8.8.8
Showing page 1.
Current page size: 50
Filename Login Private Sample Sha256 Timestamp filename false sample_e sha256_e 2022-12-22T08:09:30Z file_name false sample_e sha256_e 2022-12-22T08:07:40Z
threat-grid-path-samples-list
Returns a list of samples associated with a Path.
Base Command
threat-grid-path-samples-list
Input
| Argument Name | Description | Required |
|---|---|---|
| path | The path to search for. A path is a slash-separated list of directory names followed by either a directory name or a file name. Path example: ‘/user/name/file’. | Required |
| after | “A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| before | “A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| page_zise | The number of items per page. | Optional |
| page | Page number of paginated results. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.PathAssociatedSample.path | string | The Path. |
| ThreatGrid.PathAssociatedSample.samples | string | The associated samples. |
Command example
!threat-grid-path-samples-list path=user
Context Example
{
"ThreatGrid": {
"PathAssociatedSample": {
"path": "user",
"samples": [
{
"details": "/api/v2/samples/sample_e",
"filename": "user",
"iocs": [
{
"confidence": 100,
"ioc": "html-script-prefix-suffix",
"sample": "sample_e",
"severity": 85
}
],
"login": null,
"owner": null,
"private": false,
"relation": null,
"sample": "sample_e",
"sha256": "sha256_e",
"timestamp": "ThreatGrid_PathAssociatedSample_samples[0]_timestamp"
},
{
"details": "/api/v2/samples/sample_e",
"filename": "file_name",
"iocs": [
{
"confidence": 85,
"ioc": "pe-invalid-certificate-signature",
"sample": "sample_e",
"severity": 100
},
{
"confidence": 100,
"ioc": "pe-certificate",
"sample": "sample_e",
"severity": 10
}
],
"login": null,
"owner": null,
"private": false,
"relation": null,
"sample": "sample_e",
"sha256": "sha256_e",
"timestamp": "ThreatGrid_PathAssociatedSample_samples[1]_timestamp"
},
]
}
}
}
Human Readable Output
List of samples associated to the path - user
Showing page 1.
Current page size: 50
Filename Login Private Sample Sha256 Timestamp user false sample_e sha256_e 2022-11-11T08:26:04Z file_name false sample_e sha256_e 2022-10-30T13:09:35Z
threat-grid-url-samples-list
Returns a list of samples associated with an URL.
Base Command
threat-grid-url-samples-list
Input
| Argument Name | Description | Required |
|---|---|---|
| url | The target URL. Please provide the URL in the format http://example.com:80/ . | Required |
| after | “A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| before | “A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| page_zise | The number of items per page. | Optional |
| page | Page number of paginated results. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.UrlAssociatedSample.url | string | The URL. |
| ThreatGrid.UrlAssociatedSample.samples | string | The associated samples. |
Command example
!threat-grid-url-samples-list url=http://domain_example:80/
Context Example
{
"ThreatGrid": {
"UrlAssociatedSample": {
"samples": [
{
"details": "/api/v2/samples/sample_id",
"filename": "file_name",
"iocs": [
{
"confidence": 25,
"ioc": "network-communications-http-get-url",
"sample": "sample_id",
"severity": 25
}
],
"login": "login_name",
"owner": "self",
"private": false,
"relation": null,
"sample": "sample_id",
"sha256": "sha256_example",
"timestamp": "ThreatGrid_UrlAssociatedSample_samples[0]_timestamp"
},
{
"details": "/api/v2/samples/sample_id",
"filename": "file_name",
"iocs": [
{
"confidence": 90,
"ioc": "pe-uses-stealth-packer",
"sample": "sample_id",
"severity": 90
}
],
"login": null,
"owner": null,
"private": false,
"relation": null,
"sample": "sample_id",
"sha256": "sha256_example",
"timestamp": "ThreatGrid_UrlAssociatedSample_samples[1]_timestamp"
},
],
"sha256": "sha256_example",
"url": "ThreatGrid_UrlAssociatedSample_url"
}
}
}
Human Readable Output
List of samples associated to the url - sha256_example
Showing page 1.
Current page size: 50
Filename Login Private Sample Sha256 Timestamp domain_example_.url login_name false sample_id sha256_example 2022-12-22T08:36:44Z file_name false sample_id sha256_example 2022-12-22T08:35:03Z file_name false sample_id sha256_example 2022-12-22T08:35:03Z domain_example_.url login_name false sample_e sha256_example 2022-12-22T08:30:57Z
threat-grid-registry-key-samples-list
Returns a list of samples associated with a specified registry key.
Base Command
threat-grid-registry-key-samples-list
Input
| Argument Name | Description | Required |
|---|---|---|
| registry_key | The registry key to search for. | Required |
| after | “A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| before | “A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500”. | Optional |
| limit | The maximum number of records to retrieve. Default is 50. | Optional |
| page_size | The number of items per page. | Optional |
| page | Page number of paginated results. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.RegistryKeyAssociatedSample.key | string | The Registry Key. |
| ThreatGrid.RegistryKeyAssociatedSample.samples | string | The associated samples. |
Command example
!threat-grid-registry-key-samples-list registry_key=ChangeNotice
Context Example
{
"ThreatGrid": {
"RegistryKeyAssociatedSample": {
"key": "ChangeNotice",
"samples": []
}
}
}
Human Readable Output
List of samples associated to the registry_key - ChangeNotice
Showing page 1.
Current page size: 50
No entries.
threat-grid-ip-associated-domains
Returns a list of domains associated with the IP.
Base Command
threat-grid-ip-associated-domains
Input
| Argument Name | Description | Required |
|---|---|---|
| ip | The IP to search for. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.IpAssociatedDomain.ip | string | The IP. |
| ThreatGrid.IpAssociatedDomain.domains | string | The associated Domain. |
Command example
!threat-grid-ip-associated-domains ip=8.8.8.8
Context Example
{
"ThreatGrid": {
"IpAssociatedDomain": {
"domains": [
{
"details": "/api/v2/domains/domain",
"domain": "domain"
},
{
"details": "/api/v2/domains/domain",
"domain": "domain"
},
],
"ip": "ThreatGrid_IpAssociatedDomain_ip"
}
}
}
Human Readable Output
List of domains associated to the ip - 8.8.8.8
Domain domain2 domain1
threat-grid-ip-associated-urls
Returns a list of URLs associated to the IP.
Base Command
threat-grid-ip-associated-urls
Input
| Argument Name | Description | Required |
|---|---|---|
| ip | The IP to search for. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.IpAssociatedUrl.ip | string | The IP. |
| ThreatGrid.IpAssociatedUrl.urls | string | The associated URL. |
Command example
!threat-grid-ip-associated-urls ip=8.8.8.8
Context Example
{
"ThreatGrid": {
"IpAssociatedUrl": {
"ip": "ThreatGrid_IpAssociatedUrl_ip",
"urls": [
{
"details": "/api/v2/urls/sha256",
"sha256": "sha256",
"url": "ThreatGrid_IpAssociatedUrl_urls[0]_url"
},
{
"details": "/api/v2/urls/sha256",
"sha256": "sha256",
"url": "ThreatGrid_IpAssociatedUrl_urls[1]_url"
}
]
}
}
}
Human Readable Output
List of urls associated to the ip - 8.8.8.8
Sha256 Url sha256 ThreatGrid_IpAssociatedUrl_urls[0]_url sha256 ThreatGrid_IpAssociatedUrl_urls[1]_url
threat-grid-domain-associated-urls
Returns a list of URLs associated to the domain.
Base Command
threat-grid-domain-associated-urls
Input
| Argument Name | Description | Required |
|---|---|---|
| domain | The domain to search for. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.DomainAssociatedUrl.domain | string | The Domain. |
| ThreatGrid.DomainAssociatedUrl.urls | string | The associated URL. |
Command example
!threat-grid-domain-associated-urls domain=domain_example
Context Example
{
"ThreatGrid": {
"DomainAssociatedUrl": {
"domain": "domain_example",
"urls": [
{
"details": "/api/v2/urls/sha256",
"sha256": "sha256",
"url": "ThreatGrid_DomainAssociatedUrl_urls[0]_url"
},
{
"details": "/api/v2/urls/sha256",
"sha256": "sha256",
"url": "ThreatGrid_DomainAssociatedUrl_urls[1]_url"
},
]
}
}
}
Human Readable Output
List of urls associated to the domain - domain_example
Sha256 Url sha256 some_url sha256 some_url
threat-grid-domain-associated-ips
Returns a list of IPs associated to the domain.
Base Command
threat-grid-domain-associated-ips
Input
| Argument Name | Description | Required |
|---|---|---|
| domain | The domain to search for. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| ThreatGrid.DomainAssociatedIp.domain | String | The Domain. |
| ThreatGrid.DomainAssociatedIp.ips | String | The associated IP. |
Command example
!threat-grid-domain-associated-ips domain=domain_example
Context Example
{
"ThreatGrid": {
"DomainAssociatedIp": {
"domain": "domain_example",
"ips": [
{
"ip": "ThreatGrid_DomainAssociatedIp_ips[0]_ip"
},
{
"ip": "ThreatGrid_DomainAssociatedIp_ips[1]_ip"
},
]
}
}
}
Human Readable Output
List of ips associated to the domain - domain_example
Ip ip_address ip_address
Configuration parameters
base_url— Server URL (e.g. https://192.168.0.1) (required)credentials— (required)integrationReliability— Source Reliability (required)insecure— Trust any certificate (not secure)proxy— Use system proxy settings
Commands (34)
-
domainChecks the reputation of a domain.
-
fileChecks the file reputation of the specified hash.
-
ipChecks the reputation of an IP address.
-
threat-grid-analysis-annotations-getReturns data regarding the annotations of the analysis.
-
threat-grid-analysis-artifacts-getReturns the sample id artifact with artifact id.
-
threat-grid-analysis-iocs-getReturns data regarding the specified Indicator of Compromise.
-
threat-grid-analysis-metadata-getReturns metadata about the analysis.
-
threat-grid-analysis-network-streams-getReturns data regarding a specific network stream.
-
threat-grid-analysis-processes-getReturns data regarding the specific process id in the analysis.
-
threat-grid-domain-associated-ipsReturns a list of IPs associated to the domain.
-
threat-grid-domain-associated-urlsReturns a list of URLs associated to the domain.
-
threat-grid-domain-samples-listReturns a list of samples associated with a Domain.
-
threat-grid-feed-specific-getGets a specific threat feed.
-
threat-grid-feeds-artifactGet artifacts threat feed.
-
threat-grid-feeds-domainGet domain threat feed.
-
threat-grid-feeds-ipGet ips threat feed.
-
threat-grid-feeds-network-streamGet network stream threat feed.
-
threat-grid-feeds-pathGet path threat feed.
-
threat-grid-feeds-urlGet url threat feed.
-
threat-grid-ip-associated-domainsReturns a list of domains associated with the IP.
-
threat-grid-ip-associated-urlsReturns a list of URLs associated to the IP.
-
threat-grid-ip-samples-listReturns a list of samples associated with an IP.
-
threat-grid-ip-searchSearch IPs. Please provide a single argument (only one) to use this command, as the API supports 1 filter at a time.
-
threat-grid-path-samples-listReturns a list of samples associated with a Path.
-
threat-grid-rate-limit-getGet rate limit for a specific user name. ThreatGrid employs a simple rate limiting method for sample submissions by specifying the number of samples which can be submitted within some variable time period by a user. Multiple rate limits can be employed to form overlapping submission limits. For example, 20 submissions per hour AND 400 per day.
-
threat-grid-registry-key-samples-listReturns a list of samples associated with a specified registry key.
-
threat-grid-sample-listSearch samples on the Threat Grid platform. Input parameters are ANDed together. Only finished samples can be searched (that is, the ones that are having a status of succ or fail.)
-
threat-grid-sample-summary-getReturns summary analysis information.
-
threat-grid-sample-uploadSubmits a sample to threat grid for analysis. URL or file, not both.
-
threat-grid-submissions-searchSearch threat grid submissions.
-
threat-grid-url-samples-listReturns a list of samples associated with an URL.
-
threat-grid-url-searchSearch urls. Please provide the URL in the format http://example.com:80/ (note that ThreatGrid only support '.com' domains).
-
threat-grid-who-am-iGet logged in user.
-
urlChecks the reputation of a URL.
commonfields: id: ThreatGridv2 version: -1 name: ThreatGridv2 sectionorder: - Connect - Collect display: Cisco Secure Malware Analytics (Threat Grid) v2 category: Forensics & Malware Analysis provider: Cisco Systems description: Query and upload samples to Cisco threat grid. configuration: - display: Server URL (e.g. https://192.168.0.1) name: base_url defaultvalue: https://panacea.threatgrid.com type: 0 required: true section: Connect - displaypassword: API token name: credentials type: 9 required: true hiddenusername: true display: '' section: Connect - display: Source Reliability name: integrationReliability type: 15 required: true additionalinfo: Reliability of the source providing the intelligence data. defaultvalue: B - Usually reliable options: - A+ - 3rd party enrichment - A - Completely reliable - B - Usually reliable - C - Fairly reliable - D - Not usually reliable - E - Unreliable - F - Reliability cannot be judged section: Connect - display: Trust any certificate (not secure) name: insecure type: 8 required: false section: Connect - display: Use system proxy settings name: proxy type: 8 required: false section: Connect script: script: '' type: python subtype: python3 commands: - name: threat-grid-sample-list arguments: - name: sample_id description: The sample ID. - name: user_only description: It 'True' - Only display samples created by the current user, as determined by the value of api_key. auto: PREDEFINED predefined: - 'True' - 'False' - auto: PREDEFINED description: It 'True' - Only display samples created by the current user's organization, as determined by the value of api_key. name: org_only predefined: - 'True' - 'False' - name: sha256 description: A SHA256 of the submitted sample, only matches samples, not their artifacts. - name: md5 description: A MD5 checksum of the submitted sample, only matches samples, not their artifacts. - name: sha1 description: A sha1 of the submitted sample, only matches samples, not their artifacts. - name: artifact description: The artifact to download. Sample ID is required when choosing 'artifact'. auto: PREDEFINED predefined: - video.webm - network-artifacts.zip - report.html - sample.zip - screenshot.png - extracted-artifacts.zip - timeline.json - analysis.json - processes.json - network.pcap - name: page description: 'Page number of paginated results. Minimum value: 1.' - name: page_size description: The number of items per page. - name: limit description: The maximum number of records to retrieve. defaultValue: '50' outputs: - contextPath: ThreatGrid.Sample.id description: The sample id. type: String - contextPath: ThreatGrid.Sample.filename description: The sample filename. type: String - contextPath: ThreatGrid.Sample.state description: The state of the sample, one of a stable set of strings "wait, prep, run, proc, succ, fail". type: String - contextPath: ThreatGrid.Sample.status description: The sample status, one of a stable set of strings "succ, fail". type: String - contextPath: ThreatGrid.Sample.md5 description: The sample md5. type: String - contextPath: ThreatGrid.Sample.sha1 description: The sample sha1. type: String - contextPath: ThreatGrid.Sample.sha256 description: The sample sha256. type: String - contextPath: ThreatGrid.Sample.os description: The sample os. type: String - contextPath: ThreatGrid.Sample.submitted_at description: The sample submission time. type: String - contextPath: ThreatGrid.Sample.started_at description: The sample analysis starting time. type: String - contextPath: ThreatGrid.Sample.completed_at description: The sample completion time. type: String - contextPath: InfoFile.Name description: The file name. type: String - contextPath: InfoFile.EntryID description: The ID for locating the file in the War Room. type: String - contextPath: InfoFile.Size description: The size of the file (in bytes). type: Number - contextPath: InfoFile.Type description: The file type, as determined by libmagic (same as displayed in file entries). type: String - contextPath: InfoFile.Extension description: The file extension. type: String - contextPath: InfoFile.Info description: Basic information about the file. type: String description: Search samples on the Threat Grid platform. Input parameters are ANDed together. Only finished samples can be searched (that is, the ones that are having a status of succ or fail.) - name: threat-grid-sample-upload arguments: - name: file_id description: The file ID. Click on the chain-like icon after you upload a file in Demisto to find the file_id. - description: "The URL to upload. " name: url - defaultValue: '10' description: Indicates how long to wait between command execution (in seconds) when 'polling' argument is true. Minimum value is 10 seconds. Default is 10. name: interval_in_seconds - defaultValue: '60' description: Indicates the time in seconds until the polling sequence timeouts. Default is 60. name: timeout_in_seconds - description: The uploaded sample ID. name: sample_id - name: tags description: A comma-separated list of tags applied to this sample. - name: private description: Whether to mark the sample as private. auto: PREDEFINED predefined: - 'True' - 'False' - name: playbook auto: PREDEFINED predefined: - none - default - alt_tab_programs - open_word_embedded_object - visit_site - close_file - use_best_option description: 'Name of a playbook to apply to this sample run. none: Explicitly disables playbooks, default: Default Playbook, alt_tab_programs: Conduct Active Window Change, open_word_embedded_object: Open Embedded Object in Word Document, use_best_option: allows Malware Analytics to select the best Playbook option based on the submitted sample, visit_site: Visit Website Using Internet Explorer, close_file: Close Active Window. The current list of playbooks endpoints can be obtained by querying /api/v3/configuration/playbooks.' - name: vm auto: PREDEFINED predefined: - win7-x64 - win7-x64-2 - win10 - win10-x64-2-beta - win10-x64-browser - win10-x64-jp - win10-x64-kr - win10-x64-phishing-beta description: 'a string identifying a specific VM to use. Options: win7-x64: Windows 7 64bit, win7-x64-2: Windows 7 64-bit Profile 2, win10-x64-2-beta: Windows 10 LTSC 2019 (beta), win10-x64-browser: Windows 10 Browser, win10-x64-jp: Windows 10 Japanese, win10-x64-kr: Windows 10 Korean, win10-x64-phishing-beta: Windows 10 (Phishing), win10: Windows 10 (Not available on Threat Grid appliances). NOTE: The standard (English) VMs default to UTF-8 encoding. To support Korean and Japanese character sets, such as S-JIS, submit to the appropriate VM.' - name: hide_polling_output description: Whether to hide the polling result (automatically filled by polling). hidden: true defaultValue: true outputs: - contextPath: ThreatGrid.Sample.id description: The sample id. type: String - contextPath: ThreatGrid.Sample.filename description: The sample filename. type: String - contextPath: ThreatGrid.Sample.state description: The state of the sample, one of a stable set of strings "wait, prep, run, proc, succ, fail". type: String - contextPath: ThreatGrid.Sample.status description: The sample status. type: String - contextPath: ThreatGrid.Sample.md5 description: The sample md5. type: String - contextPath: ThreatGrid.Sample.sha1 description: The sample sha1. type: String - contextPath: ThreatGrid.Sample.sha256 description: The sample sha256. type: String - contextPath: ThreatGrid.Sample.os description: The sample os. type: String - contextPath: ThreatGrid.Sample.submitted_at description: The sample submission time. type: String description: Submits a sample to threat grid for analysis. URL or file, not both. polling: true - name: threat-grid-submissions-search arguments: - name: query description: Query text. If you wish to work with an elasticsearch query please set 'advanced' argument to true. - name: user_only description: Only display submissions created by the current user, as determined by the value of api_key. auto: PREDEFINED predefined: - 'True' - 'False' - auto: PREDEFINED description: Only display submissions created by the current user's organization, as determined by the value of api_key. name: org_only predefined: - 'True' - 'False' - auto: PREDEFINED description: Restrict matches to a subset of submission fields. The value of 'term' is a comma-delimited list of strings which select groups of fields. name: term predefined: - antivirus - analysis.artifacts.av_signatures.product - analysis.artifacts.av_signatures.signature - behavior - analysis.behaviors.name - analysis.behaviors.title - analysis.artifacts.av_signatures.signature - domain - analysis.domains.domain - analysis.domains.domain.component - mutant - analysis.processes.mutants - analysis.processes.mutants.whole - analysis.processes.mutants.component - path - filename - analysis.paths.path - analysis.paths.path.whole - analysis.processes.paths - process - analysis.processes.process_name - analysis.processes.startup_info.command_line - analysis.processes.startup_info.image_pathname - analysis.processes.startup_info.window_title - registry_key - analysis.registry_keys.key - analysis.registry_keys.key.whole - analysis.registry_keys.key.component - analysis.processes.registry_keys - analysis.processes.registry_keys.whole - analysis.registry_keys.value_names - sample - filename - url - analysis.urls.url - analysis.urls.url.whole. - description: "A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500." name: before - description: "A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500." name: after - auto: PREDEFINED description: Restrict match to submissions in specific state or states. name: state predefined: - wait - prep - run - proc - succ - fail - auto: PREDEFINED description: If not specified, results will be sorted by the search score, which is based on which fields match the query most accurately, and their weight. name: sort_by predefined: - timestamp - submitted_at - analyzed_at - filename - type - state - threat or threat_score - login - auto: PREDEFINED description: desc or asc. name: sort_order predefined: - desc - asc - auto: PREDEFINED description: Provide a 'matches' field in results, indicating which fields were matched. name: highlight predefined: - 'True' - 'False' - description: 'Page number of paginated results. Minimum value: 1.' name: page - description: The number of items per page. name: page_size - defaultValue: '50' description: The maximum number of records to retrieve. name: limit outputs: - contextPath: ThreatGrid.Sample.sample description: The sample ID. type: String - contextPath: ThreatGrid.Sample.filename description: The name of the sample file. type: String - contextPath: ThreatGrid.Sample.state description: The state of the sample, one of a stable set of strings "wait, prep, run, proc, succ, fail". type: String - contextPath: ThreatGrid.Sample.status description: The status of the sample. type: String - contextPath: ThreatGrid.Sample.md5 description: The MD5 id of the sample. type: String - contextPath: ThreatGrid.Sample.sha1 description: The SHA1 id of the sample. type: String - contextPath: ThreatGrid.Sample.sha256 description: The SHA256 id of the sample. type: String - contextPath: ThreatGrid.Sample.submitted_at description: Time of submission for the sample. type: Date - contextPath: ThreatGrid.Sample.threat_score description: The threat score of the sample. type: Number description: Search threat grid submissions. - name: threat-grid-sample-summary-get arguments: - name: sample_id required: true description: The sample id. outputs: - contextPath: ThreatGrid.SampleAnalysisSummary.sample description: The sample ID. type: String - contextPath: ThreatGrid.SampleAnalysisSummary.registry_count description: The registry count of the sample. type: Number - contextPath: ThreatGrid.SampleAnalysisSummary.filename description: The Filename of the sample. type: String - contextPath: ThreatGrid.SampleAnalysisSummary.sha256 description: The SHA256 hash of the sample. type: String - contextPath: ThreatGrid.SampleAnalysisSummary.magic_type description: The sample type. type: String - contextPath: ThreatGrid.SampleAnalysisSummary.first_seen description: The timestamp when the sample was first seen. type: Date - contextPath: ThreatGrid.SampleAnalysisSummary.last_seen description: The timestamp when the sample was last seen. type: Date description: Returns summary analysis information. - name: threat-grid-who-am-i outputs: - contextPath: ThreatGrid.User.email description: Current user mail. type: string - contextPath: ThreatGrid.User.login description: Current user login name. type: string description: Get logged in user. arguments: [] - name: threat-grid-rate-limit-get arguments: - name: login required: true default: true description: User login name. - auto: PREDEFINED description: User or Organization. name: entity_type predefined: - user - organization required: true outputs: - contextPath: ThreatGrid.RateLimit.submission-rate-limit description: 'Array of array(s) representing submission(s) per minute(s) or the string"nil" to clear the value. Example: [[5, 1440]] which represents 5 samples per day. This field represent the number of samples allowed.' type: number - contextPath: ThreatGrid.RateLimit.submission-wait-seconds description: The number of seconds to wait for a submission to get uploaded on the platform. type: number - contextPath: ThreatGrid.RateLimit.submissions-available description: The number of submissions available for the specified username. type: number description: Get rate limit for a specific user name. ThreatGrid employs a simple rate limiting method for sample submissions by specifying the number of samples which can be submitted within some variable time period by a user. Multiple rate limits can be employed to form overlapping submission limits. For example, 20 submissions per hour AND 400 per day. - name: threat-grid-feed-specific-get arguments: - name: feed_name required: true description: The feed name. auto: PREDEFINED predefined: - autorun-registry - banking-dns - dga-dns - dll-hijacking-dns - doc-net-com-dns - downloaded-pe-dns - dynamic-dns - irc-dns - modified-hosts-dns - parked-dns - public-ip-check-dns - ransomware-dns - rat-dns - scheduled-tasks - sinkholed-ip-dns - stolen-cert-dns - name: output_type description: The output type. defaultValue: "json" auto: PREDEFINED predefined: - json - csv - stix - snort - txt - description: 'A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' name: before - description: 'A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' name: after outputs: - contextPath: ThreatGrid.Feed.sample description: Feed sample. type: String - contextPath: ThreatGrid.Feed.description description: Feed description. type: String description: Gets a specific threat feed. - name: threat-grid-ip-search arguments: - name: ip required: true description: The IP to search for. outputs: - contextPath: ThreatGrid.search.ip description: IP item. type: string - contextPath: ThreatGrid.search.asn description: IP asn. type: string - contextPath: ThreatGrid.search.location description: IP location details. type: string description: Search IPs. Please provide a single argument (only one) to use this command, as the API supports 1 filter at a time. - name: threat-grid-analysis-annotations-get arguments: - name: sample_id required: true description: The sample ID. outputs: - contextPath: ThreatGrid.SampleAnnotations.network description: IP address & timestamp in the annotation. type: String description: Returns data regarding the annotations of the analysis. - name: threat-grid-url-search arguments: - name: url required: true description: The URL to search for (please provide the URL in the format http://example.com:80/. note that ThreatGrid only support '.com' domains). outputs: - contextPath: ThreatGrid.search.url description: URL item. type: String description: Search urls. Please provide the URL in the format http://example.com:80/ (note that ThreatGrid only support '.com' domains). - name: threat-grid-feeds-artifact arguments: - name: sha256 description: Restrict returned records with this sha256. - description: Restrict returned records with this sha1. name: sha1 - description: Restrict returned records with this md5. name: md5 - description: Restrict returned records to this path or path fragment. name: path - description: 'A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' name: before - description: 'A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' name: after - defaultValue: '80' description: Restrict to IOCs with this confidence score or higher, defaults to 80. name: confidence - defaultValue: '80' description: Restrict to IOCs with this severity score or higher, defaults to 80. name: severity - description: Restrict returned records to events of this type. name: ioc - auto: PREDEFINED description: "If “true”, will only match against samples submitted by your organization." name: org_only predefined: - 'True' - 'False' - auto: PREDEFINED description: "If “true”, will only match against samples you submitted." name: user_only predefined: - 'True' - 'False' - description: A comma-separated list of sample IDs. Restrict results to these samples. isArray: true name: sample_id - description: The maximum number of records to retrieve. defaultValue: '50' name: limit - description: The number of items per page. name: page_size - description: Page number of paginated results. name: page outputs: - contextPath: ThreatGrid.Artifact.confidence description: Artifact confidence. type: Number - contextPath: ThreatGrid.Artifact.severity description: "Artifact severity." type: Number - contextPath: ThreatGrid.Artifact.ioc description: Artifact IOC. type: String - contextPath: ThreatGrid.Artifact.artifact_sha256 description: "Artifact sha256." type: String - contextPath: ThreatGrid.Artifact.artifact_md5 description: Artifact md5. type: String - contextPath: ThreatGrid.Artifact.sample_id description: Artifact sample ID. type: String description: Get artifacts threat feed. - name: threat-grid-feeds-domain arguments: - name: domain description: Restrict returned records to this domain or hostname. - description: 'A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' name: before - description: 'A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' name: after - defaultValue: '80' description: Restrict to IOCs with this confidence score or higher, defaults to 80. name: confidence - defaultValue: '80' description: Restrict to IOCs with this severity score or higher, defaults to 80. name: severity - description: Restrict returned records to events of this type. name: ioc - auto: PREDEFINED description: "If “true”, will only match against samples submitted by your organization." name: org_only predefined: - 'True' - 'False' - auto: PREDEFINED description: "If “true”, will only match against samples you submitted." name: user_only predefined: - 'True' - 'False' - description: A comma-separated list of sample IDs. Restrict results to these samples. isArray: true name: sample_id - description: Page number of paginated results. name: page - description: The number of items per page. name: page_size - description: The maximum number of records to retrieve. name: limit defaultValue: '50' outputs: - contextPath: ThreatGrid.Domain.confidence description: "Domain confidence." type: Number - contextPath: ThreatGrid.Domain.severity description: "Domain severity." type: Number - contextPath: ThreatGrid.Domain.ioc description: "Domain IOC." type: String - contextPath: ThreatGrid.Domain.sample_sha256 description: Domain sha256. type: String - contextPath: ThreatGrid.Domain.sample_id description: "Domain sample ID." type: String - contextPath: ThreatGrid.Domain.domain description: "The Domain." type: String description: Get domain threat feed. - name: threat-grid-feeds-ip arguments: - name: ip description: Restrict returned records to this IP or CIDR block. - description: 'A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' name: before - description: 'A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' name: after - defaultValue: '80' description: Restrict to IOCs with this confidence score or higher, defaults to 80. name: confidence - defaultValue: '80' description: Restrict to IOCs with this severity score or higher, defaults to 80. name: severity - description: Restrict returned records to events of this type. name: ioc - auto: PREDEFINED description: "If “true”, will only match against samples submitted by your organization." name: org_only predefined: - 'True' - 'False' - auto: PREDEFINED description: "If “true”, will only match against samples you submitted." name: user_only predefined: - 'True' - 'False' - description: A comma-separated list of sample IDs. Restrict results to these samples. isArray: true name: sample_id - description: Page number of paginated results. name: page - description: The number of items per page. name: page_size - description: The maximum number of records to retrieve. name: limit defaultValue: '50' outputs: - contextPath: ThreatGrid.Ip.confidence description: IP confidence. type: Number - contextPath: ThreatGrid.Ip.severity description: "IP severity." type: Number - contextPath: ThreatGrid.Ip.ioc description: IP IOC. type: String - contextPath: ThreatGrid.Ip.sample_sha256 description: IP sha256. type: String - contextPath: ThreatGrid.Ip.sample_id description: IP sample ID. type: String - contextPath: ThreatGrid.Ip.ip description: "The IP." type: String - contextPath: ThreatGrid.Ip.port description: The IP port. type: Number description: Get ips threat feed. - name: threat-grid-feeds-network-stream arguments: - name: ip description: Restrict returned records to this IP address. - description: Restrict returned records to this port number. name: port - description: 'A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' name: before - description: 'A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' name: after - defaultValue: '80' description: Restrict to IOCs with this confidence score or higher, defaults to 80. name: confidence - defaultValue: '80' description: Restrict to IOCs with this severity score or higher, defaults to 80. name: severity - description: Restrict returned records to events of this type. name: ioc - auto: PREDEFINED description: "If “true”, will only match against samples submitted by your organization." name: org_only predefined: - 'True' - 'False' - auto: PREDEFINED description: "If “true”, will only match against samples you submitted." name: user_only predefined: - 'True' - 'False' - description: A comma-separated list of sample IDs. Restrict results to these samples. isArray: true name: sample_id - description: Page number of paginated results. name: page - description: The number of items per page. name: page_size - description: The maximum number of records to retrieve. name: limit defaultValue: '50' outputs: - contextPath: ThreatGrid.NetworkStreams.confidence description: "Network Streams confidence." type: Number - contextPath: ThreatGrid.NetworkStreams.severity description: "Network Streams severity." type: Number - contextPath: ThreatGrid.NetworkStreams.ioc description: "Network Streams IOC." type: String - contextPath: ThreatGrid.NetworkStreams.sample_sha256 description: "Network Streams sha256." type: String - contextPath: ThreatGrid.NetworkStreams.sample_id description: "Network Streams sample ID." type: String - contextPath: ThreatGrid.NetworkStreams.src description: "The Network Streams source." type: String - contextPath: ThreatGrid.NetworkStreams.src_port description: "The Network Streams source port." type: Number - contextPath: ThreatGrid.NetworkStreams.dst description: "The Network Streams destination." type: String - contextPath: ThreatGrid.NetworkStreams.dst_port description: "The Network Streams destination port." type: Number description: Get network stream threat feed. - name: threat-grid-feeds-path arguments: - name: path description: Restrict returned records to this path or path fragment. - name: before description: 'A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' - name: after description: 'A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' - defaultValue: '80' description: Restrict to IOCs with this confidence score or higher, defaults to 80. name: confidence - defaultValue: '80' description: Restrict to IOCs with this severity score or higher, defaults to 80. name: severity - description: Restrict returned records to events of this type. name: ioc - auto: PREDEFINED description: "If “true”, will only match against samples submitted by your organization." name: org_only predefined: - 'True' - 'False' - auto: PREDEFINED description: "If “true”, will only match against samples you submitted." name: user_only predefined: - 'True' - 'False' - description: A comma-separated list of sample IDs. Restrict results to these samples. isArray: true name: sample_id - description: Page number of paginated results. name: page - description: The number of items per page. name: page_size - description: The maximum number of records to retrieve. name: limit defaultValue: '50' outputs: - contextPath: ThreatGrid.Path.confidence description: "Path confidence." type: Number - contextPath: ThreatGrid.Path.severity description: "Path severity." type: Number - contextPath: ThreatGrid.Path.ioc description: "Path IOC." type: String - contextPath: ThreatGrid.Path.sample_sha256 description: "Path sha256." type: String - contextPath: ThreatGrid.Path.sample_id description: "Path sample ID." type: String description: Get path threat feed. - name: threat-grid-feeds-url arguments: - name: url description: Restrict returned records to this URL or URL fragment. - description: 'A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' name: before - description: 'A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' name: after - defaultValue: '80' description: Restrict to IOCs with this confidence score or higher, defaults to 80. name: confidence - defaultValue: '80' description: Restrict to IOCs with this severity score or higher, defaults to 80. name: severity - description: Restrict returned records to events of this type. name: ioc - auto: PREDEFINED description: "If “true”, will only match against samples submitted by your organization." name: org_only predefined: - 'True' - 'False' - auto: PREDEFINED description: "If “true”, will only match against samples you submitted." name: user_only predefined: - 'True' - 'False' - description: A comma-separated list of sample IDs. Restrict results to these samples. name: sample_id - description: Page number of paginated results. name: page - description: The number of items per page. name: page_size - description: The maximum number of records to retrieve. name: limit defaultValue: '50' outputs: - contextPath: ThreatGrid.Url.confidence description: URL confidence. type: Number - contextPath: ThreatGrid.Url.severity description: URL severity. type: Number - contextPath: ThreatGrid.Url.ioc description: "URL IOC." type: String - contextPath: ThreatGrid.Url.sample_sha256 description: URL sha256. type: String - contextPath: ThreatGrid.Url.sample_id description: URL sample ID. type: String - contextPath: ThreatGrid.Url.url description: The URL. type: String description: Get url threat feed. - name: threat-grid-analysis-artifacts-get arguments: - description: the sample id. name: sample_id required: true - description: The artifact id requested. name: artifact_id outputs: - contextPath: ThreatGrid.ArtifactAnalysis.items description: List of artifact analysis of the sample. type: Unknown description: Returns the sample id artifact with artifact id. - name: threat-grid-analysis-iocs-get arguments: - name: sample_id required: true description: the sample id. - description: the IOC requested. name: ioc outputs: - contextPath: ThreatGrid.IOCAnalysis.title description: 'The title of the IOC.' type: String - contextPath: ThreatGrid.IOCAnalysis.confidence description: 'The confidence of the IOC.' type: Number - contextPath: ThreatGrid.IOCAnalysis.severity description: The severity of the IOC. type: String - contextPath: ThreatGrid.IOCAnalysis.ioc description: Threat grid's IOC. type: String - contextPath: ThreatGrid.IOCAnalysis.category description: The IOC category of the IOC. type: String - contextPath: ThreatGrid.IOCAnalysis.sha256 description: The SHA256 value of the IOC. type: String - contextPath: ThreatGrid.IOCAnalysis.tags description: The tags of the IOC. type: String description: Returns data regarding the specified Indicator of Compromise. - name: threat-grid-analysis-metadata-get arguments: - name: sample_id required: true default: true description: the sample id. outputs: - contextPath: ThreatGrid.AnalysisMetadata.general_details description: The Metadata Analysis General Details. type: Unknown - contextPath: ThreatGrid.AnalysisMetadata.malware_desc description: The Metadata Analysis Malware Desc. type: Unknown - contextPath: ThreatGrid.AnalysisMetadata.sandcastle_env description: "The Metadata Analysis Malware Sandcastle ENV." type: Unknown description: Returns metadata about the analysis. - name: threat-grid-analysis-network-streams-get arguments: - name: sample_id required: true description: the sample id. - name: network_stream_id description: The network stream id. outputs: - contextPath: ThreatGrid.NetworkAnalysis.protocol description: The network protocol. type: Number - contextPath: ThreatGrid.NetworkAnalysis.transport description: "The network transport." type: String - contextPath: ThreatGrid.NetworkAnalysis.service description: The network service. type: String - contextPath: ThreatGrid.NetworkAnalysis.client_ip description: The client IP. type: String - contextPath: ThreatGrid.NetworkAnalysis.server_ip description: The server IP. type: String description: Returns data regarding a specific network stream. - name: threat-grid-analysis-processes-get arguments: - name: sample_id required: true description: the sample id. - description: the process id requested. name: process_id description: Returns data regarding the specific process id in the analysis. outputs: - contextPath: ThreatGrid.ProcessAnalysis.process_name description: The process name. type: String - contextPath: ThreatGrid.ProcessAnalysis.process_id description: The process ID. type: String - name: file arguments: - name: file required: true default: true description: A CSV list of hashes of the file to query. Supports MD5, SHA1, and SHA256. isArray: true - auto: PREDEFINED defaultValue: 'false' description: Whether to return full response for scans. Default is "false". name: long predefined: - 'True' - 'False' - description: If the number of positives is higher than the threshold, the file will be considered malicious. If the threshold is not specified, the default file threshold, as configured in the instance settings, will be used. name: threshold - defaultValue: '60' description: Time (in seconds) to wait between tries if the API rate limit is reached. Default is "60". name: wait - defaultValue: '0' description: Number of retries for the API rate limit. Default is "0". name: retries outputs: - contextPath: File.MD5 description: MD5 hash. type: String - contextPath: File.Name description: File name. type: String - contextPath: File.SHA1 description: SHA1 hash. type: String - contextPath: File.sha256 description: SHA256 hash. type: String - contextPath: File.EntryID description: The entry ID of the file. type: String - contextPath: File.Malicious.Vendor description: The vendor that reported the file as malicious. type: String - contextPath: File.Malicious.Description description: A description explaining why the file was determined to be malicious. type: String - contextPath: DBotScore.Indicator description: The indicator that was tested. type: String - contextPath: DBotScore.Type description: The indicator type. type: String - contextPath: DBotScore.Vendor description: The vendor used to calculate the score. type: String - contextPath: DBotScore.Score description: The actual score. type: Number - contextPath: DBotScore.Reliability description: Reliability of the source providing the intelligence data. type: String - contextPath: ThreatGrid.File.PositiveDetections description: Number of engines that positively detected the indicator as malicious. type: number - contextPath: ThreatGrid.File.DetectionEngines description: Total number of engines that checked the indicator. type: number - contextPath: ThreatGrid.File.tgLink description: ThreatGrid permanent link. type: string description: Checks the file reputation of the specified hash. - name: ip arguments: - name: ip description: IP address to check. default: true isArray: true required: true - name: long description: Whether to return full response for detected URLs. Default is "false". auto: PREDEFINED defaultValue: 'false' predefined: - 'True' - 'False' - name: threshold description: If the number of positives is higher than the threshold, the IP address will be considered malicious. If the threshold is not specified, the default IP threshold, as configured in the instance settings, will be used. - name: sampleSize description: The number of samples from each type (resolutions, detections, etc.) to display for long format. Default is "10". defaultValue: '10' - name: wait description: Time (in seconds) to wait between tries if the API rate limit is reached. Default is "60". defaultValue: '60' - name: retries description: Number of retries for API rate limit. Default is "0". defaultValue: '0' - name: fullResponse description: Whether to return all results, which can be thousands. Default is "false". We recommend that you don't return full results in playbooks. auto: PREDEFINED defaultValue: 'false' predefined: - 'True' - 'False' description: Checks the reputation of an IP address. outputs: - contextPath: IP.Address description: IP address. type: String - contextPath: IP.ASN description: IP ASN. type: String - contextPath: IP.Geo.Country description: IP country. type: String - contextPath: ThreatGrid.IP.indicator description: IP address. type: String - contextPath: ThreatGrid.IP.confidence description: Indicator confidence between 0-99. type: Number - contextPath: DBotScore.Indicator description: The indicator that was tested. type: String - contextPath: DBotScore.Type description: The indicator type. type: String - contextPath: DBotScore.Vendor description: The vendor used to calculate the score. type: String - contextPath: DBotScore.Score description: The actual score. type: Number - contextPath: DBotScore.Reliability description: Reliability of the source providing the intelligence data. type: String - name: url arguments: - name: url description: A comma-seperated list of URLs to check. This command will not work properly on URLs containing commas. default: true isArray: true required: true - defaultValue: '10' description: The number of samples from each type (resolutions, detections, etc.) to display for long format. name: sampleSize - auto: PREDEFINED defaultValue: 'false' description: Whether to return the full response for the detected URLs. name: long predefined: - 'True' - 'False' - description: If the number of positives is higher than the threshold, the URL will be considered malicious. If the threshold is not specified, the default URL threshold, as configured in the instance settings, will be used. name: threshold - defaultValue: '0' description: Time (in seconds) to wait if the URL does not exist and is submitted for scanning. Default is "0". name: submitWait - defaultValue: '60' description: Time (in seconds) to wait between tries if the API rate limit is reached. Default is "60". name: wait - defaultValue: '0' description: Number of retries for API rate limit. Default is "0". name: retries outputs: - contextPath: URL.Data description: URLs found. type: String - contextPath: URL.Malicious.Vendor description: For malicious URLs, the vendor that made the decision. type: String - contextPath: URL.Malicious.Description description: For malicious URLs, the reason that the vendor made the decision. type: String - contextPath: URL.PositiveDetections description: Number of engines that positively detected the indicator as malicious. type: Number - contextPath: DBotScore.Indicator description: The indicator that was tested. type: String - contextPath: DBotScore.Type description: The indicator type. type: String - contextPath: DBotScore.Vendor description: The vendor used to calculate the score. type: String - contextPath: DBotScore.Score description: The actual score. type: Number - contextPath: DBotScore.Reliability description: Reliability of the source providing the intelligence data. type: String - contextPath: ThreatGrid.URL.url description: The URL. type: String - contextPath: ThreatGrid.URL.detection_engines description: Number of engines. type: Number - contextPath: ThreatGrid.URL.positive_engines description: Number of positive engines. type: Number description: Checks the reputation of a URL. - name: domain arguments: - name: domain description: Domain name to check. default: true isArray: true required: true - name: long description: Whether to return the full response for detected URLs. Default is "false". auto: PREDEFINED defaultValue: 'false' predefined: - 'True' - 'False' - name: sampleSize description: The number of samples from each type (resolutions, detections, etc.) to display for long format. defaultValue: '10' - name: threshold description: If the number of positives is higher than the threshold, the domain will be considered malicious. If the threshold is not specified, the default domain threshold, as configured in the instance settings, will be used. - name: wait description: Time (in seconds) to wait between tries if the API rate limit is reached. Default is "60". defaultValue: '60' - name: retries description: Number of retries for API rate limit. Default is "0". defaultValue: '0' - name: fullResponse description: Whether to return all results, which can be thousands. Default is "false". We recommend that you don't return full results in playbooks. auto: PREDEFINED defaultValue: 'false' predefined: - 'True' - 'False' outputs: - contextPath: Domain.Name description: domain found. type: String - contextPath: Domain.Malicious.Vendor description: For malicious domains, the vendor that made the decision. type: String - contextPath: Domain.Malicious.Description description: For malicious domains, the reason that the vendor made the decision. type: String - contextPath: DBotScore.Indicator description: The indicator that was tested. type: String - contextPath: DBotScore.Type description: The indicator type. type: String - contextPath: DBotScore.Vendor description: The vendor used to calculate the score. type: String - contextPath: DBotScore.Score description: The actual score. type: Number - contextPath: DBotScore.Reliability description: Reliability of the source providing the intelligence data. type: String - contextPath: Domain.CreationDate description: The date that the domain was created. type: Date - contextPath: Domain.DNS description: A list of IP objects resolved by DNS. type: String - contextPath: Domain.WHOIS.NameServers description: Name servers of the domain. type: String - contextPath: Domain.WHOIS.Registrar.AbuseEmail description: The email address of the contact for reporting abuse. type: Unknown - contextPath: Domain.WHOIS.Registrar.AbusePhone description: The phone number of contact for reporting abuse. type: Unknown - contextPath: Domain.WHOIS.Registrar.Name description: 'The name of the registrar, for example: "GoDaddy".' type: String - contextPath: Domain.WHOIS.ExpirationDate description: The expiration date of the domain. type: Date - contextPath: Domain.WHOIS.DomainStatus description: The status of the domain. type: String - contextPath: ThreatGrid.Domain.domain description: The domain name. type: String description: Checks the reputation of a domain. - name: threat-grid-domain-samples-list arguments: - name: domain description: The domain to search for. required: true - name: after description: 'A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' - name: before description: 'A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: page_size description: The number of items per page. - name: page description: Page number of paginated results. description: Returns a list of samples associated with a Domain. outputs: - contextPath: ThreatGrid.DomainAssociatedSample.domain description: The domain. type: string - contextPath: ThreatGrid.DomainAssociatedSample.samples description: The associated samples. type: string - name: threat-grid-ip-samples-list arguments: - name: ip description: The IP to search for. required: true - description: 'A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' name: after - description: 'A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' name: before - defaultValue: '50' description: The maximum number of records to retrieve. name: limit - description: The number of items per page. name: page_size - description: Page number of paginated results. name: page outputs: - contextPath: ThreatGrid.IpAssociatedSample.ip description: The IP. type: string - contextPath: ThreatGrid.IpAssociatedSample.samples description: The associated samples. type: string description: Returns a list of samples associated with an IP. - name: threat-grid-path-samples-list arguments: - name: path description: "The path to search for. A path is a slash-separated list of directory names followed by either a directory name or a file name. Path example: ‘/user/name/file’." required: true - name: after description: 'A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' - name: before description: 'A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: page_zise description: The number of items per page. - name: page description: Page number of paginated results. outputs: - contextPath: ThreatGrid.PathAssociatedSample.path description: The Path. type: string - contextPath: ThreatGrid.PathAssociatedSample.samples description: The associated samples. type: string description: Returns a list of samples associated with a Path. - name: threat-grid-url-samples-list arguments: - name: url description: The target URL. Please provide the URL in the format http://example.com:80/ . required: true - name: after description: 'A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' - name: before description: 'A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: page_zise description: The number of items per page. - name: page description: Page number of paginated results. outputs: - contextPath: ThreatGrid.UrlAssociatedSample.url description: The URL. type: string - contextPath: ThreatGrid.UrlAssociatedSample.samples description: The associated samples. type: string description: Returns a list of samples associated with an URL. - name: threat-grid-registry-key-samples-list arguments: - name: registry_key description: The registry key to search for. required: true - name: after description: 'A date/time (ISO 8601), restricting results to samples submitted after it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' - name: before description: 'A date/time (ISO 8601), restricting results to samples submitted before it. Please use the following date/time format. YYYY-MM-DD Thhmmss+|-hhmm e.g. : 2012-04-19T04:00:55-0500.' - name: limit description: The maximum number of records to retrieve. defaultValue: '50' - name: page_size description: The number of items per page. - name: page description: Page number of paginated results. outputs: - contextPath: ThreatGrid.RegistryKeyAssociatedSample.key description: The Registry Key. type: string - contextPath: ThreatGrid.RegistryKeyAssociatedSample.samples description: The associated samples. type: string description: Returns a list of samples associated with a specified registry key. - name: threat-grid-ip-associated-domains arguments: - name: ip description: The IP to search for. required: true outputs: - contextPath: ThreatGrid.IpAssociatedDomain.ip description: The IP. type: string - contextPath: ThreatGrid.IpAssociatedDomain.domains description: The associated Domain. type: string description: Returns a list of domains associated with the IP. - name: threat-grid-ip-associated-urls arguments: - name: ip description: The IP to search for. required: true outputs: - contextPath: ThreatGrid.IpAssociatedUrl.ip description: The IP. type: string - contextPath: ThreatGrid.IpAssociatedUrl.urls description: The associated URL. type: string description: Returns a list of URLs associated to the IP. - name: threat-grid-domain-associated-urls arguments: - name: domain description: The domain to search for. required: true outputs: - contextPath: ThreatGrid.DomainAssociatedUrl.domain description: The Domain. type: string - contextPath: ThreatGrid.DomainAssociatedUrl.urls description: The associated URL. type: string description: Returns a list of URLs associated to the domain. - name: threat-grid-domain-associated-ips arguments: - name: domain required: true description: The domain to search for. description: Returns a list of IPs associated to the domain. outputs: - contextPath: ThreatGrid.DomainAssociatedIp.domain description: The Domain. type: String - contextPath: ThreatGrid.DomainAssociatedIp.ips description: The associated IP. type: String dockerimage: demisto/python3:3.12.13.10325753 tests: - No tests (auto formatted) fromversion: 5.0.0