Plus Single Tool Setup

Owned by Andrea Schmidt, created
Dec 06, 2023
2 min read

Setting up single tool launch from Plus using samigo

(Tests & Quizzes)

The instructions are for using two different servers to mimic a real-world experience. The tenant is on one server, while the external tool, users and main course are on a different server.

Important: Given the setup instructions below, if the tenant is on the mysql8 server, do not add your users to mysql8. The actual external tool and users need to be added to maria.

Add the tenant (tool launches in iFrame)

  1. As an admin, log intohttps://trunk-mysql8.nightly.sakaiproject.org/portal/

  2. Navigate to Worksite Setup > Administration Workspace

  3. Click on Plus Admin - Sakai Plus Tenants page displays

  4. Click Add Tenant - Tenant: (Draft) displays

  5. Enter/modify the following:

    • Title: give this a title that you will recognize

    • Issuer: add the following URL without the ending '/' https://trunk-maria.nightly.sakaiproject.org

    • Allowed tools: sakai.samigo

    • Trust Email: on by default, leave it as it is

    • Registration Lock: 42

    • Verbose Logging: off by default - turn it on

    • Click Add Tenant - Sakai Plus Tenants page displays with a message “Tenant saved”

  6. Click on the tenant just created - Tenant page displays with config info

  7. Click the Hide/Show link for the LTI Dynamic Registration URL

  8. Copy the URL

Add the tenant (tool launches in new window)

  1. As an admin, log intohttps://trunk-mysql8.nightly.sakaiproject.org/portal/

  2. Navigate to Worksite Setup > Administration Workspace

  3. Click on Plus Admin - Sakai Plus Tenants page displays

  4. Click Add Tenant - Tenant: (Draft) displays

  5. Enter/modify the following:

    • Title: give this a title that you will recognize

    • Issuer: add the following URL without the ending '/' https://trunk-maria.nightly.sakaiproject.org

    • Allowed tools: sakai.samigo

    • Trust Email: on by default, leave it as it is

    • Registration Lock: 42

    • ​New Window Tools: sakai.samigo

    • Verbose Logging: off by default - turn it on

    • Click Add Tenant - Sakai Plus Tenants page displays with a message “Tenant saved”

  6. Click on the tenant just created - Tenant page displays with config info

  7. Click the Hide/Show link for the LTI Dynamic Registration URL

  8. Copy the URL

Add the Plus tool

  1. As an admin, log intohttps://trunk-maria.nightly.sakaiproject.org/

  2. Navigate to Worksite Setup > Administration Workspace

  3. Click on External Tools - External Tools page displays

  4. Click the LTI Dynamic Registration link

  5. Enter a tool title and click Dynamic Registration - External Tool form displays

  6. Click the Use LTI Dynamic Registration button

  7. Enter the URL that you had copied from the mysql8 site where you added the tenant

  8. Click Begin Registration and finish adding the tool

  9. Make sure the following items are set:

    • Allow tool title to be changed: Do not allow

    • Allow launch URL to be changed: Do not allow

    • Launch key should have nothing in it and should not allow changes

    • Launch secret should have nothing in it and should not allow changes

    • Allow the iframe height to be changed

  10. Privacy Settings: both boxes should be set

  11. Services: all should be checked except the last one (Allow External Tool to store setting data)

  12. Scroll down and check the box: The tool URL can receive an LTI Resource Link launch (do not check the box for The tool can receive a Content-Item or Deep-Link launch)

  13. Check the box: Allow the tool to be selected from Lessons

  14. Click Save - External Tools page displays and the tool is listed