This article provides a step-by-step guide how to configure and install CirQlive MEETS as an LTI tool in your D2L Brightspace LMS.

MEETS offers the option to set up MEETS using LTI 1.0/1.1 as well as LTI 1.3. Choose the option that fits you best.


1) Configuring the LTI tool for LTI 1.3

2) Configuring the LTI tool for LTI 1.0/1.1



1) LTI 1.3 


When setting up LTI 1.3, you will need to transfer information between Brightspace and MEETS Administration. Open MEETS Administration platform connection settings as well as the Brightspace external tool configuration as described below. 


Step 1: 


In MEETS Administration open the "Platform Connection" tab, and retrieve the platform connection information. Please see:  Creating a MEETS integration instance for your LMS. Choose LTI version 1.3



In the "Installation configuration" window that opens, choose the encryption settings supported by your LMS and approved by your security team. Brightspace is known to support an "Encryption Type" of "Rivest-Shamir-Adleman (RSA)" and "Signing Algorithm" of "RS256". Choose your desired "Key Size", "3072-Bit" is the default, and the option recommended by the US National Security Agency in 2016. After choosing your preferred options, press "Generate".



You will now have the data needed to enter into the Brightspace setup as you can see in the following screenshot.

Keep this window opened as you will need to enter data into it from Brightspace as will be explained below.




Step 2:


In your Brightspace admin panel press on "Manage Extensibility"



Choose LTI advantage>Register Tool



In the Register a Tool page,

Choose "Standard" registration.

Set the tool to "Enabled". 

Give the tool a name.

Enter the corresponding data from the MEETS admin panel as seen above.

In the Extensions section, enable "Deep Linking" and "Names and Role Provisioning Services"

In the Roles section enable "Send Institution Role"

Press "Register".




After Registering the tool, you will get the "Brightspace Registration Details" .

Enter this data into the corresponding fields in the "Installation configuration" window in the MEETS admin panel.



Keep the "Installation configuration" window in the MEETS admin panel opened, as additional configuration will still need to be completed as explained below. 


Step 3:


In the "Brightspace Registration Details" page, press "View Deployments"


Press "New Deployment"



In the "Deploy Tool" page,

Set the tool deployment to "Enabled". 

In the "Extensions" section, assure Deep Linking and Names and Role Provisioning Services is checked.

In the "Security Settings" section, assure the following are checked: Org Unit Information, all User Information (including name, email, user ID, username and org defined ID), and "Classlist including users not known to this deployment". 

In "Configuration Settings", check "Open as External Resource" .

Add the Org Units and press "Create Deployment"




You will now get the Brightspace Deployment ID.

Enter the Deployment ID into the corresponding field in the "Installation configuration" window in the MEETS admin panel. 



Step 4:


In the Brightspace Deployment Details, press "View Links".


Press "New Link"


In the "Create Link" page,

Enable the link, give it a name, enter the Redirect URL from the Installation configuration page in the MEETS admin, from the section of "Information to copy to the LMS" into the URL field in Brightspace.

In the "Type" dropdown, choose "Deep Linking Quicklink".  Choose your preferred dimensions.

Press Save in Brighspace.



Step 5:


Go to the MEETS admin panel to finalize the settings.

In the "Installation configuration" window in the MEETS admin panel, it is more convenient to check the box for "Automatically recheck the LMS Public Key URL for key updates" as it will prevent the platform failing to connect in the event of a change to the key in Brightspace. Please see the comment next to that option.

You can change the settings based on your preferred security preferences. 

Press "Save" or "Save and Close". You can now close the MEETS Installation configuration page.



Step 6:


Back in Brightspace, we are now ready to set up the MEETS LTI platform in the course page.


The ideal setup is to create a link to the MEETS platform on the Navbar.

One can also point to the MEETS platform or deeplink to a unique page or event in MEETS from the activity section as explained below.


To Create a Custom Link for the Navbar, press Insert Quicklink and choose MEETS.

It's recommended to choose "Default Landing Page".

Choose the preferred behavior of the window, and the browser attributes. 

Add this link to the Navbar.

Creating the link as an activity:

Add an activity to a module in the content section. Choose the MEETS platform.

You can select the option for the MEETS platform to open on the main page ("Event Calendar"), a specific MEETS page (such as the appointment booking page, recordings or attendance page), or on a specific event (at which point a window will open with the events to choose from.)  For more information on deeplinking, see the manual.












2) LTI 1.0/1



Step 1. Create an entry for the External Learning Tool on the Admin Settings


When logged in as an administrator, select "External Learning Tools" from the admin tools dropdown on the top right of any page.



Under the "Manage External Learning Tool Links" tab (generally the active tab when the page is first loaded) click the "New Link" button.



For the following section, you will need the URL, Key and Secret provided to you in the MEETS Admin Panel when first setting up a MEETS instance. (to retrieve your LTI credentials, please see: Creating a MEETS integration instance for your LMS)

Alternatively, CirQlive may not have provided you with a MEETS Admin Panel. In this case, you will have received a URL, Key and Secret directly from CirQlive which you can use when following the steps below. 


In the "Properties" section:

  • For "Title" enter "MEETS"
  • For "URL", enter the URL (which you received from the MEETS Admin Panel or directly from CirQlive)
  • Ensure that "Allow users to view this link" is checked



In the "Key/Secret" section:

  • Ensure that "Sign messages with key/secret" is selected
  • Select "Link key/secret"
  • For the "Key", enter the Key (which you received from the MEETS Admin Panel or directly from CirQlive)
  • For the "Secret", enter the Secret (which you received from the MEETS Admin Panel or directly from CirQlive)



In the "Security Settings" section, ensure that the following boxes are checked:

  • Send tool consumer information to tool provider
  • Send context information to tool provider
  • Send user ID to tool provider
  • Send user name to tool provider
  • Send user email to tool provider



Under "Make link available to", click the "Add Org Units" button.



Search for or scroll down to your top-level org unit. This is generally the name of your university. Once you find it, ensure that its checkbox is checked and that the "All descendants" option is selected. After this is done, click "Insert".



The org units display will now show a message indicating that the link will be available to all org units under your top-level unit. Click save.



Once you save, a new entry for MEETS will appear in the External Learning Tools list.




Step 2. Create a custom link for MEETS on the Admin Settings


When logged in as an administrator, select "Navigation & Themes" from the admin tools dropdown on the top right of any page.



Under the "Custom Links" tab, click the "Create Link" button.



Note: for the purpose of this guide, we will use "MEETS" as the name of the LTI tool. You can, however, substitute this name with the name of your choice in the following steps.


For "Name", enter "MEETS".



Ensure that the "Share with child org units" option is checked.



For "URL":

  1. Click on the "Insert Quicklink" button



  1. Select "External Learning Tools" from the popup



  1. Select "MEETS" from the popup (If you gave the tool a different name than "MEETS" in Step 1, then this dropdown will contain that name instead)



  1. There will now be a relative (partial) URL in the URL field



Important: This URL will need to be converted into an absolute (complete) URL. Failing to complete this step will result in MEETS LTI launching incorrectly.

To convert the relative URL to an absolute one, prefix the relative URL with the protocol and domain portion of your Desire2Learn site's URL (http:// or https:// followed by the domain). The easiest way to do this is to simply copy that URL segment from your browser's address bar and paste it into the URL field at the beginning.

For example, if the page you are currently viewing (the one on which this information is being entered) is at "https://d2l.your-university.edu/d2l/lp/navbars/6607/customlink/create", then the portion to copy would be "https://d2l.your-university.edu".
The relative URL in the “input field” will be something similar to: "/d2l/common/dialogs/quickLink/quickLink.d2l?ou={orgUnitId}&type=lti&rcode=17d8147a-7-174&srcou=6607" (the specific numbers and IDs will differ).
The completed URL as prefixed with the protocol and domain should read: "https://d2l.youruniversity.edu/d2l/common/dialogs/quickLink/quickLink.d2l?ou={orgUnitId}&type=lti&rcode=17d8147a-7-174&srcou=6607" (as previously mentioned, with the specific numbers and IDs generated by your system).




  1. Finally, ensure that the "Behavior" dropdown is set to "Same window" (usually selected by default), and click the "Save" button



There will now be an entry for MEETS in the custom links list.



Step 3. Adding MEETS to the Course Default Navbar


On the "Navigation & Themes" page, under the "Navbars" tab, click on the "Course Default" entry to edit it.



On the Navbar Editor page, click "Add Links" for the Navbar section to which you wish to add a MEETS link (for simplicity, we recommend adding it to the bottom right section).



Select MEETS from the popup and click "Add". (If you gave the link a different name than "MEETS" in step 2, this dropdown will contain that name instead)



Once MEETS has been added to the list of Navbar links, it can be dragged to wherever in the Navbar you wish it to appear.




After positioning MEETS as desired, click "Save and Close".



There will now be a link to MEETS appearing in the Navbar of any course page using the default Navbar, giving your users direct, one-click access to the MEETS platform.




Adding MEETS to Non-Default Navbars


If any courses are using Navbars other the default, Step 3 will need to be repeated for each custom Navbar on which you wish to display a MEETS link. (Steps 1 and 2 only need to be done once per site and instance)