Legacy Portal: Set Up Your D2L Integration

Before You Begin 

What you need:

  • Mozilla Firefox or Google Chrome
  • D2L Administrator Account
  • Note taking software to record values (Notepad, Wordpad, etc.)
  • The Key/Secret provided by your ExamSoft contact.




Complete all of these procedures.


Register the ExamSoft App

  1. Login to D2L.
  2. Select the Gear icon (at the top right), and then select Manage Extensibility.


  3. Select Register an App


  4. Enter this information:
  5. Select the checkboxes to enable the application and to accept the agreement.
  6. Select Register Application (near the lower left corner).


  7. Copy the Application ID and Application Key and paste them into a file so that you can retrieve this information later in these procedures.


  8. Continue to the next procedure.


Create the User Role

  1. Select the Gear.
  2. Under Security, select Roles and Permissions.


  3. Select Create/Copy.
  4. Select the options below.


    • Access
      • Access inactive courses
      • Access past courses
      • Access future courses
    • Sections: Access all course sections
    • Groups: Access all course groups
  5. Select Save to save the new role.
  6. Continue to the next procedure.


Import and Apply the Role Permissions

  1. Use this D2L Permissions File download link to download the permissions file (right-click on the link, and then save the file on your computer). 
  2. Back in the role list, locate the new ExamSoft role that you created.
  3. Scroll down to find the ExamSoft role, select the drop-down arrow, and then select Import Permissions.


  4. Select Choose File, and then browse for the permissions file that you previously downloaded.
  5. Select Next, and then select Next again.
  6. Scroll to the bottom of the Preview screen, and ignore all errors.
  7. Select Import at the bottom left.
  8. Under Security, select Roles and Permissions.


  9. Find Administrator, select the drop-down arrow, and then select Edit Role Permissions.
  10. In each row of the table (Search, Enroll, and Impersonate), select all of the checkboxes to assign full rights to the newly created role.


  11. Select Save and Close.
  12. Continue to the next procedure.


Create the Service User Account

  1. Select the Gear icon, and then select Users (near the top left corner).


  2. Select New User.
  3. Enter a First Name and a Last Name to identify this account. 

    Note: No password is necessary.



  4. Select Save.
  5. Continue to the next procedure.


Impersonate the Service User Account

As a best practice, you'll impersonate the service account so that later, when you authenticate with the API Test Tool, you'll use the service account's credentials rather than using your full administrator account.

  1. Select the Gear icon, and then select Users (near the top left corner).


  2. In the left side, find the new service user account that you created.
  3. Select the drop-down arrow, and then select Impersonate User.


    Your current session will now be impersonating this user.

  4. Continue to the next procedure.


Authenticate with the API Test Tool

  1. Open a new browser tab.
  2. Go to the API Test Tool.
  3. Enter the following values:


    • Host: Enter your D2L instance URL, but omit https://.
    • App ID: Enter the Application ID that you saved earlier in these procedures.
    • App Key: Enter the Application Key that you saved earlier in these procedures.
    • Select Authenticate.

      Selecting Authenticate might produce the following error. The request's 'x_target' value does not match the allowed values for this application. Contact your administrator. 

      If this was the case, it is likely the trusted URL within the app was not properly set to: https://apitesttool.desire2learnvalence.com/index.php

  4. Select Continue when prompted.
  5. Copy the User ID and User Key into the same file where you previously recorded the App ID and App Key.


  6. Stop impersonating ExamSoft Service Account.
  7. Continue to the next procedure.


Add the ExamSoft API as a New External Tool

Add the ExamSoft API as a new External Tool, which will enable the sync list and will trigger courses to sync to the ExamSoft portal.

  1. Navigate to the course that will have the API installed into it.



    • You can use an existing sandbox course or create an ExamSoft course for the tool to live in.
    • Even though this API is installed into a particular course, you can still sync all courses in the instance from within the API.
  2. Select the Content tab.


  3. Select the Add Existing Activities tab, and then select External Learning Tools.


  4. Select Manage External Tools (in the lower right corner).

    Note: It will open in a new tab.


  5. Select New Link.


  6. Enter the New Link settings. 
    • You can enter any Title.
    • For the URL, enter: https://lmsintegration.examsoft.com/lms/admin.jsp
    • Under Visibility, select Allow users to view this link.
    • Under Key/Secret, select the checkbox for Sign messages with key/secret with.
    • Enter the Key and the Secret that were provided by your ExamSoft Contact.
    • Under Security Settings, select Use link security settings and all of the checkboxes below it.

      Note: The selected course is automatically displayed under Make link available to.


  7. Select Save and Close.
  8. Navigate back to the External Tools list.
  9. Select the new tool that you created to add it to the Contents tab of the course.


  10. Select the down arrow for the ExamSoft module that you created (a), and then select Edit Properties In-place (b).


  11. Select the Open as External Resource checkbox.


  12. Select the tool within the Contents section to launch the ExamSoft API.



Next Steps

Configure the ExamSoft API. See: Legacy Portal: Setup ExamSoft API

Was this article helpful?
1 out of 1 found this helpful

Articles in this section