<html>
<head>
	<title>MOA SP/SS-Administration</title>
	<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
	<meta content="heinz.rosenkranz@brz.gv.at" name="author"/>

<style type="text/css">
 	body { font-family:"Verdana", "Arial"; font-size:10pt; color:#505060; }
	td { font-family:"Verdana", "Arial"; font-size:10pt; color:#505060; }
	th { font-family:"Verdana", "Arial"; font-size:10pt; font-weight:bold; color:#d8d8d8; background:#505050}
	li { font-family:"Verdana", "Arial"; font-size:10pt; color:#505060; margin-top:3px }
	ul { font-family:"Verdana", "Arial"; font-size:10pt; color:#505060; margin-top:3px }
	tt { font-size:9pt; color:#505060; }
	pre { font-size:9pt; color:#505060; }
	#titel { font-family:"Verdana", "Arial"; font-size:18pt; color:#505060; }
	#subtitel { font-family:"Verdana", "Arial"; font-size:12pt; font-weight:bold; color:#505060; }
	#slogan { font-family:"Verdana", "Arial"; font-size:8pt; color:#808090; text-align:justify; width:160px }
	#block { font-family:"Verdana", "Arial"; font-size:10pt; color:#505060; text-align:justify }
	#klein { font-family:"Verdana", "Arial"; font-size:9pt; color:#505060; margin-top:3px }
	#info { font-family:"Verdana", "Arial"; font-size:8pt; color:#505060; padding:3px; border:solid 1px #c0c0c0 }
	#infolist { font-family:"Verdana", "Arial"; font-size:8pt; color:#505060; }
	a:link {color:#000090}
	a:visited {color:#000090}
	a:hover {color:#c03030}
	a {text-decoration: none}
</style>

<script language="JavaScript">
<!-- 
function goWin(url) {
	Fenster=window.open(url,"smallWin","toolbar=0,location=0,directories=0,status=0,menubar=0,resizable=yes,scrollbars=yes,width=500,height=480,top=20,screenY=0,left=20,screenX=0");
	window.setTimeout("showWin()",300);
}
function showWin() { Fenster.focus(); }
// -->
</script>
</head>

<body bgcolor="#FFFFFF" >
<div style="width:650px">

<!-- Projekt-Logo -->
<div style="height:42px; font-size:16pt; color:#b0b8c0; background:#003050">
&#160;Module f�r Online-Applikationen
</div>
<div style="margin-left:8px; margin-top:3px; font-size:8pt; color:#707070; ">
<!-- Development Center der BRZ GmbH, A-Trust und IAIK Graz -->&#160;
</div>
<div style="margin-top:-65px; text-align:right; font-size:8pt; font-weight:bold; color:#d04040;" > 
Projekt <span style="font-size:48pt; ">moa</span>&#160;
</div>
<br />

<!-- First Section with Navigation -->
<table width="650" border="0" cellpadding="10" cellspacing="0">
<tr>
<td width="170"  valign="top">
<div style="font-weight:bold; margin-top:12px">MOA-SP/SS</div><br />
<div id="klein"><a href="sp-admin.htm"><img src="../moa_images/idle.gif" border="0" width="13" height="14" /> 
	<b> �bersicht</b></a></div>
<div id="klein"><img src="../moa_images/select.gif" border="0" width="13" height="14" /> 
	<b> Basis-Installation<br />&#160; &#160;&#160;(Webservice)</b></div>
<div id="klein"><a href="sp-admin_4.htm"><img src="../moa_images/idle.gif" border="0" width="13" height="14" /> 
	<b> Basis-Installation<br />&#160; &#160;&#160;(Klassenbibliothek)</b></a></div>
<div id="klein"><a href="sp-admin_2.htm"><img src="../moa_images/idle.gif" border="0" width="13" height="14" /> 
	<b> Konfiguration </b></a></div>
<div id="klein"><a href="sp-admin_3.htm"><img src="../moa_images/idle.gif" border="0" width="13" height="14" /> 
	<b> Optionale<br />&#160; &#160;&#160;Komponenten</b></a></div>
<br />
<div id="klein"><a href="moa.htm"><img src="../moa_images/west.gif" border="0" width="13" height="14" />
	<b> Zur�ck</b></a></div>
<br />
<div id="slogan">
<b>Installationsschritte: </b>
<br />
<a href="#vorbereitung"><b>Vorbereitung</b></a><br />
<a href="#Tomcat"><b>Tomcat Konfiguration</b></a><br />
<a href="#deployment"><b>Webservice Deployment</b></a><br />
<a href="#Tomcat_Start"><b>Tomcat Start/Stop</b></a><br />
<a href="#Logging"><b>Logging</b></a><br />
</div>
</td>

<td valign="top">
<p id="titel">Basis-Installation (Webservice)</p>
<div id="vorbereitung" />
<p id="subtitel">Vorbereitung</p>
<div id="block">
<b>Installation des JDK</b><br />
Installieren Sie das JDK 1.3.1 oder JDK 1.4.1 in ein beliebiges Verzeichnis. Das Wurzelverzeichnis der JDK-Installation wird im weiteren Verlauf als $JAVA_HOME bezeichnet.
<br /><br />
<b>Installation von Tomcat</b><br />
Installieren Sie Tomcat in ein Verzeichnis, das keine Leerzeichen im Pfadnamen enth�lt. Das Wurzelverzeichnis der Tomcat-Installation wird im weiteren Verlauf als $CATALINA_HOME bezeichnet. <b>Hinweis:</b> Tomcat wird in einer Distribution f�r JDKs ab Version 1.2 und in einer Distribution speziell f�r JDK 1.4 ausgeliefert. Installieren Sie die zur Version Ihres JDK passende Tomcat-Version.
<br /><br />
<b>Entpacken des MOA SP/SS Webservices</b><br />
Entpacken Sie die Datei moa-spss-1.0.x.zip in ein beliebiges Verzeichnis. Dieses Verzeichnis wird im weiteren Verlauf als $MOA_SPSS_INST bezeichnet. 
<br /><br />
<b>Installation der IAIK JCE und JSSE im JDK 1.3.1</b><br />
Da Java in der Version 1.3.1 ohne Unterst�tzung f�r Kryptographie und SSL ausgeliefert wird, muss dies manuell nachtr�glich installiert werden. F�r den Betrieb des MOA SP/SS Webservices ist es deshalb notwendig, die Dateien aus dem Verzeichnis $MOA_SPSS_INST/ext13 in das Verzeichnis $JAVA_HOME/jre/lib/ext zu kopieren.
<br /><br />
<b>Installation der IAIK JCE im JDK 1.4.1</b><br />
            Um die mit MOA SP/SS ausgelieferte IAIK JCE im JDK 1.4.1 zu installieren, 
            m�ssen die Dateien aus dem Verzeichnis $MOA_SPSS_INST/ext14 in das 
            Verzeichnis $JAVA_HOME/jre/lib/ext kopiert werden. Zus�tzlich m�ssen 
            die sogenannten "Unlimited Strength Jurisdiction Policy Files 1.4.1" 
            heruntergeladen, entpackt und ins Verzeichnis $JAVA_HOME/jre/lib/security 
            kopiert werden. Der Download f�r diese Dateien findet sich am unteren 
            Ende der <a href="http://java.sun.com/j2se/1.4.1/download.html">Download-Seite 
            f�r das JDK 1.4.1</a> in der Sektion "Other Downloads". <br />
            <br />
</div>
</div></td></tr></table>


<div id="Tomcat" />
<table width="650" border="0" cellpadding="10" cellspacing="0">
<td width="170" valign="top" id="klein">
<p id="subtitel">&#160;</p>
<div id="slogan">
<br /><br />
</div>
</td>
<td valign="top">
<p id="subtitel">Konfiguration von Tomcat</p>
<div id="block">
<b>Minimale Konfiguration</b> <br />
Die zentrale Konfigurations-Datei von Tomcat ist $CATALINA_HOME/conf/server.xml. Tomcat wird grunds�tzlich mit einer funktionierenden Default-Konfiguration ausgeliefert, die jedoch einiges an Ballast enth�lt und viele Ports offen l�sst. Die Datei $MOA_SPSS_INST/tomcat/server.xml enth�lt eine minimale Tomcat-Konfiguration, die ausschlie�lich den Connector f�r HTTP freischaltet. Durch kopieren dieser Datei nach $CATALINA_HOME/conf/server.xml kann Tomcat mit dieser Konfiguration gestartet werden.<br /><br />
<b>SSL</b><br />
Ein sicherer Betrieb des MOA SP/SS Webservices setzt voraus, dass f�r die �bertragung der Daten SSL verwendet wird. Das Dokument <a href="http://jakarta.apache.org/tomcat/tomcat-4.1-doc/ssl-howto.html" target="_new">Tomcat SSL Configuration HOW-TO</a> gibt einen guten �berblick �ber die Konfiguration von SSL in Tomcat. Da das JDK bereits im Abschnitt "Vorbereitung" auf SSL vorbereitet wurde, sind an dieser Stelle nur noch folgende Schritte notwendig: 
</div>
<ul>
<li>Erstellung eines Server-Keystores, welches den privaten Schl�ssel des Servers sowie das Server-Zertifikat enth�lt, z.B. mit dem <a href="http://java.sun.com/j2se/1.3/docs/tooldocs/win32/keytool.html" target="_new"> Java Keytool</a>. </li>
<li>Erstellung eines Keystores mit vertrauensw�rdigen Client-Zertifikaten, z.B. mit dem <a href="http://java.sun.com/j2se/1.3/docs/tooldocs/win32/keytool.html" target="_new"> Java Keytool</a> (nur, wenn SSL Client-Authentisierung verwendet werden soll) </li>
<li>Konfiguration des SSL-Connectors in $CATALINA_HOME/conf/server.xml (optional mit Client-Authentisierung) </li>
</ul>
<div id="block">
Die Konfiguration von SSL im Tomcat kann entfallen, wenn Tomcat ein Webserver vorgeschaltet ist, der die SSL-Kommunikation mit dem Aufrufer des Webservices �bernimmt.
</div>
<br /><br />
<div id="block">
<b>MOA Administrator</b><br />
Der Aufruf der URL f�r die dynamische Konfiguration des MOA SP/SS Webservices ist durch eine Passwort-Abfrage gesch�tzt, und kann nur von Benutzern aufgerufen werden, die der Benutzer-Rolle <tt>moa-admin</tt> zugeordnet werden k�nnen.<br />
Um diese Benutzer-Rolle und einen oder mehrere Benutzer einzurichten, m�ssen in der Datei $CATALINA_HOME/conf/tomcat-users.xml unter dem Element <tt>&lt;tomcat-users&gt;</tt> sinngem�� folgende Eintr�ge hinzugef�gt werden:
<pre>
&lt;role rolename="moa-admin"/&gt;
&lt;user username="moa" password="moa" roles="moa-admin"/&gt;
</pre>
</div>
</td></tr></table>

<div id="deployment" />
<table width="650" border="0" cellpadding="10" cellspacing="0">
<td width="170" valign="top" id="klein">
<p id="subtitel">&#160;</p>
<div id="slogan">
<br /><br />
</div>
</td>
<td valign="top">
<p id="subtitel">Deployment des MOA SP/SS Webservices in Tomcat</p>
<div id="block">
Um das MOA SP/SS Webservice in Tomcat f�r den Ablauf vorzubereiten, sind folgende Schritte notwendig: <br />
              <ul>
                <li>Die Datei $MOA_SPSS_INST/moa-spss.war enth�lt das einsatzfertige 
                  MOA SP/SS Webarchiv und muss ins Verzeichnis Verzeichnis $CATALINA_HOME/webapps 
                  kopiert werden. Dort wird sie beim ersten Start von Tomcat automatisch 
                  ins Verzeichnis $CATALINA_HOME/webapps/ moa-spss entpackt. </li>
                <li>Die MOA SP/SS Konfigurationsdatei und zugeh�rige Profil-Verzeichnisse 
                  m�ssen in ein beliebiges Verzeichnis im Filesystem kopiert werden 
                  (z.B. $CATALINA_HOME/ conf/moa). <br />
                  In $MOA_SPSS_INST/conf befindet sich eine funktionsf�hige Konfiguration, 
                  die als Ausgangspunkt f�r die Konfiguration des MOA SP/SS Webservices 
                  dienen kann. </li>
                <li>Wird Tomcat unter JDK 1.3.1 betrieben, m�ssen die Dateien 
                  aus dem Verzeichnis $MOA_SPSS_INST/endorsed13 in das Tomcat-Verzeichnis 
                  $CATALINA_HOME/common/endorsed kopiert werden. Folgende Libraries 
                  sind f�r das Deployment im endorsed Verzeichnis vorgesehen: 
                  <ul>
                    <li id="klein">Xerces-J-2.0.2 (bestehend aus xercesImpl.jar 
                      und xmlParserAPIs.jar).</li>
                  </ul>
                  Eventuell vorhandene Dateien mit dem gleichen Namen m�ssen ersetzt 
                  werden. </li>
                <li>Wird Tomcat unter JDK 1.4.1 betrieben, m�ssen die Dateien 
                  aus dem Verzeichnis $MOA_SPSS_INST/endorsed14 in das Tomcat-Verzeichnis 
                  $CATALINA_HOME/common/endorsed kopiert werden. Folgende Libraries 
                  sind f�r das Deployment im endorsed Verzeichnis vorgesehen: 
                  <ul>
                    <li id="klein">Xerces-J-2.0.2 (bestehend aus xercesImpl.jar 
                      und xmlParserAPIs.jar).</li>
                    <li id="klein">Xalan-J-2.2.0 (bestehend aus xalan.jar.jar 
                      und bsf.jar).</li>
                  </ul>
                  Eventuell vorhandene Dateien mit dem gleichen Namen m�ssen ersetzt 
                  werden. </li>
                <li>Folgende Java System-Properties k�nnen optional gesetzt sein:<br />
                  <ul>
                    <li id="klein">moa.spss.server.configuration=Name der MOA 
                      SP/SS Konfigurationsdatei. Eine beispielhafte MOA SP/SS 
                      Konfiguration ist in $MOA_SPSS_INST/conf/moa-spss/ MOA-SPSSConfiguration.xml 
                      enthalten. Ist diese System-Property nicht gesetzt, wird 
                      automatisch eine im Web-Archive unter <tt>WEB-INF/conf</tt> 
                      enthaltene Default-Konfiguration herangezogen.</li>
                    <li id="klein">log4j.configuration=URL der Log4j Konfigurationsdatei. 
                      Eine beispielhafte Log4j-Konfiguration ist in $MOA_SPSS_INST/conf/moa-spss/log4j.properties 
                      enthalten. Ist diese System-Property nicht gesetzt, wird 
                      automatisch eine im Web-Archive unter <tt>WEB-INF/classes</tt> 
                      enthaltene Default-Konfiguration herangezogen.</li>
                    <li id="klein">moa.node.id=Name des Rechner-Knotens, auf dem 
                      MOA SP/SS l�uft. Der Name des Knotens wird bei Log-Ausgaben 
                      von MOA SP/SS angef�hrt und dient zur Unterscheidung mehrerer 
                      gleichzeitig betriebener MOA SP/SS Webservice-Instanzen. 
                      Der Name des Knotens ist frei w�hlbar.</li>
                    <li id="klein">javax.net.ssl.trustStore=Dateiname des Truststores 
                      f�r vertrauensw�rdige SSL Client-Zertifikate (optional; 
                      nur, wenn SSL Client-Authentisierung durchgef�hrt werden 
                      soll). Relative Dateinamen werden zum Verzeichnis, von dem 
                      Tomcat gestartet wird, aufgel�st.</li>
                    <li id="klein">javax.net.ssl.trustStorePassword=Passwort f�r 
                      den Truststore (optional; nur, wenn SSL Client-Authentisierung 
                      durchgef�hrt werden soll). </li>
                    <li id="klein">javax.net.ssl.trustStoreType=Truststore-Typ 
                      (optional; nur, wenn SSL Client-Authentisierung durchgef�hrt 
                      werden soll). Je nach verwendetem Keystore-Typ ist "jks" 
                      oder "pkcs12" �blich.</li>
                  </ul>
                  Diese Java System-Properties werden Tomcat �ber die Umgebungsvariable 
                  CATALINA_OPTS mitgeteilt.
                
              </ul>
</div>
</td></tr></table>



<div id="Tomcat_Start" />
<table width="650" border="0" cellpadding="10" cellspacing="0">
<td width="170" valign="top" id="klein">
<p id="subtitel">&#160;</p>
<div id="slogan">
<br /><br />
</div>
</td>
<td valign="top">
              <p id="subtitel">Starten und Stoppen von Tomcat</p>
              <p><b>Windows</b></p>
              <div id="block"> 
                <p>Das Verzeichnis $MOA_SPSS_INST/tomcat/win32 enth&auml;lt Script-Dateien 
                  zum Starten und Stoppen sowie f&uuml;r das Installieren und 
                  Deinstallieren von Tomcat als Service. </p>
                <p>Vor der erstmaligen Verwendung der Scripts m&uuml;ssen in den 
                  ersten Zeilen die Umgebungsvariablen JAVA_HOME und CATALINA_HOME 
                  angepasst werden.</p>
              </div>
              <div id="block"> 
                <p><b>Unix</b></p>
                <div id="block"> 
                  <p>Zun&auml;chst m&uuml;ssen die im vorigen Abschnitt besprochenen 
                    Umgebungsvariablen gesetzt sein. Die Datei $MOA_SPSS_INST/tomcat/unix/moa-env.sh 
                    enth&auml;lt ein Beispiel daf&uuml;r.</p>
                  <p>Nach dem Deployment und der Konfiguration kann Tomcat aus 
                    seinem Wurzelverzeichnis mit </p>
                  <pre>    bin/catalina.sh start</pre>
					gestartet werden. Das Stoppen von 
                    Tomcat erfolgt analog mit <pre>    bin/catalina.sh stop</pre>
                  <p><b>Pr&uuml;fen des erfolgreichen Starts</b></p>
                  <p>Ein erfolgreicher Startvorgang ist an folgender Log-Meldung 
                    ersichtlich: <br />
                  </p>
                </div>
<pre>
    INFO | 18 10:09:45,155 | main | TID=startup NID=&lt;null&gt; 
      MSG=MOA Konfiguration erfolgreich geladen
</pre>
Bei leichten Fehlern in der Konfiguration geben WARN Log-Meldungen unmittelbar davor Aufschluss �ber fehlerhafte Konfigurations-Eintr�ge.
<br /> <br />
Nach dem Starten von Tomcat steht das MOA SP/SS Webservice f�r die Server-Signatur und Signatur-Pr�fung unter den Endpunkten
<pre>
    http://host:port/moa-spss/services/SignatureCreation
</pre>
bzw.
<pre>
    http://host:port/moa-spss/services/SignatureVerification
</pre> 
zur Verf�gung. Die Verf�gbarkeit des Services kann einfach �berpr�ft werden, indem der Endpunkt mit einem Web-Browser aufgerufen wird und zu einer Anzeige einer Informationsseite f�hrt.
<br /><br />
<div id="ConfigurationUpdate"/>
Dynamische Konfigurations-Updates k�nnen durch den Aufruf der URL http://host:port/moa-spss/ConfigurationUpdate (z.B. durch Eingabe in einem Browser) durchgef�hrt werden. <br />
Konnte das MOA-SPSS Webservice nicht ordnungsgem�� konfiguriert und gestartet werden, geht das aus der Log-Meldung hervor: <br />
<pre>
    FATAL | 18 10:17:03,475 | main | TID=startup NID=&lt;null&gt; 
      MSG=Fehler beim Lesen der MOA Konfiguration: 
      das Service steht nicht zur Verf�gung
</pre>
In diesem Fall geben die WARN bzw. ERROR Log-Meldungen unmittelbar davor Aufschluss �ber den genaueren Grund.  
</div>
</div></td></tr></table>


<div id="Logging" />
<table width="650" border="0" cellpadding="10" cellspacing="0">
<td width="170" valign="top" id="klein">
<p id="subtitel">&#160;</p>
<div id="slogan">
<br /><br />
</div>
</td>
<td valign="top">
<div id="Logging" />
<p id="subtitel">Logging</p>
<div id="block">
Das MOA SP/SS Webservice verwendet Jakarta Log4j 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://jakarta.apache.org/log4j/docs/manual.html" target="_new">Log4j Handbuch</a> beschrieben sind. Unter anderem gibt es die M�glichkeit, folgende Einstellungen vorzunehmen: <br />
<ul>
<li id="klein">Das verwendete Log-Level (DEBUG, INFO, WARN, ERROR, FATAL).</li>
<li id="klein">Name und maximale Gr��e der Log-Datei(en).</li>
<li id="klein">Das Aussehen der Log-Eintr�ge.</li>
</ul>
Das MOA-SPSS Webservice verwendet folgende Log-Hierarchien: 
</div>
<ul>
<li>moa.spss.server f�r alle Log-Meldungen aus dem MOA-SPSS Webservice </li>
<li>iaik.server f�r alle Log-Meldungen aus den IAIK Kryptographie-Modulen </li>
</ul>
<div id="block">
Als Ausgangspunkt f�r die Logging-Konfiguration liegt die Datei $MOA_SPSS_INST/conf/moa-spss/log4j.properties bei. Wird diese Datei als Logging-Konfiguration verwendet, so werden alle Log-Meldungen sowohl in die Konsole, als auch in die Datei <tt>moa-spss.log</tt> geschrieben.
<br /><br /> 
<b>Format der Log-Meldungen</b><br />
Anhand einer konkreten Log-Meldung wird das Format der MOA SP/SS Log-Meldungen erl�utert:
<pre>
    INFO | 01 21:25:26,540 | Thread-3 | 
      TID=1049225059594-100 NID=node1 
      MSG=Starte neue Transaktion: TID=1049225059594-100, 
      Service=SignatureVerification
</pre>

Der Wert <tt>INFO</tt> besagt, dass die Log-Meldung im Log-Level <tt>INFO</tt> entstanden ist. Folgende Log-Levels existieren:<br />
<ul>
<li id="klein"><tt>DEBUG:</tt> Log-Meldungen im Log-Level <tt>DEBUG</tt> geben Auskunft �ber die innere Arbeitsweise des Systems. Sie sind haupts�chlich f�r Entwickler interessant.</li>
<li id="klein"><tt>INFO:</tt> Diese Log-Meldungen geben Status-Informationen �ber den Ablauf des Webservices, wie z.B., dass eine neue Anfrage eingelangt ist.</li> 
<li id="klein"><tt>WARN:</tt> Bei der Ausf�hrung einer Operation sind leichte Fehler aufgetreten. Der Ablauf des Webservices ist nicht weiter beeintr�chtigt.</li>
<li id="klein"><tt>ERROR:</tt> Die Ausf�hrung einer Operation musste abgebrochen werden. Das Webservice ist davon nicht beeintr�chtigt. </li>
<li id="klein"><tt>FATAL:</tt> Es ist ein Fehler aufgetreten, der den weiteren Betrieb des Webservices nicht mehr erlaubt.</li>
</ul>
Der n�chste Wert <tt>&quot;01 21:25:26,540&quot;</tt>, gibt den Zeitpunkt an, an dem die Log-Meldung generiert wurde (in diesem Fall den 1. Tag im aktuellen Monat, sowie die genaue Uhrzeit). <br />
Der Wert <tt>Thread-3</tt> bezeichnet den Tomcat Worker-Thread, von dem die Anfrage bearbeitet wird.<br />
Der Wert von <tt>TID</tt> gibt die f�r jede Anfrage eindeutige Transaktions-ID an. Log-Meldungen, die bei der Abarbeitung dieser Anfrage geschrieben werden, enthalten alle einen Hinweis auf die entsprechende Transaktions-ID.<br />
Der Wert von <tt>NID</tt> gibt den Rechner-Knoten an, auf dem das MOA SP/SS Webservice l�uft (bei <tt>NID=&lt;null&gt;</tt> ist dieser Wert nicht konfiguriert).<br />
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.
<br /><br />


<b>Wichtige Log-Meldungen</b><br />
Neben den im Abschnitt "Starten und Stoppen von Tomcat" beschriebenen Log-Meldungen, die anzeigen, ob das Service ordnungsgem�� gestartet wurde, geben nachfolgenden Log-Meldungen Aufschluss �ber die Abarbeitung von Anfragen. Die Entgegennahme einer Anfrage wird angezeigt durch: 
</div>
<pre>
    INFO | 01 21:25:26,540 | Thread-3 | 
      TID=1049225059594-100 NID=&lt;null&gt; 
      MSG=Starte neue Transaktion: TID=1049225059594-100, 
      Service=SignatureVerification
    INFO | 01 21:25:26,540 | Thread-3 | 
      TID=1049225059594-100 NID=&lt;null&gt; 
      MSG=Aufruf von Adresse=127.0.0.1
    INFO | 01 21:25:26,540 | Thread-3 | 
      TID=1049225059594-100 NID=&lt;null&gt; 
      MSG=Client-Zertifikat nicht verf�gbar
</pre>

<div id="block">
Die 3. Log-Meldung besagt, dass f�r die Abarbeitung dieser Anfrage kein Client-Zertifikat verf�gbar ist (entweder, weil die Anfrage �ber HTTP eingelangt ist, oder weil die SSL Client-Authentisierung nicht eingeschaltet ist). Bei erfolgreicher SSL Client-Authentisierung, gibt beispielsweise folgende Log-Meldung Informationen �ber das Client-Zertifikat aus:
</div>
<pre>
    INFO | 12 13:58:08,772 | Thread-10 | 
      TID=1045054687159-2 NID=&lt;null&gt; 
      MSG=Client-Zertifikat: Subject=CN=Testuser, 
      OU=MOA, O=BRZ, L=Vienna, ST=Vienna, C=AT, 
      Serial=1.039.104.204, 
      Issuer=CN=TestCA, OU=MOA, O=BRZ, L=Vienna, 
      ST=Vienna, C=AT
</pre>

Eine erfolgreich abgearbeitete Anfrage wird angezeigt durch:

<pre>
    INFO | 01 21:25:53,168 | Thread-3 | 
      TID=1049225059594-106 NID=&lt;null&gt; 
      MSG=Anfrage erfolgreich abgearbeitet
</pre>

Ein Fehler beim Abarbeiten der Anfrage wird angezeigt durch: <br />
<pre>
    INFO | 01 21:25:27,642 | Thread-3 | 
      TID=1049225059594-100 NID=&lt;null&gt; 
      MSG=Fehler beim Abarbeiten der Anfrage
</pre>
<div id="block">
In diesem Fall gibt der mitgeloggte Stacktrace Auskunft �ber die Art des Fehlers. Der Aufrufer des MOA SP/SS Webservices bekommt einen Fehlercode sowie eine kurze Beschreibung des Fehlers als Antwort zur�ck.
<br /><br />
Die Tats�chlich �bertragenen Anfragen bzw. Antworten werden aus Effizienzgr�nden nur im Log-Level DEBUG angezeigt.
</div>
</div></td></tr></table>
<br /><br />



<table width="650" border="0" cellpadding="10" cellspacing="0">
<tr>
<td width="170" valign="top"><br /></td>
<td valign="top">
<hr />
<div style="font-size:8pt; color:#909090">&copy; 2003 <!-- Development Center, BRZ GmbH --></div>
</td></tr></table>
<br />


</div>
</div></div></div></div></body>
</html>