Indicator#

Tip

This entity is analogous to these STIX objects:

Indicators:

are fingerprints that potentially malicious actors leave behind in a targeted system or environment.

They act as red flags to point out anomalous or unusual activity or behavior.
help identify specific observable patterns
build context for investigations

Create an indicator by selecting:

In the side navigation bar + Create > Indicator.

Or:

(Requires EclecticIQ Labs: Intelligence creation on the graph)

In the top navigation bar of a graph, select + and then Indicator to create a draft entity.
Double-click to open the newly created draft entity to edit it.

Then, Configure this indicator.

Configure#

The following sections the fields and options available.

Note

Required fields are marked with an asterisk (*).

General#

Field	EIQ JSON field	Description
Title*	`data.title`	Descriptive title for this entity. See Titles and aliases.
Analysis	`data.description`	Long description of indicator. Use this to contain unstructured information about this indicator.
Types*	`data.types`	See Indicator subtypes
Likely Impact	`data.likely_impact`	Describes the severity of the likely impact this indicator has in a given context. See Confidence scale: High Medium low.
Confidence	`data.confidence`	See Confidence scale: High Medium low.

Characteristics#

Characteristics are properties on an entity that provide context for the intelligence indicated by this object.

The following are characteristics available for indicators:

Time window
Sighting
Test mechanism

Characteristics: Time window#

The Time window characteristic allows you to specify a start time and end time for the indicated threat. Analogous to ValidTimeType.

You can specify more than one time window.

Tip

This may overlap with estimated threat start time and estimated threat end time properties for an indicator, which are used for calculating the half-life of an entity.

You may want to use estimated threat time properties instead.

These fields are available:

Field	EIQ JSON field	Description
Time window	`data.valid_time_positions[]`	Each time window characteristic on an indicator is an item in the `data.valid_time_positions` list. E.g.: "valid_time_positions": [ { "end": "2023-03-02T00:00:00+00:00", "end_precision": "second", "start": "2023-03-01T00:00:00+00:00", "start_precision": "year", "type": "valid-time" } ]
Start time	`data.valid_time_positions.start`	Start of time window.
Start precision	`data.valid_time_positions.start_precision`	Date and time precision of start of time window.
End time	`data.valid_time_positions.end`	End of time window.
End precision	`data.valid_time_positions.end_precision`	Date and time precision of end of time window.

Characteristics: Sighting#

Use the sighting characteristic to indicate that this indicator entity has been sighted as least once.

You can only add one sighting characteristic per indicator entity.

Field	EIQ JSON field	Description
Sighted	`data.sightings_count`	Adds 1 to `sightings_count`.

Characteristics: Test mechanism#

Test mechanisms allow you to embed detection rules and other detection mechanisms into an indicator, which in turn can be sent out for use in a separate an intrusion detection system or similar. Analogous to TestMechanismType.

Test mechanisms are set in the entity’s data.test_mechanisms[] field.

To start setting up a test mechanism, first select one of the following Type values:

Field	EIQ JSON field	Description
Type*	Various. See individual sections.	Available options: Snort YARA Generic (sub-types also available)

Field

EIQ JSON field

Description

Type*

Various. See individual sections.

Available options:

Snort
YARA
Generic (sub-types also available)

Then, fill out the fields as described their respective sections below.

Test mechanisms: Snort#

Snort test mechanisms allow you to attach Snort rules to indicator entities. Analogous to SnortTestMechanismType.

These fields are available:

Field	EIQ JSON field	Description
Efficacy*	`data.test_mechanisms[].efficacy`	Describes how effective this test mechanism is at detecting threats. See Confidence scale: High Medium low.
Product name	`data.test_mechanisms[].product_name`	Name of product Snort detection rules are used with. Specify a CPE name, if available.
Version	`data.test_mechanisms[].version`	Version of product specified in Product name.
Signature (rule)*	`data.test_mechanisms[].rules[]`	One or more Snort rules.
Event filters	`data.test_mechanisms[].event_filters[]`	One or more event filters. See Snort Manual: Event Filtering. Select +More to add event filters.
Rate filters	`data.test_mechanisms[].rate_filters[]`	One or more rate filters. See Snort Manual: Rate Filtering. Select +More to add rate filters.
Event suppressions	`data.test_mechanisms[].event_suppressions[]`	One or more event suppressions. See Snort Manual: Event Suppression.
Producer	`data.test_mechanisms[].producer`	See Test mechanism: Producer.

Test mechanisms: YARA#

YARA test mechanisms. Analogous to YaraTestMechanismType.

These fields are available:

Field	EIQ JSON field	Description
Efficacy*	`data.test_mechanisms[].efficacy`	Describes how effective this test mechanism is at detecting threats. See Confidence scale: High Medium low.
Signature (rule)*	`data.test_mechanisms[].rules[]`	One or more Snort rules.
Producer	`data.test_mechanisms[].producer`	See Test mechanism: Producer.

Test mechanisms: Generic#

Generic test mechanisms. Analogous to GenericTestMechanismType)

These fields are available:

Field	EIQ JSON field	Description
Efficacy*	`data.test_mechanisms[].efficacy`	Describes how effective this test mechanism is at detecting threats. See Confidence scale: High Medium low.
Description	`data.test_mechanisms[].description`	Text description for this test mechanism.
Subtype*	`data.test_mechanisms[].generic_test_mechsnism_type`	Select one of the following sub-types: `pcre` (Perl-Compatible Regular Expressions) `sigma` (Sigma) `suricata` (Suricata) `stix` (STIX 2.1 patterns)
Specification	`data.test_mechanisms[].specification.value`	A detection mechanism written for the selected Subtype.
Producer	`data.test_mechanisms[].producer`	See Test mechanism: Producer.

Observables#

You can create one or more new observables and link it to the currently open entity by selecting + Observable under the Observables section.

Note

If an observable you create here matches an observable rule with an ignore action, it does not appear when the you publish the entity.

In the Add observable view that appears, fill out these fields:

Field	EIQ JSON field	Description
Type*	`extracts[].kind`	See Observable types
Link name*	See Observable link types	See Observable link types
Values(s)*	`extracts[].value`	Enter one or more values. One observable is created per value. Values must be comma-separated, or newline-separated, but not both.
Maliciousness*	See Observable maliciousness	See Observable maliciousness

Relationships#

Add relationships to this entity by selecting + Add relationship.

See Relationships.

Meta#

The Meta section contains configuration options that allow you to attach descriptive data to the entity.

Field	EIQ JSON field	Description
Estimated threat start time	`meta.estimated_threat_start_time`	Estimated start of threat. See Time values.
Estimated threat end time	`meta.estimated_threat_end_time`	Estimated end of threat. See Time values.
Estimated observed time	`meta.estimated_observed_time`	Estimated time threat was observed. See Time values.
Half-life	`meta.half_life`	See Half-life. Select one of these options: Use default value: When selected, half-life for this entity is set to 720 days. Override value: Set a custom value for half-life, in number of days.
Tags	`meta.tags[]` and `meta.taxonomy_paths[]`	See tags and taxonomies.
Source*	`sources[]`	Select one source.
Source reliability	`meta.source_reliability`	See source reliability. Options: Inherit from source: This entity inherits source reliability from Source. Custom override: Set a source reliability value for just this entity.
TLP	`meta.tlp_color`	Set a TLP color for this entity.

Producer#

Field	EIQ JSON field	Description
Description	`data.producer.description`	Description of producer.
Identity	`data.producer.identity`	Name of this producer
Roles	`data.producer.roles[]`	One or more producer roles. Possible values: Initial Author Content Enhancer/Refiner Aggregator Transformer/Translator
References	`data.producer.references[]`	One or more URLs.

Data marking#

Descriptive metadata for entity.

Field	EIQ JSON field	Description
Terms of use	`data.handling[].marking_structures[]`	Free text field allowing you to attach terms of use to an entity. Analogous to TermsOfUseMarkingStructureType.
Simple	`data.handling[].marking_structures[]`	Free text field for attaching any text to an entity. Analogous to SimpleMarkingStructureType.

Workflow#

Use options here to apply workflow options to this entity.

Field	Description
Add to dataset	Select this option to add this entity to one or more datasets on Publish.
Manually enrich	Run one or more enrichers on this entity on Publish.

Save and publish#

Tip

For more information, see Draft and published entities.

Select Publish to create this entity, and make it available under + Create > Production > Published.

For more publishing options, select More and then one of these options:

Publish and new: Publish this entity, and start creating a new entity.
Publish and duplicate: Publish this entity, and start creating a new entity using all the values set for this entity.

Select Save draft to save this entity as a draft, and make it available under + Create > Production > Drafts. You must publish an entity to use it elsewhere on EclecticIQ Intelligence Center.

For more options while saving as a draft, select More and then one of these options:

Publish and new: Save this entity as a draft, and start creating a new entity.
Publish and duplicate: Save this entity as a draft, and start creating a new entity using all the values set for this draft entity.

Appendix#

Indicator subtypes#

The Types field is used to set a subtype for an indicator entity.

Note

This is different from the entity type (i.e. “indicator”), which is set in the entity’s data.type field instead.

This subtype is analogous to IndicatorTypeVocab-1.1 types. Possible values:

Malicious E-mail
IP Watchlist
File Hash Watchlist
Domain Watchlist
URL Watchlist
Malware Artifacts
C2
Anonymization
Exfiltration
Host Characteristics
Compromised PKI Certificate
Login Name
IMEI Watchlist
IMSI Watchlist

Test mechanism: Producer#

Test mechanisms have a separate Producer component:

Identity

Field	EIQ JSON field	Description
Name	`data.test_mechanisms[].producer.identity.name`	Name of test mechanism producer.

Time

Field	EIQ JSON field	Description
Start	`data.test_mechanisms[].producer.time_start`	Start of validity for test mechanism.
Start Precision	`data.test_mechanisms[].producer.time_start_precision`	Date and time precision of start time.
End	`data.test_mechanisms[].producer.time_end`	End of validity for test mechanism.
End Precision	`data.test_mechanisms[].producer.time_end_precision`	Date and time precision of end time.
Received	`data.test_mechanisms[].producer.time_received`	Date and time when test mechanism was received.
Received Precision	`data.test_mechanisms[].producer.time_received_precision`	Date and time precision of received time.

References

Field	EIQ JSON field	Description
Reference back URL	`data.test_mechanisms[].producer.references[]`	One or more URLs.