• Home
  • Instruction
  • Instruction Settings
  • Digital Learning Applications
  • Additional OneRoster Information

OneRoster Migration Instructions

IMS/1EdTech, the consortium who created and maintains the OneRoster specification, has deprecated OAuth1 for OneRoster connections. Campus supports OAuth 2; not all of our Digital Learning Partners (DLPs) support OAuth 2 yet.


This article provides instructions for migrating DLPs to OAuth 2. General migration instructions are provided first, followed by partner-specific information. Partners receive information in different ways; expand a section below to view more information.


In conjunction with this OAuth change, all Base URLs have been changed. The Base URL is part of the credentials sent to the vendor as part of the configuration process to establish a connection.  


The Digital Learning Applications article provides more information about these connections, including instructions for setting them up.

Timeline

Districts have between now and June 30, 2023 to move their connections from OAuth 1 to OAuth 2, or to share the updated Base URLs with partners.

If a connection is not updated by June 30, 2023, the connection will stop working after that date.

Migration Instructions

All connections need to be updated in some way, whether by generating a new connection with OAuth 2 or sharing a new Base URL:

Current connection uses OneRoster 1.1 with OAuth 1*


Current connection uses OneRoster 1.1 with OAuth 2 
or OneRoster 1.2
  1. Generate a new connection, selecting either OneRoster 1.2, if supported by the partner, or OneRoster 1.1 with OAuth 2. 
  2. Once the new connection is in place, disable the previous connection.

* Most common scenario


  1. Share the updated Base URL with the partner.

All newly-created connections will already use the new Base URL.


This Base URL is updated with the release of Campus.2235. The legacy Base URL for the connection is available in the Legacy Configuration area.

To see the OneRoster and OAuth versions of a connection, click the partner to view their connections. Versions are shown for each connection. Hover over the yellow warning icon for more information about what needs to be updated for the connection.  

The OneRoster and OAuth Versions are listed for each connection. 

Connection Tracker

To keep track needed updates, click the Open Connection Tracker button to view a list of all connections that have been updated. 

  • A connection with a yellow warning icon indicates that that connection uses OAuth 1 and must be replaced.
  • A connection with a clickable checkbox only needs to have its new Base URL shared. Once the URL is shared, mark the checkbox to record the connection as updated. Once the checkbox is marked for a connection, the yellow warning is cleared from the partner's connection list. 

Open the Connection Tracker to see which connections need to be updated.

Partner-Specific Information

D2L

Converge

eDoctrina

GG4L

Google Classroom

Instructure (Kimono and Canvas)

ItsLearning

Naiku

Otus

SchoolCity

Schoology

Teams

Other Vendors