These scripts demonstrate how you can integrate your work with the Bit Discovery API.
To run these scripts, you have to have Python 3.6+ installed on your computer and your Bit Discovery API keys for an inventory. (You can get this on your Bit Discovery profile page.) The best way is to save your API key to a variable and reuse it for every script.
APIKEY=eyJh...hUFs
python pdf-report.py $APIKEY
If you need more information about the options of any script, just see the help message:
python pdf-report.py --help
The pdf-report.py
script exports the assets from one or all of your inventories (--multiple
flag), and creates a PDF
file analysis based on the inventory data.
Install the dependencies:
pip install argparse datetime fpdf2 matplotlib pypdf2 requests
Create a pdf report by passing the inventory api key:
python3 pdf-report.py $APIKEY
If you want to create a pdf report for every inventory you own, you can pass the --multiple
flag:
python3 pdf-report.py $APIKEY --multiple
The auto-add-assets.py
script can search your cloud provider, AWS, Google Cloud or Azure (using their respective
command-line tools), and add your running instances to the provided inventory.
For this script you need to have and be signed in to the command-line interfaces of your cloud provider of choice. For AWS, install the AWS CLI, for GCP Cloud the gcloud CLI and for Azure az.
After that, install the Python dependencies:
pip install argparse datetime requests sh
Read your running EC2 instances and buckets from your AWS account:
python3 auto-add-assets.py amazon-ec2 $APIKEY
Similarly for Google Cloud and Azure:
# GCP
python3 auto-add-assets.py google-cloud $APIKEY
# Azure
python3 auto-add-assets.py azure $APIKEY
The delete-ip.py
script deletes one specific IP or source from your inventory.
First, install the Python dependencies:
pip install argparse requests sh
Delete an IP or a source (with its id) from the given inventory:
python3 delete-ip.py ip 1.1.1.1 $APIKEY
python3 delete-ip.py source 13 $APIKEY