JupyterHub authenticator that uses GH orgs as whitelists
Project description
# sqre-ghowlauth
GitHub Organization WhiteList Authentication
JupyterHub authentication that uses GitHub OAuth2 but additionally checks user org membership against a list defined in the environment variable GITHUB_ORGANIZATION_WHITELIST.
## Installation
sqre-ghowlauth runs on Python 3.3 or greater. You can install it with
`bash pip install sqre-ghowlauth `
This will also install dependencies: jupyterhub and tornado.
## Example usage
Your jupyterhub_config.py file should contain c.JupyterHub.authenticator_class = ‘ghowlauth.GHOWLAuthenticator’ (or you can use LocalGHOWLAuthenticator to handle both local and GitHub auth).
You also must have set the environment variable GITHUB_ORGANIZATION_WHITELIST to be a comma-separated list of organizations whose members you want to permit, e.g. GITHUB_ORGANIZATION_WHITELIST=lsst,lsst-sqre.
The rest of the instructions are the same as those found at https://github.com/jupyterhub/oauthenticator (that is, you still need a callback URL, a client ID, and a client secret).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for sqre_ghowlauth-0.0.7-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1523f6221a43d39e9bfe1f37dc08895fe31424622dc17bbe32c33089c29d3ac8 |
|
MD5 | b614ddc37ef2f937fca9a3397e2bd186 |
|
BLAKE2b-256 | 42fab3006f541f507c63c6115af6280717710b4fe2c28ecb8dcf01d6b0567574 |