> ## 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.

# Connect Puddin to Manaba Using LTI 1.3 External Tools

> Register Puddin as an LTI 1.3 external tool in Manaba system settings to enable seamless student login and assignment integration.

Manaba is a learning management system widely used at universities across Japan. Integrating Puddin with Manaba allows students to launch Puddin writing sessions directly from Manaba course pages, signing in automatically through their institutional credentials without needing a separate Puddin account. The integration follows the LTI 1.3 standard, which Manaba supports through its external tool settings.

<Note>
  These instructions assume that your Manaba instance has LTI 1.3 support enabled by your Manaba service administrator. If you are unsure whether LTI 1.3 is available on your instance, contact your Manaba support representative or the vendor (Cyber Campus) before proceeding.
</Note>

## Prerequisites

Before you begin, confirm that you have the following:

* Manaba system administrator (管理者) access
* LTI 1.3 support enabled on your Manaba instance
* Access to the Puddin administrator panel (Settings → Integrations)
* Puddin's LTI 1.3 configuration values ready to copy (see [LTI Setup overview](/core/integrations/lti-setup))

## Setup steps

<Steps>
  <Step title="Open the Puddin Integrations panel">
    Sign in to Puddin as an administrator. Navigate to **Settings → Integrations** and locate the **Manaba / LTI 1.3** section. Keep this tab open throughout the setup — you will copy values from it into Manaba's system settings.

    Note down the following values:

    * Tool URL
    * Client ID
    * Public Keyset URL
    * Access Token URL
    * Authentication Request URL
  </Step>

  <Step title="Sign in to Manaba as a system administrator">
    Open your Manaba administration console and sign in with system administrator credentials. The administration console is typically accessed at a separate URL from the main Manaba interface (for example, `/admin` or as directed by your Manaba contract).
  </Step>

  <Step title="Navigate to external tool settings">
    In the Manaba administration panel, navigate to **System Settings (システム設定) → External Tools (外部ツール)** or the equivalent section for LTI tool registration in your Manaba version.

    If you do not see an external tool or LTI settings section, confirm with your Manaba support representative that LTI 1.3 has been enabled for your instance.
  </Step>

  <Step title="Register Puddin as a new external tool">
    Click **Add new tool (新しいツールを追加)** or the equivalent button. A registration form opens.

    Enter a display name for the tool, such as `Puddin`, so that course instructors can identify it when adding it to their courses.

    Set the **LTI Version** to **LTI 1.3** if prompted to select a version.
  </Step>

  <Step title="Enter the Puddin configuration values">
    Fill in the registration form fields using the values from the Puddin Integrations panel:

    | Manaba field               | Puddin value to paste      |
    | -------------------------- | -------------------------- |
    | Tool URL / Launch URL      | Tool URL                   |
    | Client ID                  | Client ID                  |
    | Public Keyset URL          | Public Keyset URL          |
    | Access Token URL           | Access Token URL           |
    | Authentication Request URL | Authentication Request URL |

    <Tip>
      Field labels in Manaba's administration interface may appear in Japanese. Match each field by its purpose: the launch URL is where students are sent when they open the tool; the keyset URL is for cryptographic verification; the access token and authentication request URLs handle the login flow.
    </Tip>
  </Step>

  <Step title="Configure user data sharing">
    Enable sharing of the following user attributes with the external tool so that Puddin can identify students and link sessions to submissions:

    * **Full name (氏名)**
    * **Email address (メールアドレス)**
    * **Role in course (コース内のロール)**

    These settings are typically found under a **Privacy** or **User Information** section within the tool registration form.
  </Step>

  <Step title="Save and retrieve the platform values">
    Click **Save** to register the tool. Manaba will generate platform-side values, including a **Platform ID** and **Deployment ID**.

    Copy these values into the corresponding fields in the Puddin Integrations panel and click **Save** in Puddin to complete the two-way registration.
  </Step>

  <Step title="Make the tool available to course instructors">
    Depending on your Manaba configuration, you may need to explicitly enable the registered tool for specific courses, faculties, or the entire institution. Navigate to the deployment or availability settings for the Puddin tool and assign it to the appropriate scope.

    Once enabled, course instructors will see Puddin as an available external tool when adding resources or assignments to their course pages.
  </Step>

  <Step title="Test the connection">
    Open a test course in Manaba and add Puddin as an external tool link. Access the link as a student and confirm that:

    * Puddin launches without prompting for a separate login
    * The correct course context is displayed in Puddin
    * A test submission appears in the Puddin teacher dashboard
  </Step>
</Steps>

## Support and localisation

Puddin's interface is available in Japanese. Students and teachers at Japanese universities will see Japanese-language prompts and labels within Puddin when their browser or LMS locale is set to Japanese. If you need to adjust language settings or require Japanese-language support documentation, contact the Puddin support team.

<Warning>
  If your institution uses a custom Manaba configuration managed by an outsourced IT partner, coordinate with that partner when entering system-level settings. Incorrect values in the external tool registration can prevent all LTI launches for the affected tool.
</Warning>

For additional troubleshooting steps, see the [Troubleshooting guide](/core/troubleshooting).