How-to: UCS@school - username max length increase in UMC and Kelvin-API

Knowledge Base Community
, , , , ,
#1

How to:

In this short guide, i would like to show you how to set the maximum number of characters when setting usernames and how this is implemented for the UMC and the Kelvin API in UCS@school.

Step 1: Set the UCRV for the UMC

You need to set the following UCRV to increase the max length of the usernames.

ucr info ucsschool/username/max_length
ucsschool/username/max_length: <empty>
Maximum length of usernames. User accounts with usernames above 20 are excluded from the support regarding Samba, Samba4 connector app and Active Directory connector app. 
If Window clients before 8.1 are in use, the maximum username lenght must not exceed 20, 
or logging into them will not be possible. 
Default: 20
 Categories: ucsschool-base
 Default: (not set)
 Type: int

Hint

Please note that 5 characters are required for the exam users, so you should include these in your calculations.

The login name for the classwork account is made up of a fixed prefix (exam- by default) and the normal user name. For example, the classwork account exam-anton123 is created for the user anton123, with which he must log in during the classwork.
10.1. Technische Hintergründe — UCS@school - Handbuch für Administratoren

Example:

ucr set ucsschool/username/max_length=30

This makes it possible to use a user name with 25 characters and with the exam-, it becomes the full 30 characters for a exam.

Step 2: Set the UCRV for the Kelvin-API

The variable for the Kelvin API must be set separately in the container.

  1. univention-app shell ucsschool-kelvin-rest-api
  2. ucr set ucsschool/username/max_length=30
  3. exit
  4. univention-app restart ucsschool-kelvin-rest-api

The reason why the variable must be set separately in the Kelvin API container is the following Bug 52934.

#2
Mastodon