Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update cti thehive #1332

Merged
merged 18 commits into from
Nov 24, 2023
Merged
Show file tree
Hide file tree
Changes from 14 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions .idea/documentation.iml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

6 changes: 6 additions & 0 deletions .idea/inspectionProfiles/profiles_settings.xml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

6 changes: 6 additions & 0 deletions .idea/vcs.xml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

108 changes: 80 additions & 28 deletions _shared_content/intelligence_center/integrations/thehive.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,54 +12,107 @@ Collect Sekoia.io CTI feed in an existing Cortex instance self-managed, for any
- An active Sekoia.io licence with access to the CTI
- An access to Sekoia.io User Center with the permissions to create an API key with [CTI permissions](https://docs.sekoia.io/getting_started/Permissions/#cti-permissions)

!!!note
Sekoia Intelligence feed will be available upon Cortex setup

## 1. Connect to Cortex

1- In a Web browser, type the following _http://server_ip:cortex_port_
!!!note
Cortex instance must be activated on your server

1. In a Web browser, type the following _http://server_ip:cortex_port_

2- Enter your login and password of your Cortex instance setup beforehand with `orgadmin` role
2. Enter your login and password of your Cortex instance setup beforehand with `orgadmin` role


## 2. Configuration

#### 1- Setup the Analyzer configuration
### 1. Setup the Analyzer configuration

!!!note
The setup of Analyzers in Cortex will allow to be used in Cortex and in theHive

1. Select your _Organization_ on the top right corner
![Orga_setup_1](/assets/intelligence_center/orga_setup_1.png){: style="width: 60%; max-width: 60%"}

2. Go to _Analyzers Config_ tab and Search `SekoiaIntelligenceCenter`
![Orga_setup_2](/assets/intelligence_center/orga_setup_2.png){: style="width: 60%; max-width: 60%"}

1- Select your _Organization_ on the top right corner
![Orga_setup_1](/assets/intelligence_center/orga_setup_1.png){: style="width: 100%; max-width: 100%"}
3. Edit and Add your Sekoia API key and Base url
![Orga_setup_3](/assets/intelligence_center/orga_setup_3.png){: style="width: 60%; max-width: 60%"}

2- Go to _Analyzers Config_ tab and Search `SekoiaIntelligenceCenter`
![Orga_setup_2](/assets/intelligence_center/orga_setup_2.png){: style="width: 100%; max-width: 100%"}

3- Edit and Add your Sekoia API key and Base url
![Orga_setup_3](/assets/intelligence_center/orga_setup_3.png){: style="width: 100%; max-width: 100%"}

#### 2- Setup the Analyzer
### 2. Enable and Setup the Analyzer

1- Go to _Analyzers_ tab and Search `SekoiaIntelligenceCenter`
![Analyzer_ config_1](/assets/intelligence_center/analyzer_config_1.png){: style="width: 100%; max-width: 100%"}
The configuration setup in the previous section will provide 3 Analyzers to enable and setup:
Men-hau marked this conversation as resolved.
Show resolved Hide resolved

2- Edit and Add your Sekoia API key and Base url
![Analyzer_ config_2](/assets/intelligence_center/analyzer_config_2.png){: style="width: 100%; max-width: 100%"}
- SEKOIAIntelligenceCenter_Indicators_1_0
- SEKOIAIntelligenceCenter_Context_1_0
- SEKOIAIntelligenceCenter_Observables_1_0

#### 3- Check Sekoia intelligence
Here is below one example of setup to be done for the 3 analyzers:

1- Go to job page
1. Go to _Analyzers_ tab and Search `SekoiaIntelligenceCenter`
![Analyzer_ config_1](/assets/intelligence_center/analyzer_config_1.png){: style="width: 60%; max-width: 60%"}

2- Select `SekoiaIntelligenceCenter` in _Analyzers_
![job_1](/assets/intelligence_center/job_1.png){: style="width: 100%; max-width: 100%"}
2. Edit and Add your `Sekoia API key` and `Base url`
![Analyzer_ config_2](/assets/intelligence_center/analyzer_config_2.png){: style="width: 60%; max-width: 60%"}

3- Click on `view` to see details of the job
![job_2](/assets/intelligence_center/job_2.png){: style="width: 100%; max-width: 100%"}

## 3. Troubleshoot
## 3. Sekoia intelligence in Cortex

1- Go to _Analyzers_ tab > Run an analyzer
In the following section, you will find information on how Sekoia intelligence is available in Cortex

2- Check the jobs in _Jobs History_ tab
### Summary of the information

## 4. Other resources
|Artefact|Analyzers|in Cortex|in Sekoia.io|
|--|--|--|--|
|Indicator|SEKOIAIntelligenceCenter_Indicators_1_0 |indicators|Details of an [indicator](../consume/observables.md) or called IOC (Indicator of Compromission). The indicator is found under objects tab of Intelligence page (Dates, Condifidence level, Indicator types, Kill chain, Pattern)|
Men-hau marked this conversation as resolved.
Show resolved Hide resolved
Men-hau marked this conversation as resolved.
Show resolved Hide resolved
|Context|SEKOIAIntelligenceCenter_Context_1_0|context of an indicator|Side details in an indicator (Related threats, Linked Observables, Latest reports, Indicator types, Kill chain)|
|Observable|SEKOIAIntelligenceCenter_Observables_1_0|known observables|[Observable](../consume/observables.md) under observables tab of Intelligence page|

## 4. Steps to retrieve and search Sekoia intelligence

### Search existing Sekoia intelligence in Cortex

1. Select `Data Types`, `Job Type` and `Analyzers`
2. Type your indicator or observable in the Observable search bar (here is an example with `Google`)

![TheHive_searchExisting_SekoiaCTI](/assets/intelligence_center/searchExisting_SekoiaCTI.png){: style="width: 80%; max-width: 80%"}

### Verify a Sekoia feed artefact in Cortex

Here is an example on how to verify if a Sekoia Indicator exist in Cortex and import its content for verification (same process for Context and Observable)

!!!note
- IOC (associated threat) is found on Indicator
- Details of an Indicator (IOC) is found on Indicator
- Observables is found on Observable

1. Go to Sekoia.io connector `Analyzers > SEKOIAIntelligenceCenter_Indicators` and click on button Run (button play symbol in the right side)

![TheHive_Sekoia_connector1](/assets/intelligence_center/search_SekoiaCTI-1_indicators.png){: style="width: 80%; max-width: 80%"}

2. Fill the information with the indicator
![TheHive_Sekoia_connector2a](/assets/intelligence_center/search_SekoiaCTI-2_indicators.png){: style="width: 60%; max-width: 60%"}

3. Check the indicator in _Jobs History_
![TheHive_Sekoia_job](/assets/intelligence_center/search_SekoiaCTI-3_indicators.png){: style="width: 60%; max-width: 60%"}

4. Check the Sekoia indicator
![TheHive_Sekoia_feed1](/assets/intelligence_center/search_SekoiaCTI-4_indicators.png){: style="width: 100%; max-width: 100%"}

5. Check the Indicator in Sekoia Intelligence page
![TheHive_Sekoia_objects](/assets/intelligence_center/searchCTI_Sekoia_objects.png){: style="width: 40%; max-width: 40%"}


## 5. Troubleshoot

1. Make a verification on the artefact, follow steps of `Verify a Sekoia feed artefact in Cortex` (see previous section)

2. Check the jobs in _Jobs History_ tab to see if the observable or the indicator have been retrieved AND

3. Compare this artefact in Sekoia Intelligence Center under the Intelligence page

## 6. Other resources

- **The Cortex official documentation**

Expand All @@ -68,4 +121,3 @@ https://github.com/TheHive-Project/CortexDocs/blob/master/installation/install-g
http://docs.thehive-project.org/cortex/user-guides/first-start/

https://github.com/TheHive-Project/CortexDocs/blob/master/admin/quick-start.md

Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/assets/intelligence_center/analyzer_config_1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/assets/intelligence_center/analyzer_config_2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/assets/intelligence_center/orga_setup_1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/assets/intelligence_center/orga_setup_2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/assets/intelligence_center/orga_setup_3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.