1. Understanding Student ID formats.
By default, Akindi will strip any non-numeric values from the Student IDs. For example, Student ID "ABC1234" will become "1234".
Please contact your Customer Success Manager if you'd like this default behaviour adjusted.
2. Generate Tool Provider Key and Secret Key for Akindi
1. Log into Akindi.
2. Under the 'Administration' Heading on left-hand panel, go to 'LMS Integrations'.
3. Click 'Add LMS Integration'
4. Fill in the form:
LMS Name: Blackboard
Environment: Select Development/Testing or Production environment
LMS URL: Enter your Blackboard instance URL
Copy & Save the 'Tool Provider Key' and 'Tool Provider Secret'
5. Click 'Add LMS Integration'.
3. Setup Global LTI properties
A) Log into Blackboard. Go to System Admin > LTI Tool Providers.
B) Select ManageGlobal Properties.
C) Set the following fields:
Creation of Tool Provider Links: Allow only links to be approved by tool providers
Allow configured tool providers to post grades: Yes
Send User Data: Send user data only over SSL
User Fields to Send: Role in Course; Name; Email Address
Allow Membership Service Access: Yes
D) Click 'Submit'
4. Register Akindi as LTI Provider
A) Go to System Admin > LTI Tool Providers > Register LTI 1.1 Provider
B) Enter the following:
PROVIDER DOMAIN STATUS
Provider Domain: Akindi.com
Provider Domain Status: Approved
Secondary Hostnames: [leave blank]
DEFAULT CONFIGURATION
Default Configuration: Set Globally
Tool Provider Key: [enter key provided by Akindi]
Tool Provider Secret: [secret key provided by Akindi]
Custom Parameters: [copy & paste each line separately]
bb_user_id=@X@user.pk_string@X@
bb_membership_role=@X@membership.role@X@
bb_course_id=@X@course.pk_string@X@
INSTITUTION POLICIES
Send User Data: send user data only over SSL
User Fields to Send: Role in Course; Name; Email Address
Allow Membership Service: Yes
C) Click 'Submit'
5. Manage Akindi Placements
A) Go to System Admin > LTI Tool Providers
B) Click dropdown arrow next to 'Akindi' and select 'Manage Placements'
C) Click 'Create Placement'
D) Enter the following:
Label: Akindi: online and in-person testing
Description: [leave blank]
Handle: Akindi (or ‘Akindi-test’ if this is a test integration)
Availability: Yes
Type: Course tool
Allow Student Access: check
Launch in New Window: leave unchecked
Tool Provider URL: (copy & paste exactly)
https://akindi.com/api/blackboard/launch
Tool Provider Custom Parameters [copy & paste each line separately]
bb_user_id=@X@user.pk_string@X@
bb_membership_role=@X@membership.role@X@
bb_course_id=@X@course.pk_string@X@
E) Click 'Submit'
5. Setup the REST API
A) Under System Admin > REST API Integrations:
B) Click 'Create Integration'
C) Fill in the following
Application ID:
5b58b622-a9dc-4448-aadc-254c418a762aLearn User: administrator
End User Access: Yes
Authorized To Act As User: Yes
D) Click 'Submit'
The integration is now complete! 🎉
Instructors can access Akindi from their Blackboard Ultra Course Shells.