Register the tool in ILIAS

This guide is meant for the administration of the ILIAS installation and for whoever runs NextPad. Both sides need HTTPS. Below, https://nextpad.example.org stands for the NextPad address and https://ilias.example.org for the ILIAS address.

Each kind gets its own tool. Teachers then simply pick NextPad Idea collection, NextPad Quiz or NextPad Pad and have nothing to type.

Steps in ILIAS

ILIAS administration LTI on the tab ILIAS as LTI Consumer. Marked are the tab, the button Add Global Provider for all Users and the entry NextPad Idea collection in the list. — Under “ILIAS as LTI Consumer” one global provider is created per kind.

Open Administration › Extending ILIAS › LTI and choose the tab ILIAS as LTI Consumer.
Choose Add Global Provider for all Users.
Fill in the form as in the table below and save it.
Repeat steps 2 and 3 for the other kinds, each with its own title and its own value for typ.
Open a saved provider again through its title. The hints field now lists the values for NextPad.

The fields

Form of the provider NextPad Idea collection, upper part. Marked and numbered 1 to 8: Title, Availability, Version 1.3, Launch URL, Initiate Login URL, Redirection URI, key type URL and the hints field with Platform ID, Client ID and Deployment ID. — Upper part: NextPad addresses and the hints for NextPad.

Form of the provider, lower part. Marked and numbered 9 to 13: user identification E-Mail Address, user name Entire name, the unticked boxes Use Provider ID and LTI User is always Learner, and the field with the parameter typ=ideen. — Lower part: name and email address, launch options and the parameter.

No.	Field	Value
1	Title	as teachers should read it in the list, for example `NextPad Idea collection`
2	Availability	For Creating Objects
3	LTI Version	Version 1.3
4	Launch URL	`https://nextpad.example.org/lti/launch`
5	Initiate Login URL	`https://nextpad.example.org/lti/login`
6	Redirection URI	`https://nextpad.example.org/lti/launch`
7	Public Key Type	URL (Json Web Token), below it `https://nextpad.example.org/lti/jwks`
8	Hints	appear only after saving; the values belong in the NextPad configuration
9	User identification	E-Mail Address
10	User name	Entire name
11	Use Provider ID	leave unticked
12	LTI User is always Learner	leave unticked
13	Custom Parameters for this specific Provider	`typ=ideen`, for the quiz `typ=quiz`, for the pad `typ=pad`

The parameter values ideen, quiz and pad stay the same in every language. The NextPad mark suits the Icon, “Communication” the Category. Both are optional.

With Use Provider ID all objects of a course would share one collection. With LTI User is always Learner ILIAS would send no roles to NextPad, and nobody could moderate.

Step in NextPad

NextPad only accepts launches from platforms listed in the platform file lti-platforms.json. Each tool gets an entry there with the values from the hints field:

{
  "name": "ilias-ideas",
  "label": "Sign in with ILIAS",
  "issuer": "https://ilias.example.org",
  "client_id": "AbC123xYz456QrS",
  "deployment_ids": ["1"],
  "auth_url": "https://ilias.example.org/ltiauth.php",
  "jwks_url": "https://ilias.example.org/lticerts.php"
}

issuer is the Platform ID, auth_url the Authentication request URL and jwks_url the Public keyset URL. Client ID and Deployment ID differ per tool. The server documentation describes all fields of the file. NextPad must restart after the file changes.

Good to know