<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <meta http-equiv="content-type" content="text/html; charset=iso-8859-1"> <title>Die österreichische Bürgerkarte - Einführung</title> <link rel="stylesheet" href="../common/MOA.css" type="text/css"> </head> <body bgcolor="white" text="#000000" link="#990000" vlink="#666666" alink="#cc9966"> <table class="logoTable" width="100%" border="0" cellspacing="0" cellpadding="10"> <tr> <td align="center" width="30%"><img src="../common/LogoBKA.png" width="267" height="36" alt="Logo BKA"></td> <td align="center" class="logoTitle"><div align="right">Open Source für das E-Government</div></td> </tr> </table> <hr/> <p class="title"><a href="../index.html">MOA: Serversignatur (SS) und Signaturprüfung (SP), V 1.2 </a></p> <p class="subtitle">Konfiguration</p> <hr/> <h1>Inhalt</h1> <ol> <li> <p><a href="#übersicht">Übersicht</a></p> <ol> <li><a href="#übersicht_zentraledatei">Zentrale Konfigurationsdatei</a></li> <li><a href="#übersicht_bekanntmachung">Bekanntmachung der Konfigurationsdatei </a> <ol> <li><a href="#übersicht_bekanntmachung_laufenderbetrieb">Aktualisierung der Konfiguration im laufenden Betrieb</a></li> </ol> </li> <li><a href="#übersicht_logging">Konfiguration des Loggings</a></li> </ol> </li> <li><a href="#konfigurationsparameter">Konfigurationsparameter</a></li> <li><a href="#beispielkonfigurationen">Beispielkonfigurationen</a></li> <li>Typische Konfigurationsaufgaben </li> </ol> <hr/> <h1><a name="�bersicht" id="�bersicht"></a>1 Übersicht </h1> <p>Dieses Handbuch beschreibt detailliert die Konfigurationsmöglichkeiten für MOA SP/SS. Wenn nicht anders angegeben, beziehen sich die Erläuterungen sowohl auf die Konfiguration des Webservices als auch auf die Konfiguration von MOA SP/SS für den Einsatz als Klassenbibliothek.</p> <h2><a name="�bersicht_zentraledatei" id="�bersicht_zentraledatei"></a>1.1 Zentrale Konfigurationsdatei</h2> <p>Die Konfiguration von MOA SP/SS erfolgt zentral über eine einzige Konfigurationsdatei. Das Format der Konfigurationsdatei ist XML und muss dem Schema <a href="./MOA-SPSS.config.xsd">MOA-SPSS.config.xsd</a> entsprechen. <a href="#konfigurationsparameter">Abschnitt 2</a> erläutert die Konfigurationsmöglichkeiten im Einzelnen.</p> <h2><a name="�bersicht_bekanntmachung" id="�bersicht_bekanntmachung"></a>1.2 Bekanntmachung der Konfigurationsdatei</h2> <p>Die zentrale Konfigurationsdatei von MOA SP/SS wird der <span class="term">Java Virtual Machine</span>, in der MOA SP/SS läuft, durch ein <span class="term">VM Argument</span> mitgeteilt. Der Name des <span class="term">VM Argument</span> lautet <code>moa.spss.server.configuration</code>; als Wert des Parameters ist der Pfad sowie der Name der Konfigurationsdatei im Dateisystem anzugeben, z.B.</p> <pre>moa.spss.server.configuration=C:/Programme/apache/tomcat-4.1.30/conf/moa-spss/moa-spss.config.xml </pre> <p>Weitere Informationen zum Bekanntmachen der zentralen Konfigurationsdatei MOA SP/SS erhalten Sie in <span class="comment">Abschnitt TBD des Installationshandbuchs</span>.</p> <h3><a name="�bersicht_bekanntmachung_laufenderbetrieb" id="�bersicht_bekanntmachung_laufenderbetrieb"></a>1.2.1 Aktualisierung der Konfiguration im laufenden Betrieb</h3> <p>Wird MOA SP/SS als Webservice eingesetzt, kann durch Aufrufen einer speziellen URL des Webservice ein erneutes Einlesen der Konfigurationsdatei erzwungen werden. Damit ist es möglich, Änderungen an der Konfigurationsdatei vorzunehmen, und diese Änderungen ohne Neustart des zu Grunde liegenden Servlet Containers in den Betrieb zu übernehmen.</p> <p>Weitere Informationen zum erneuten Einlesen der Konfigurationsdatei im Webservice-Betrieb erhalten Sie in <span class="comment">Abschnitt TBD des Installationshandbuchs</span>.</p> <h2><a name="�bersicht_logging" id="�bersicht_logging"></a>1.3 Konfiguration des Loggings</h2> <p>MOA SP/SS verwendet als Framework für Logging-Information die Open Source Software <code>log4j</code>. Die Konfiguration der Logging-Information erfolgt nicht direkt durch MOA SP/SS, sondern über eine eigene Konfigurationsdatei, die der <span class="term">Java Virtual Machine</span> durch ein <span class="term">VM Argument</span> mitgeteilt wird. Der Name des <span class="term">VM Argument</span> lautet <code>log4j.configuration</code>; als Wert des Parameters ist eine URL anzugeben, die auf die <code>log4j</code>-Konfigurationsdatei verweist, z.B.</p> <p> <pre>log4j.configuration=file:/C:/Programme/apache/tomcat-4.1.30/conf/moa-spss/log4j.properties</pre> Weitere Informationen zur Konfiguration des Loggings erhalten Sie in <span class="comment">Abschnitt TBD des Installationshandbuchs</span>. </p> <h1><a name="konfigurationsparameter"></a>2 Konfigurationsparameter</h1> <p>Nachfolgend werden die verfügbaren Konfigurationsparameter der zentralen Konfigurationsdatei im Detail erläutert. Die Reihenfolge der Abhandlung entspricht der Reihenfolge des vorgeschriebenen Auftretens in der Konfigurationsdatei. Für beispielhafte Konfigurationsdateien siehe <a href="#beispielkonfigurationen">Abschnitt 3</a>. </p> <p>Muss der Wert eines Konfigurationsparameters eine URL oder eine Pfadangabe sein, und wird als konkreter Wert eine relative URL bzw. ein relativer Pfad angegeben, so wird diese Angabe relativ zum Pfad jenes Verzeichnisses interpretiert, in dem die zentrale Konfigurationsdatei gespeichert ist.</p> <p>Präfixe für Namenräume von XML-Elementen werden wie folgt verwendet:</p> <table class="fixedWidth" border="1" cellpadding="2"> <tr> <th scope="col">Präfix</th> <th scope="col">Namenraum</th> </tr> <tr> <td><code>cfg</code></td> <td><code>http://reference.e-government.gv.at/namespace/moaconfig/20021122#</code></td> </tr> <tr> <td><code>dsig</code></td> <td><code>http://www.w3.org/2000/09/xmldsig#</code></td> </tr> </table> <h2><a name="konfigurationsparameter_kanonisierungsalgorithmus" id="konfigurationsparameter_kanonisierungsalgorithmus"></a>2.1 Kanonisierungs-Algorithmus</h2> <table class="fixedWidth" border="1" cellpadding="2"> <tr> <td>Name</td> <td><code>cfg:CanonicalizationAlgorithm</code></td> </tr> <tr> <td>Gebrauch</td> <td>optional</td> </tr> <tr> <td>Erläuterung</td> <td><p> Als Inhalt des Elements kann der Kanonisierungs-Algorithmus, der für das Erstellen von XML-Signaturen verwendet werden soll und in der Signatur als Inhalt von <code>dsig:Signature/dsig:SignedInfo/dsig:CanonicalizationMethod</code> aufscheint, spezifiziert werden. Folgende Werte dürfen verwendet werden:</p> <p> <pre>http://www.w3.org/TR/2001/REC-xml-c14n-20010315 <br>http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithComments <br>http://www.w3.org/2001/10/xml-exc-c14n# <br>http://www.w3.org/2001/10/xml-exc-c14n#WithComments </pre> </p> <p>Wird das Element nicht angegeben, wird folgender Wert als Default-Wert verwendet:</p> <pre>http://www.w3.org/TR/2001/REC-xml-c14n-20010315 </pre> <p>F�r die genaue Bedeutung der Werte siehe die <a href="http://www.w3.org/TR/xmldsig-core/" target="_blank">Spezifikation f�r XML-Signaturen</a>.</p></td> </tr> </table> <h2><a name="konfigurationsparameter_digestsalgorithmus" id="konfigurationsparameter_digestsalgorithmus"></a>2.2 Digest-Algorithmus</h2> <table class="fixedWidth" border="1" cellpadding="2"> <tr> <td>Name</td> <td><code>cfg:DigestAlgorithm</code></td> </tr> <tr> <td>Gebrauch</td> <td>optional</td> </tr> <tr> <td>Erläuterung</td> <td><p> Als Inhalt des Elements kann der Digest-Algorithmus, der für das Erstellen von XML-Signaturen verwendet werden soll und in der Signatur als Inhalt von <code>dsig:Signature/dsig:SignedInfo/dsig:Reference/dsig:DigestMethod</code> aufscheint, spezifiziert werden. Folgende Werte dürfen verwendet werden:</p> <p> <pre>http://www.w3.org/2000/09/xmldsig#sha1 </pre> <p></p> <p>Wird das Element nicht angegeben, wird folgender Wert als Default-Wert verwendet:</p> <pre>http://www.w3.org/2000/09/xmldsig#sha1</pre> <p>Für die genaue Bedeutung der Werte siehe die <a href="http://www.w3.org/TR/xmldsig-core/" target="_blank">Spezifikation für XML-Signaturen</a>.</p></td> </tr> </table> <h2> </h2> <h1><a name="beispielkonfigurationen"></a>3 Beispielkonfigurationen </h1> <p> </p> </body> </html>