OpenCTI Feed 4.X

Ingest indicators from the OpenCTI feed. Compatible with OpenCTI 5.12.17 and above.

Data Enrichment & Threat Intelligence · OpenCTI Feed · Feed

Details

IDOpenCTI Feed 4.X
ProviderFiligran
CategoryData Enrichment & Threat Intelligence
From Version5.5.0
Docker Imagedemisto/vendors-sdk:1.0.0.115493
Supported ModulesAgentix XSIAM

README

Ingest indicators from the OpenCTI feed. Compatible with OpenCTI 5.12.17 and above.

Configure OpenCTI Feed 4.X in Cortex

Parameter Description Required
Base URL   True
API Key (leave empty. Fill in the API key in the password field.)   False
Indicator types to fetch The indicator types to fetch. Out-of-the-box indicator types supported in XSOAR are: Account, Domain, Email, File, Host, IP, IPv6, Registry Key, and URL. Other types will not cause automatic indicator creation in XSOAR. True
Max indicators per fetch   False
Fetch indicators   False
Indicator Reputation Indicators from this integration instance will get this reputation. If none of the options is chosen, the indicator reputation will be set according to the indicator data. False
Source Reliability Reliability of the source providing the intelligence data. True
Traffic Light Protocol Color The Traffic Light Protocol (TLP) designation to apply to indicators fetched from the feed. If none of the options is chosen, the TLP color will be set according to the indicator data. False
Feed Fetch Interval   False
Tags CSV values are supported. False
Bypass exclusion list When selected, the exclusion list is ignored for indicators from this feed. This means that if an indicator from this feed is on the exclusion list, the indicator might still be added to the system. False
Trust any certificate (not secure)   False
Use system proxy settings   False
Score minimum value Score minimum value to filter by. Values range is 1-100. False
Score maximum value Score maximum value to filter by. Values range is 1-100. 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.

opencti-reset-fetch-indicators


WARNING: This command will reset your fetch history.

Base Command

opencti-reset-fetch-indicators

Input

There are no input arguments for this command.

Context Output

There is no context output for this command.

Command Example


#### Human Readable Output

>Fetch history deleted successfully

### opencti-get-indicators

***
Gets indicators from the feed.

#### Base Command

`opencti-get-indicators`

#### Input

| **Argument Name** | **Description** | **Required** |
| --- | --- | --- |
| limit | The maximum number of indicators to return per fetch. Default value is 50. Maximum value is 500. | Optional |
| indicator_types | The indicator types to fetch. Out-of-the-box indicator types supported in XSOAR are: Account, Domain, Email, File, Host, IP, IPv6, Registry Key, and URL. Other types will not cause automatic indicator creation in XSOAR. Possible values are: ALL, Account, Domain, Email, File, Host, IP, IPv6, Registry Key, URL. Default is ALL. | Optional |
| last_run_id | The last ID from the previous call, from which to begin pagination for this call. You can find this value at the OpenCTI.IndicatorsList.LastRunID context path. | Optional |
| score_start | Score minimum value to filter by. Values range is 1-100. | Optional |
| score_end | Score naximum value to filter by. Values range is 1-100. | Optional |

#### Context Output

There is no context output for this command.

#### Command Example

```!opencti-get-indicators limit=2 indicator_types="IP"```

#### Context Example

```json
{
    "OpenCTI": {
        "Indicators": {
            "IndicatorsList": [
                {
                    "createdBy": "1e12fe87-db3e-4838-8391-6910547bf60d",
                    "description": "test_desc",
                    "externalReferences": [],
                    "id": "700c8187-2dce-4aeb-bf3a-0864cb7b02c7",
                    "labels": [
                        "dev1"
                    ],
                    "marking": [
                        "TLP:AMBER"
                    ],
                    "score": 70,
                    "type": "IP",
                    "value": "1.2.3.4"
                },
                {
                    "createdBy": "1e12fe87-db3e-4838-8391-6910547bf60d",
                    "description": "test fetch one",
                    "externalReferences": [],
                    "id": "33bd535b-fa1c-41e2-a6f9-80d82dd29a9b",
                    "labels": [
                        "dev1",
                        "test-label-1"
                    ],
                    "marking": [],
                    "score": 100,
                    "type": "IP",
                    "value": "1.1.1.1"
                }
            ],
            "lastRunID": "YXJyYXljb25uZWN0aW9uOjI="
        }
    }
}

Human Readable Output

Indicators

type value id
IP 1.2.3.4 700c8187-2dce-4aeb-bf3a-0864cb7b02c7
IP 1.1.1.1 33bd535b-fa1c-41e2-a6f9-80d82dd29a9b

Configuration parameters

  • base_url — Base URL (required)
  • credentials — API Key (leave empty. Fill in the API key in the password field.)
  • indicator_types — Indicator types to fetch (required)
  • max_indicator_to_fetch — Max indicators per fetch
  • feed — Fetch indicators
  • feedReputation — Indicator Reputation
  • feedReliability — Source Reliability (required)
  • tlp_color — Traffic Light Protocol Color
  • feedExpirationPolicy
  • feedExpirationInterval
  • feedFetchInterval — Feed Fetch Interval
  • feedTags — Tags
  • feedBypassExclusionList — Bypass exclusion list
  • insecure — Trust any certificate (not secure)
  • proxy — Use system proxy settings
  • score_start — Score minimum value
  • score_end — Score maximum value

Commands (2)

  • opencti-get-indicators

    Gets indicators from the feed.

  • opencti-reset-fetch-indicators

    WARNING: This command will reset your fetch history.

category: Data Enrichment & Threat Intelligence
provider: Filigran
commonfields:
  id: OpenCTI Feed 4.X
  version: -1
configuration:
- display: Base URL
  name: base_url
  required: true
  type: 0
- display: API Key (leave empty. Fill in the API key in the password field.)
  displaypassword: API Key
  name: credentials
  type: 9
  hiddenusername: true
  required: false
- additionalinfo: 'The indicator types to fetch. Out-of-the-box indicator types supported in XSOAR are: Account, Domain, Email, File, Host, IP, IPv6, Registry Key, and URL. Other types will not cause automatic indicator creation in XSOAR.'
  defaultvalue: ALL
  display: Indicator types to fetch
  name: indicator_types
  options:
  - ALL
  - Account
  - Domain
  - Email
  - File
  - Host
  - IP
  - IPv6
  - Registry Key
  - URL
  required: true
  type: 16
- defaultvalue: '500'
  display: Max indicators per fetch
  name: max_indicator_to_fetch
  type: 0
  required: false
- defaultvalue: 'true'
  display: Fetch indicators
  name: feed
  type: 8
  required: false
- additionalinfo: Indicators from this integration instance will get this reputation. If none of the options is chosen, the indicator reputation will be set according to the indicator data.
  display: Indicator Reputation
  name: feedReputation
  options:
  - None
  - Good
  - Suspicious
  - Bad
  type: 18
  required: false
- additionalinfo: Reliability of the source providing the intelligence data.
  defaultvalue: F - Reliability cannot be judged
  display: Source Reliability
  name: feedReliability
  options:
  - A - Completely reliable
  - B - Usually reliable
  - C - Fairly reliable
  - D - Not usually reliable
  - E - Unreliable
  - F - Reliability cannot be judged
  required: true
  type: 15
- additionalinfo: The Traffic Light Protocol (TLP) designation to apply to indicators fetched from the feed. If none of the options is chosen, the TLP color will be set according to the indicator data.
  display: Traffic Light Protocol Color
  name: tlp_color
  options:
  - RED
  - AMBER
  - GREEN
  - WHITE
  type: 15
  required: false
- defaultvalue: indicatorType
  display: ''
  name: feedExpirationPolicy
  options:
  - never
  - interval
  - indicatorType
  - suddenDeath
  type: 17
  required: false
- defaultvalue: '20160'
  display: ''
  name: feedExpirationInterval
  type: 1
  required: false
- defaultvalue: '240'
  display: Feed Fetch Interval
  name: feedFetchInterval
  type: 19
  required: false
- additionalinfo: CSV values are supported.
  display: Tags
  name: feedTags
  type: 0
  required: false
- additionalinfo: When selected, the exclusion list is ignored for indicators from this feed. This means that if an indicator from this feed is on the exclusion list, the indicator might still be added to the system.
  display: Bypass exclusion list
  name: feedBypassExclusionList
  type: 8
  required: false
- display: Trust any certificate (not secure)
  name: insecure
  type: 8
  required: false
- display: Use system proxy settings
  name: proxy
  type: 8
  required: false
- display: Score minimum value
  name: score_start
  additionalinfo: 'Score minimum value to filter by. Values range is 1-100. '
  type: 0
  required: false
- display: Score maximum value
  name: score_end
  additionalinfo: 'Score maximum value to filter by. Values range is 1-100. '
  type: 0
  required: false
description: Ingest indicators from the OpenCTI feed. Compatible with OpenCTI 5.12.17 and above.
display: OpenCTI Feed 4.X
name: OpenCTI Feed 4.X
script:
  commands:
  - description: 'WARNING: This command will reset your fetch history.'
    name: opencti-reset-fetch-indicators
  - arguments:
    - description: The maximum number of indicators to return per fetch. Default value is 50. Maximum value is 500.
      name: limit
    - auto: PREDEFINED
      defaultValue: ALL
      description: 'The indicator types to fetch. Out-of-the-box indicator types supported in XSOAR are: Account, Domain, Email, File, Host, IP, IPv6, Registry Key, and URL. Other types will not cause automatic indicator creation in XSOAR.'
      isArray: true
      name: indicator_types
      predefined:
      - ALL
      - Account
      - Domain
      - Email
      - File
      - Host
      - IP
      - IPv6
      - Registry Key
      - URL
    - description: The last ID from the previous call, from which to begin pagination for this call. You can find this value at the OpenCTI.IndicatorsList.LastRunID context path.
      name: last_run_id
    - description: 'Score minimum value to filter by. Values range is 1-100. '
      name: score_start
    - description: 'Score naximum value to filter by. Values range is 1-100. '
      name: score_end
    description: Gets indicators from the feed.
    name: opencti-get-indicators
  dockerimage: demisto/vendors-sdk:1.0.0.115493
  feed: true
  runonce: false
  script: '-'
  subtype: python3
  type: python
tests:
- OpenCTI Feed Test
fromversion: 5.5.0
autoUpdateDockerImage : false