Bug 41499 - Manual: Handling of UCS@school admins
Manual: Handling of UCS@school admins
Status: CLOSED FIXED
Product: UCS@school
Classification: Unclassified
Component: Documentation
UCS@school 4.1 R2
Other Linux
: P5 normal (vote)
: UCS@school 4.1 R2
Assigned To: Daniel Tröder
Florian Best
http://jenkins.knut.univention.de:808...
: interim-1
Depends on: 41494 41740
Blocks:
  Show dependency treegraph
 
Reported: 2016-06-09 00:05 CEST by Sönke Schwardt-Krummrich
Modified: 2017-05-08 09:43 CEST (History)
2 users (show)

See Also:
What kind of report is it?: Bug Report
What type of bug is this?: 1: Cosmetic issue or missing function but workaround exists
Who will be affected by this bug?: 2: Will only affect a few installed domains
How will those affected feel about the bug?: 1: Nuisance – not a big deal but noticeable
User Pain: 0.011
Enterprise Customer affected?:
School Customer affected?: Yes
ISV affected?:
Waiting Support:
Flags outvoted (downgraded) after PO Review:
Ticket number:
Bug group (optional):
Max CVSS v3 score:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Sönke Schwardt-Krummrich univentionstaff 2016-06-09 00:05:02 CEST
Update chapter on how to create OU admins:
Untested steps:
- create teacher
- open teacher in UDM and edit [options] → add "UCS@school Administrator"
- add teacher to group "admins-${OU}"
- (optional) move user object to cn=admins
→ the object will not show up in UMC modules if objectclass ucsschoolTeacher has 
  been deselected via UDM options

+++ This bug was initially created as a clone of Bug #41494 +++

Currently the UCS@school admins are identified by their object class. But this will not work if a teacher is schooladmin in school A but only normal teacher in school B, C, ...
Comment 1 Sönke Schwardt-Krummrich univentionstaff 2016-06-09 15:18:29 CEST
We should also document invalid combinations of UCS@school UDM options.
Comment 2 Sönke Schwardt-Krummrich univentionstaff 2016-07-06 14:57:30 CEST
Because not clearly stated in original description:
The user will NOT show up ONLY, if the optional step "(optional) move user object to cn=admins" has been performed.
Comment 3 Sönke Schwardt-Krummrich univentionstaff 2016-07-06 15:06:51 CEST
(In reply to Sönke Schwardt-Krummrich from comment #2)
> Because not clearly stated in original description:
> The user will NOT show up ONLY, if the optional step "(optional) move user
> object to cn=admins" has been performed.

This is due to the fallback in current code, that considers object position in LDAP *AND* object class of user objects. → currently intended behaviour.
Comment 4 Daniel Tröder univentionstaff 2016-08-01 10:01:05 CEST
The text regarding creation of admins from teacher accounts was updated.
Text change: 71299
Indentation: 71300

I have not published this yet, as I don't feel confident enough about this section. Waiting for QA to approve.
Comment 5 Florian Best univentionstaff 2016-09-15 15:14:22 CEST
Too much whitespace:
admins- OU (twice)
lehrer- OU (twice)

I am unsure about this:
"""
Damit das Konto nicht mehr in den UCS@school UMC-Modulen aufgelistet wird, muss es noch in einen anderen Container verschoben werden.
"""
→ @Sönke: what is your opinion on this sentence?

I would rephrase the sentence:
"""
Soll das Benutzerkonto des Schuladministrators auch auf den Systemen des Verwaltungsnetzes verfügbar sein, so reicht es nicht aus, die Gruppenmitgliedschaft zu ändern. Es muss manuell ein neues Benutzerkonto über das Univention Management Console-Modul Benutzer auf dem Domänencontroller Master angelegt werden."""
into
"""
Soll das Benutzerkonto des Schuladministrators auch auf den Systemen des Verwaltungsnetzes verfügbar sein, so muss manuell ein neues Benutzerkonto über das Univention Management Console-Modul Benutzer auf dem Domänencontroller Master angelegt werden.
"""" (…?)

@Sönke:
Should we write "OU" or "Schule" ?

"""
Die Benutzerkonten der Schuladministratoren müssen unterhalb der OU der Schule im Container cn=admins,cn=users angelegt werden.
"""
@Sönke: Is this still necessary wiht UCS@school 4.1R2? Why?

Missing whitespace:
(siehe dazu auchAbschnitt 6.2).
Comment 6 Sönke Schwardt-Krummrich univentionstaff 2016-09-22 17:15:20 CEST
(In reply to Florian Best from comment #5)
> I am unsure about this:
> """
> Damit das Konto nicht mehr in den UCS@school UMC-Modulen aufgelistet wird,
> muss es noch in einen anderen Container verschoben werden.
> """
> → @Sönke: what is your opinion on this sentence?

If I'm not wrong, the container cn=admin,cn=users,ou=… is not really used.
In most cases, the user is still a teacher and should be listet. So I would
suggest to delete the sentence without substitution.

> I would rephrase the sentence:
> """
> Soll das Benutzerkonto des Schuladministrators auch auf den Systemen des
> Verwaltungsnetzes verfügbar sein, so reicht es nicht aus, die
> Gruppenmitgliedschaft zu ändern. Es muss manuell ein neues Benutzerkonto
> über das Univention Management Console-Modul Benutzer auf dem
> Domänencontroller Master angelegt werden."""
> into
> """
> Soll das Benutzerkonto des Schuladministrators auch auf den Systemen des
> Verwaltungsnetzes verfügbar sein, so muss manuell ein neues Benutzerkonto
> über das Univention Management Console-Modul Benutzer auf dem
> Domänencontroller Master angelegt werden.
> """" (…?)

Huh? Why this? A School-Admin should be always replicated to educational slave AND administrative slaves (regardless of the LDAP container). Is this not the case?

> @Sönke:
> Should we write "OU" or "Schule" ?

Generally I would prefer "Schule" if not the explicit OU container/subtree is meant.

> """
> Die Benutzerkonten der Schuladministratoren müssen unterhalb der OU der
> Schule im Container cn=admins,cn=users angelegt werden.
> """
> @Sönke: Is this still necessary wiht UCS@school 4.1R2? Why?

I thought, that this is no longer required. Is it?
Comment 7 Daniel Tröder univentionstaff 2016-09-28 08:39:27 CEST
(In reply to Sönke Schwardt-Krummrich from comment #6)
> (In reply to Florian Best from comment #5)
> > I am unsure about this:
> > """
> > Damit das Konto nicht mehr in den UCS@school UMC-Modulen aufgelistet wird,
> > muss es noch in einen anderen Container verschoben werden.
> > """
> > → @Sönke: what is your opinion on this sentence?
> 
> If I'm not wrong, the container cn=admin,cn=users,ou=… is not really used.
> In most cases, the user is still a teacher and should be listet. So I would
> suggest to delete the sentence without substitution.
That means, that users that are _not_ actually teachers will be listed as teachers in the school-users, workgroups, classes and teachers module and in all selection windows when editing workgroups, teachers, classes etc. I think that is confusing.
Furthermore school admins will be able to reset the passwords of those admins, as they are listed in the reset-teacher-passwords module.

The text offers a solution to something that will correctly be seen as a bug. If the users wish to keep the school admin account as teacher, than they will simply not apply this whole section. I'd keep it.

> > I would rephrase the sentence:
> > """
> > Soll das Benutzerkonto des Schuladministrators auch auf den Systemen des
> > Verwaltungsnetzes verfügbar sein, so reicht es nicht aus, die
> > Gruppenmitgliedschaft zu ändern. Es muss manuell ein neues Benutzerkonto
> > über das Univention Management Console-Modul Benutzer auf dem
> > Domänencontroller Master angelegt werden."""dtroeder_76-sch-edu-s
> > into
> > """
> > Soll das Benutzerkonto des Schuladministrators auch auf den Systemen des
> > Verwaltungsnetzes verfügbar sein, so muss manuell ein neues Benutzerkonto
> > über das Univention Management Console-Modul Benutzer auf dem
> > Domänencontroller Master angelegt werden.
> > """" (…?)
> 
> Huh? Why this? A School-Admin should be always replicated to educational
> slave AND administrative slaves (regardless of the LDAP container). Is this
> not the case?
Currently installing a non-edu slave to investigate...

> > """
> > Die Benutzerkonten der Schuladministratoren müssen unterhalb der OU der
> > Schule im Container cn=admins,cn=users angelegt werden.
> > """
> > @Sönke: Is this still necessary wiht UCS@school 4.1R2? Why?
> 
> I thought, that this is no longer required. Is it?
Ah yes - it seems it's no longer needed.
Comment 8 Daniel Tröder univentionstaff 2016-09-28 10:27:00 CEST
(In reply to Sönke Schwardt-Krummrich from comment #6)
> (In reply to Florian Best from comment #5)
> > I am unsure about this:
> > """
> > Damit das Konto nicht mehr in den UCS@school UMC-Modulen aufgelistet wird,
> > muss es noch in einen anderen Container verschoben werden.
> > """
> > → @Sönke: what is your opinion on this sentence?
> 
> If I'm not wrong, the container cn=admin,cn=users,ou=… is not really used.
> In most cases, the user is still a teacher and should be listet. So I would
> suggest to delete the sentence without substitution.
> 
> > I would rephrase the sentence:
> > """
> > Soll das Benutzerkonto des Schuladministrators auch auf den Systemen des
> > Verwaltungsnetzes verfügbar sein, so reicht es nicht aus, die
> > Gruppenmitgliedschaft zu ändern. Es muss manuell ein neues Benutzerkonto
> > über das Univention Management Console-Modul Benutzer auf dem
> > Domänencontroller Master angelegt werden."""
> > into
> > """
> > Soll das Benutzerkonto des Schuladministrators auch auf den Systemen des
> > Verwaltungsnetzes verfügbar sein, so muss manuell ein neues Benutzerkonto
> > über das Univention Management Console-Modul Benutzer auf dem
> > Domänencontroller Master angelegt werden.
> > """" (…?)
> 
> Huh? Why this? A School-Admin should be always replicated to educational
> slave AND administrative slaves (regardless of the LDAP container). Is this
> not the case?
It's not.
They are replicated only when moved to cn=admin,cn=users,ou=…

Even then, when I login to the non-edu-slave with such an admin, he has no UMC-modules and is sent directly to the password-change module. On the edu-slave the school-modules are shown.

When a _new_ user is created as admin (as described in the manual) and I login to the non-edu-slave, *no* module is shown, not even a redirect to the password-change module happens.
Comment 9 Sönke Schwardt-Krummrich univentionstaff 2016-09-28 11:48:31 CEST
(In reply to Daniel Tröder from comment #8)
> > > Soll das Benutzerkonto des Schuladministrators auch auf den Systemen des
> > > Verwaltungsnetzes verfügbar sein, so muss manuell ein neues Benutzerkonto
> > > über das Univention Management Console-Modul Benutzer auf dem
> > > Domänencontroller Master angelegt werden.
> > > """" (…?)
> > 
> > Huh? Why this? A School-Admin should be always replicated to educational
> > slave AND administrative slaves (regardless of the LDAP container). Is this
> > not the case?
> It's not.
> They are replicated only when moved to cn=admin,cn=users,ou=…

Seems to be an ACL problem.
@Florian: can you have a look at it?
 
> Even then, when I login to the non-edu-slave with such an admin, he has no
> UMC-modules and is sent directly to the password-change module. On the
> edu-slave the school-modules are shown.

This is the correct behaviour. On non-edu-slaves there are no special UCS@school UMC modules. So a school admin is merely a "normal UCS user" on a non-edu-slave.
 
> When a _new_ user is created as admin (as described in the manual) and I
> login to the non-edu-slave, *no* module is shown, not even a redirect to the
> password-change module happens.

This depends on group memberships. I would assume that the group memberships between your 2 test school admins differ.
Comment 10 Daniel Tröder univentionstaff 2016-09-30 12:28:38 CEST
r72926: updated manual on handling of school admins
r72927: white space fixes

http://jenkins.knut.univention.de:8080/job/UCSschool%204.1/job/UCSschool%204.1%20R2%20Manual/46/artifact/webroot/
Comment 12 Florian Best univentionstaff 2016-10-13 18:44:47 CEST
OK: the wording is fine now!
Comment 13 Sönke Schwardt-Krummrich univentionstaff 2017-05-08 09:43:13 CEST
Already published.