Depending on your institution's needs, choose one of the the following tabs for instructions.
Create the ExamSoft Service Account Role/User
- Navigate to your Administrator Panel in Blackboard.
- Select System Roles.
- Select Create Role.
- Add the Role Name and Role ID.
- Example: ExamSoft BB Service Account and ESBBAPI
- Select the Submit button at the bottom of the page. Then, you will see the Privileges page.
- At the bottom of the Privileges page, select the Show all button.
- Select the top-most checkbox to highlight all permissions.
- Then, hover over the Privileges: button and select Restrict Privileges to remove all "baked-in" permissions.
- At the bottom of the Privileges page, select the Show all button again.
- Select the following permission (Use the "Find" command for each):
- Administrator Panel (Courses) > Courses > Edit > Course Properties
- Administrator Panel (Courses) > Courses > Merge
- Administrator Panel (Courses) > Courses > Edit > Enrollments
- Administrator Panel (Courses) > Courses > Edit > Enrollments > Add Enrollment
- Administrator Panel (Users) > Users > Edit > View Course Enrollments
- Administrator Panel (Users) > Users > Edit > View Organization Enrollments
- Administrator Panel (Users) > Users
- Administrator Panel (Users) > Users > View Institution Roles
- Administrator Panel (Users) > System Roles
- Administrator Panel (Organizations) > Organizations > Merge
- Course/Organization Control Panel (Customization) > Properties
- Course/Organization Control Panel (Grade Center) > Full Control
- Hover over the Privileges: button and select Permit Privileges.
- Navigate to the Administrator Panel in Blackboard.
- Select Users.
- Select Create User.
- Add all of the required date under Personal Information and Account Information.
- The user will never need to login, so you can user any input for the username and password values.
- Scroll down to the System Roles section.
- Select the ExamSoft Service Account role you created earlier. Select the small right arrow between the Available Roles and Primary System Role to assign this role to the user account you are creating.
- Select the Submit button.
Register the Turnitin/ExamSoft API in Blackboard
- Navigate to the Administrator Panel in Blackboard.
- Under Integrations, select REST API Integrations.
- Under the REST API Integrations section, select Create Integration .
- Make the following changes:
- Application ID: 907b10a5-fbbe-4811-adbf-8ac3a40a2b34
-
Learn User: Choose your Blackboard Admin account
Note: The permissions on this user account allow the integration to function properly. - End User Access: Yes
- Authorized to Act As User: No
- Select Submit to save the integration.
- The application you added will look similar to this:
The Blackboard portion of this integration is complete. Please follow the steps in Legacy Portal Blackboard API User Guide to configure the ExamSoft integration.