This page will guide you through the process of setting up ProQuest as an External Tool within Canvas. Once completed, your Canvas users will be able to search for ProQuest documents from within Canvas, select them, and embed them directly for viewing within Canvas courses. The advantage of this method is that users will be able to read external documents from ProQuest without leaving Canvas, and users will not be prompted to authenticate.
This process will take approximately 20 minutes. If you experience difficulties or errors during the set up process, please reach out to ProQuest Technical Support
Before you begin, make sure you have the following information at hand:
Your system administrator username and password for Canvas
Your username and password for the ProQuest Administrator Module at https://admin.proquest.com
Log into Canvas with your system administrator username and password.
Select the Admin option on the left side of the screen and select your primary Canvas administrator account from the menu that appears.
Select Developer Keys from the menu on the left side of the screen.
Select the + Developer Key button to add a new Developer Key. Pick + LTI Key from the dropdown menu. This will load a new page with a form titled Key Settings.
On the left column of the Key Settings page, add a value for the Key Name. This can be any name you’d like. Users will not see this name; it is only for your later reference. You can use a name like “ProQuest Key” or similar.
On the left column of the Key Settings page, in the Redirect URIs field, enter https://sso-authenticate.prod.proquest.com/ltiLaunch
Under the Configure heading to the right, use the Method dropdown menu and select Manual Entry (this could be the default selection).
Under Title, enter the name you would like your users to see for this External Tool (e.g. ProQuest Platform). This can be any name you want, but try to choose a name that your users will recognize and understand.
Under Description, enter a description of the database tool you are adding. This can be any description you want. Again, enter a description that is understandable to your users.
In the Target Link URI field, enter https://sso-authenticate.prod.proquest.com/ltiLaunch
In the OpenID Connect Initiation Url field, enter https://sso-authenticate.prod.proquest.com/oidcLogin
Using the JWK Method dropdown menu, select Public JWK URL.
For Public JWK URL enter https://sso-authenticate.prod.proquest.com/.well-known/jwks.json
Open the Additional Settings section. In the Domain field, enter proquest.com
Also within Additional Settings, set a Selection Height and Selection Width to be used for the window that will display the ProQuest session. These are pixel values. You can choose whatever values you want, but we recommend a Selection Height of 700 and a Selection Width of 1000, which will work well for laptop devices.
Under Placements, if there is not already a value added for Link Selection in the dropdown menu, you will need to add one. select Link Selection from the dropdown, a Link Selection section will be added below.
In the same Placements dropdown menu, select and add Assignment Selection and Editor Button. Remove any other placements that you see here. Your Placements menu should now appear like this:
Open the Link Selection section and paste the following URL in the Target Link URI field: https://www.proquest.com/ltiDeepLinkSelect/embedded/$LOGIN_TOKEN
NOTE: This URL will set up access to the ProQuest Platform, which will allow your Canvas users to cross-search across all your subscribed ProQuest databases. While we strongly recommend this option, you can set up access to only a specific database on the ProQuest K-12 platform. To do so, replace the Target Link URL with the desired option below.
|ProQuest Platform||Target Link URL|
ProQuest Platform - all databases
|SIRS Issues Researcher only||https://explore.proquest.com/svc/grapple/ltiDeepLinkCreate/sirsissuesresearcher/embedded/$LOGIN_TOKEN|
|SIRS Discoverer only||https://explore.proquest.com/svc/grapple/ltiDeepLinkCreate/sirsdiscoverer/embedded/$LOGIN_TOKEN|
Under the Select Message Type heading, select the LtiDeepLinkingRequest option. A warning message may appear (“This placement requires Deep Link support by the vendor”). This is expected. You can ignore the message and move on.
Set the Selection Height and Selection Width to the same values selected before. Again, we recommend a Selection Height of 700 and a Selection Width of 1000.
Complete steps 18-20 for the Assignment Selection and Editor Button sections.
In the Editor Button section, add a value of your choosing to the Text field. We recommend something recognizable like “ProQuest Resources”.
In the Icon Url field, add the following URL: https://pq-static-content.prod.proquest.com/lti/PQ-LTI-Icon.png
Select Save at the bottom of the page to create the Developer Key and return to the Developer Keys page.
Set the State of the new Developer Key to ON by clicking the OFF button.
In the Details column, directly above the Show Key button, you will see a Client ID. Copy this Client ID and paste it somewhere you can access, like in a notes file, as it will be used later in the setup process.
If you want to make your ProQuest LTI application available to everyone in your canvas instance, select the Settings option in the left panel (this is within the Admin section). If you prefer to give access to only a specific account or subaccount within your Canvas instance, navigate to that account and access the Settings menu.
Select the Apps tab and click the + App button to add a new App placement.
On the form displayed, select the Configuration Type dropdown menu, and then select By Client ID. The form will change and show only a Client ID field. Paste the Client ID you copied from the Developer Keys page.
Select Submit. A popup will tell you a Tool was found for your Client ID and will ask if you would like to install it. Choose Install. The placement will be added and shown in the List of External Apps.
From the gear dropdown on the External App entry, select the Deployment ID option. A popup will display the Deployment ID for this tool placement. Copy the Deployment ID and paste it in a notes file, as it will be used in the setup on the ProQuest Administrator Module.
If you are installing the ProQuest LTI application for multiple accounts or subaccounts, repeat steps 1-4 for each account/subaccount. Note that installing the app at the parent account will give access to all child subaccounts.
You should now have a notes file with a single Client ID and Deployment ID. You will need these numbers to complete the setup process on the ProQuest Administrator Module as described in Step 3 below. If you are not the administrator for your ProQuest account, you will need to pass this information to your institution’s ProQuest administrator so they can complete the tasks described in Step 3.
Log into the ProQuest Administrator Module (https://admin.proquest.com) with the Account you wish to connect to the External Tool placement created in steps 1 and 2.
Select the Authentication/Access tab on the left panel.
From the Authentication/Access screen, select the LTI tab.
Select the usage group you would like to associate with the LTI usage.
Under Issuer ID enter https://canvas.instructure.com
Under Client ID enter the Client ID you copied in Step 1 above.
Under Deployment ID enter the Deployment ID you recorded in Step 2 above.
Determine the root URL for your Canvas instance. This is the part of your Canvas URL up to but not including the first slash (e.g. https://canvas-lms.schooldomain.edu). Copy this Root URL.
Paste your Root URL into the following three fields: Public Keyset URL, Access Token URL, and Authentication Request URL
In the Public Keyset URL input box, directly after your Root URL in the same field, copy and paste the following: /api/lti/security/jwks
For the Access Token URL input box, directly after your Root URL in the same field, copy and paste the following: /login/oauth2/token
For the Authentication Request URL input box, directly after your Root URL in the same field, copy and paste the following: /api/lti/authorize_redirect
Select the Add credentials button and verify that the entries added in the list above are all correct.
Your Canvas users with course editing permissions are now ready to use the ProQuest External Tool. You can test your configuration and make sure everything is working as expected by following the instructions in the support article below: