LTI settings reference

Every control on the RaeNotes Integrations page and in the Add / Edit LTI Platform dialog: what it means, whether it is required, and where the value comes from.

Integrations page — RaeNotes URLs

These three values describe RaeNotes to your LMS. They are identical for every platform you register, and each has a copy button next to it.

Field Value Meaning
Login URL https://app.raenotes.com/lti/login Where the LMS starts the OpenID Connect login handshake. LMSes call this the Initiate login URL or Authorization (Login) URL.
Redirect URL https://app.raenotes.com/lti/launch Where the signed launch is delivered. It is both the tool's Launch URL and the only allowed Redirection URI.
JWKS URL https://app.raenotes.com/lti/jwks RaeNotes' public keyset, used by the LMS to verify messages signed by RaeNotes. Keys rotate, so always register the URL — never a copied key.

Registered platforms

Each registered platform is listed with its issuer (first line) and client ID (second line), plus three controls.

Control What it does
Enabled / Disabled Turns the registration on and off. A disabled platform rejects LTI launches and webhook deliveries. Reversible at any time — use it to pause an integration instead of deleting it.
Edit (pencil) Reopens the dialog with the saved values. The Team dropdown is disabled; the LearnWorlds Webhook URL is visible only here.
Delete (trash) Removes the registration after a confirmation prompt. You can register the same issuer, client ID and deployment ID again afterwards, but it counts as a new platform and gets a new webhook URL.

Dialog: LTI Configuration

These fields identify your LMS to RaeNotes. Every value is produced by the LMS when you register RaeNotes as an external tool — copy them, don't invent them.

Field Required Meaning and where to find it
Issuer Yes The unique identifier of the LMS, always a URL. Moodle calls it Platform ID (e.g. https://your.moodle.site); LearnWorlds uses a per-school URL such as https://your-school.com/admin/api/lti/<school-id>.
Client ID Yes The ID the LMS assigned to the RaeNotes tool registration. Together with the issuer it identifies this integration.
Deployment ID No Identifies one particular deployment of the tool inside the LMS. Fill it in if your LMS issues one (Moodle and LearnWorlds both do); leave empty otherwise.
Authentication request URL Yes The LMS endpoint RaeNotes redirects to during the login handshake. Moodle: …/mod/lti/auth.php.
Access token URL Yes The LMS OAuth 2.0 token endpoint. RaeNotes uses it to obtain the token needed to post grades back. Moodle: …/mod/lti/token.php.
Key Set URL Yes The LMS public keyset, used by RaeNotes to verify that a launch really came from your LMS. Moodle: …/mod/lti/certs.php.

Dialog: Team

Field Meaning
Team The RaeNotes team every student who launches from this LMS joins. Only teams you administer are listed. Fixed after creation — the dropdown is disabled when editing.
Existing RaeNotes accounts not in the team What to do when a launch's email matches a RaeNotes account that is not a member of the selected team:
  • Forbid login (default) — the launch is rejected. The secure choice: nobody gets silently attached to an account they already own.
  • Create a separate account — a new, LMS-bound account is provisioned and the original account is left untouched.

Dialog: Integration Workflow

Option Meaning
Upload only The student uploads a recording; the LMS shows Completed once processing finishes. No review is created and no instructor is involved. The instructor-email fields are hidden.
Self-assessment with supervisor feedback (default) Upload → processing → a review is created automatically with the student as Required reviewer and the instructor as Supervisor → the grade is posted back as each of them submits.

Instructor email fields (self-assessment only)

Field Meaning
Instructor email property The name of the field that carries the instructor's email — not the email itself. Default instructor_email. It must match exactly what the LMS sends: the custom parameter name for Moodle, or the property name in the webhook payload for LearnWorlds.
Instructor email source Where RaeNotes looks for that field:
  • LTI launch custom parameter (default) — the email travels inside the launch itself. Use for Moodle and any LMS supporting LTI custom parameters.
  • LearnWorlds webhook integration — the email arrives separately over a webhook, because LearnWorlds cannot put custom data into launches.
Webhook URL
(read-only, edit mode only)
The address the LearnWorlds automation posts to, e.g. https://app.raenotes.com/lti/webhook/<token>. Generated when the platform is saved, which is why it is absent while you are still adding the platform: save first, then reopen the dialog to copy it. Stable across edits; only deleting and re-registering the platform changes it.
LearnWorlds signature token The shared secret LearnWorlds signs deliveries with, found in LearnWorlds under Settings → Developers → Webhooks. RaeNotes rejects every delivery until the stored token matches, so the integration is safe but inert while this is empty.

Which fields are mandatory

Add / Save stays disabled until Team, Issuer, Client ID, Authentication request URL, Access token URL and Key Set URL are filled in. Deployment ID and everything else is optional or has a default.

Note. If the LMS is disabled or the platform is deleted, launches stop working immediately, but recordings, transcripts and reviews already in RaeNotes are unaffected — they stay in the team.

Any questions? Contact us