Quick Start Guide¶
Setup on AWS or GCP¶
Security Monkey can run on an Amazon EC2 (AWS) instance or a Google Cloud Platform (GCP) instance (Google Cloud Platform). The only real difference in the installation is the IAM configuration and the bringup of the Virtual Machine that runs Security Monkey.
Security Monkey needs a postgres database. Select one of the following:
Install Security Monkey on your Instance¶
- Setup a local postgres server
- Clone security_monkey
- Compile (or Download) the web UI
- Review the config
Create the logging folders:
sudo mkdir /var/log/security_monkey sudo mkdir /var/www sudo chown -R `whoami`:www-data /var/log/security_monkey/ sudo chown www-data /var/www
Let’s install the tools we need for Security Monkey:
sudo apt-get update sudo apt-get -y install python-pip python-dev python-psycopg2 postgresql postgresql-contrib libpq-dev nginx supervisor git libffi-dev gcc python-virtualenv
If you’re not ready to setup AWS RDS or Cloud SQL, follow these instructions to setup a local postgres DB.
sudo apt-get install postgresql postgresql-contrib
Configure the DB:
sudo -u postgres psql CREATE DATABASE "secmonkey"; CREATE ROLE "securitymonkeyuser" LOGIN PASSWORD 'securitymonkeypassword'; CREATE SCHEMA secmonkey; GRANT Usage, Create ON SCHEMA "secmonkey" TO "securitymonkeyuser"; set timezone TO 'GMT'; select now(); \q
Releases are on the master branch and are updated about every three months. Bleeding edge features are on the develop branch.
cd /usr/local/src sudo git clone --depth 1 --branch develop https://github.com/Netflix/security_monkey.git sudo chown -R `whoami`:www-data /usr/local/src/security_monkey cd security_monkey virtualenv venv source venv/bin/activate pip install --upgrade setuptools pip install --upgrade pip pip install --upgrade urllib3[secure] # to prevent InsecurePlatformWarning pip install google-compute-engine # Only required on GCP python setup.py develop
Compile (or Download) the web UI¶
If you’re using the stable (master) branch, you have the option of downloading the web UI instead of compiling it. Visit the latest release https://github.com/Netflix/security_monkey/releases/latest and download static.tar.gz.
If you’re using the bleeding edge (develop) branch, you will need to compile the web UI by following these instructions:
# Get the Google Linux package signing key. $ curl https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo apt-key add - # Set up the location of the stable repository. cd ~ curl https://storage.googleapis.com/download.dartlang.org/linux/debian/dart_stable.list > dart_stable.list sudo mv dart_stable.list /etc/apt/sources.list.d/dart_stable.list sudo apt-get update sudo apt-get install -y dart # Build the Web UI cd /usr/local/src/security_monkey/dart /usr/lib/dart/bin/pub get /usr/lib/dart/bin/pub build # Copy the compiled Web UI to the appropriate destination sudo mkdir -p /usr/local/src/security_monkey/security_monkey/static/ sudo /bin/cp -R /usr/local/src/security_monkey/dart/build/web/* /usr/local/src/security_monkey/security_monkey/static/ sudo chgrp -R www-data /usr/local/src/security_monkey
Configure the Application¶
Security Monkey ships with a config for this quickstart guide called config.py. You can override this behavior by setting the
SECURITY_MONKEY_SETTINGS environment variable.
FQDN: Add the IP or DNS entry of your instance.
SQLACHEMY_DATABASE_URI: This config assumes that you are using the local db option. If you setup AWS RDS or GCP Cloud SQL as your database, you will need to modify the SQLACHEMY_DATABASE_URI to point to your DB.
SECRET_KEY: Something random.
SECURITY_PASSWORD_SALT: Something random.
For an explanation of the configuration options, see options.
Create the database tables:¶
Security Monkey uses Flask-Migrate (Alembic) to keep database tables up to date. To create the tables, run this command:
cd /usr/local/src/security_monkey/ monkey db upgrade
Populate Security Monkey with Accounts¶
Add Amazon Accounts¶
This will add Amazon owned AWS accounts to security monkey. :
Add Your AWS/GCP Accounts¶
You’ll need to add at least one account before starting the scheduler. It’s easiest to add them from the command line, but it can also be done through the web UI. :
monkey add_account_aws usage: manage.py add_account_aws [-h] -n NAME [--thirdparty] [--active] [--notes NOTES] --id IDENTIFIER [--update-existing] [--canonical_id CANONICAL_ID] [--s3_name S3_NAME] [--role_name ROLE_NAME] monkey add_account_gcp usage: manage.py add_account_gcp [-h] -n NAME [--thirdparty] [--active] [--notes NOTES] --id IDENTIFIER [--update-existing] [--creds_file CREDS_FILE]
Create the first user:¶
Users can be created on the command line or by registering in the web UI:
$ monkey create_user "firstname.lastname@example.org" "Admin" > Password: > Confirm Password:
create_user takes two parameters:
- email address
- role (One of
[View, Comment, Justify, Admin])
Setting up Supervisor¶
Supervisor will auto-start security monkey and will auto-restart security monkey if it crashes.
Copy supervisor config:
chgrp -R www-data /var/log/security_monkey sudo cp /usr/local/src/security_monkey/supervisor/security_monkey.conf /etc/supervisor/conf.d/security_monkey.conf sudo service supervisor restart sudo supervisorctl status
Supervisor will attempt to start two python jobs and make sure they are running. The first job, securitymonkey, is gunicorn, which it launches by calling manage.py
The second job supervisor runs is the scheduler, which polls for changes.
You can track progress by tailing
Create an SSL Certificate¶
For this quickstart guide, we will use a self-signed SSL certificate. In production, you will want to use a certificate that has been signed by a trusted certificate authority.:
$ cd ~
There are some great instructions for generating a certificate on the Ubuntu website:
The last commands you need to run from that tutorial are in the “Installing the Certificate” section:
sudo cp server.crt /etc/ssl/certs sudo cp server.key /etc/ssl/private
Once you have finished the instructions at the link above, and these two files are in your /etc/ssl/certs and /etc/ssl/private, you are ready to move on in this guide.
Security Monkey uses gunicorn to serve up content on its internal 127.0.0.1 address. For better performance, and to offload the work of serving static files, we wrap gunicorn with nginx. Nginx listens on 0.0.0.0 and proxies some connections to gunicorn for processing and serves up static files quickly.
Copy the config file into place:
sudo cp /usr/local/src/security_monkey/nginx/security_monkey.conf /etc/nginx/sites-available/security_monkey.conf sudo ln -s /etc/nginx/sites-available/security_monkey.conf /etc/nginx/sites-enabled/security_monkey.conf sudo rm /etc/nginx/sites-enabled/default sudo service nginx restart
Logging into the UI¶
You should now be able to reach your server