Setup Instructions

1. Please note, any non-numeric values will be stripped from the student ID. For example, the student id "ABC1234" will become "1234". 

2. Generate Tool Provider Key and Secret Key for Akindi

A. Log into Akindi
B. Under the Administration Heading on left-hand panel, go to LMS Integrations > Add LMS Integration.
C. Fill out: 

LMS Name: Blackboard
Select Development/Testing or Production environment
Input LMS URL
Copy the consumer and secret key
Input App ID and App Key
If required, add Custom Student ID field

3. Setup the LTI provider

A. Go to System Admin > Building Blocks > LTI Tool Provider > ManageGlobal Properties, then set:

Enabled in courses: 'yes'
Send user data: 'Send user data only over SSL'
User fields to send: 'role in course', 'name', and 'email address'

B. Under System Admin > Building Blocks > LTI Providers > Register Provider Domain, enter:

Provider domain: ‘akindi.com'
Default configuration: ‘Set Globally’
Tool provider key, tool provider secret (key provided earlier)
Customer parameters: (copy and paste exactly)

bb_user_id=@X@user.id@X@
bb_membership_role=@X@membership.role@X@
bb_course_id=@X@course.pk_string@X@

Send User Data: ‘send user data only over SSL’
User Fields to Send: ‘role in course’, ‘name’, ‘email address’
Click ‘Submit’

C. Go to System Admin > Building Blocks > LTI Providers. In the drop-down menu beside Akindi’s domain, click Manage Placements > Create Placement, and ender:

Label: ‘Akindi: print and score bubble sheets’
Handle: ‘Akindi’ (or ‘Akindi-test’ if this is a test integration)
Type: Content type, ‘Tools’
Tool Provider URL: https://{yourschool}.akindi.com/api/blackboard/launch
Click ‘Submit’ then ‘Okay’ to the warning about potentially opening a new window

4. Setup the REST API

A. Under System Admin > REST API Integrations:

Click ‘Create Integration’
Application ID: 5b58b622-a9dc-4448-aadc-254c418a762a
Learn User: ‘administrator’
Click ‘Submit’

5. Add Launch Link to Courses:

A. In a course, click Content from the left-hand menu, then go to Tools > Akindi: print and score bubble sheets, and enter:

Name: ‘Launch Akindi’
Click ‘Submit’
Hover over the link to a chess the dropdown menu, then click ‘Adaptive Release’
Membership: select the username of the course instructor(s)
Click ‘Submit

6. Add the Launch Link to Course Sidebar:

A. Click ‘+’ in the top right of the course sidebar, select Add CourseLink, and enter:

Location: select ‘Browse’
Content: select ‘Launch Akindi’
Make sure the name is ‘Launch Akindi’
Click ‘Submit’

Did this answer your question?