<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html><head> <meta content="text/html; charset=iso-8859-1" http-equiv="content-type"><title>MOA SL - Betriebshandbuch</title> <link type="text/css" href="../common/handbook.css" rel="stylesheet"></head> <body style="color: rgb(0, 0, 0); background-color: white;" alink="#cc9966" link="#990000" vlink="#666666"><table class="logoTable" border="0" cellpadding="10" cellspacing="0" width="100%"> <tbody> <tr><td class="logoTitle" align="center" width="267"><img style="width: 267px; height: 37px; float: left;" alt="Logo BKA" src="../common/LogoBKA.png"></td> <td class="logoTitle" align="center">E-Recht</td> </tr> </tbody> </table><hr><p class="title"><a href="../index.html">E-Recht: Signaturclient f�r MOA SS, V0.9</a></p> <p class="subtitle">Betriebshandbuch</p> <hr><h1>Inhalt</h1> <ol> <li> <p><a href="#%FCbersicht">�bersicht</a></p> </li> <li><a href="#installation">Installation</a> <ol> <li><a href="#installation_einf%FChrung">Einf�hrung</a></li> <li><a href="#installation_vorbereitung">Vorbereitung</a></li> <li><a href="#installation_tomcatconfig">Konfiguration von Apache Tomcat</a> <ol> <li><a href="#installation_tomcatconfig_httpconn">Konfiguration des HTTP Connectors</a></li> </ol> </li> <li><a href="#installation_deploy">Einsatz des E-Recht Signaturclients f�r MOA SS in Tomcat</a></li> <li><a href="#installation_tomcatstartstop">Starten und Stoppen von Tomcat</a> <ol> <li><a href="#installation_tomcatstartstop_windows">Unter Windows</a></li> <li><a href="#installation_tomcatstartstop_unix">Unter Unix</a></li> <li><a href="#installation_tomcatstartstop_logging">Logging</a> <ol> <li><a href="#webservice_basisinstallation_logging_format">Format der Log-Meldungen</a> </li> </ol> </li> <li><a href="#installation_tomcatstartstop_verify">Pr�fen des erfolgreichen Starts</a></li> </ol> </li> </ol> </li> <li><a href="#konfiguration">Konfiguration</a> <ol> <li><a href="#konfiguration_konfigurationsdatei">Zentrale Konfigurationsdatei</a> <ol> <li><a href="#konfiguration_konfigurationsdatei_request">Parameter f�r den MOA SS Signaturerstellungsrequest</a></li> <li><a href="operation.html#konfiguration_konfigurationsdatei_moass">Parameter der verwendeten MOA SS Installation</a></li><li><a href="operation.html#konfiguration_konfigurationsdatei_adressierung">Adressierung des Servlet Containers des E-Recht Signaturclients</a></li><li><a href="#konfiguration_konfigurationsdatei_arbeitsverzeichnis">Arbeitsverzeichnis</a></li></ol> </li> <li><a href="#konfiguration_layout">Layout der Benutzeroberfl�che</a> </li> </ol> </li> </ol><hr><h1><a name="�bersicht" id="�bersicht"></a>1 �bersicht</h1> <p>Der E-Recht Signaturclient f�r MOA SS ist als plattformunabh�ngiges Modul ausgelegt, das als Webanwendung �ber HTTP angesprochen werden kann. </p> <p>Dieses Handbuch beschreibt einerseits die Installation des Clients, andererseits werden die Konfigurationsm�glichkeiten dargestellt. F�r eine funktionale Beschreibung des Moduls siehe <a href="../system/system.html">Systemhandbuch</a>. </p><h1><a name="installation" id="installation"></a>2 Installation</h1> <h2><a name="installation_einf�hrung" id="installation_einf�hrung"></a>2.1 Einf�hrung </h2> <p>Der E-Recht Signaturclient f�r MOA SS wurde plattformunabh�nig konzipiert und in Java entwickelt. Er ben�tigt als Ablaufumgebung eine Java 2 Standard Edition (J2SE SDK, Version <a href="http://java.sun.com/j2se/1.4.2/">1.4.2</a> oder <a href="http://java.sun.com/j2se/1.5.0/">5.0</a>) sowie einen Java Servlet Container, der die <a href="http://java.sun.com/products/servlet/reference/api/index.html">Java Servlet Specification</a> in der Version 2.3 erf�llt. Als grafische Benutzerschnittstelle f�r den Anwender dient ein herk�mmlicher Webbrowser.</p> <p>In diesem Betriebshandbuch wird davon ausgegangen, dass der E-Recht Signaturclient f�r MOA SS <a href="http://jakarta.apache.org/tomcat/index.html">Apache Tomcat</a> (Version 4.1 oder h�her) als Servlet Container verwendet. Die Verwendung eines anderen Servlet Containers ist grunds�tzlich m�glich, wurde aber nicht getestet und ist auch nicht Gegenstand dieses Betriebshandbuchs. </p> <p>Weiters wird davon ausgegangen, dass Apache Tomcat gleichzeitig als HTTP-Server dient, d.h. die Kommunikation zwischen dem Webbrowser als grafische Benutzerschnittstelle des Signaturclients und der Kernanwendung des Signaturclients wird �ber Tomcat abgewickelt. Die Verwendung eines vor Apache Tomcat geschalteten Webservers ist grunds�tzlich m�glich. So werden etwa als Teil des Apache Tomcat Projekts <a href="http://tomcat.apache.org/connectors-doc/">Module</a> zur Verbindung mit einem vorgeschalteten Microsoft Internet Information Server oder mit einem vorgeschalteten Apache Webserver angeboten. Die Beschreibung der m�glichen Vorschaltungen ist jedoch nicht Teil dieses Betriebshandbuchs.</p><p>Aufgabe des E-Recht Signaturclients f�r MOA SS ist es zun�chst, alle Informationen zu sammeln, die notwendig sind, um ein Rechtsdokument aus E-Recht mit Hilfe des Moduls MOA SS elektronisch zu signieren. Zu diesen Informationen z�hlen die XML-Pr�sentation des Rechtsdokuments, der Stylesheet f�r die Umwandlung der XML-Repr�sentation in die HTML-Repr�sentation, sowie etwaige Bilder und Grafiken, die in der XML- und damit auch HTML-Repr�sentation referenziert werden. Liegen all diese Informationen vor, steuert der Signaturclient das Modul MOA SS, um die Signatur �ber das Rechtsdokument herzustellen. Die erstellte Signatur kann wird dem Benutzer abschlie�end zur lokalen Speicherung zur Verf�gung gestellt. F�r den Betrieb des E-Recht Signaturclients ist daher die Verf�gbarkeit einer Webservice-Installation von MOA SP in der Version 1.3 oder h�her Voraussetzung.</p> <p>Als Logging Toolkit verwendet das MOA SL Webservice <a href="http://logging.apache.org/log4j/">Apache Log4j</a>. </p> <h2><a name="installation_vorbereitung" id="installation_vorbereitung"></a>2.2 Vorbereitung</h2> <p>Die folgenden Schritte dienen der Vorbereitung der Installation.</p> <dl> <dt>Installation von J2SE SDK</dt> <dd>Installieren Sie <a href="http://java.sun.com/j2se/1.4.2/">J2SE 1.4.2 SDK</a> oder <a href="http://java.sun.com/j2se/1.5.0/">J2SE 5.0 SDK</a> in ein beliebiges Verzeichnis. Das Wurzelverzeichnis der J2SE SDK Installation wird im weiteren Verlauf als <code>$JAVA_HOME</code> bezeichnet. </dd> <dt>Installation von Apache Tomcat</dt> <dd> Installieren Sie <a href="http://jakarta.apache.org/tomcat/index.html">Apache Tomcat</a> 4.1.31 oder h�her in ein Verzeichnis, das keine Leerzeichen im Pfadnamen enth�lt. Verwenden Sie bitte die zu Ihrem J2SE SDK passende Distribution von Tomcat. Das Wurzelverzeichnis der Tomcat-Installation wird im weiteren Verlauf als <code>$CATALINA_HOME</code> bezeichnet.</dd> <dt>Installation von MOA SP </dt> <dd>Installieren Sie das <a href="http://www.cio.gv.at/onlineservices/basicmodules/moa-spss/">Kombinationsmodul MOA SPSS</a> Version 1.3 oder h�her entsprechend seiner Installationsanleitung. Sie ben�tigen die Webservice-Schnittstelle von MOA SS. Es ist ausreichend, mittels entsprechender Konfigurationseinstellungen ausschlie�lich MOA SS zu aktivieren; MOA SP kann deaktiviert bleiben. Wenn Sie sowohl f�r MOA SPSS als auch f�r den E-Recht Signaturclient f�r MOA SS Apache Tomcat als Servlet Container verwenden m�chten, empfehlen wir, MOA SPSS und en E-Recht Signaturclient f�r MOA SS in jeweils eigenst�ndigen Instanzen von Apache Tomcat zu betreiben. </dd> <dt>Entpacken der Distribution des E-Recht Signaturclients f�r MOA SS</dt> <dd> Entpacken Sie die Datei <code>moa-ss-erecht-client-x.y.zip</code> in ein beliebiges Verzeichnis. Dieses Verzeichnis wird im weiteren Verlauf als <code>$MOA_SS_CLIENT_INST</code> bezeichnet. </dd> </dl><h2><a name="installation_tomcatconfig" id="installation_tomcatconfig"></a>2.3 Konfiguration von Apache Tomcat</h2> <p> Die zentrale Konfigurations-Datei von Tomcat ist <code>$CATALINA_HOME/conf/server.xml</code>. Tomcat wird grunds�tzlich mit einer funktionierenden Default-Konfiguration ausgeliefert, die jedoch einiges an Ballast enth�lt und viele Ports offen l�sst. </p> <h3><a name="installation_tomcatconfig_httpconn" id="installation_tomcatconfig_httpconn"></a>2.3.1 Konfiguration des HTTP Connectors</h3> <p> Die Datei <code>$MOA_SS_CLIENT_INST</code><code>/conf/tomcat/server.xml</code> enth�lt eine minimale Tomcat-Konfiguration, die ausschlie�lich den Connector f�r HTTP auf Port 8080 freischaltet. Durch kopieren dieser Datei nach <code>$CATALINA_HOME/conf/server.xml</code> kann Tomcat mit dieser Konfiguration gestartet werden. </p><p class="remark">Sicherheitshinweis: Es wird in diesem Betriebshandbuch davon ausgegangen, dass der E-Recht Signaturclient f�r MOA SS sowie das Modul MOA SS selbst miteinander in einer abschlossenen Umgebung betrieben werden. Der E-Recht Signaturclient f�r MOA SS unterst�tzt derzeit die Anbindung von MOA SS nur �ber die ungesicherte HTTP Webservice-Schnittstelle. Weiters bietet der E-Recht Signaturclient f�r MOA SS derzeit keine eigenst�ndige Benutzerauthentisierung. </p><h3><a name="installation_tomcatconfig_httpsconn" id="installation_tomcatconfig_httpsconn"></a></h3><h2><a name="installation_deploy" id="installation_deploy"></a>2.4 Einsatz des E-Recht Signaturclient f�r MOA SS in Tomcat</h2> <p> Um den E-Recht Signaturclient f�r MOA SS in Tomcat f�r den Einsatz vorzubereiten, sind folgende Schritte notwendig:</p> <ul> <li>Die Datei <code>$MOA_SS_CLIENT_INST</code><code>/moa-ss-erecht-client.war</code> enth�lt das einsatzfertige Webarchiv f�r den E-Recht Signaturclient f�r MOA SS und muss ins Verzeichnis <code>$CATALINA_HOME/webapps</code> kopiert werden. Dort wird sie beim ersten Start von Tomcat automatisch ins Verzeichnis <code>$CATALINA_HOME/webapps/</code><code>moa-ss-erecht-client</code> entpackt. </li> <li>Die zentrale Konfigurationsdatei f�r den E-Recht Signaturclient f�r MOA SS muss in ein beliebiges Verzeichnis im Dateisystem kopiert werden (z.B. <code>$CATALINA_HOME/conf/moa-ss-erecht-client/</code>). Eine funktionsf�hige Konfiguration, die als Ausgangspunkt f�r die Konfiguration des E-Recht Signaturclients f�r MOA SS dienen kann, finden Sie unter <code>$MOA_SS_CLIENT_INST</code><code></code><code>/conf/</code><code>moa-ss-erecht-client.config.properties</code>. </li> <li>Die Dateien <code>xalan.jar</code>, <code>xercesImpl.jar</code> und <code>xml-apis.jar</code> aus dem Verzeichnis <code>$MOA_SS_CLIENT_INST</code><code>/endorsed14</code> m�ssen in das Tomcat-Verzeichnis <code>$CATALINA_HOME/common/endorsed</code> kopiert werden. Sind gleichnamige Dateien dort bereits vorhanden, m�ssen sie �berschrieben werden. </li> <li>Folgende <span class="term">System Properties</span> f�r die <span class="term">Java Virtual Machine</span> m�ssen bzw. k�nnen gesetzt werden. Am einfachsten k�nnen diese <span class="term">System Properties</span> beim Starten von Tomcat in der Umgebungsvariablen <code>CATALINA_OPTS</code> in der Form <code>-D<name>=<wert></code> �bergeben werden. <ul> <li id="klein"><code>at.gv.egovernment.moa.ss.erechtclient.PropertiesLocation</code>: Pfad und Name der zentralen Konfigurationsdatei f�r den E-Recht Signaturclient f�r MOA SS. Eine beispielhafte Konfigurationsdatei finden Sie unter <code>$MOA_SS_CLIENT_INST</code><code></code><code>/conf/</code><code>moa-ss-erecht-client.config.properties</code>.<code></code>. Wird ein relativer Pfad angegeben, wird zuerst versucht, diesen relativ zum Wurzelverzeichnis der Webapplikation (also <code>$CATALINA_HOME/webapps/</code><code></code><code>moa-ss-erecht-client</code>) zu interpretieren. Klappt das nicht, wird dann versucht, den relativen Pfad relativ zum Startverzeichnis der <span class="term">Java Virtual Machine</span> zu interpretieren. Diese <span class="term">System Property</span> muss jedenfalls gesetzt werden.</li> <li id="klein"><code>log4j.configuration</code>: URL der Log4j Konfigurationsdatei. Eine beispielhafte Log4j-Konfiguration finden Sie unter <code>$MOA_SS_CLIENT_INST</code><code></code><code>/conf/</code><code>log4j.properties</code>. Wird eine relative URL angegeben, wird diese als File-URL relativ zum Startverzeichnis der <span class="term">Java Virtual Machine</span> interpretiert. Ist diese System Property nicht gesetzt, wird automatisch eine im Webarchiv unter <code>WEB-INF/classes</code> enthaltene Default-Konfiguration herangezogen.</li></ul> </li> </ul><h2><a name="installation_tomcatstartstop" id="installation_tomcatstartstop"></a>2.5 Starten und Stoppen von Tomcat</h2> <h3><a name="installation_tomcatstartstop_windows" id="installation_tomcatstartstop_windows"></a>2.5.1 Unter Windows</h3> <p>Das Verzeichnis <code>$MOA_SL_INST/conf/tomcat/win32</code> enth�lt Script-Dateien zum Starten und Stoppen von Tomcat. Vor der erstmaligen Verwendung der Scripts m�ssen in den ersten Zeilen die Umgebungsvariablen <code>JAVA_HOME</code> (Basisverzeichnis des eingesetzten J2SE SDK) und <code>CATALINA_HOME</code> (Basisverzeichnis der eingesetzten Tomcat-Installation) angepasst werden. Evtl. m�ssen Sie auch noch die in den Script-Dateien gesetzten, in <a href="#installation_deploy">Abschnitt 2.4</a> besprochenen <span class="term">System Properties</span> anpassen. </p> <h3><a name="installation_tomcatstartstop_unix" id="installation_tomcatstartstop_unix"></a>2.5.2 Unter Unix</h3> <p>Zun�chst m�ssen die in <a href="#installation_deploy">Abschnitt 2.4</a> besprochenen <span class="term">System Properties</span> mit Hilfe der Umgebungsvariablen <code>CATALINA_OPTS</code> gesetzt werden. Die Datei <code>$MOA_SL_INST/tomcat/unix/moa-env.sh</code> enth�lt ein Beispiel daf�r. Weiters m�ssen noch die Umgebungsvariablen <code>JAVA_HOME</code> (Basisverzeichnis des eingesetzten J2SE SDK) und <code>CATALINA_HOME</code> (Basisverzeichnis der eingesetzten Tomcat-Installation) angepasst werden.</p> <p>Nun kann Tomcat aus seinem Basisverzeichnis mit </p> <pre>bin/catalina.sh start</pre>gestartet werden. Das Stoppen von Tomcat erfolgt analog mit <pre>bin/catalina.sh stop</pre><h3><a name="installation_tomcatstartstop_logging" id="installation_tomcatstartstop_logging"></a>2.5.3 Logging </h3> <p>Das MOA SL Webservice verwendet <a href="http://logging.apache.org/log4j/">Apache Log4j</a> f�r die Ausgabe von Log-Meldungen am Bildschirm bzw. in Log-Dateien. Log4j bietet zahlreiche Konfigurationsm�glichkeiten, die ausf�hrlich im <a href="http://logging.apache.org/log4j/">Apache Log4j</a> Handbuch beschrieben sind. Unter anderem gibt es die M�glichkeit, folgende Einstellungen vorzunehmen: </p><ul> <li id="klein"> <p>Das verwendete Log-Level (<code>DEBUG</code>, <code>INFO</code>, <code>WARN</code>, <code>ERROR</code>, <code>FATAL</code>);</p> </li> <li id="klein"> <p>Name und maximale Gr��e der Log-Datei(en);</p> </li> <li id="klein"> <p>Das Aussehen der Log-Eintr�ge.</p> </li> </ul><p>Der E-Recht Signaturclient f�r MOA SS verwendet f�r alle Logeintr�ge die Log-Hierarchie <code>erechtclient</code>. F�r die einzelnen Pakete des E-Recht Signaturclients f�r MOA SS werden davon abgeleitete Sub-Hierarchien eingesetzt, z.B. <code>erechtclient</code><code>.xmlparser</code>, <code>erechtclient</code><code>.init, erechtclient.servlets</code> oder <code>erechtclient</code><code>.moainvoker</code>.</p> <p>Eine f�r den E-Recht Signaturclient f�r MOA SS passende Konfigurationsdatei f�r Log4j finden Sie unter <code>$MOA_SS_CLIENT_INST</code><code></code><code>/conf/</code><code>log4j.properties</code>. Wird diese Datei als Logging-Konfiguration verwendet, so werden alle Log-Meldungen sowohl in die Konsole, als auch in die Datei <code>$CATALINA_HOME/logs/moa-ss-erecht-client.log</code> geschrieben. </p> <h4><a name="webservice_basisinstallation_logging_format" id="webservice_basisinstallation_logging_format"></a>2.5.3.1 Format der Log-Meldungen</h4> <p> Anhand einer konkreten Log-Meldung wird das Format der Log-Meldungen erl�utert: </p> <pre>INFO | 28 12:14:48,567 | erechtclient.init | main | <br> Web application initialization succeeded.</pre><p>Der Wert <code>INFO</code> besagt, dass die Log-Meldung im Log-Level <code>INFO</code> entstanden ist. Folgende Log-Levels existieren:</p> <ul> <li> <p><code>DEBUG</code>: Log-Meldungen im Log-Level <code>DEBUG</code> geben Auskunft �ber die innere Arbeitsweise des Systems. Sie sind haupts�chlich f�r Entwickler interessant.</p> </li> <li> <p><code>INFO</code>: Diese Log-Meldungen geben Status-Informationen �ber den Ablauf des Webservices, wie z.B. �ber das Einlangen einer neuen Anfrage.</p> </li> <li> <p><code>WARN</code>: Bei der Ausf�hrung einer Anfrage sind leichte Fehler aufgetreten. Der Ablauf des Webservices ist nicht weiter beeintr�chtigt.</p> </li> <li> <p><code>ERROR</code>: Die Ausf�hrung einer Anfrage musste abgebrochen werden. Das Webservice ist davon nicht beeintr�chtigt. </p> </li> <li> <p><code>FATAL</code>: Es ist ein Fehler aufgetreten, der den weiteren Betrieb des Webservices nicht mehr erlaubt.</p> </li> </ul><p>Der n�chste Wert <code>28 12:14:48,567</code> gibt den Zeitpunkt an, zu dem die Log-Meldung generiert wurde (in diesem Fall den 28. Tag im aktuellen Monat, sowie die genaue Uhrzeit). </p> <p>Der Wert <code>erechtclient.init</code> gibt die Log-Hierarchie an, aus der die Log-Meldung stammt. </p> <p>Der Wert <code>main</code> bezeichnet den Thread, aus der die Log-Meldung stammt. </p> <p>Der Rest der Zeile einer Log-Meldung ist der eigentliche Text, mit dem das System bestimmte Informationen anzeigt. Im Fehlerfall ist h�ufig ein Java Stack-Trace angef�gt, der eine genauere Ursachen-Forschung erm�glicht.</p> <h3><a name="installation_tomcatstartstop_verify" id="installation_tomcatstartstop_verify"></a>2.5.4 Pr�fen des erfolgreichen Starts </h3> <p>Ein erfolgreicher Start des E-Recht Signaturclients f�r MOA SS ist an folgender Log-Meldung ersichtlich: </p> <pre>INFO | 28 12:14:48,567 | erechtclient.init | main | <br> Web application initialization succeeded.</pre><p>Konnte der E-Recht Signaturclient f�r MOA SS nicht ordnungsgem�� gestartet werden, f�hrt das zu folgender Log-Meldung:</p> <pre>FATAL | 28 10:17:03,475 | main | TID=startup NID=<null> <br> Web application initialization failed.<br></pre><p>In diesem Fall geben die<code> </code>Log-Meldungen unmittelbar davor Aufschluss �ber den genaueren Grund. </p><h1><a name="konfiguration" id="konfiguration"></a>3 Konfiguration</h1> <h2><a name="konfiguration_konfigurationsdatei" id="konfiguration_konfigurationsdatei"></a>3.1 Zentrale Konfigurationsdatei</h2> <p>Alle Konfigurationsparameter des E-Recht Signaturclients f�r MOA SS sind in einer zentralen Konfigurationsdatei zusammengefasst. Eine beispielhafte Konfigurationsdatei finden Sie unter <code>$MOA_SS_CLIENT_INST</code><code></code><code>/conf/</code><code>moa-ss-erecht-client.config.properties</code>. F�r Hinweise, wie Sie dem E-Recht Signaturclient f�r MOA SS mitteilen, welche Konfigurationsdatei er verwenden soll, siehe Abschnitt <a href="#installation_deploy">2.4</a>. </p> <p>In den folgenden Abschnitten werden die einzelnen Konfigurationsparameter der zentralen Konfigurationsdatei im Detail besprochen. Die meisten Konfigurationsparameter werden leichter verst�ndlich, wenn Sie zun�chst<span style="font-style: italic;"> </span>das <a href="../system/system.html">Systemhandbuch<span class="comment"></span></a> lesen. Dort werden der gesamte Ablauf eines Signaturerstellungsvorgangs sowie die daran beteiligten Komponenten erkl�rt. </p> <p>Die Konfigurationsdatei ist als <span class="term">Java Properties</span> Datei aufgebaut, d. h. jede Zeile enth�lt den Namen sowie den Wert des jeweiligen Konfigurationsparameters in der Form <code>name=wert</code>. Details zum Aufbau einer <span class="term">Java Properties</span> Datei finden Sie in der API-Dokumentation zu Ihrem Java JDK, beispielsweise <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Properties.html">hier</a>. </p> <h3><a name="konfiguration_konfigurationsdatei_request" id="konfiguration_konfigurationsdatei_schemata"></a>3.1.1 Parameter f�r den MOA SS Signaturerstellungsrequest </h3><table class="fixedWidth" border="1" cellpadding="2"> <tbody> <tr> <td>Name</td> <td><code>location.schema.moa</code></td> </tr> <tr> <td>Erl�uterung</td> <td> <p>Mit diesem Konfigurationsparameter wird dem E-Recht Signaturclient f�r MOA SS mitgeteilt, wo er das XML-Schema f�r die Validierung eines von MOA SS empfangenen Signaturerstellungsresponses nach MOA SPSS V1.3 findet. </p> <p>Der Konfigurationsparameter muss als Wert einen Pfad enthalten, der mit <code>/</code> beginnt, und der vom E-Recht Signaturclient f�r MOA SS als relativ zum <span class="term">Context Root</span> der Webapplikation interpretiert wird.</p> </td> </tr> <tr> <td>Beispiel</td> <td> <p><code>/WEB-INF/classes/resources/schemas/MOA-SPSS-1.3.xsd</code></p> </td> </tr> </tbody></table><table class="fixedWidth" border="1" cellpadding="2"><tbody> <tr> <td>Name</td> <td><code>location.ss.stylesheet</code></td> </tr> <tr> <td>Erl�uterung</td> <td> <p>Mit diesem Konfigurationsparameter wird dem E-Recht Signaturclient f�r MOA SS mitgeteilt, wo er den Default-Stylesheet findet, der im MOA SS Signaturerstellungsrequest angegeben und von MOA SS dazu verwendet wird, um die XML-Repr�sentation des Rechtsdokuments in die dann tats�chlich elektronisch sigierte HTML-Repr�senation �berzuf�hren. </p> <p>Der Konfigurationsparameter muss als Wert einen Pfad enthalten, der mit <code>/</code> beginnt, und der vom E-Recht Signaturclient f�r MOA SS als relativ zum <span class="term">Context Root</span> der Webapplikation interpretiert wird.</p> </td> </tr> <tr> <td>Beispiel</td> <td> <p><code>/static/erecht.stylesheet.1-9-0.xsl</code></p> </td> </tr> </tbody></table><table class="fixedWidth" border="1" cellpadding="2"><tbody> <tr> <td>Name</td> <td><code>location.ss.requestTemplate</code></td> </tr><tr> <td>Erl�uterung</td> <td> <p>Mit diesem Konfigurationsparameter wird dem E-Recht Signaturclient f�r MOA SS mitgeteilt, wo er das XML-Template f�r den Signaturerstellungsrequest an MOA SS findet. </p> <p>Der Konfigurationsparameter muss als Wert einen Pfad enthalten, der mit <code>/</code> beginnt, und der vom E-Recht Signaturclient f�r MOA SS als relativ zum <span class="term">Context Root</span> der Webapplikation interpretiert wird.</p> </td> </tr> <tr> <td>Beispiel</td> <td> <p><code>/WEB-INF/classes/resources/templates/CreateRequest.xml</code></p> </td> </tr> </tbody></table><h3><a name="konfiguration_konfigurationsdatei_moass" id="konfiguration_konfigurationsdatei_moasp"></a>3.1.2 Parameter der verwendeten MOA SS Installation</h3> <table class="fixedWidth" border="1" cellpadding="2"><tbody><tr><td>Name</td> <td><code>service.ss.endpoint</code></td> </tr> <tr> <td>Erl�uterung</td> <td> <p>Mit diesem Konfigurationsparameter wird dem E-Recht Signaturclient f�r MOA SS der Zugangspunkt zum Webservice von MOA SS mitgeteilt. </p> <p>Der Konfigurationsparameter muss eine URL enthalten, die vom E-Recht Signaturclient f�r MOA SS aus erreichbar ist und den Zugangspunkt zu MOA SS adressiert. </p> </td> </tr> <tr> <td>Beispiel</td> <td> <p><code>http://localhost:8081/moa-spss/services/SignatureCreation</code></p> </td> </tr> </tbody></table><table class="fixedWidth" border="1" cellpadding="2"><tbody><tr><td>Name</td> <td><code>service.ss.keyIdentifier</code></td> </tr> <tr> <td>Erl�uterung</td> <td> <p>Mit diesem Konfigurationsparameter wird dem E-Recht Signaturclient f�r MOA SS mitgeteilt, welchen Schl�sselbezeichner er im Signaturerstellungsrequest an MOA SS verwenden soll. </p> <p>Der Konfigurationsparameter muss den Bezeichner eines in MOA SS hinterlegten Schl�sselbezeichner enthalten.</p> </td> </tr> <tr> <td>Beispiel</td> <td> <p><code>KG_allgemein</code></p> </td> </tr> </tbody></table><h3><a name="konfiguration_konfigurationsdatei_adressierung" id="konfiguration_konfigurationsdatei_umfang"></a>3.1.3 Adressierung des Servlet Containers des E-Recht Signaturclients</h3> <table class="fixedWidth" border="1" cellpadding="2"><tbody><tr><td>Name</td> <td><code>location.webAppHostPort</code></td> </tr> <tr> <td>Erl�uterung</td> <td> <p>Mit diesem Konfigurationsparameter wird dem E-Recht Signaturclient f�r MOA SS mitgeteilt, unter welchem Hostnamen bzw. Port der Servlet Container, in dem der E-Recht Signaturclient f�r MOA SS l�uft, <strong>vom Benutzer</strong> erreicht werden kann. </p> <p>Der Konfigurationsparameter muss eine URL sein, die ausschlie�lich die Komponenten Protokoll (also in der Regel <code>http</code>), Hostname (z.B. <code>localhost</code>) und Portnummer (z.B. <code>8084</code>) enth�lt.</p> </td> </tr> <tr> <td>Beispiel</td> <td> <p><code>http://localhost:8084</code></p> </td> </tr> </tbody></table> <table class="fixedWidth" border="1" cellpadding="2"><tbody><tr><td>Name</td> <td><code>location.webAppHostPortFromMOASS</code></td> </tr> <tr> <td>Erl�uterung</td> <td> <p>Mit diesem Konfigurationsparameter wird dem E-Recht Signaturclient f�r MOA SS mitgeteilt, unter welchem Hostnamen bzw. Port der Servlet Container, in dem der E-Recht Signaturclient f�r MOA SS l�uft, <strong>von MOA SS</strong> erreicht werden kann. </p> <p>Der Konfigurationsparameter muss eine URL sein, die ausschlie�lich die Komponenten Protokoll (also in der Regel <code>http</code>), Hostname (z.B. <code>localhost</code>) und Portnummer (z.B. <code>8084</code>) enth�lt.</p> </td> </tr> <tr> <td>Beispiel</td> <td> <p><code>http://localhost:8084</code></p> </td> </tr> </tbody></table> <h3><a name="konfiguration_konfigurationsdatei_arbeitsverzeichnis" id="konfiguration_konfigurationsdatei_arbeitsverzeichnis"></a>3.1.4 Arbeitsverzeichnis</h3> <table class="fixedWidth" border="1" cellpadding="2"><tbody><tr><td>Name</td> <td><code>location.tempdir</code></td> </tr> <tr> <td>Erl�uterung</td> <td> <p>Mit diesem Konfigurationsparameter wird dem E-Recht Signaturclient f�r MOA SS mitgeteilt, wo es das Arbeitsverzeichnis zum tempor�ren Ablegen der vom Benutzer hochgeladenen Dokumente findet. </p> <p>Der Konfigurationsparameter muss als Wert einen Pfad enthalten, der vom E-Recht Signaturclient f�r MOA SS als relativ zum <span class="term">Context Root</span> der Webapplikation interpretiert wird. Der angegebene Pfad muss einen abschlie�enden <code>/</code> aufweisen und im Dateisystem tats�chlich existieren. </p> </td> </tr> <tr> <td>Beispiel</td> <td> <p><code>/workdir/temp/</code></p> </td> </tr> </tbody></table><h2><a name="konfiguration_layout" id="konfiguration_layout"></a>3.2 Layout der Benutzeroberfl�che </h2> <p>Die Benutzeroberfl�che des E-Recht Signaturclient f�r MOA SS ist in Form von Webseiten realisiert, die dem Benutzer in seinem Webbrowser angezeigt werden.</p><p>Das Layout dieser Webseiten kann v�llig frei gestaltet werden. Die Vorlagen f�r die Webseiten liegen in Form von JSP-Seiten (Java Server Pages) im Verzeichnis <code>$MOA_SL_WEBAPP/pages</code> (<code>UploadXML.jsp</code>, <code>UploadImages.jsp</code>, <code>DownloadSignature.jsp</code> sowie <code>Error.jsp</code>). </p> <p>Wenn Sie das Layout gegen�ber der Vorgabe ver�ndern m�chten, editieren Sie einfach die HTML-Teile dieser JSP-Seiten. Beachten Sie bitte, dass Sie dabei die JSP-Scriptelemente unver�ndert lassen. JSP-Scriptelemente sind entweder Tags, die mit dem Pr�fix <code>jsp</code> gekennzeichnet sind (z.B. <code><jsp:useBean></code> oder <code><jsp:getProperty></code>, oder Bereiche die mit der Kennzeichnung <code><%</code> eingeleitet bzw. mit der Kennzeichnung <code>%></code> ausgeleitet werden. </p> <h1><a name="testapp" id="testapp"></a></h1></body></html>