This configuration uses your current Ally Key, Secret and Client ID. If you don't know it, ask your Blackboard Technical Consultant for it.

Download and install the Building Block

  1. Download the Building Block from GitHub.
  2. Install the Building Block on your Learn environment.

Register new tool

  1. From the Administrator panel select Basic LTI Tools.
  2. Optionally, select System Settings. In the Default Availability menu select Default on.
  3. Select Register New Tool.
    • If you see a warning icon
      after adding the information in the next steps, you can ignore it.
  4. Enter this information:
    • Name: Accessibility Report
    • Description: Blackboard Ally Course Accessibility Report
  5. Use one of these URLs for the Launch URL. Replace "[ClientID]" with your Client ID.
    • Institutions hosted in the US data centre: https://prod.ally.ac/api/v1/[ClientId]/lti/instructor
    • Institutions hosted in the Canadian data centre: https://prod-ca-central-1.ally.ac/api/v1/[ClientId]/lti/instructor
    • Institutions hosted in the European data centre: https://prod-eu-central-1.ally.ac/api/v1/[ClientId]/lti/instructor
    • Institutions hosted in the Singapore data centre: https://prod-ap-southeast-1.ally.ac/api/v1/[ClientId]/lti/instructor
    • Institutions hosted in the Australian data centre: https://prod-ap-southeast-2.ally.ac/api/v1/[ClientId]/lti/instructor
  6. Enter the Consumer Key.
  7. Enter the Shared Secret.
  8. In the Signature method menu select HMAC-SHA1.
  9. Under OTHER SETTINGS, in the Icon file field, add a link to the Ally icon.

    You can save and use this Ally logo.

    Ally icon
  10. Select Submit.

Configure the Accessibility Report LTI tool

  1. From the Basic LTI Tools page, open the menu for the tool you registered.
  2. Select Edit data settings.
  3. Under CONTEXT DATA select the Context ID check box.
  4. Under PERSONAL DATA select these settings:
    • In the User Id menu select Required by tool.
    • In the Value to use for user ID menu select Database Key.
    • Select the User Roles check box.
  5. Under COURSE ROLE MAPPINGS select the INSTRUCTOR check box for both the Instructor and Teaching Assistant role names.
  6. Select Submit.
  7. Open the menu for the tool you registered and select Add as course tool.
  8. Open the menu for the tool you registered and select Enable.

Accessibility Report appears as an option in a course in student Tools. Instructors can hide the link so students don't see it. If you encounter any issues configuring the report, please Submit a case on Behind the Blackboard.