<!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&nbsp;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&nbsp;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&nbsp;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&nbsp;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&nbsp;E-Recht Signaturclients ist daher
die&nbsp;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&nbsp;en E-Recht Signaturclient f�r MOA SS in jeweils
eigenst�ndigen Instanzen von Apache
Tomcat zu betreiben. </dd> <dt>Entpacken
der&nbsp;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&nbsp;<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.&nbsp;</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&nbsp;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&nbsp;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&nbsp;E-Recht Signaturclient&nbsp;f�r MOA SS in
Tomcat</h2>
<p> Um den&nbsp;E-Recht Signaturclient&nbsp;f�r MOA SS in
Tomcat f�r den Einsatz
vorzubereiten, sind folgende Schritte notwendig:</p>
<ul> <li>Die Datei&nbsp;<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&nbsp;den&nbsp;E-Recht Signaturclient&nbsp;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&nbsp;E-Recht Signaturclients f�r MOA SS
dienen kann,
finden Sie unter&nbsp;<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&nbsp;<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.&nbsp;</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&lt;name&gt;=&lt;wert&gt;</code>
�bergeben werden. <ul> <li id="klein"><code>at.gv.egovernment.moa.ss.erechtclient.PropertiesLocation</code>:
Pfad und Name der zentralen Konfigurationsdatei
f�r&nbsp;den&nbsp;E-Recht
Signaturclient&nbsp;f�r MOA SS.
Eine beispielhafte Konfigurationsdatei finden Sie unter&nbsp;<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&nbsp;<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&nbsp;E-Recht Signaturclient&nbsp;f�r
MOA SS&nbsp;verwendet f�r alle
Logeintr�ge die Log-Hierarchie <code>erechtclient</code>.
F�r die einzelnen Pakete des&nbsp;E-Recht Signaturclients f�r MOA
SS
werden davon
abgeleitete Sub-Hierarchien eingesetzt, z.B.&nbsp;<code>erechtclient</code><code>.xmlparser</code>,&nbsp;<code>erechtclient</code><code>.init,
erechtclient.servlets</code> oder&nbsp;<code>erechtclient</code><code>.moainvoker</code>.</p>
<p>Eine f�r den&nbsp;E-Recht Signaturclient&nbsp;f�r MOA
SS passende Konfigurationsdatei
f�r Log4j finden Sie unter&nbsp;<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&nbsp;
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&nbsp;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&nbsp;E-Recht Signaturclient&nbsp;f�r MOA SS&nbsp; nicht
ordnungsgem�� gestartet werden, f�hrt das
zu folgender Log-Meldung:</p>
<pre>FATAL | 28 10:17:03,475 | main | TID=startup NID=&lt;null&gt; <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&nbsp;des&nbsp;E-Recht
Signaturclients f�r MOA SS&nbsp; 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&nbsp;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&nbsp;</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&nbsp;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&nbsp;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&nbsp;E-Recht Signaturclient
f�r MOA SS
mitgeteilt, wo er das XML-Template f�r den Signaturerstellungsrequest
an MOA SS&nbsp;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&nbsp;dem&nbsp;E-Recht
Signaturclient f�r MOA SS der
Zugangspunkt zum Webservice von MOA SS mitgeteilt. </p> <p>Der
Konfigurationsparameter muss eine URL enthalten, die&nbsp;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&nbsp;dem&nbsp;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&nbsp;dem&nbsp;E-Recht
Signaturclient f�r MOA SS
mitgeteilt, unter welchem Hostnamen bzw. Port der Servlet Container, in
dem der&nbsp;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&nbsp;dem&nbsp;E-Recht
Signaturclient f�r MOA SS
mitgeteilt, unter welchem Hostnamen bzw. Port der Servlet Container, in
dem der&nbsp;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&nbsp;dem&nbsp;E-Recht
Signaturclient f�r MOA SS
mitgeteilt, wo es das Arbeitsverzeichnis zum tempor�ren Ablegen der vom
Benutzer hochgeladenen Dokumente findet.&nbsp; </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>).&nbsp; </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>&lt;jsp:useBean&gt;</code>
oder <code>&lt;jsp:getProperty&gt;</code>, oder
Bereiche die mit der Kennzeichnung <code>&lt;%</code>
eingeleitet bzw. mit der Kennzeichnung <code>%&gt;</code>
ausgeleitet werden. </p>
<h1><a name="testapp" id="testapp"></a></h1></body></html>