JupyterHubGitHubSignUp: Difference between revisions

From CSDMS
m (Minor text edits)
m (Add key demographic)
Line 6: Line 6:
To obtain a login, follow these steps.
To obtain a login, follow these steps.


# You must be a CSDMS member to use this Hub. [[Join_CSDMS| Join CSDMS]] if you're interested in using community software to model earth surface processes.
# You must be a CSDMS member to use this Hub. [[Join_CSDMS| Join CSDMS]] if you're interested in using community software to model earth and planetary surface processes.
# If you don't already have a [https://github.com/ GitHub] account, [https://github.com/signup sign up] for one.
# If you don't already have a [https://github.com/ GitHub] account, [https://github.com/signup sign up] for one.
# [https://github.com/csdms/help-desk/issues/new?assignees=mdpiper&labels=jupyterhub&template=new-csdms-jupyterhub-account.md&title=CSDMS+JupyterHub+account Request authorization] for your account through the CSDMS Help Desk. You should typically hear back in less than a day.
# [https://github.com/csdms/help-desk/issues/new?assignees=mdpiper&labels=jupyterhub&template=new-csdms-jupyterhub-account.md&title=CSDMS+JupyterHub+account Request authorization] for your account through the CSDMS Help Desk. You should typically hear back in less than a day.

Revision as of 09:23, 7 April 2022

GitHub Authentication for the OpenEarthscape JupyterHub

Logins to the jupyter instance of the OpenEarthscape JupyterHub are controlled through GitHub. It takes a little extra work to set this up, but afterward you won't have to remember a username + password to login.

To obtain a login, follow these steps.

  1. You must be a CSDMS member to use this Hub. Join CSDMS if you're interested in using community software to model earth and planetary surface processes.
  2. If you don't already have a GitHub account, sign up for one.
  3. Request authorization for your account through the CSDMS Help Desk. You should typically hear back in less than a day.

Once you're approved, sign in to the Hub.

The first-time login process

The first time you login, you'll be asked to authenticate through GitHub. This can seem a little scary, so here are some screenshots of the process.

First, the login screen for https://jupyter.openearthscape.org. Click the "Sign in with GitHub" button.

Next, you'll be asked to provide your GitHub login credentials. If you've turned on two-factor authentication in GitHub, you'll also be asked to provide a code.

Finally, GitHub will ask you if it's OK to use your credentials to login to the OpenEarthscape JupyterHub.

These steps are only performed once. Afterward, GitHub will automatically log you in to the JupyterHub.