Add JupyterHub as an App on Canvas

The final infrastructure step for this course is to add JupyterHub as an App to your Canvas course shell. Follow the steps below to do this.

Note: If your University typically provides instructors their course shells (as is typically done at UBC) then the University IT/LT team may have to perform the steps outlined below:

  1. In the Setting page, click on “View App Configuration”


    canvas-1

  2. Next, click the blue “+App” button:


    canvas-2

  3. On the Add App page, enter/select the values listed below, and then click the blue “Submit” button:

    • Name (What you would like to call the app, here we call it JupyterHub)

    • Consumer Key (the output from openssl rand -hex 32 that was set as jupyterhub_lti_client_key in ansible/group_vars/hubs/secrets.yml)

    • Shared Secret (the output from openssl rand -hex 32 that was set as jupyterhub_lti_client_secret in ansible/group_vars/hubs/secrets.yml)

    • Launch URL (the Let’s Encrypt compatible domain for the student JupyterHub concatenated with /jupyter/hub/lti/launch)

    • Privacy (set as Public)


    canvas-3

  4. Now JupyterHub should be available as an App to your Canvas course shell. You can test this by trying to create an assignment and under Submission Type, select “External Tool” and click Find:


    canvas-4

  5. You should be able to see the name of the App you just created:


    canvas-5