envauth 1.0.1

Authentication based on the ENVAUTH environment variable

Super simple authentication middleware for when you quickly need to password protect something and don’t have the time to implement rigorous authentication. Supports Flask, bottle, Django and generic WSGI servers out of the box.

$ENVAUTH

envauth looks for a JSON object in the ENVAUTH environment variable. The keys are the usernames and the value contains the password for the user.

{"username": "password", "anotheruser": "pass1234"}

Heroku Example

envauth is especially useful if you happen to be running your application on a PAAS!

$ heroku config:set ENVAUTH='{"username": "password", "anotheruser": "pass1234"}'
Setting config vars and restarting application... done, v2

Examples

---

Flask

import envauth

@app.route('/secret-page')
@envauth.flask.requires_auth(realm='You shall not pass!')
def secret_page():
    return render_template('secret_page.html')

Bottle

import envauth

@app.route('/secret-page')
@envauth.bottle.requires_auth(realm='You shall not pass!')
def secret_page():
    return template('secret_page.html')

Django

MIDDLEWARE_CLASSES += ('envauth.django',)

WSGI

import envauth

application = envauth.wsgi(application, realm='You shall not pass!')

Installation

Install envauth with pip:

$ pip install envauth