To install Portflow on your Blackboard instance, follow the steps below.

Installation

I. Add an LTI Tool Provider

1. Navigate to Admin → LTI Tool Providers (under Integrations)

2. Click Register LTI 1.3/Advantage Tool

   

3. Enter the following Client ID:
   🇪🇺 EU Hosting 
   dbf25a94-5d49-495c-a1c5-e64923cdf3ec
   🇦🇺 AU Hosting 
   90a46a52-fd6b-4fe1-aa31-b5f7f5e18dea

4. Click Submit

5. Set the Status to Approved

6. Copy the Default Deployment ID (send it over to Drieam)

   A full overview of all details to be sent to Drieam can be found below step III.

7. Ensure all User Fields to be Sent are checked:

   1. Role in Course

   2. Name

   3. Emaik Address

8. You can set the Allow mark service access to No

9. Ensure Allow Membership Service Access is set to Yes

   

10. Click Submit

II. Add Role and User

1. Navigate to Admin → System Roles (under Users)

2. Click Create Role

   

3. Add a Role name and Role ID, e.g. 'Portflow API Access'

4. Click Submit.

5. Search for the Privilege: Administrator Panel (Users) > Users and enable that privilege.
   All other privileges are not required (and can be removed).

   

6. Navigate to Admin → Users (under Users)

7. Create a new user with the just created role as the Primary System Role

   

8. Share the user sign in details with Drieam

   You SHOULD NOT change the password or delete the user after Drieam has processed the account to authorise access. Changing the password or removing the user will revoke Drieam's API access.

9. Click Submit

III. Add API Integration

1. Navigate to Admin → REST API Integrations (under Integrations)

2. Click Create Integration

   

3. Enter the Application ID, same as the Client ID from step I.3 above
   🇪🇺 EU Hosting 
   dbf25a94-5d49-495c-a1c5-e64923cdf3ec
   🇦🇺 AU Hosting 
   90a46a52-fd6b-4fe1-aa31-b5f7f5e18dea

4. Select the created user from step II (with the assigned System role) for the Learn User

5. Set End User Access to Yes

6. Set Authorised To Act As User to No or Service Default (No)

   

Information to send to Drieam

Please forward the following information to Drieam, for them to complete the installation:

1. Default Deployment ID (from step I.6)

2. Domain and URL of the Blackboard instance where Portflow is installed.

3. Type of installation (e.g. acceptance/testing/production)

4. Sign-in details (username, password, Blackboard sign-in url w/o SSO) of the newly created user with the designated privileges.

5. Default language and optional secondary language(s) (see below)