andreystepanov / intrigue-core

Discover Your Attack Surface

Home Page:https://core.intrigue.io

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Welcome!

Intrigue-core is a framework for external attack surface discovery and automated OSINT. There are a number of use cases:

The frameworks supports a number of OSINT and automation-related use cases:

  • Asset (Application and Infrastructure) Discovery
  • Security Research and Vulnerability Scanning
  • Exploratory OSINT
  • Malware IOC Enrichment
  • General Data Gathering Pipelines

If you'd like assistance getting started or have development-related questions, feel free to join us in the chat.

Users

If you want started quickly and play around, head on over to the Getting Started Guide

Developers

To get started setting up a development environment, follow the instructions below!

Setting up a development environment

Follow the appropriate setup guide:

Now that you have a working environment, browse to the web interface.

Using the web interface

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/

Configuring the system

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.

The API

Intrigue-core is built API-first, allowing all functions in the UI to be automated. The following methods for automation are provided.

API usage via curl

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

API usage via command line (core-cli)

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}

API SDK (Ruby)

A Ruby gem is available for your convenience: Gem Version

About

Discover Your Attack Surface

https://core.intrigue.io

License:BSD 3-Clause "New" or "Revised" License


Languages

Language:JavaScript 48.6%Language:Ruby 46.5%Language:HTML 3.6%Language:Shell 1.1%Language:Python 0.1%Language:CSS 0.1%Language:Dockerfile 0.0%