OneRoster Interface

Starting with Relution 26.2, the OneRoster interface is implemented in the portal for users. This interface allows the synchronization of users and classes, for example, from Untis or WebUntis, with Relution. The feature can be found under Settings > User Management > OneRoster.

Setting Up the OneRoster Interface #

General Settings #

1. Provider Name: Enter a unique name for the provider.
2. Activate: Enable the interface by toggling the switch.
3. Host: Enter the URL of the OneRoster server.

Authorization Parameters #

• Token URL: URL for token authentication.
• Client ID: The client ID for authentication.
• Password: The corresponding password.

Use the Check Connection button to test the connection to the OneRoster server.

Synchronization Settings #

Select Organizations #

• Select the OneRoster organizations to be synchronized.
• Use the Synchronization Preview to review the data to be synchronized beforehand.

Synchronize Classes #

• Enable the Synchronize Classes option to import classes from OneRoster.
• Action for Missing Users: Define how to handle users missing in Relution.
• Action for Missing Classes: Specify how to handle classes missing in Relution.

Automatic Synchronization #

• Set up automatic synchronization using Cron Syntax:
  • Minutes: Specify the minute when synchronization should occur.
  • Hours: Define the hour for synchronization.
  • Days of the Month, Months, Weekdays: Adjust the synchronization intervals as needed.

Checking Synchronization #

Once the connection is successfully saved, it can be opened in the overview to check the sync status.

If errors occur during the synchronization process, the cause can be identified here.