de.ipcon.db.core

Class SyncServiceTools

java.lang.Object

de.ipcon.db.core.SyncServiceTools

public class SyncServiceTools
extends java.lang.Object

This class exists basically for build reasons, actually the stuff in here should rather be in db/SyncService but BN.nrx (which is build earlier) also needs this code (and I think it does not belong in BN.nrx). Comment originally from BN.nrx: Wir erstellen eine .init-syncaccount-Datei, eine kleine XML-Datei mit folgendem Inhalt: Ein Root-Element mit Namen NodeAccount mit drei Attributen: - nodeId: Das ist die ID des BNs - accountName: Das ist der Name des zugewiesenen Accounts - accountPass: Das Passwort fuer den Account. Das Problem ist, dass es nur eine Anmeldemoeglichkeit gibt: Man muss das richtige Passwort im Klartext auf der Client-Seite eingeben, dieses wird dann ueber den uebergebenen Public-Key des Server verschluesselt und auf Serverseite wieder entschluesselt, dann in den konfigurierten Hash-Algorithmus gesteckt und mit dem gespeicherten Hash verglichen. Wir kriegen aber aus dem gepeicherten Hash kein Klartextpasswort raus, und mit dem verhashten Passwort koennen wir uns nicht anmelden (waere ja auch nicht sicher...). Einzige Moeglichkeit ist, das Passwort automatisch zu erstellen und gleich am Account zu setzen und die zugehoerige Datei dabei zu erzeugen. Genau das machen wir hier. Das Passwort darf nur nicht unverschluesselt in der Datei stehen, deshalb muessen wir es mit einem symmetrischen Schluessel vorbereiten, der das Passwort verschluesselt. Es gibt einen Trick, der hier weiterhilft: Der Server liefert uns waehrend der Verbindung seinen (statischen) Serverkey. Den koennen wir benutzen, um das Passwort vorab schon zu kodieren. Wir koennen sozusagen die Line-Crypt schon vorwegnehmen. Das kriegt nur der Server auseinander... Die Methode dafuer liegt im CryptoHandlerI-Interface, an das man einfach via getSchema().getCryptoHandler(), in der Methode getPWString(). Die macht aus einem uebergebenen String einen vorkodierten und fuer uns nicht mehr rueckverwandelbaren Passwort-String, den man auch zum Anmelden verwenden kann :-)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SyncServiceTools.InvalidSyncAccountConfigurationException
static class	SyncServiceTools.SyncAccountConfiguration

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	GRUPPENNAME_SYNC
static java.lang.String	INITSYNCFILENAME

Method Summary

Modifier and Type	Method and Description
static SyncServiceTools.SyncAccountConfiguration	assureSyncAccount(Transaction _tx, BN _bn) Gets sync account for BN (or creates one if one does not already exists) and returns its configuration.
static Benutzer	createSyncBenutzer(Transaction _tx, java.lang.String _name) Creates a Benutzer account suitable for use by the SyncService.
static java.lang.String	createSyncBenutzerName(java.lang.String _name) Helper method to assure consistent name creation.
static Benutzer	getOrCreateAccount(Transaction tx, java.lang.String hostname) Finds and returns Benutzer for sync of machine with given hostname or creates and returns new one.
static Gruppe	getSyncGruppe(BOLoaderI _bol) Loads and returns the Gruppe that all sync Benutzer must be a member of.
static SyncServiceTools.SyncAccountConfiguration	loadSyncAccountConfiguration(electric.xml.Document _doc) Loads configuration data for the SyncService account from the given Document and returns it.
static SyncServiceTools.SyncAccountConfiguration	loadSyncAccountConfiguration(java.io.File _file) Loads configuration data for the SyncService account from the specified file and returns it.
static void	saveSyncAccountConfiguration(java.io.File _file, SyncServiceTools.SyncAccountConfiguration _sac) Saves given configuration data for the SyncService account to the specified file.
static electric.xml.Document	saveSyncAccountConfiguration(SyncServiceTools.SyncAccountConfiguration _sac) Builds and returns an XML Document with the sync account configuration data.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

INITSYNCFILENAME

public static final java.lang.String INITSYNCFILENAME

See Also:

Constant Field Values

GRUPPENNAME_SYNC

public static final java.lang.String GRUPPENNAME_SYNC

See Also:

Constant Field Values

Method Detail

assureSyncAccount

public static SyncServiceTools.SyncAccountConfiguration assureSyncAccount(Transaction _tx,
                                                                          BN _bn)

Gets sync account for BN (or creates one if one does not already exists) and returns its configuration.

Returns:

a SyncAccountConfiguration with all the data that is available for the sync account for _bn (at least accountName, accountPass and nodeId).

getOrCreateAccount

public static Benutzer getOrCreateAccount(Transaction tx,
                                          java.lang.String hostname)

Finds and returns Benutzer for sync of machine with given hostname or creates and returns new one.

createSyncBenutzerName

public static java.lang.String createSyncBenutzerName(java.lang.String _name)

Helper method to assure consistent name creation.

createSyncBenutzer

public static Benutzer createSyncBenutzer(Transaction _tx,
                                          java.lang.String _name)

Creates a Benutzer account suitable for use by the SyncService.

getSyncGruppe

public static Gruppe getSyncGruppe(BOLoaderI _bol)

Loads and returns the Gruppe that all sync Benutzer must be a member of.

saveSyncAccountConfiguration

public static void saveSyncAccountConfiguration(java.io.File _file,
                                                SyncServiceTools.SyncAccountConfiguration _sac)

Saves given configuration data for the SyncService account to the specified file.

saveSyncAccountConfiguration

public static electric.xml.Document saveSyncAccountConfiguration(SyncServiceTools.SyncAccountConfiguration _sac)

Builds and returns an XML Document with the sync account configuration data.

loadSyncAccountConfiguration

public static SyncServiceTools.SyncAccountConfiguration loadSyncAccountConfiguration(java.io.File _file)
                                                                              throws SyncServiceTools.InvalidSyncAccountConfigurationException

Loads configuration data for the SyncService account from the specified file and returns it.

Returns:

a SyncAccountConfiguration with all the data that is available in the _file (at least accountName, accountPass and nodeId) or null if the _file does not exist.

Throws:

SyncServiceTools.InvalidSyncAccountConfigurationException - if the data in the configuration file is invalid or incomplete.

loadSyncAccountConfiguration

public static SyncServiceTools.SyncAccountConfiguration loadSyncAccountConfiguration(electric.xml.Document _doc)
                                                                              throws SyncServiceTools.InvalidSyncAccountConfigurationException

Loads configuration data for the SyncService account from the given Document and returns it.

Returns:

a SyncAccountConfiguration with all the data that is available in the Document (at least accountName, accountPass and nodeId).

Throws:

SyncServiceTools.InvalidSyncAccountConfigurationException - if the data in the configuration Document is invalid or incomplete.