Skip to main content

OneRoster Conformance Testing

All systems applying for OneRoster certification for any version must follow the following process:

  • Go to the 1EdTech Conformance Test Suite for OneRoster for either the REST or CSV version of OneRoster. Conformance Test Suite links are below.
  • Follow the onscreen instructions to run the tests
  • Once the test has been successfully run, submit a print out of the test results, complete this form, and send the test results and the completed form to conformance@imsglobal.org
  • 1EdTech will review the results and issue a conformance certification number.

 

Consumers of CSVs:

If you only consume CSV files, the process for testing is as follows:

  • Download the OR v1.1 CSV Reference Set (2021-03-29) or the OR 1.2.1 CSV Reference Test Set (2023-11-12)
  • Import the valid Reference csv files and validate that they import correctly.
  • Log that you have detected problems in the reference tests with known errors.  Logs are to be submitted along with the form linked above. 
  • The provided logs MUST contain information similar to the grid below but DO NOT need to be specifically in that format. Submission of the actual log files created by your system is acceptable as long as the required information is available in those logs. Submissions deemed to be manually created will be rejected and asked to be resubmitted.

 

Test Identifier:         <test zip file name>
Test Date:   Date of test
Status:    Success | Fail
CSV Files Imported: List of CSV files imported successfully
CSV Files Rejected:  List of CSV files not imported
Comment:     

Detailed explanation of why each of the CSV files were rejected.  This must explain the set of detected errors in the CSV file.

Explanation of syntactic and semantic errors is required.

Bug/Issue Reporting

If you encounter any bugs in the certification suites, you can send your issue to or any issues, contact us via the support site.

 


OneRoster 1.2

The conformance systems and test sets to be used for testing OneRoster 1.2.

OneRoster 1.2 Conformance & Certification Guide

OneRoster 1.2 test suites by modality

Mode

Use

URL

CSV Export Test that your csv data sets meet OneRoster 1.2 compliance https://onerostervalidator.imsglobal.org:8443/oneroster-server-cts-webapp/instructions
CSV Import

Reference test set of '.csv' files that should be used to test systems that claim conformance for importing the CSV files. This set of test files includes files with known errors. The zip file includes an '.html' file that contains a detailed list and associated description of the test files.

 

Note: This test set covers release 1.2.1 of the OR 1.2 CSV specification.

OneRoster v1.2.1 (2023-11-12)
REST Service Provider Testing of OneRoster 1.2 Service provider systems for conformance https://validate.imsglobal.org/ORv1p2_CTS_ServiceProvider
REST Service Consumer Testing of OneRoster 1.2 Service consumer systems for conformance  https://certification.imsglobal.org/certification/or12cts/launch.html
Norwegian K12 Profile Service Provider The conformance systems to be used for testing provider implementations of the Norwegian K12/Schools OneRoster 1.2 Profile. https://validate.imsglobal.org/NK12_ORv1p2_CTS_ServiceProvider
Norwegian K12 Profile Service Consumer The conformance systems to be used for testing consumer implementations of the Norwegian K12/Schools OneRoster 1.2 Profile. Under deveolpment.

NOTES

  • The Norwegian Profile defines the use of the OneRoster 1.2 REST API ONLY
  • The current test systems ARE NOT AVAILABLE for formal certification. They are supplied to support early adopters and as such are still subject to further development and testing. If you encounter problems please contact Colin Smythe. 

 


OneRoster 1.1

The conformance systems and test sets to be used for testing OneRoster 1.1.

OneRoster 1.1 Conformance Document

 

OneRoster 1.1 Test Suites by Modality

Mode

Use

URL

CSV Export confirm that your csv data sets meet OneRoster 1.1 compliance https://onerostervalidator.imsglobal.org:8443/oneroster-server-cts-webapp/instructions
CSV Import Reference test set of '.csv' files that should be used to test systems that claim conformance for importing the CSV files. This set of test files includes files with known errors. The zip file includes an '.html' file that contains a detailed list and associated description of the test files. OR 1.1 CSV Reference Test Set (2021-03-29)
REST Service Provider Testing of OneRoster 1.1 Service provider systems for conformance https://validate.imsglobal.org/ORv1p1_CTS_ServiceProvider
REST Service Consumer Testing of OneRoster 1.1 Service consumer systems for conformance  https://onerostervalidator.imsglobal.org:8443/oneroster-client-cts-webapp/index
     

NOTE:

  1. Certification of implementations using OAuth 1.0a/SHA1 is NO LONGER AVAILABLE. The use of OAuth 1.0a/SHA1 for OR 1.1 REST API is PROHIBITED;
  2. Support for OAuth 1.0a/SHA256 is now deprecated. 

 

OneRoster 1.0

NOTE: OneRoster 1.0 Certification is NOT available. Version 1.0 has been deprecated.

Help us improve the accessibility of this site by emailing recommendations to web@imsglobal.org