Skip to main content

OpenCTI

This Integration is part of the OpenCTI Pack.#

Manages indicators from OpenCTI.
This integration was tested with version 5.12.17 of OpenCTI.

Configure OpenCTI on Cortex XSOAR#

  1. Navigate to Settings > Integrations > Servers & Services.

  2. Search for OpenCTI.

  3. Click Add instance to create and configure a new integration instance.

    ParameterRequired
    Base URLTrue
    API Key (leave empty. Fill in the API key in the password field.)False
    Trust any certificate (not secure)False
    Use system proxy settingsFalse
  4. Click Test to validate the URLs, token, and connection.

Commands#

You can execute these commands from the Cortex XSOAR 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-get-indicators#


Gets indicators from OpenCTI.

Base Command#

opencti-get-indicators

Input#

Argument NameDescriptionRequired
limitThe maximum number of indicators to return. Default value is 50. Maximum value is 500.Optional
score_startScore minimum value to filter by. Values range is 0-100.Optional
score_endScore maximum value to filter by. Values range is 0-100.Optional
indicator_typesThe 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. Possible values are: ALL, Account, Domain, Email, File, Host, IP, IPv6, Registry Key, URL. Default is ALL.Optional
last_run_idThe 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

Context Output#

PathTypeDescription
OpenCTI.Indicators.IndicatorsList.typeStringIndicator type.
OpenCTI.Indicators.IndicatorsList.valueStringIndicator value.
OpenCTI.Indicators.IndicatorsList.idStringIndicator ID.
OpenCTI.Indicators.IndicatorsList.createdByUnknownThe creator of the indicator.
OpenCTI.Indicators.IndicatorsList.scoreNumberIndicator score.
OpenCTI.Indicators.IndicatorsList.descriptionStringIndicator description.
OpenCTI.Indicators.IndicatorsList.labelsUnknownIndicator labels.
OpenCTI.Indicators.IndicatorsList.markingUnknownIndicator marking definitions.
OpenCTI.Indicators.IndicatorsList.externalReferencesUnknownIndicator external references.
OpenCTI.Indicators.LastRunIDStringThe last ID of the previous fetch to use for pagination.

Command Example#

!opencti-get-indicators score_start=20 score_end=70 indicator_types=Domain

Context Example#

{
"OpenCTI": {
"Indicators": {
"IndicatorsList": [
{
"createdBy": "0c7cb378-64c3-4809-b423-986ac7cecf91",
"description": "test",
"externalReferences": [],
"id": "7ed5946a-81a2-4490-8be8-06d3633a41fb",
"labels": [
"devdemisto"
],
"marking": [
"TLP:AMBER"
],
"score": 70,
"type": "Domain",
"value": "TestDomainDocs.com"
},
{
"createdBy": null,
"description": null,
"externalReferences": [],
"id": "ebe37223-f455-4122-b83d-3cfb8d8784ea",
"labels": [],
"marking": [
"TLP:AMBER"
],
"score": 50,
"type": "Domain",
"value": "test1111"
},
{
"createdBy": null,
"description": "sdfghjk",
"externalReferences": [
{
"created": "2021-02-09T14:50:39.587Z",
"createdById": null,
"description": null,
"entity_type": "External-Reference",
"external_id": null,
"hash": null,
"id": "c42f673d-b2fa-40df-8ae3-c5cb25626663",
"modified": "2021-02-09T14:50:39.587Z",
"source_name": "source test",
"standard_id": "external-reference--e1b0cc44-a5bd-5729-9d1f-765b0d8e59e7",
"url": "www.test.com"
},
{
"created": "2021-02-22T09:37:46.634Z",
"createdById": null,
"description": null,
"entity_type": "External-Reference",
"external_id": null,
"hash": null,
"id": "a46acbf0-9996-400e-bc5d-f756c48f52c1",
"modified": "2021-02-22T09:37:46.634Z",
"source_name": "TestPlaybook",
"standard_id": "external-reference--be9a7896-80c0-5ec9-80e7-fd072c1808c9",
"url": "www.testplaybook.com"
},
{
"created": "2021-02-21T15:06:39.147Z",
"createdById": null,
"description": null,
"entity_type": "External-Reference",
"external_id": null,
"hash": null,
"id": "62ae7aec-e9e4-4c2a-b789-dfe6c213d391",
"modified": "2021-02-21T15:06:39.147Z",
"source_name": "name_test",
"standard_id": "external-reference--76fed957-9221-56db-8457-65816e4b0fdd",
"url": "http://test.com"
}
],
"id": "74faf2e8-bbab-4a1a-a548-58db202c5e57",
"labels": [],
"marking": [
"TLP:WHITE"
],
"score": 50,
"type": "Domain",
"value": "xcvbnm"
}
],
"lastRunID": "YXJyYXljb25uZWN0aW9uOjM="
}
}
}

Human Readable Output#

Indicators#

typevalueid
DomainTestDomainDocs.com7ed5946a-81a2-4490-8be8-06d3633a41fb
Domaintest1111ebe37223-f455-4122-b83d-3cfb8d8784ea
Domainxcvbnm74faf2e8-bbab-4a1a-a548-58db202c5e57

opencti-indicator-delete#


Delete indicator.

Base Command#

opencti-indicator-delete

Input#

Argument NameDescriptionRequired
idIndicator ID.Required

Context Output#

There is no context output for this command.

Command Example#

!opencti-indicator-delete id=74faf2e8-bbab-4a1a-a548-58db202c5e57

Human Readable Output#

Indicator deleted.

opencti-indicator-field-update#


Update the indicator field. The fields that can be updated are: score, description.

Base Command#

opencti-indicator-field-update

Input#

Argument NameDescriptionRequired
idIndicator ID.Required
fieldIndicator field to update. Possible values are: score, description.Required
valueValue of the field to update.Required

Context Output#

PathTypeDescription
OpenCTI.Indicator.idStringUpdated indicator ID.

Command Example#

!opencti-indicator-field-update field=score id=81d63245-9ba3-495d-8e78-03b037d71e01 value=100

Context Example#

{
"OpenCTI": {
"Indicator": {
"id": "81d63245-9ba3-495d-8e78-03b037d71e01"
}
}
}

Human Readable Output#

Indicator 81d63245-9ba3-495d-8e78-03b037d71e01 updated successfully.

opencti-indicator-create#


Create new indicator.

Base Command#

opencti-indicator-create

Input#

Argument NameDescriptionRequired
typeThe indicator type to create. Out-of-the-box indicator types supported in XSOAR are: Account, Domain, Email, File-MD5, File-SHA1, File-SHA256, Host, IP, IPV6, Registry Key, and URL. Possible values are: Account, Domain, Email, File-MD5, File-SHA1, File-SHA256, Host, IP, IPv6, Registry Key, URL.Required
created_byOrganization ID. Use opencti-organization-list to find all organization IDs in OpenCTI, or use opencti-organization-create to create a new organization ID.Optional
marking_idIndicator marking definition ID. Use opencti-marking-definition-list to find all marking definition IDs in OpenCTI.Optional
label_idIndicator label ID. Use opencti-label-list to find all label IDs in OpenCTI, or use opencti-label-create to create a new label.Optional
external_references_idExternal references URL. Use opencti-external-reference-create to create a new external reference.Optional
descriptionIndicator description.Optional
scoreIndicator score. Values range is 0 - 100. Default value is 50.Optional
valueIndicator value.Optional

Context Output#

PathTypeDescription
OpenCTI.Indicator.idStringNew indicator ID.
OpenCTI.Indicator.valueStringNew indicator value.
OpenCTI.Indicator.typeStringNew indicator type.

Command Example#

!opencti-indicator-create type=Domain created_by=0c7cb378-64c3-4809-b423-986ac7cecf91 description=test value="TestDomainDocs.com" score=70 label_id=fa57f98e-f2f5-45fd-97f2-bf2c53119044 marking_id=9128e411-c759-4af0-aeb0-b65f12082648

Context Example#

{
"OpenCTI": {
"Indicator": {
"id": "7ed5946a-81a2-4490-8be8-06d3633a41fb",
"type": "Domain",
"value": "TestDomainDocs.com"
}
}
}

Human Readable Output#

Indicator created successfully. New Indicator id: 7ed5946a-81a2-4490-8be8-06d3633a41fb

opencti-indicator-field-add#


Add a field to the indicator. Fields that can be added are marking definition and label.

Base Command#

opencti-indicator-field-add

Input#

Argument NameDescriptionRequired
idIndicator ID.Required
fieldIndicator field to add. Possible values are: marking, label.Required
valueValue of the field to add. Enter label ID or marking definition ID. Use opencti-label-list to find all label IDs in OpenCTI, or use opencti-label-create to create a new label. Use opencti-marking-definition-list to find all marking definition IDs in OpenCTI.Required

Context Output#

There is no context output for this command.

Command Example#

!opencti-indicator-field-add id=33bd535b-fa1c-41e2-a6f9-80d82dd29a9b field=label value=07cfae2d-6cc9-42c5-9fd0-32eff8142404

Human Readable Output#

Added label successfully.

opencti-indicator-field-remove#


Remove indicator field value. Fields which values can be removed are marking definition and label.

Base Command#

opencti-indicator-field-remove

Input#

Argument NameDescriptionRequired
idIndicator ID.Required
fieldIndicator field to update. Possible values are: marking, label.Required
valueValue of the field to remove. Enter label ID or marking definition ID. Use opencti-label-list to find all label IDs in OpenCTI or opencti-marking-definition-list to find all marking definition IDs in OpenCTI.Required

Context Output#

There is no context output for this command.

Command Example#

!opencti-indicator-field-remove id=33bd535b-fa1c-41e2-a6f9-80d82dd29a9b field=marking value=c9819001-c80c-45e1-8edb-e543e350f195

Human Readable Output#

marking: c9819001-c80c-45e1-8edb-e543e350f195 was removed successfully from indicator: 33bd535b-fa1c-41e2-a6f9-80d82dd29a9b.

opencti-organization-list#


Get a list of all organizations in OpenCTI.

Base Command#

opencti-organization-list

Input#

Argument NameDescriptionRequired
limitThe maximum number of organizations to return per fetch. Default value is 50. Maximum value is 200. Default is 50.Optional
last_run_idThe last ID from the previous call, from which to begin pagination for this call. You can find this value at the OpenCTI.Organizations.organizationsLastRun context path.Optional

Context Output#

PathTypeDescription
OpenCTI.Organizations.OrganizationsList.idStringOrganization ID.
OpenCTI.Organizations.OrganizationsList.nameStringOrganization name.
OpenCTI.Organizations.organizationsLastRunStringThe last ID of the previous fetch to use for pagination.

Command Example#

!opencti-organization-list limit=2

Context Example#

{
"OpenCTI": {
"Organizations": [
{
"OrganizationsList": [
{
"id": "1e12fe87-db3e-4838-8391-6910547bf60d",
"name": "Test_Organization"
},
{
"id": "11ddff08-8933-46d7-ab22-31f49496499f",
"name": "ExampleOrganization"
}
]
},
{
"organizationsLastRun": "YXJyYXljb25uZWN0aW9uOjI="
}
]
}
}

Human Readable Output#

Organizations#

NameId
Test_Organization1e12fe87-db3e-4838-8391-6910547bf60d
ExampleOrganization11ddff08-8933-46d7-ab22-31f49496499f

opencti-organization-create#


Create a new organization.

Base Command#

opencti-organization-create

Input#

Argument NameDescriptionRequired
nameName of the organization to create.Required
descriptionDescription of the organization.Optional
reliabilityReliability of the organization. Possible values are: A, B, C, D, E, F.Optional

Context Output#

PathTypeDescription
OpenCTI.Organization.idStringNew organization ID.

Command Example#

!opencti-organization-create name=ExampleOrganization description="create organization" reliability="C"

Context Example#

{
"OpenCTI": {
"Organization": {
"id": "11ddff08-8933-46d7-ab22-31f49496499f"
}
}
}

Human Readable Output#

Organization ExampleOrganization was created successfully with id: 11ddff08-8933-46d7-ab22-31f49496499f.

opencti-label-list#


Get list of all labels.

Base Command#

opencti-label-list

Input#

Argument NameDescriptionRequired
limitThe maximum number of labels to return per fetch. Default is 50.Optional
last_run_idThe last ID from the previous call, from which to begin pagination for this call. You can find this value at the OpenCTI.Labels.labelsLastRun context path.Optional

Context Output#

PathTypeDescription
OpenCTI.Labels.LabelsList.idStringLabel ID.
OpenCTI.Labels.LabelsList.valueStringLabel name.
OpenCTI.Labels.labelsLastRunStringThe last ID of the previous fetch to use for pagination.

Command Example#

!opencti-label-list limit=2

Context Example#

{
"OpenCTI": {
"Labels": {
"LabelsList": [
{
"id": "7ba41668-1594-4a09-9be5-3640f2c2d253",
"value": "demisto_lablel"
},
{
"id": "fa57f98e-f2f5-45fd-97f2-bf2c53119044",
"value": "devdemisto"
}
],
"labelsLastRun": "YXJyYXljb25uZWN0aW9uOjI="
}
}
}

Human Readable Output#

Labels#

ValueId
demisto_lablel7ba41668-1594-4a09-9be5-3640f2c2d253
devdemistofa57f98e-f2f5-45fd-97f2-bf2c53119044

opencti-label-create#


Create a new label.

Base Command#

opencti-label-create

Input#

Argument NameDescriptionRequired
nameName of the new label to create.Required

Context Output#

PathTypeDescription
OpenCTI.Label.idStringNew label ID.

Command Example#

!opencti-label-create name=docsTest

Context Example#

{
"OpenCTI": {
"Label": {
"id": "beb5159a-e162-4352-b7d7-6e355db7f057"
}
}
}

Human Readable Output#

Label docsTest was created successfully with id: beb5159a-e162-4352-b7d7-6e355db7f057.

opencti-external-reference-create#


Create external reference.

Base Command#

opencti-external-reference-create

Input#

Argument NameDescriptionRequired
urlExternal references URL.Required
source_nameExternal references source name.Required

Context Output#

PathTypeDescription
OpenCTI.externalReference.idStringNew external reference ID.

Command Example#

!opencti-external-reference-create source_name=source_name url=www.url.com

Context Example#

{
"OpenCTI": {
"externalReference": {
"id": "8339d023-ada2-4b32-8a29-0a3897fc096d"
}
}
}

Human Readable Output#

Reference source_name was created successfully with id: 8339d023-ada2-4b32-8a29-0a3897fc096d.

opencti-marking-definition-list#


Get a list of all marking definitions.

Base Command#

opencti-marking-definition-list

Input#

Argument NameDescriptionRequired
limitThe maximum number of marking definitions to return per fetch. Default is 50.Optional
last_run_idThe last ID from the previous call, from which to begin pagination for this call. You can find this value at the OpenCTI.MarkingDefinitions.markingsLastRun context path.Optional

Context Output#

PathTypeDescription
OpenCTI.MarkingDefinitions.MarkingDefinitionsList.idStringMarking definition ID.
OpenCTI.MarkingDefinitions.MarkingDefinitionsList.valueStringMarking definition name.
OpenCTI.MarkingDefinitions.markingsLastRunStringThe last ID of the previous fetch to use for pagination.

Command Example#

!opencti-marking-definition-list limit=2

Context Example#

{
"OpenCTI": {
"MarkingDefinitions": {
"MarkingDefinitionsList": [
{
"id": "dc911977-796a-4d96-95e4-615bd1c41263",
"value": "TLP:GREEN"
},
{
"id": "9128e411-c759-4af0-aeb0-b65f12082648",
"value": "TLP:AMBER"
}
],
"markingsLastRun": "YXJyYXljb25uZWN0aW9uOjI="
}
}
}

Human Readable Output#

Markings#

ValueId
TLP:GREENdc911977-796a-4d96-95e4-615bd1c41263
TLP:AMBER9128e411-c759-4af0-aeb0-b65f12082648