> ## Documentation Index
> Fetch the complete documentation index at: https://docs.puddin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecting Puddin to Your LMS: LTI 1.3 Setup Overview

> Connect Puddin to your LMS using LTI 1.3 for single sign-on, automatic course and assignment sync, and seamless in-LMS assignment launches.

Puddin integrates with your Learning Management System through LTI 1.3, the current industry standard for secure, interoperable connections between educational tools and LMS platforms. Once connected, your institution gains single sign-on for both teachers and students, automatic course and assignment synchronisation, grade passback where your LMS supports it, and the ability for students to launch Puddin directly from within their existing LMS environment — no separate logins or manual navigation required.

## What LTI 1.3 enables

LTI 1.3 replaces older integration methods with a modern, token-based security model. When you connect Puddin to your LMS via LTI 1.3, you unlock the following capabilities:

<CardGroup cols={2}>
  <Card title="Single Sign-On" icon="arrow-right-to-bracket">
    Teachers and students authenticate through your LMS. No separate Puddin credentials are needed once the integration is live.
  </Card>

  <Card title="Course & Assignment Sync" icon="rotate">
    Courses and assignments created in your LMS are automatically reflected in Puddin, eliminating double entry.
  </Card>

  <Card title="In-LMS Launch" icon="rocket">
    Students open Puddin writing sessions directly from their assignment page in the LMS — the experience feels native to the platform they already use.
  </Card>

  <Card title="Grade Passback" icon="chart-bar">
    Where your LMS supports it, submission status and scores can be passed back to the gradebook automatically.
  </Card>
</CardGroup>

## General setup process

The steps below apply regardless of which LMS you use. Each LMS-specific guide walks you through the same three phases in the context of that platform's interface.

<Steps>
  <Step title="Retrieve your Puddin credentials">
    Sign in to Puddin as an administrator and navigate to **Settings → Integrations**. You will find the following values ready to copy:

    * **Tool URL** — your Puddin instance address
    * **Client ID** — issued per LMS registration
    * **Deployment ID** — identifies this specific deployment
    * **Public Keyset URL** — the JWKS endpoint Puddin exposes for token verification
    * **Access Token URL** — used by the LMS to request OAuth 2 tokens
    * **Authentication Request URL** — the OIDC login initiation endpoint

    <Tip>
      Keep this panel open in a separate browser tab while you complete the registration in your LMS. You will need to copy values between the two screens.
    </Tip>
  </Step>

  <Step title="Register Puddin in your LMS">
    Follow the guide for your LMS below. Each guide walks you through entering the Puddin configuration values into your LMS's external tool or developer key settings.
  </Step>

  <Step title="Test the connection">
    After registration, launch Puddin from a test course in your LMS and confirm that you are signed in automatically, that the correct course context is loaded, and that a test submission appears in the Puddin teacher dashboard.
  </Step>
</Steps>

<Note>
  If your institution uses a hosted (SaaS) LMS, your LMS vendor may need to allowlist Puddin's domain before the connection will work. Contact your LMS support team if the launch URL is blocked.
</Note>

## LMS-specific setup guides

Select your LMS below to follow a detailed, step-by-step configuration guide.

<CardGroup cols={2}>
  <Card title="Moodle" icon="graduation-cap" href="/core/integrations/moodle">
    Configure Puddin as an external LTI tool in Moodle 3.9 or later.
  </Card>

  <Card title="Canvas" icon="palette" href="/core/integrations/canvas">
    Add Puddin via Developer Keys and deploy it to Canvas courses.
  </Card>

  <Card title="Blackboard" icon="chalkboard" href="/core/integrations/blackboard">
    Register Puddin with Blackboard Ultra or Learn and deploy to courses.
  </Card>

  <Card title="Brightspace (D2L)" icon="sun" href="/core/integrations/brightspace">
    Set up Puddin as an LTI Advantage tool in Brightspace and deploy to org units.
  </Card>

  <Card title="Manaba" icon="book-open" href="/core/integrations/manaba">
    Register Puddin as an external tool in the Manaba system settings.
  </Card>
</CardGroup>

## Required configuration values reference

The table below summarises every value you will enter during LMS registration. All values are available from **Settings → Integrations** in your Puddin admin panel.

| Value                      | Description                                                    |
| -------------------------- | -------------------------------------------------------------- |
| Tool URL                   | The base URL of your Puddin instance                           |
| Client ID                  | A unique identifier Puddin generates for each LMS registration |
| Deployment ID              | Identifies the specific deployment within the LMS              |
| Public Keyset URL          | JWKS endpoint for verifying Puddin's signed tokens             |
| Access Token URL           | OAuth 2.0 endpoint for token requests                          |
| Authentication Request URL | OIDC endpoint that initiates the login flow                    |

<Warning>
  Do not share your Client ID or Deployment ID publicly. These values authenticate your LMS to Puddin and should be treated as sensitive configuration data.
</Warning>