de.bsvrz.dav.daf.main.config.management
Interface UserAdministration

All Known Implementing Classes:
ConfigurationUserAdministration

public interface UserAdministration

Die Implementation dieses Interfaces erlaubt es, die Benutzer der Kernsoftware zu verwalten. Dies beinhaltet Aktionen wie:

Alle beschriebenen Aktionen setzen dabei die nötigen Rechte des Benutzers voraus, der die Aktion auslöst. Sind die nötigen Rechte nicht vorhanden, so wird die Aktion nicht durchgeführt.

Author:
Kappich Systemberatung

Method Summary
 void changeUserPassword(String orderer, String ordererPassword, String user, String newUserPassword)
          Beauftragt die Konfiguration das Passwort eines Benutzers zu ändern.
 void changeUserRights(String orderer, String ordererPassword, String user, boolean adminRights)
          Beauftragt die Konfiguration die Rechte eines Benutzers zu ändern.
 void createNewUser(String orderer, String ordererPassword, String newUsername, String newUserPid, String newPassword, boolean adminRights, String pidConfigurationArea)
          Beauftragt die Konfiguration ein neues Benutzerkonto anzulegen.
 void createSingleServingPassword(String orderer, String ordererPassword, String username, String singleServingPassword)
          Beauftragt die Konfiguration ein Einmal-Passwort zu erzeugen und es einem Benutzer zu zuordnen.
 

Method Detail

createNewUser

void createNewUser(String orderer,
                   String ordererPassword,
                   String newUsername,
                   String newUserPid,
                   String newPassword,
                   boolean adminRights,
                   String pidConfigurationArea)
                   throws ConfigurationTaskException
Beauftragt die Konfiguration ein neues Benutzerkonto anzulegen. Zu einem Benutzerkonto gehören ein Benutzername, ein Passwort und die Rechte des Benutzers.

Ein neuer Benutzer kann nur durch einen Benutzer angelegt werden, der die Rechte eines Administrators besitzt. Besitzt der Benutzer diese Rechte nicht, wird der Auftrag zur Konfiguration übertragen und dort abgelehnt.

Parameters:
orderer - Benutzername des Auftraggebers.
ordererPassword - Passwort des Auftraggebers.
newUsername - Benutzername des neuen Benutzers.
newUserPid - Pid des neuen Benutzers. Wird der Leerstring ("") übergeben, wird dem Benutzer keine explizite Pid zugewiesen.
newPassword - Passwort des neuen Benutzers.
adminRights - true, wenn der neue Benutzer die Rechte eines Administrators besitzen soll; false, wenn der Benutzer keine speziellen Rechte besitzen soll.
pidConfigurationArea - Pid des Konfigurationsbereichs, in dem der neue Benutzer angelegt werden soll.
Throws:
ConfigurationTaskException - Die Konfiguration kann den Auftrag nicht ausführen, weil die übergebenen Parameter falsch sind. So kann der Auftraggeber zum Beispiel nicht die nötigen Rechte besitzen einen neuen Benutzer anzulegen.

changeUserRights

void changeUserRights(String orderer,
                      String ordererPassword,
                      String user,
                      boolean adminRights)
                      throws ConfigurationTaskException
Beauftragt die Konfiguration die Rechte eines Benutzers zu ändern.

Nur ein Benutzer mit den Rechten eines Administrators darf die Rechte anderer Benutzer ändern. Besitzt ein Benutzer diese Rechte nicht wird der Auftrag an die Konfiguration verschickt und dort von der Konfiguration abgelehnt.

Parameters:
orderer - Auftraggeber, der die Rechte eines Benuters ändern möchte.
ordererPassword - Passwort des Auftraggebers.
user - Benutzer, dessen Rechte geändert werden sollen.
adminRights - true, wenn der Benutzer, der mit user identifiziert wird, die Rechte eines Administrators erhalten soll; false, wenn der Benutzer, der mit user identifiziert wird, keine speziellen Rechte erhalten soll.
Throws:
ConfigurationTaskException - Die Konfiguration kann den Auftrag nicht ausführen, weil die übergebenen Parameter falsch sind. So kann der Auftraggeber zum Beispiel nicht die nötigen Rechte besitzen die Rechte eines anderen Benutzers zu ändern.

changeUserPassword

void changeUserPassword(String orderer,
                        String ordererPassword,
                        String user,
                        String newUserPassword)
                        throws ConfigurationTaskException
Beauftragt die Konfiguration das Passwort eines Benutzers zu ändern. Diese Methode kann von jedem Benutzer aufgerufen werden. Es ist jedem Benutzer gestattet das Passwort seines Benutzerkontos zu ändern. Soll das Passwort eines fremden Benutzerkontos geändert werden, sind die Rechte eines Administrators nötig.

Parameters:
orderer - Benutzername des Auftraggebers
ordererPassword - Derzeit gültiges Passwort, falls der Benutzername orderer und user identisch sind. Sind die Parameter nicht identisch, muss der Benutzer, der mit orderer identifiziert wird, die Rechte eines Administrators besitzen und sein Passwort übergeben
user - Benutzername des Benutzerkontos, dessen Passwort geändert werden soll
newUserPassword - Neues Passwort des Benutzers, der mit user identifiziert wurde
Throws:
ConfigurationTaskException - Die Konfiguration kann den Auftrag nicht ausführen, weil die übergebenen Parameter falsch sind. So kann der Auftraggeber zum Beispiel nicht die nötigen Rechte besitzen das Passwort eines anderen Benutzers zu ändern oder das Passwort zum ändern ist falsch.

createSingleServingPassword

void createSingleServingPassword(String orderer,
                                 String ordererPassword,
                                 String username,
                                 String singleServingPassword)
                                 throws ConfigurationTaskException
Beauftragt die Konfiguration ein Einmal-Passwort zu erzeugen und es einem Benutzer zu zuordnen.

Damit dieser Auftrag ausgeführt werden kann, muss der Auftraggeber orderer die Rechte eines Administrators besitzen. Besitzt der Auftraggeber diese Rechte nicht, wird der Auftrag zwar zur Konfiguration übertragen, dort aber abgelehnt.

Parameters:
orderer - Benutzername des Auftraggebers
ordererPassword - Passwort des Auftraggebers.
username - Benutzername, dem ein Einmal-Passwort hinzugefügt werden soll.
singleServingPassword - Einmal-Passwort das dem Benutzer, der mit username identifiziert wird, hinzugefügt wird.
Throws:
ConfigurationTaskException - Die Konfiguration kann den Auftrag nicht ausführen, weil die übergebenen Parameter falsch sind. So kann der Auftraggeber zum Beispiel nicht die nötigen Rechte besitzen ein Einmal-Passwort anzulegen oder das Passwort existierte bereits, usw..