Skip to content

Drone Usage (Getting data in and out of Lair)

Tom Steele edited this page Oct 13, 2015 · 7 revisions

Drones are how we create, update, and remove data from Lair. Drones communicate over HTTP using a JSON API. Unlike Lair v1, Lair v2 does not communicate directly with MongoDB.

If drones are adhering to the drone specification, they will authenticate using a LAIR_API_SERVER environment variable. This environment variable is setup like so, using your Lair username and password, NOT the database:

LAIR_API_SERVER='http(s)://username:password@host:port'

Example:

$ export LAIR_API_SERVER='https://admin@localhost:secretstuff@192.168.1.2:11013'
$ drone-nmap zsXkdFR98ZXnj7WqP file.xml

SSL Certificate Errors

Drones by specification will validate certificates when connecting over SSL. If you are using a self-signed certificate you should use the -k option to disable this validation.

Drone List

Drones are no longer distributed as a single Python package, instead many of them are now single compiled binaries, and are written in Go. For more information on writing drones, see the drone specification. Below is a list of drones that are ready for use:

Clone this wiki locally