snappass 1.2.0

Security

Passwords are encrypted using Fernet symmetric encryption, from the cryptography library. A random unique key is generated for each password, and is never stored; it is rather sent as part of the password link. This means that even if someone has access to the Redis store, the passwords are still safe.

Requirements

• Redis.

• Python 2.6, 2.7 or 3.3+.

Installation

$ pip install snappass
$ snappass
* Running on http://0.0.0.0:5000/
* Restarting with reloader

Configuration

You can configure the following via environment variables.

SECRET_KEY this should be a unique key that’s used to sign key. This should be kept secret. See the Flask Documentation for more information.

DEBUG to run Flask web server in debug mode. See the Flask Documentation for more information.

STATIC_URL this should be the location of your static assets. You might not need to change this.

NO_SSL if you are not using SSL.

REDIS_HOST this should be set by Redis, but you can override it if you want. Defaults to “localhost”

REDIS_PORT is the port redis is serving on, defaults to 6379

SNAPPASS_REDIS_DB is the database that you want to use on this redis server. Defaults to db 0

REDIS_URL is optional and, if set, will be used instead of REDIS_HOST, REDIS_PORT, and SNAPPASS_REDIS_DB to configure the Redis client object. For example: redis://username:password@localhost:6379/0

Docker

Alternatively, you can use Docker and Docker Compose to install and run SnapPass:

$ docker-compose up -d

This will pull all dependencies, i.e. Redis and appropriate Python version (3.6), then start up SnapPass and Redis server. SnapPass server is accessible at: http://localhost:5000