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
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
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:
- 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;
- 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.