Adding Piazza as an LTI 1.3 Tool in BlackBoard


LTI Guide from BlackBoard


Adding the Piazza LTI tool


In order to add Piazza to your BlackBoard instance, you’ll need to add it in the Developer Portal. This requires Administrator level access in BlackBoard as well as an account in the BlackBoard Developer Portal. 


Go to the BlackBoard Developer Portal (https://developer.blackboard.com/) and log in to your account. 


Click the + button to create a new LTI 1.3 tool.

 

Enter a name, description, and domain for your Piazza tool.

Name: Piazza

Description: Piazza Q&A Tool

Domainprovided by Piazza; school-specific. Please contact integrations@piazza.com to get your school’s domain.


Select “My integration supports LTI 1.3” and fill in the following fields:


Login Initiation URLprovided by Piazza; school-specific. Please contact integrations@piazza.com to get your school’s value

Tool Redirect URL(s): https://piazza.com/lti/connect

Tool JWKS URL: https://credentials.piazza.com/lti/jwk.json


Then click “Register application and generate API key”. Record the resulting values. 


Send the Application ID value to integrations@piazza.com to complete the process. We’ll notify you when the integration has been added.


Please note: In addition to the client ID, we may request the following values in order to complete the integration:


Platform ID     

Authorize Redirect URL     

Public JWK URL or json file

OAuth token URL


Administrators: Make the Piazza Tool available to Instructors


  1. Navigate to System Admin → Integrations → LTI Tool Providers, and click Register LTI 1.3 Tool.

  1. Enter the Client ID (the Application ID from earlier setup) and click Submit.

  1. Verify the following information:

    • Tool Status

    • Tool Status: Approved

    • Tool Provider Custom Parameters

      • blackboard_username=@X@user.id@X@

      • blackboard_course_id=@X@course.pk_string@X@

      • blackboard_user_external_uid=@X@user.batch_uid@X@

      • blackboard_course_external_uid=@X@course.batch_uid@X@

      • blackboard_user_id=@X@user.pk_string@X@


  • Institution Policies 

    • User Fields to Send

      • Role in Course

      • Name

      • Email Address

  • Allow Membership Service Access: Yes

  1. Click Submit.

  2. Locate the tool in the “LTI Tool Providers” list and select “Manage Placements” from the drop down menu next to it. 

  1. Press “Create Placement”. Fill in the Label and Handle with “Piazza” and make sure the type is "Course tool" with "Allow student access" enabled.

  2. For “Tool Provider URL” use the “Redirect URL” provided in step 3.

  3. Press “Submit”.


Managing Link Placements

After you have set Piazza set up as an LTI 1.3 Tool, you can place LTI links into courses. 


Manage Placements 

This will make an LTI link to Piazza available in Course Tools.

  1. Go to the System Admin panel.

  2. Click on LTI Tool Providers and find the Tool/Provider for Piazza

  3. Click the arrow next to the provider domain and click Manage Placements.

  4. Click Create Placement and enter the following:

  • Label: Enter what you would like to have appear in the course

  • Handle: Piazza

  • Availability: Yes

  • Type: 

    • Course tool, student -Select this option if you would like to add the link to the course menu (classic) or would like the tool to be available to students in the books & tools menu (ultra)

    • Course content tool - Select this option if you would like faculty to add the link to their course through the Content section (classic) or Content Market (Ultra)

  • Tool Provider URL: piazza.com

  • Tool Provider Custom Parameters

    • blackboard_username=@X@user.id@X@

    • blackboard_course_id=@X@course.pk_string@X@

    • blackboard_user_external_uid=@X@user.batch_uid@X@

    • blackboard_course_external_uid=@X@course.batch_uid@X@

    • blackboard_user_id=@X@user.pk_string@X@

  1. Click Submit.


Adding Tool Link to the Course Menu (Classic View)

Default Course Menu

This will allow you to add a Link Placement to the default Course Menu. This is your best option if you would like to have the Piazza Tool link available in all courses by default.

  1. In the System Admin panel, click on Course Settings

  2. Select Course Menu and Structures

  3. Click the + on the default Course menu

  4. Select Tool Link and enter the following:

    • Name: Enter what you would like to appear in the Course Menu

    • Type: Select the link placement you created for Piazza

    • Available to Users: Check the box

  5. Click Submit

Course Level Menu

Add a Link Placement to the menu for a specific course.

  1. From within a course, click the + on the top left hand corner of the Course Menu

  2. Click Tool Link and enter the following:

    • Name: Enter what you like to appear in the Course Menu

    • Type: Select the link placement

    • Available to Users: Check the box

  3. Click Submit

Adding Links to a Content Area (Classic View)

Create a Link from a Link Placement

This will allow you to add a Link Placement to a content area in a course. Courses typically have a content area labeled Content available in the Course Menu by default.

  1. From within a course, click Content in the Course Menu

  2. Click on the Build Content drop-down menu and locate the Piazza tool.

  3. Enter the following to create your link:

    • Link Name: Enter what you’d like the link to be called. 

    • Available: Yes

  4. Click Submit


Creating Links (Ultra View)

Creating a Link from a Link Placement

This will allow you to add a Link Placement to an Ultra course.

  1. When in an Ultra course, click the + sign in the area of the course where you would like your link to be and select Content Market.

  2. Locate the Piazza tool you’d like to add and click the plus sign in the bottom right hand corner of the tool panel.

  3. This will add a link to your course. Click the three dots icon next to the link to edit the link title if you would like.

  4. The link will be hidden from students by default. Click the eye icon to make the link available to students.