Legacy Portal: Set Up Your Canvas Integration

ExamSoft integrates with your Canvas account. A Canvas integration gives you the ability to push courses and students over to the ExamSoft Portal, alleviating the need to manually import them.

Procedures

• Add the ExamSoft App to Canvas
• Add the API
• Find the Access Token

Add the ExamSoft App to Canvas

1. Log in to your Canvas account.
2. Select Admin in the upper left-hand corner. 
3. Select a sub-account.

   

4. Select +  New Course (near the lower right corner) and follow the prompts to create a new course.

   

5. Enter this Name for the new course: ExamSoft

   Note: This course will be used to hold the module to be created later in this guide. Please ensure that this course has two test users and one instructor.

6. Return to the sub-account and select Settings. 
7. Select the Apps tab.

   

8. Select View App Configurations.
9. Select + App.

   

10. On the Add App page, enter this information:
    • Customize the name of the app as it appears in your Canvas portal.
    • In the Launch URL field, enter: https://lmsintegration.examsoft.com/lms/admin.jsp
    • In the Domain field, enter: lmsintegration.examsoft.com
    • Add the Consumer Key and Shared Secret provided by ExamSoft.
    • Set the Privacy to Public.

    

11. Select Submit.

Add the API

1. Navigate to a test course that was previously created
2. Select Modules on the left side.
3. Select + Module (in the top right).

   

4. Enter this Name for the new module: ExamSoft
5. After creating the module, select the gray + button (to the right of the module name) to add a new item.

   

6. Open the drop-down menu, and select to add an External Tool.
7. In the list, select the app that you created, and then select Add Item.

   Note: This will auto-populate the URL from a previous step.

   

8. Select the checkbox to Load in a new tab.
9. Select the new link, and the LMS API will be launched in a new tab. 

   

Find the Access Token

The Access Token is a unique identifier that allows our services to connect with your specific canvas services. We support scoped tokens with custom account roles.

Note: To create a service account or verify your role permissions before generating a token, see:  Canvas: Create Custom Role Permissions for Restricted Token

1. Log in to your Canvas account.
2. Select Admin in the upper left-hand corner.
3. Select Settings.

   

4. Select+ New Access Token (below the list of applications).

   

5. In the New Access Token window, enter these values:
   • In the Purpose field, enter: ExamSoft
   • Leave the expiration field blank.
6. Select Generate Token.

   

7. Select and copy the characters in the Token row, and then paste them into a file where you can find this information later.

   Note: After you close the screen, you will not be able to access the token again. 

   

8. Launch the link in the course module.

Next Steps

Set up the ExamSoft API. See: Legacy Portal: Setup ExamSoft API