documentation enhanced (RSCH)

git-svn-id: https://joinup.ec.europa.eu/svn/moa-idspss/trunk@141 d688527b-c9ab-4aba-bd8d-4036d912da1d

1 files changed, 65 insertions, 45 deletions

diff --git a/id.server/doc/moa_id/id-anwendung_1.htm b/id.server/doc/moa_id/id-anwendung_1.htm
index 81c4ecc9e..c7f5f0e80 100644
--- a/id.server/doc/moa_id/id-anwendung_1.htm
+++ b/id.server/doc/moa_id/id-anwendung_1.htm
@@ -67,8 +67,6 @@ Projekt <span style="font-size:48pt; ">moa</span>&#160;
 	<b> Zurück</b></a></div>
 </br /><br />
 </td>
-
-
 <td valign="top">
 <p id="titel">Aufruf von MOA-ID-AUTH </p>
 <div id="block">MOA-ID-AUTH wird immer durch eine andere (verweisende) Webseite aufgerufen. Diese Webseite kann z.B. Teil eines Portals sein.
@@ -76,7 +74,6 @@ Der Aufruf erfolgt durch einen Verweis der Form: </div>
 <pre>&lt;a href=&quot;https://&lt;moa-id-server-und-pfad&gt;/
 StartAuthentication?Target=&lt;geschäftsbereich&gt;
 &OA=&lt;oa-url&gt;&Template=&lt;template-url&gt;&quot;&gt;</pre>
-
 <table border="1"><tbody valign="baseline">
 <tr>
 <td id="klein">&lt;moa-id-server-und-pfad&gt;</td><td id="klein">Server und Pfad, wo MOA-ID-AUTH installiert ist</td>
@@ -96,39 +93,40 @@ StartAuthentication?Target=&lt;geschäftsbereich&gt;
 <div id="block">
 <b>Template</b><br /><br />
 Ein <a href="examples/Template.html">Template</a> f&uuml;r die Anmeldeseite von MOA-ID-AUTH kann aus folgender Grundstruktur aufgebaut werden: </div>
-<pre>
-&lt;form name="CustomizedForm" action="&lt;BKU&gt;" method="post"&gt;
- &lt;input type="hidden"
-        name="XMLRequest"
-        value="&lt;XMLRequest&gt;"/&gt;
- &lt;input type="hidden"
-        name="DataURL"
-        value="&lt;DataURL&gt;"/&gt;
- &lt;input type="submit" value="B&uuml;rgerkarte lesen"/&gt;
-&lt;/form&gt;
-&lt;form name="CustomizedInfoForm"
- action="&lt;BKU&gt;"
- method="post"&gt;
- &lt;input type="hidden"
-        name="XMLRequest"
-        value="&lt;CertInfoXMLRequest&gt;"/&gt;
- &lt;input type="hidden"
-        name="DataURL"
-        value="&lt;CertInfoDataURL&gt;"/&gt;
-Hier finden Sie weitere Informationen 
-zur &Uuml;berpr&uuml;fung der Zertifikate.&lt;br/&gt;
- &lt;input type="submit" value="Weitere Info"/&gt;
-&lt;/form&gt;
-</pre>
-
-<div id="block">Innerhalb dieser <tt>&lt;form&gt;</tt>-Elemente k&ouml;nnen Texte, Beschriftungen und Styles modifiziert werden,
+<pre>&lt;!DOCTYPE HTML PUBLIC &quot;-//W3C//DTD HTML 4.01 Transitional//EN&quot;&gt;<br>&lt;html&gt;<br>&lt;head&gt;<br>&lt;title&gt;MOA ID - Identifizierter Zugang mit B&amp;uuml;rgerkarte&lt;/title&gt;
+	&lt;meta http-equiv=&quot;Content-Type&quot; content=&quot;text/html; charset=utf-8&quot;&gt;<br>&lt;/head&gt;</pre>
+<p>&lt;form name=&quot;CustomizedForm&quot; action=&quot;&lt;BKU&gt;&quot; method=&quot;post&quot;&gt;<br>
+&lt;div align=&quot;center&quot;&gt;<br>
+&lt;input type=&quot;hidden&quot;<br>
+name=&quot;XMLRequest&quot;<br>
+value=&quot;&lt;XMLRequest&gt;&quot;/&gt;<br>
+&lt;input type=&quot;hidden&quot;<br>
+name=&quot;DataURL&quot;<br>
+value=&quot;&lt;DataURL&gt;&quot;/&gt;<br>
+&lt;input type=&quot;submit&quot; value=&quot;Anmeldung mit B&amp;uuml;rgerkarte&quot; name=&quot;submit&quot;/&gt;<br>
+&lt;/div&gt;<br>
+&lt;/form&gt;<br>
+&lt;form name=&quot;CustomizedInfoForm&quot;<br>
+action=&quot;&lt;BKU&gt;&quot;<br>
+method=&quot;post&quot;&gt;<br>
+&lt;input type=&quot;hidden&quot;<br>
+name=&quot;XMLRequest&quot;<br>
+value=&quot;&lt;CertInfoXMLRequest&gt;&quot;/&gt;<br>
+&lt;input type=&quot;hidden&quot;<br>
+name=&quot;DataURL&quot;<br>
+value=&quot;&lt;CertInfoDataURL&gt;&quot;/&gt;<br>
+</p>
+<p> &lt;input type=&quot;hidden&quot; value=&quot;Weitere Info&quot;/&gt;<br>
+&lt;/form&gt;</p><p>&lt;/body&gt;<br>
+&lt;/html&gt;<br>
+</p>
+<pre>Innerhalb dieser <tt>&lt;form&gt;</tt>-Elemente k&ouml;nnen Texte, Beschriftungen und Styles modifiziert werden,
 und es k&ouml;nnen zus&auml;tzliche Elemente darin aufgenommen werden. 
 <br /><br />
 Die vorgegebene Grundstruktur ist aber in jedem Fall einzuhalten, und es m&uuml;ssen die speziellen
 Tags <tt>&lt;BKU&gt;</tt> (kommt 2x vor), <tt>&lt;XMLRequest&gt;</tt>, <tt>&lt;DataURL&gt;</tt>, <tt>&lt;CertInfoXMLRequest&gt;</tt> und <tt>&lt;CertInfoDataURL&gt;</tt>
 darin enthalten sein.
-</div>
-<br /><br />
+</pre><br /><br />
 
 <div id="block">
 <b>BKU-Auswahl</b><br /><br />
@@ -137,7 +135,6 @@ MOA-ID-AUTH bietet die M&ouml;glichkeit, die B&uuml;rgerkartenumgebung (BKU) aus
 SelectBKU?Target=&lt;geschäftsbereich&gt;
 &OA=&lt;oa-url&gt;&Template=&lt;template-url&gt;
 &BKUSelectionTemplate=&lt;bku-template-url&gt;&quot;&gt;</pre>
-
 <table border="1"><tbody valign="baseline">
 <tr><td id="klein">BKUSelectionTemplate= &lt;bku-template-url&gt;</td>
 <td id="klein">optional; HTML-Vorlage f&uuml;r der BKU-Auswahlseite von MOA-ID-AUTH.
@@ -150,20 +147,43 @@ SelectBKU?Target=&lt;geschäftsbereich&gt;
 <b>BKUSelectionTemplate</b><br /><br />
 Ein <a href="examples/BKUSelectionTemplate.html">Template f&uuml;r die BKU-Auswahl</a> von MOA-ID-AUTH kann aus folgender Grundstruktur aufgebaut werden: </div>
 <pre>
-&lt;form name="CustomizedForm" method="post" action="&lt;StartAuth&gt;"&gt;
- &lt;BKUSelect&gt;
- &lt;input type="submit" value="Ausw&auml;hlen"/&gt;
-&lt;/form&gt;
-</pre>
-<div id="block">Innerhalb dieser <tt>&lt;form&gt;</tt>-Elemente k&ouml;nnen Texte, Beschriftungen und Styles modifiziert werden,
-und es k&ouml;nnen zus&auml;tzliche Elemente darin aufgenommen werden. 
-<br /><br />
-Auch dabei ist die vorgegebene Grundstruktur einzuhalten, die speziellen Tags <tt>&lt;StartAuth&gt;</tt> und <tt>&lt;BKUSelect&gt;</tt> sind verpflichtend.
-</div>
-<br /><br />
+&lt;!DOCTYPE HTML PUBLIC &quot;-//W3C//DTD HTML 4.01 Transitional//EN&quot;&gt;<br>&lt;html&gt;<br>&lt;head&gt;<br>&lt;title&gt;MOA ID - Auswahl der B&amp;uuuml;rgerkartenumgebung&lt;/title&gt;
+	&lt;meta http-equiv=&quot;Content-Type&quot; content=&quot;text/html; charset=utf-8&quot;&gt;<br>&lt;/head&gt;</pre><p>&lt;form name=&quot;CustomizedForm&quot; method=&quot;post&quot; action=&quot;&lt;StartAuth&gt;&quot;&gt;<br>
+&lt;BKUSelect&gt; <br>
+&lt;input type=&quot;submit&quot; value=&quot;Ausw&amp;auml;hlen&quot;/&gt;<br>
+&lt;/form&gt;<br>
+&lt;br/&gt;<br>
+&lt;p&gt;&lt;/p&gt;</p>
+<p> &lt;input type=&quot;hidden&quot; value=&quot;Weitere Info&quot;/&gt;<br>
+&lt;/form&gt;</p>
+<p>&lt;/body&gt;<br>
+&lt;/html&gt;<br>
+</p>
+<p>
+
+
+Innerhalb dieser <tt>&lt;form&gt;</tt>-Elemente k&ouml;nnen Texte, Beschriftungen und Styles modifiziert werden,
+und es k&ouml;nnen zus&auml;tzliche Elemente darin aufgenommen werden. <br />
+<br />
+Auch dabei ist die vorgegebene Grundstruktur einzuhalten, die speziellen Tags <tt>&lt;StartAuth&gt;</tt> und <tt>&lt;BKUSelect&gt;</tt> sind verpflichtend.</p>
+<p><strong>Wichtiger Hinweis:</strong> wenn die Templates &uuml;ber HTTPS geladen werden sollten, so muss das SSL/TLS Zertifikat des Servers in einem Java Truststore gespeichert werden und dieser beim Start von Tomcat angegeben werden. </p>
+<strong>Vorgeschlagene Vorgehensweise:<br>
+</strong>
+<pre>
 
+1. Webserver SSL/TLS Zertifikat speichern im .cer Format speichern (z.B. mittels Internet Explorer).<br>
+2. Mittels Java Keytool das Zertifikat in einen Java Truststore importieren. </pre>
 
-</td></tr></table>
+Im folgenden Beispiel wird in den Java Truststore &quot;truststore.jks&quot; mit dem Passwort &quot;changeit&quot; importiert.<br>
+<pre>keytool -import -trustcacerts -alias mytomcat -file tomcat_localhost.cer -keystore truststore.jks</pre>
+<p>3. Truststore beim Starten von Tomcat angeben (&uuml;ber das Hinzuf&uuml;gen folgender Parameter in 
+  die Variable CATALINA_OPTS im Tomcat Startskript).</p>
+<p><br><pre>
+    -Djavax.net.ssl.trustStore=&lt;PFAD&gt;\truststore.jks<br>
+    -Djavax.net.ssl.trustStorePassword=changeit<br>
+    -Djavax.net.ssl.trustStoreType=jks <br /></pre>
+</p></td>
+</tr></table>
 
 
 
@@ -172,7 +192,7 @@ Auch dabei ist die vorgegebene Grundstruktur einzuhalten, die speziellen Tags <t
 <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>
+<div style="font-size:8pt; color:#909090">&copy; 2004</div>
 </td></tr></table>
 <br />