Configuration reference#

This section describes the available configuration options for the various classes of the plugin. Configuration is defined via traitlets of the classes and values are specified either in the jupyterhub_config.py or by some other means depending on the JupyterHub deployment (e.g. the JupyterHub helm chart). For example, to set the config_title property of the LTI11Authenticator class, your jupyterhub_config.py file would contain the lines

c.JupyterHub.authenticator_class = "ltiauthenticator.lti11.auth.LTI11Authenticator"
c.LTI11Authenticator.config_title = "Some Title"

or your helm chart config.yml would contain

hub:
  config:
    JupyterHub:
      authenticator_class: ltiauthenticator.lti11.auth.LTI11Authenticator
    LTI11Authenticator:
      config_title: "Some Title"

LTI11Authenticator#

Property

Required

Description

Default

config_description

No

The LTI 1.1 external tool description

JupyterHub LTI 1.1 external tool

config_icon

No

The http/s URL with the LTI 1.1 icon

nil

config_title

No

The LTI 1.1 external tool Title

JupyterHub

consumers

Yes

The key/value pair that represents the client key and shared secret

{}

username_key

No

The LTI 1.1 launch parameter that contains the JupyterHub username value

canvas_custom_user_id

uri_scheme

No

Scheme to use for endpoint URLs offered by this authenticator. Possible values are "auto" (default), "https" and "http". When "auto" is chosen the scheme is inferred from the incomming request’s header. Since this may lead to unreliable results in some deployment scenarios (in particular when several different versions of forwarded headers are mixed), manually specifying it here is kept as an escape hatch.

"auto"