Intrigu Core is an automation framework and orchestration engine for cybersecurity data collection and normalization. While the framework is primarily designed for external attack surface discovery, it has been adopted for a wide variety of use cases such as:
- Asset and Exposure Discovery (Application and Infrastructure)
- Security Research and Vulnerability Scanning
- Exploratory OSINT (People, Systems, Applications, and arbitrary entities)
- Security-Oriented Data Gathering Pipelines
- Threat Data Gathering and Enrichment
- Malware IOC Enrichment
If you'd like assistance getting started or have development-related questions, feel free to join us in slack channel, simply drop a line to hello-at-intrigue.io
To get started quickly and play around with an instance, head on over to the Getting Started Guide. We suggest the Docker image as a first place to start. It's actively built on the master branch of Intrigue Core.
To use the web interface, browse to http://127.0.0.1:7777. Once you're able to connect, you can follow the instructions here: http://core.intrigue.io/up-and-running/
Many tasks work via external APIs and thus require configuration of keys. To set them up, browse to the "Configure" tab and click on the name of the module. You will be taken to the relevant signup page where you can provision an API key. These keys are ultimately stored in the file: config/config.json.
Intrigue-core is built API-first, allowing all functions in the UI to be automated. The following methods for automation are provided.
You can use curl to drive the framework. See the example below:
$ curl -s -X POST -H "Content-Type: application/json" -d '{ "task": "create_entity", "entity": { "type": "DnsRecord", "attributes": { "name": "intrigue.io" } }, "options": {} }' http://127.0.0.1:7777/results
A command line utility has been added for convenience, core-cli.
List all available tasks:
$ bundle exec ./core-cli.rb list
Start a task:
## core-cli.rb start [Project Name] [Task] [Type#Entity] [Depth] [Option1=Value1#...#...] [Handlers] [Strategy Name] [Auto Enrich]
$ bundle exec ./core-cli.rb start new_project create_entity DnsRecord#intrigue.io 3
Got entity: {"type"=>"DnsRecord", "name"=>"intrigue.io", "details"=>{"name"=>"intrigue.io"}}
Task Result: {"result_id":66103}
A Ruby gem is available for your convenience:
To get started setting up a development environment, follow the instructions below!
While you can build a local setup and develop, we'd suggest starting with one of the following setup guides:
- Ubuntu/Debian: https://github.com/intrigueio/intrigue-core/wiki/Setting-up-a-Test-Environment-on-Ubuntu-Linux
- Vagrant: http://core.intrigue.io/getting-started-with-intrigue-core-on-vagrant-virtualbox/
- Docker: https://core.intrigue.io/2017/03/07/using-intrigue-core-with-docker/
You'll probably want to take a look at the following resources:
- Key System Files: https://github.com/intrigueio/intrigue-core/wiki/Understanding-Intrigue-Core%3A-Key-System-Files
Send an email to hello-at-intrigue.io to receive an invite to our private slack community, where you'll be able to interact directly with us.
Intrigue Core would not be possible without hard work, time, and attention from the following contributors: