The ATLAS LTI Tool is currently incompatible with Safari.  We recommend using the LTI with Chrome or Firefox while we work to fix this. We apologize for the inconvenience.

Overview

The LTI Tool allows instructors to embed ATLAS Cases they have curated to Groups directly into D2L.  When students launch the LTI links, they'll be able to view the Case the instructor has selected. There is no need to add students to the ATLAS platform beforehand.


Setting up Course Groups in ATLAS

Before instructors will be able to use the LTI Tool, they will need to create one or more ATLAS Groups where they curate Cases they'd like to add to their Blackboard Courses. If you need more information about setting up Groups, please see our Group Leader Help Articles


Installing the ATLAS LTI in Brightspace


Step 1: Get Your Information In Order. You'll need the following items:


  1. Key/Secret pair obtained from your ATLAS Account Representative
  2. Launch URL obtained from your ATLAS Account Representative


Step 2: Configuring the ATLAS LTI Provider 


  1. Open Course Admin 
  2. Open External Learning Tools





  1. Select Manage Tool Providers
  2. Select New Tool Provider



  1. Open the Credentials.txt file you received from the M.O.S.T. Commons admin 
  2. Copy the Launch URL from the Credentials.txt file and paste it in to the “Launch Point” box
  3. Set Version to 1.1 
  4. Set Oauth Signature Method to HMAC-SHA1
  5. Copy the Secret from the .txt file, and paste into the “Secret” box
  6. Check the “Use Custom Tool Consumer Information” Checkbox, copy the Key from the .txt file, and paste the Key into the Tool Providers Settings



  1. Scroll down to Security Settings. Check all the boxes shown below. *Note: The ATLAS LTI will NOT work if you don’t check all of the boxes shown below. 



Step 3: Configure ATLAS LTI Link


  1. Click Manage External Learning Tool Links 
  2. Click New Link

  1. Add a Title, and Paste in the Launch URL from Credentials.txt file again


  1. Scroll Down to Key/Secret and select “Use Tool consumer key/secret”. This will use the key/secret pair you already set up in your Tool Provider earlier.

  1. Scroll Down to Security Settings and Settings “Use tool provider security settings”



Add an ATLAS Link to a Brightspace Course


Note: In order for the video cases to show up in Brightspace, login to ATLAS, create a group and add cases only to the group. Here is the help article on how to create a group: https://help.atlas.nbpts.org/support/solutions/articles/42000049854-creating-a-group. 

Note: Do NOT add Students to the group, only video cases. Add link to create/group article.

  1. Navigate to the Module where you would like to add an ATLAS Case
  2. Click Add Existing Activities
  3. Click External Learning Tools
  4. Click on the ATLAS in list of available External Learning Tools 



Embed an ATLAS Case

  1. Click on the ATLAS link you've just added to your Course
  2. If prompted, login to your ATLAS account 
  3. Find the case you want to embed and click "Attach LTI Link" 
  4. You are finished! The ATLAS case is now accessible to your students





Trouble Shooting 


Check your Cookie Settings  

  1. Make sure you are allowing third party cookies. We use a cookie to connect your Blackboard session to your ATLAS session. If you don't allow third party cookies, we won't be able to connect your sessions and log you in.  
  2. Make sure atlas.nbpts.org has been added to your allowed sites if you are strict about your cookie settings 

You can refer to the links below for more information about managing cookies in different browsers. If you are unable to manage cookies, you may need to contact your department instructional technology support. 

Manage Cookies in Chrome

Manage Cookies in Firefox

Manage Cookies in Safari

Manage Cookies in IE

Safari Login Issue


The Problem: I am using Safari and I can’t seem to login to the LTI Tool no matter what I do! I’ve even tried changing my password via reset password from email, and it still doesn’t work. 


If you are using Safari 13+ the solution below will not work, due to updates with the way 3rd party cookies are handled.  We recommend using Firefox or Chrome instead. 


If you are using Safari 12 or earlier: 


The Solution: 

  1. Check your cookie settings, and make sure you are allowing third party cookies. If you are strict about your cookie settings, you may need to whitelist atlas.nbpts.org

  2. Close out of the LTI Tool

  3. Open the Homepage in a new tab 

  4. Launch the LTI tool again 


The Reason


Safari does a lot to protect your privacy, and ensure third parties aren’t tracking you without your consent. Because of this, Safari won’t allow third parties to set cookie information, if it looks like you haven’t visited the site recently. This means we can’t set an SSO cookie if you’ve recently cleared your history, are using Safari for the first time, or are using Safari on a new device. Opening the ATLAS Homepage will fix this problem, because it indicates to Safari that ATLAS is a site you use intentionally. Technical details can be found here: https://webkit.org/blog/7675/intelligent-tracking-prevention/