In Canvas, you can create two types of developer keys: LTI keys and API keys. These instructions are for LTI developer keys. Want to create API developer keys? Jump to Canvas API developer keys.

Ally uses LTI to integrate with your Learning Management System (LMS). LTI is a standard developed by IMS Global for secure and seamless integrations.

The standard allows users to access Ally without leaving Canvas. Forget about logging into multiple sites: LTI allows a secure exchange of information that enables a cohesive experience for your users.

There are two versions of LTI: v1.1 and v1.3. Each version requires different configuration steps. The current version is LTI v1.3. The biggest difference from previous versions is the upgraded security model based on OAuth2, OpenID Connect, and JSON Web Tokens.

Ally is moving to LTI 1.3 to take advantage of the upgraded security model.

What does this mean to you? If you are new to Ally, nothing. We do the Ally integration set up with you. But if you already have Ally integrated with your LMS, you’ll need to reconfigure your integration with LTI 1.3.

Reconfigure your Ally integration with LTI 1.3

A typical institution would have these three Ally tools available in the root account:

Each tool has a corresponding LTI developer key and application.

You’ll need to configure each tool following this process:

  1. Create an LTI 1.3 developer key for each tool.
  2. Send the client key ID for each tool to Ally for configuration.
  3. Set up each tool application with the developer key information.
  4. Remove the LTI 1.1 configuration.

    Do this step last for a seamless transition with no interruptions.

Create an LTI developer key for each tool

  1. Go to the root account of the Canvas instance and go to Developer keys.
  2. Select the + Developer Key button and select LTI Key.
    Developer Keys page on a Canvas environment. The + Developer Key button is expanded showing the LTI Key option.
    The Key Settings Configure screen opens.
  3. Select the Method menu and select Paste JSON.
    The Method menu opened with the Paste JSON open highlighted.
  4. Open the URL for the LTI tool you are creating the key for to generate JSON configuration. Replace [AllyEnvironment] with the environment information your institution is hosted in
    • Institution Reporthttps://[AllyEnvironment]/api/v2/auth/lti/1.3/configure/canvas/institution
    • Client Configurationhttps://[AllyEnvironment]/api/v2/auth/lti/1.3/configure/canvas/config
    • Course Accessibility Reporthttps://[AllyEnvironment]/api/v2/auth/lti/1.3/configure/canvas/course
  5. Copy the information on the web page that opens.
  6. Copy and paste this link into the Redirect URIs field. Replace [AllyEnvironment] with the environment information your institution is hosted in
    • https://<AllyEnvironment>/api/v2/auth/lti/1.3/callback
  7. Provide a Key name.

    Include the name of the tool and LTI 1.3 in each. For example: Ally Institution Report LTI 1.3, Ally Course Accessibility Report LTI 1.3, and Ally Client Configuration LTI 1.3.

  8. Select Save. The new key is added to the Developer keys page and is Off by default.
  9. Turn the new key on.
  10. Copy the key ID number and secret in the Details column. This key ID number if your unique client ID.

Ally environment for your region

Use the information for the Ally environment your institution is hosted in.

  • US data center: prod.ally.ac
  • Canadian data center: prod-ca-central-1.ally.ac
  • European data center: prod-eu-central-1.ally.ac
  • Singapore data center: prod-ap-southeast-1.ally.ac
  • Australian data center: prod-ap-southeast-2.ally.ac

Send the key ID to Ally

Go to Behind the Blackboard and create a support case ticket with the developer key for the tool, so the Ally team can configure the tools within the Ally system.

Include this information in the support ticket:

  • Developer Key ID number for the tool
  • Request to set up the LTI 1.3 tool

For example, My Institution Report Developer Key is: #00000000000000000. Please set up my LTI1.3 report.

You can have have separate reports for the different sub accounts on your Canvas environment. Copy the sub account deployment ID and add that information to the support ticket as well.

Set up the tool

Follow these steps for the Institution Report, Client Configuration, and Course Accessibility Report tools.

  1. From the root account select Settings.
  2. Select Apps and View App Configuration.
  3. Select the add an App button.
  4. From the Configuration Type menu select By Client ID.
  5. Paste the client key ID number you gave to the Ally support team into the Client ID field.
  6. Select Submit.
  7. Select Install.

A new link for the tool appears in the left navigation list of links. After Ally configures the tool in the Ally system, you can access the tool from this link.

Update the Canvas theme Ally snippet

After the Ally institution report has been configured with LTI 1.3, update the Ally snippet in the Canvas theme. There needs to be an 'lti13Id' field corresponding to the LTI 1.3 institution report client id (the Ally Tool ID) added.

  1. As a Canvas administrator go to Admin and select Account.
  2. Select Themes.
  3. Point to the active theme and select Open in Theme Editor.
  4. Select the Upload tab.
  5. Update Javascript snippet.

    window.ALLY_CFG = {
     'baseUrl': ...,
     'clientId': ...,
     'lti13Id': ...
    };

  6. Select Apply theme.