Skip to content

noosenergy/noos-jupyter-authenticator

Repository files navigation

CircleCI

Noos JupyterHub Authenticator

Bespoke JupyterHub Authenticator, to enable authentication of Jupyter hub via the Noos platform.

Installation

The python package is available from the PyPi repository,

pip install noos-jupyter-authenticator

Configuration

Edit your jupyterhub_config.py file and add the following to register noos_jupyter_authenticator as a JupyterHub Authenticator class:

c.Authenticator.auto_login = True

c.JupyterHub.authenticator_class = "noos-jwt"

c.NoosJWTAuthenticator.auth_server_url = "http://<hostname>"

⚠️ This Authenticator only works with jupyterhub >= 3.0.0.

Development

Python package manager

On Mac OSX, make sure poetry has been installed and pre-configured,

brew install poetry

Local dev workflows

The development workflows of this project can be managed by noos-invoke, a ready-made CLI for common CI/CD tasks.

$ noosinv
Usage: noosinv [--core-opts] <subcommand> [--subcommand-opts] ...