Welcome to Native Authenticator’s documentation!

This is a relatively simple authenticator for small or medium-sized JupyterHub applications. Signup and authentication are implemented as native to JupyterHub without relying on external services.

NativeAuthenticator provides the following features:

• New users can signup on the system;

• New users can be blocked from accessing the system awaiting admin authorization;

• Option of enforcing password security by disallowing common passwords or requiring a minimum password length;

• Option to block users after a set number of failed login attempts;

• Option of open signup without need for initial authorization;

• Option of asking more information about users on signup (e-mail).

• Option of requiring users to agree with given Terms of Service;

• Option of protection against scripting attacks via reCAPTCHA;

• Option for users with an org-internal e-mail address to self-approve via secure link;

Indices and tables

Contents:

• Quickstart
  • Installation
  • Default workflow
  • Adding new users
  • Username restrictions
  • Authorize, un-authorize or discard users
  • Changing your own password
  • Changing a user’s password as admin
• Optional Configuration
  • Password Strength
  • Block users after failed logins
  • Disable SignUp
  • Open SignUp
  • Ask for extra information on SignUp
  • Use reCaptcha to prevent scripted SignUp attacks
  • Allow self-serve approval
  • Mandatory acceptance of Terms of Service before SignUp
  • Import users from FirstUse Authenticator
  • Add two factor authentication obligatory for users
• Errors & Troubleshooting
  • Unable to log in with admin account
  • Internal Server Errors (500) after upgrading to >= 1.0