Create a sighting

A sighting describes a specific occurrence of an indicator or an observable. More specifically, it records a date and a time when an instance of an indicator of compromise was observed within your organization or environment.

Create a sighting

Required fields are marked with an asterisk ( * ).

There are two ways of creating a sighting :

In the top navigation bar of a graph, click , and then Sighting.
In the side navigation bar of the Dashboard, click , and then Sighting.

If you create a sighting from a graph, double-click its icon to access its details page.

If you create a sighting from the Dashboard, its details page is displayed automatically.

Fill in the sighting's details as follows:

Define the general options

In the Title field, assign the new sighting entity a short, clear, and descriptive name.
The name you specify here appears on the entity detail pane, in the header section.
In the Analysis field, enter non-structured information such as additional context, references, links, and so on.
This is where you tell the story of the entity, and where you describe the entity with as much relevant detail as possible.
In the Confidence field, assign an estimated level of confidence to assess the accuracy and trustworthiness of the entity information.
From the Impact drop-down menu, select an option to assess the estimated impact of the sighted indicator of compromise on the targeted system or organization.

Define the characteristics

This section breaks down the main components of the sighting in a structured, standardized, and consistent way.

Related observables: enables relating the sighting to one or more observables to create an association between the specific occurrence of the sighting and the potentially malicious objects observed during the sighting.
Security control: describes the tools, systems, equipment, processes and procedures that are in place to manage and protect the confidentiality, integrity, and availability of the system and its data.
Raw events: enables inserting raw event data related to the sighting.

Under Characteristics, click Characteristic, and then select an option from the drop-down menu to display additional fields in the editor, where you can enter specific details about the selected item in a structured way.

Select the Related observables option to insert one or more observables you want to relate to the sighting.
From the Kind drop-down menu, select the type of observable you want to add.
Example: Domain, Ipv4, City, Actor
In the Value field, enter the value of the observable.
The value and its format should match the specified observable type (kind).
Insert one value entry per line.
Example: 75.23.125.231, ipwnu.biz, Kansas City, [email protected], Alvin Slocombe
Click Add or More to insert new rows or input fields, as necessary, where you can enter additional related observable type (kind) and value pairs.

Select the Security control option to specify the security control tool, system, process or procedure that detected the sighting.
In the Name field, enter the name of the security control acting as a data source for the sighting.
It corresponds to the security control that detected the sighting.
Use the Start drop-down menu calendar to select the date and time marking the beginning of the sighting observation period.
From the Start precision drop-down menu, select an option to provide an estimation of how accurate the start date is: from second (dead-on accurate) to year (inaccurate).
Use the End drop-down menu calendar select the date and time marking the end of the sighting observation period.
From the End precision drop-down menu, select an option to provide an estimation of how accurate the end date is: from second (dead-on accurate) to year (inaccurate).
Use the Received drop-down menu calendar to select the date and time when a notification about the sighting was received.
From the Received precision drop-down menu, select an option to provide an estimation of how accurate the sighting notification date is: from second (dead-on accurate) to year (inaccurate).
In the Reference back URL field, enter a URL pointing to relevant reference information on the sighting, if available.
The field takes only URLs as input.
Enter one URL per input field.
- To confirm the current input and to display a new input field, press ENTER.
- To remove an entry from this section, click the cross icon corresponding to the item you want to remove.
Select the Raw Events option to paste raw event data related to the sighting.
In the Raw events field, paste the raw event data as plain text in the input field.

Add observables

If you manually create an entity in the entity editor, and add observables with a type or value that matches the criteria of an existing observable ignore rule, these observables may not be accessible after saving the entity.

Observables are discrete pieces of information that represent properties, attributes, actions, and events.
They record a distinct piece of information, such as: an IP address, a hash, name of a country, name of a city, name of an organization, or the name of an individual; or an event such as the creation of a registry value, or a file deletion or modification.

They are atomic: the information they hold is complete and meaningful, but it cannot be split into smaller components without losing meaning and intelligence value.
They are factual: they record facts with no additional context or background.

You can relate observables with entities to provide context.
If observables are detected in a specific context, or if they are sighted within the organization, they become indicators and sightings, respectively.

In the Create sighting view, go to the Observables section, and click Observable.
The Add observable pane opens.
From the Type drop-down menu, select an observable type that describes the type of information you are storing in the observable.
For example, a bank account number, a payment card number, an IP address, a domain name, a country or city name, and so on.
From the Link name drop-down menu, select an option to define the type of relationship existing between the observable and the parent entity.

Setting link names to define relationships adds intelligence value by describing how entities and observables are related.
This information provides additional context, and it helps understand how a specific resource is used, or the purpose it serves for a potential attacker.
For example, it can clarify that an observable describes a vulnerability or a weakness related to its parent entity.

Therefore, observables with a Link name value are in general more relevant and more valuable than observables without a Link name value.

Link name options vary, based on the relationship the observable has with the specific entity type it belongs to.
The supported entity-observable relationship link name for the sighting entity is Sighted. The observable related to the sighting describes an observed occurrence of the sighting within the organization.
You can modify and update the link name value at any time to reflect changes in the entity-observable relationship:
1. In the top navigation bar, click Intelligence > All intelligence, and click Browse.
2. Click the Observables tab.
3. If the section is populated with observables, each of them has a Link name column.
4. Click the Link name drop-down menu for the observable whose relationship link name you want to update, and then select one of the available options.
  If the Link name drop-down menu has no options, the selected the entity-observable relationship is undefined.
In the Value(s) field, enter the value of the observable.
The value and its format should match the specified observable type (kind).
If you specify multiple values, enter one value per line.
If you enter multiple values on one line, use a comma (,) as a separator.
Example: 75.23.125.231, ipwnu.biz, Kansas City, [email protected], Alvin Slocombe.
From the Maliciousness drop-down menu, select a maliciousness confidence level to assess the likelihood the potential threat may or may not damage the organization.
This option corresponds to the value that is set under Confidence in observable rules.
To store your changes, click Save; to discard them, click Cancel.

When you flag an observable with a maliciousness confidence level, it cannot transition back to being safe or irrelevant. It can only transition to a higher maliciousness confidence level.

You can use the specified observable values to set up automation processes, so that the potential threat that the entity represents can trigger an action in a security system or another device in the toolchain.

For example, if the observable Type is Email, the Link name is Parameter, and the Value(s) are [email protected], [email protected], and [email protected], you can create a rule in the email server to block all incoming messages from the honestpaul-superdeals.com email domain.

Add relationships

In the Relationships view, click Relationship.

From the drop-down menu select the option corresponding to the relationship you want to create.
The following options are available:

Option	Incoming/Outgoing	Description
Associated campaigns	Outgoing relationship	Relates the campaign to the selected campaign(s) on the Search an entity dialog.
Attributions	Outgoing relationship	Relates the campaign to the selected threat-actor(s) on the Search an entity dialog.
Related incidents	Outgoing relationship	Relates the campaign to the selected incident(s) on the Search an entity dialog.
Related TTPs	Outgoing relationship	Relates the campaign to the selected TTP(s) on the Search an entity dialog.
Indicator Related campaigns	Incoming relationship	Relates the selected indicator(s) on the Search an entity dialog to the campaign.
Report Campaigns	Incoming relationship	Relates the selected report(s) on the Search an entity dialog to the campaign.
Threat actor Associated campaigns	Incoming relationship	Relates the selected threat-actor(s) on the Search an entity dialog to the campaign.
Sighting Campaign	Incoming relationship	Relates the selected sighting(s) on the Search an entity dialog to the campaign.

In the Search an entity dialog, click the checkbox(es) to select one or more entities that you can relate to the current one.
You can refine search results by specifying a search string in the filter input field.
Alternatively, click to select one or more quick filter options such as:
- Entity
- Source
- TLP
- Date
- Datasets
Click Select.

Select this option…	… to create this relationship for the sighting
Campaign	Outgoing relationship Relates the sighting to the selected campaign(s) on the Search an entity dialog.
Course of action	Outgoing relationship Relates the sighting to the selected course(s) of action on the Search an entity dialog.
Exploit target	Outgoing relationship Relates the sighting to the selected exploit target(s) on the Search an entity dialog.
Indicator	Outgoing relationship Relates the sighting to the selected indicator(s) on the Search an entity dialog.
Incident	Outgoing relationship Relates the sighting to the selected incident(s) on the Search an entity dialog.
Report	Outgoing relationship Relates the sighting to the selected report(s) on the Search an entity dialog.
Threat actor	Outgoing relationship Relates the sighting to the threat actor(s) on the Search an entity dialog.
TTP	Outgoing relationship Relates the sighting to the selected TTP(s) on the Search an entity dialog.

From the Relationship type, you can select the name of entity relationship you added.
You can also type in your own relationship name in the empty input field.

When you assign a relationship a predefined or a custom name, it is visible in the graph view.

The arrow orientation, either or , indicates that the relationship is either incoming — from the related entity to the current one — or outgoing — from the current entity to the related one.

To remove a relationship type name, go to the relationship type you want to remove, and click .
The relationship type name is removed.
To remove a relationship, go to the row of the relationship you want to remove, and click .
The row and the corresponding relationship are removed.

You cannot undo these actions. They are irreversible.

Add metadata information

In the Estimated observed time field, enter the date when the entity was first observed/detected.
It corresponds to the date and time when the threat was detected, recorded, and reported for the first time.
Usually, Estimated observed time can be either the same as Estimated threat start time, or it can mark a point in time after Estimated threat start time. It can also be after the Estimated threat end time if the threat ended before it was observed.
In the Estimated threat start time field, enter the estimated date the threat activity started, based on observation, reports and other intelligence.
It corresponds to the date and time when the threat was detected, recorded, and reported for the first time as an active/in-progress event.
The Estimated threat start time can be either the same as Estimated observed time, or it can mark a point in time before Estimated observed time.
If the threat is no longer active, go to the Estimated threat end time field, and enter the estimated end time of the threat activity, based on observation, reports, and other intelligence.
Go to the Half life section.

Half-life represents the amount of time it takes for a threat to lose half its intelligence value.
It corresponds to the number of days it takes for the malicious potential of a threat to decay by 50%.

Select the Use default value option to assign the entity the predefined half-life value.
You can assign default half-life values to each entity type in the /etc/eclecticiq/platform_settings.py file.
Integer values represent the number of days.
settings.py (sourced from EIQ platform-backend)

Author	Rutger Prins
Commit	17a58f9f930d83ee862b731813ff472ea3994a37
Timestamp	February, 14, 2022 11:59 AM
Full path	eiq/platform/settings.py
Title	[SNYK] Upgrade packages and ignore issues with no upgrade path
Description	Upgrade packages:<br> `ipython==7.16.0` => `ipython==7.16.3` == no risk <br> `cairosvg==2.4.2`=> `cairosvg==2.5.2` == no risk <br> `jinja2==2.10.1` => `jinja2==2.11.3` == no risk<br> `pillow==7.2.0` => `pillow==8.3.2` == no risk <br> `pygments==2.6.1` => `pygments==2.7.4` == no risk <br> <br> Snyk Ignore: <br> _Removed issues that no longer affect our product._<br> Increase ignore time for following issues:<br> snyk:lic:pip:html2text:GPL-3.0 - can't be applied for 2.9<br> SNYK-PYTHON-PIP-609855 - can't upgrade PIP due to incompatibility with credential escaping<br> SNYK-PYTHON-PIP-1278135 - can't upgrade PIP due to incompatibility with credential escaping<br> SNYK-PYTHON-DATEPARSER-1063229 - no fix available<br> SNYK-PYTHON-CELERY-2314953 - fix can't be apply due to incompatibility with python 3.6<br> SNYK-PYTHON-PILLOW-2329135 - fix can't be apply due to incompatibility with python 3.6<br> SNYK-PYTHON-PILLOW-2331905 - fix can't be apply due to incompatibility with python 3.6<br> SNYK-PYTHON-PILLOW-2331907 - fix can't be apply due to incompatibility with python 3.6<br> SNYK-PYTHON-PILLOW-2331901 - fix can't be apply due to incompatibility with python 3.6<br> SNYK-PYTHON-PILLOW-2397241 - fix can't be apply due to incompatibility with python 3.6<br> SNYK-PYTHON-CRYPTOGRAPHY-1070544 - can't apply fix risk accepted SNYK-PYTHON-PYSAML2-1063038 - can't apply fix risk accepted SNYK-PYTHON-PYSAML2-1063039 - can't apply fix risk accepted See merge request engineering/platform-backend!6465

# Default values
HALF_LIFE = {
    "campaign": 1000,
    "course-of-action": 182,
    "eclecticiq-sighting": 182,
    "exploit-target": 182,
    "incident": 182,
    "indicator": 30,
    "report": 182,
    "threat-actor": 1000,
    "ttp": 720,

Select the Override value option to override the default half-life value for the entity, and to set a custom one.
Enter an integer to represent the number of days it takes the entity to lose half its intelligence value.
In the Tags section, click Add tags to associate one or more tags with the entity .
Tags enable structuring and categorizing entities based on criteria such as confidence and attack stage.
Tags improve findability, and they offer quick reference pointers to place entities in a broader cyber threat context.
Click Source, and select the source of the threat information you are using to create the new entity.
The options available are the names of existing assigned user groups in the Intelligence Center.
Go to the Source reliability section.
Use this option to flag the entity with a predefined reliability value to help other users assess how trustworthy the entity data source is.
Select the Inherit from source option to assign the entity the same reliability value as the corresponding original data source.
Select the Custom override option to override the default source reliability value for the entity, and to set a custom one.
From the drop-down menu select, select an option to flag the entity data source reliability level.
Values in this menu have the same meaning as the first character in the two-character Admiralty System code.
Example: B - Usually reliable

Add information source details

In the Description field, provide context and details to qualify the information source.
For example, enter a job role, or the function of an institution.
In the Identity field, enter the name of the information source.
For example, an individual’s name or the official name of an entity such as an organization or government agency.
From the Roles drop-down menu, select one or more options to define how the information source contributed to the information in the report.
In the References field, enter a URL pointing to relevant reference information on the report, if available.
The field takes only URLs as input. Enter one URL per field.
- To confirm the current input and to display a new input field, press ENTER.
- To remove an input field from this section, click the corresponding .

Define sharing and usage

From the TLP drop-down menu, select the TLP color code you want to use to filter enrichment data.
You can choose to override the TLP color by selecting Not set in the Override TLP drop-down menu.
TLP provides an intuitive reference to assess how sensitive information is, focusing in particular on how serious it is, and whom it should or should not be shared with.
In the Terms of use field, enter any legal notes about fair use of the information about the entity.

Define a workflow

Select the Add to dataset checkbox to include the campaign to one or more existing datasets.
From the drop-down menu select the target datasets you want to add the entity to.
Select the Manually enrich checkbox to manually enrich the entity with the enricher sources you select from the Enrichers to apply drop-down menu.

Save and publish

To store your changes, click Save; to discard them, click Cancel.
To access additional save options, click the down arrow on the Save button:

Click Save draft to store your changes without publishing the entity.
Click Publish to release the new version of the entity that includes your changes.
Click Cancel to discard the changes.

Save a draft

Drafts are available in the entity editor under Draft entities.

Two additional options are available when saving an entity as a draft:

Click Save draft and new if you are creating a new entity and have not saved it before. This option saves the current populated form as a draft without publishing it to the Intelligence Center, and creates and opens a new draft form in the editor.
Click Save draft and duplicate to the current populated form as a draft without publishing it to the Intelligence Center, and create and opens a prepopulated copy of the draft entity in the editor to speed up the creation of a new entity of the same type.

Publish an entity

Published entities are saved to the Intelligence Center.
When the new entity is indexed, it is available in the Intelligence Center, in the entity editor under Published.
Published entities associated with a workspace or included in a dataset are available also through the corresponding workspace and dataset.

Two additional options are available when publishing an entity:

Click Publish and new if you are creating a new entity and you have not published it before. This option saves the current populated form, publishes it to the Intelligence Center, and creates and opens a new form in the editor.
Click Publish and duplicate to save the current populated form, publish it to the Intelligence Center, and create and open a prepopulated copy of the newly published entity in the editor to speed up the creation of a new entity of the same type.