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

[Hunt IO] Connector for importing C2 feed into OpenCTI #3033

Merged
merged 2 commits into from
Jan 16, 2025

Conversation

m4r35
Copy link
Contributor

@m4r35 m4r35 commented Nov 26, 2024

Proposed changes

This PR introduces a new connector to integrate Hunt.io’s C2 (Command and Control) feed with OpenCTI. The connector retrieves, processes, and maps threat intelligence data into STIX-compliant objects and relationships to enhance threat visibility in OpenCTI.

Features

  • API Integration: The connector fetches C2 feeds from the Hunt.io API in zip format.
  • Response Handling: The compressed payload is unzipped, and its contents are processed into actionable threat intelligence.
  • STIX Object Creation: Each entity in the feed is mapped to corresponding STIX objects/observables.
  • Concurrency: To efficiently handle the large datasets, the connector spawns up to 4 worker threads, processing entities concurrently to mitigate buffer overflow risks.

Field Mapping

C2 Feed Fields STIX2.1
ip - The IP address associated with the C2 scan IPv4Address observable
port - The port number used in the C2 connection NetworkTraffic object that maps IP to a specific port
hostname - The hostname or domain associated with the C2 scan DomainName observable
timestamp - The timestamp of the scan Used as a timestamp for different objects and observables
scan_uri - The URI of the scan target Indicator with url:value pattern
confidence - The confidence score of the scan result Used as confidence score for different objects and observables
malware_name - The name of the malware detected during the scan Malware object
malware_subsystem - The subsystem of malware detected Used for Malware object to represent a malware type

Relationships

Source Relationship Target
Infrastructure (malware_name) controls Malware (malware_name)
Infrastructure (malware_name) consist-of IPv4Address (ip)
Infrastructure (malware_name) consist-of DomainName (hostname)
Indicator (scan_uri) indicates Malware (malware_name)

Note

Related issues

Checklist

  • I consider the submitted work as finished
  • I tested the code for its functionality using different use cases
  • I added/update the relevant documentation (either on github or on notion)
  • Where necessary I refactored code to improve the overall quality

Further comments

@m4r35 m4r35 force-pushed the hunt-io-connector branch from 1957104 to 85ea3aa Compare November 26, 2024 16:25
@m4r35 m4r35 marked this pull request as ready for review November 26, 2024 17:09
@Jipegien Jipegien added the community use to identify PR from community label Dec 3, 2024
@Jipegien
Copy link
Member

Jipegien commented Dec 3, 2024

@helene-nguyen for your team to review

@romain-filigran romain-filigran added this to the PRs backlog milestone Jan 7, 2025
@helene-nguyen helene-nguyen added partner used to identify PR from patner and removed community use to identify PR from community labels Jan 9, 2025
Copy link
Member

@helene-nguyen helene-nguyen left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@m4r35 Thanks for the contribution !
All commits need to be signed and verified, could you please sign your commits to allow us to merge the PR ?

@m4r35 m4r35 force-pushed the hunt-io-connector branch from 85ea3aa to c3656d4 Compare January 9, 2025 12:48
@helene-nguyen helene-nguyen self-assigned this Jan 9, 2025
Copy link
Member

@helene-nguyen helene-nguyen left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Everything looks great on our end, thanks again for the contribution !

@helene-nguyen helene-nguyen linked an issue Jan 16, 2025 that may be closed by this pull request
@helene-nguyen helene-nguyen merged commit 7324a4b into OpenCTI-Platform:master Jan 16, 2025
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
partner used to identify PR from patner
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[HuntIO] Create the connector
4 participants