Verschlüsselungstool DATUSCodierung Benutzerhandbuch Stand: Januar 2014
Inhalt Verschlüsselungstool DATUSCodierung... 1 Inhalt... 2 Release Notes... 3 Technische Details... 3 Dateien im Lieferumfang... 3 Merkmale... 3 Technische Voraussetzungen (Arbeitsspeicher, CPU-Leistung, Storage, etc.)... 3 Erforderliche Release-Stände / Patch-Stände weiterer Hard-/Software... 4 Kurzanleitung... 4 Installation... 4 Über die Installer Schaltfläche installieren... 4 Vorgehen bei 64 bit Rechner... 5 o Entpacken einer der beiden zip - Dateien... 5 o Danach müssen Sie folgende Anpassungen vornehmen... 6 Programm starten... 8 Benutzung... 9 Entschlüsseln... 10 Verschlüsseln... 11 Abb. 1 DATUS Downloadseite... 4 Abb. 2 Entpacken und Speichern der benötigten Anwendungen... 6 Abb. 3 Speicherort für extrahierte Dateien... 6 Abb. 4 Bearbeiten der Start.bat bei 64 - bit Rechner... 7 Abb. 5 'normale' Start.bat... 7 Abb. 6 Kontrolle, ob Java (32 bit) vorhanden... 7 Abb. 7 Start.bat für 64 bit Rechner... 8 Abb. 8 Start.bat für 64 bit Rechner mit variablem Pfad zu Java... 8
Release Notes Technische Details mct4datus Version 2010-11-24-15 mct Core Version 1 SVN Revision 297 Kompressionsalgorithmus (mct Core) ZIP Kryptografisches Chiffre (mct Core) Advanced Encryption Standard (AES) Kryptografischer Schlüssel (mct Core) MD5-Hash des Benutzerkennworts Signatur Chiffre (mct Core) SHA-1 TransportContainer Version (mct Core) 1.0 Größte getestete, verarbeitete Nutzdatei 1 137 MB Dateien im Lieferumfang - mct4datus_vxxxxxxxxxx.jar - start.bat Merkmale Die Funktion der Software ist die systematische Ausführung transportvor- und nachbereitender Schritte für XML-basierte Nutzdaten. Dabei weist sie folgende, wesentliche Merkmale auf: - Die grafische Oberfläche ist an der Oberfläche des Datus-Validierungstools orientiert. - Die zu versendende Nutzdatei oder die erhaltene Transportdatei wird über einen Datei-Auswahldialog benannt. - Die Ausgabe der Verarbeitungsschritte erfolgt automatisch direkt im Programmfenster. Technische Voraussetzungen (Arbeitsspeicher, CPU-Leistung, Storage, etc.) Es sind keine besonderen Voraussetzungen zu beachten. Achtung: DATUSCodierung läuft nicht auf einem 64bit Rechner. Es besteht aber die Möglichkeit, die Anwendung auf einem solchen Rechner in einem gesonderten 32bit Bereich zu installieren. Beschreibung unter der folgenden Kurzanleitung - Installation Vorgehen bei 64 bit Rechner Bei weiteren Fragen zur Vorgehensweise wenden Sie sich an das Hessische Landesamt für Umwelt und Geologie (HLUG) per E-Mail an datus-fis-ag@hlug.hessen.de 1 Die maximal verarbeitbare Dateigröße kann variieren. Getestet mit Standard Java-VM-Parametern. Durch Optimierung dieser Parameter (besonders des maximal zur Verfügung stehenden Heap- Spaces) kann die maximale Dateigröße von Nutzdaten signifikant erhöht werden. Seite 3
Erforderliche Release-Stände / Patch-Stände weiterer Hard-/Software Typ Bezeichnung erforderliche Version Bemerkung Betriebssystem Windows XP und höher Runtime /Framework Java 6 Bezug: http://www.java.com/de/download/ Test: http://www.java.com/de/download/installed.jsp Kurzanleitung Installation Über die Installer Schaltfläche installieren Auf der Internetseite des Hessischen Landesamtes für Umwelt und Geologie (www.hlug.de Altlasten Datus, Anmeldung zur Downloadseite) gelangen Sie zu folgender Seite Abbildung 1. Entweder klicken Sie auf die Schaltfläche DATUS-Installer oder Sie entpacken alternativ die Programmdateien aus den zip Dateien des gewählten Downloadpaketes in das Zielverzeichnis. 1. Downloadseite von www.hlug.de Altlasten - Datus Abb. 1 DATUS Downloadseite o Achtung: Bei einem 64 bit Rechner funktioniert der DATUS-Installer der Internetseite nicht. In diesem Fall benutzen Sie bitte eine der angebotenen zip-dateien, je nachdem, ob Sie mit DATUS mobile oder mit der offenen Schnittstelle arbeiten möchten. Weiter mit Punkt 2. Weitere Beschreibungen finden Sie auch im Internet unter www.hlug.de Altlasten Datus. 2. Bedienung des Installers: Evtl. erscheint eine Sicherheitswarnung klicken Sie auf Ausführen Seite 4
Dann öffnet sich der Installer Klicken Sie auf Weiter und befolgen die Anweisungen. Vorgehen bei 64 bit Rechner o Entpacken einer der beiden zip - Dateien Wenn Sie einen 64 bit Rechner benutzen, dann entpacken Sie zunächst die zip Datei. Das kann so oder wie in der 2. Abbildung aussehen: Seite 5
Abb. 2 Entpacken und Speichern der benötigten Anwendungen Wählen Sie einen Speicherort: Abb. 3 Speicherort für extrahierte Dateien o Danach müssen Sie folgende Anpassungen vornehmen Seite 6
Markieren Sie start.bat Abb. 4 Bearbeiten der Start.bat bei 64 - bit Rechner Klicken Sie bitte mit der rechten Maustaste und dann auf bearbeiten : Abb. 5 'normale' Start.bat Stellen Sie sicher, dass auf Ihrem Rechner Java (jre6 oder auch jre7) installiert ist. Sie benötigen eine 32 bit Java-Version im Verzeichnis Programme(x86) (http://www.java.com/de/download/) Evtl. müssen Sie eine gleichzeitig vorhandene 64-bit Java Version deinstallieren. Abb. 6 Kontrolle, ob Java (32 bit) vorhanden Seite 7
Ändern Sie dann die Start.bat wie folgt: Abb. 7 Start.bat für 64 bit Rechner Wobei "C:\Program Files (x86)\java\jre7\bin\javaw.exe" der feste Pfad zu Ihrer javaw.exe sein soll. Denken Sie daran, diesen Pfad in Hochkomma zu setzen. Alternativ kann Ihr Admin auch eine Variable benutzen. Beispiel: Abb. 8 Start.bat für 64 bit Rechner mit variablem Pfad zu Java Ziel dieser Änderung ist, der Anwendung DATUSCodierung mit Namen MCT4DATUS_2010-11-24-15_Extern.jar den Pfad zu Java mitzuteilen. Programm starten Es gibt zwei Varianten um das Programm zu starten. a) Durch einen Doppelklick auf die Datei mct4datus[version].jar b) Durch einen Doppelklick auf die Datei start.bat Je nach Java-Installation kann es vorkommen, dass Variante a) nicht funktioniert. In diesem Fall wenden Sie sich bitte an Ihren Systemadministrator. Er kann eine permanente Verknüpfung für Jar-Dateien mit dem Programm javaw.exe einrichten. 1. Benutzer anlegen Die Verwaltung der Benutzerdaten erfolgt in der Datei UserDB.csv im Installationsverzeichnis der Anwendung. Falls diese Datei nicht existiert, wird sie bei dem Seite 8
ersten Programmstart angelegt werden. Sie werden in diesem Fall zur Eingabe der Benutzerdaten aufgefordert. a) b) 2. Benutzerkennung ändern Um die Benutzerkennung zu ändern können Sie einfach die Datei UserDB.csv im Installationsverzeichnis der Anwendung löschen und anschließend die Anwendung starten. Sie werden aufgefordert die neue Nutzerkennung einzugeben. Benutzung 1 2 3 1. Durchsuchen-Knopf um eine Datei zu selektieren, die entweder ver- oder entschlüsselt werden soll. 2. Verarbeiten-Knopf um den Ver- oder Entschlüsselungsvorgang zu beginnen. Dieser Knopf wird erst aktiv, wenn eine Datei zuvor mittels Durchsuchen selektiert wurde. 3. Im Log Fenster werden der Status und ggf. die Fehlermeldungen der Anwendung angezeigt. Seite 9
Entschlüsseln Die Entschlüsselung funktioniert analog zur Verschlüsselung. 1) Datei crypt_[dateiname].mct mittels Durchsuchen Knopf auswählen. 2) Auf den Verarbeiten Knopf klicken, um die Entschlüsselung zu starten. 3) Die entschlüsselte Datei liegt im selben Verzeichnis, in dem auch die verschlüsselte Datei lag. Die verschlüsselte Datei wird nach einer erfolgreichen Entschlüsselung gelöscht. 4) Alle Details zur Verarbeitung sowie alle Dateinamen werden im Log-Fenster protokolliert. Es wird ein Log-file geschrieben, die Datei mit dem Name mct4datus.log befindet sich im selben Verzeichnis wie die entschlüsselte Datei. Seite 10
Verschlüsseln Der Verschlüsselungsprozess beginnt mit der Auswahl der zu verschlüsselnden Datei. Durch Klicken auf den Knopf Durchsuchen wird ein Datei-Auswahl-Dialog geöffnet, der Ihnen die Möglichkeit bietet, eine Datei zur Verschlüsselung zu selektieren. Bitte beachten Sie, dass es sich hierbei um eine Datei mit der Endung XML handeln muss. Wenn die zu verschlüsselnde Datei gewählt wurde, können Sie den Auswahlvorgang durch Drücken des Knopfs Öffnen abschließen. Anschließend erscheint die Datei im Textfeld neben dem Durchsuchen Knopf. Durch Klicken auf den Knopf Verarbeiten beginnt die Verschlüsselung. a) Seite 11
b) c) Die verschlüsselte Datei befindet sich nach der Verschlüsselung im selben Verzeichnis wie die unverschlüsselte Originaldatei. Sie hat den Präfix crypt_ und die Dateiendung mct. Eine Datei test.xml würde beispielsweise nach der Verschlüsselung crypt_test.mct heißen. Seite 12