Updated documentation to MOA WID mode.

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

4 files changed, 112 insertions, 10 deletions

diff --git a/id.server/doc/moa_id/id-admin.htm b/id.server/doc/moa_id/id-admin.htm
index 4f7d1f4ff..56558938b 100644
--- a/id.server/doc/moa_id/id-admin.htm
+++ b/id.server/doc/moa_id/id-admin.htm
@@ -70,7 +70,7 @@ Projekt <span style="font-size:48pt; ">moa</span>&#160;
 </td>
 
 <td valign="top">
-<div id="titel">MOA ID-Administration v.1.2</div>
+<div id="titel">MOA ID-Administration v.1.3</div>
 <p id="block">
 Die Komponenten des Moduls Identifikation (MOA-ID), MOA-ID-AUTH und MOA-ID-PROXY, sind als plattformunabh&auml;ngige Webapplikationen ausgelegt.
 MOA-ID-AUTH ist die Basiskomponente des Moduls, und MOA-ID-PROXY ist eine optionale Zusatzkomponente.
diff --git a/id.server/doc/moa_id/id-admin_1.htm b/id.server/doc/moa_id/id-admin_1.htm
index b51391739..a22efd4da 100644
--- a/id.server/doc/moa_id/id-admin_1.htm
+++ b/id.server/doc/moa_id/id-admin_1.htm
@@ -81,7 +81,7 @@ Projekt <span style="font-size:48pt; ">moa</span>&#160;
 </td>
 
 <td valign="top">
-<p id="titel">Basis-Installation v.1.2</p>
+<p id="titel">Basis-Installation v.1.3</p>
 Bei der Basis-Installation von MOA-ID-AUTH und von MOA-ID-PROXY ist grunds&auml;tzlich gleichartig vorzugehen.
 Unterschiede sind in der Installationsanweisung angef&uuml;hrt.
 <div id="vorbereitung" />
diff --git a/id.server/doc/moa_id/id-admin_2.htm b/id.server/doc/moa_id/id-admin_2.htm
index dfe488830..0e293972a 100644
--- a/id.server/doc/moa_id/id-admin_2.htm
+++ b/id.server/doc/moa_id/id-admin_2.htm
@@ -111,11 +111,11 @@ Projekt <span style="font-size:48pt; ">moa</span>&#160;
 </td>
 
       <td valign="top"> 
-        <div id="titel">Konfiguration von MOA ID v.1.2</div>
+        <div id="titel">Konfiguration von MOA ID v.1.3</div>
         <div id="moaid-konfiguration" /> 
-          <p id="subtitel">Konfiguration von MOA ID v.1.2</p>
+          <p id="subtitel">Konfiguration von MOA ID v.1.3</p>
           <p id="block"> Die Konfiguration von MOA ID wird mittels einer XML-basierten 
-            Konfigurationsdatei, die dem Schema <a href="../MOA-ID-Configuration-1.2.xsd" target="_new">MOA-ID-Configuration-1.2.xsd</a> 
+            Konfigurationsdatei, die dem Schema <a href="../MOA-ID-Configuration-1.3.xsd" target="_new">MOA-ID-Configuration-1.3.xsd</a> 
             entspricht, durchgef&uuml;hrt. 
           <p /> Der Ort der Konfigurationsdatei wird im Abschnitt <a href="id-admin_1.htm#deployment">Deployment 
             der Web-Applikation in Tomcat</a> beschrieben. 
@@ -319,6 +319,14 @@ Projekt <span style="font-size:48pt; ">moa</span>&#160;
                             Die Parameter betreffen teils die MOA-ID Authentisierungskomponente, 
                             teils die MOA-ID Proxykomponente, teils beide. <br />
                             <br />
+                            Das ab Version 1.3 optionale Attribut <tt>OnlineApplication/@type</tt>
+                            spezifiziert den Typ der OnlineApplikation und kann
+                            die Werte <tt>publicService</tt> f&uuml;r eine Applikation
+                            aus dem &ouml;ffentlichen Bereich und <tt>businessService</tt>
+                            für eine Anwendung aus dem privatwirtschaftlichen Bereich annehmen.
+                            Ist dieses Attribut nicht gesetzt, so wird der Typ <tt>publicService</tt>
+                            vorausgesetzt. <br />
+                            <br />
                             Das Attribut <tt>OnlineApplication/@publicURLPrefix</tt> 
                             entspricht dem URL-Pr&auml;fix der nach au&szlig;en 
                             sichtbaren Dom&auml;ne der Online-Applikation, welcher 
@@ -344,16 +352,110 @@ Projekt <span style="font-size:48pt; ">moa</span>&#160;
                               das Verhalten der Authentisierungskomponente bez&uuml;glich 
                               der Online-Applikation konfiguriert. <br />
                               <br />
+                              Das optionale Attribut <tt>slVersion</tt> definiert die Version des
+                              verwendeten SecurityLayer und damit den Namespace aller
+                              Requests, die von MOA-ID an die B&uuml;rgerkartenumgebung
+                              geschickt werden. Dieses Attribut kann entweder den Wert <tt>1.1</tt>
+                              oder <tt>1.2</tt> annehmen. Fehlt das Attribut, so wird als
+                              Defaultwert <tt>1.1</tt> gesetzt. 
+                              <br />Wurde als Typ der Online-Applikation
+                              der Wert <tt>businessService</tt> (vgl. Attribut <tt>OnlineApplication/@type</tt>)
+                              spezifiziert, so wird das Attribut <tt>slVersion</tt> ignoriert
+                              und immer der Wert <tt>1.2</tt> verwendet, da die f&uuml;r 
+                              Applikationen aus dem privatwirtschaftlichen Bereich notwendige
+                              Berechnung des <tt>wirtschaftsbereichsspezifischen Personenkennzeichens</tt>
+                              (<tt>wbPK</tt>) erst ab SecurityLayer Version <tt>1.2</tt> m&ouml;glich ist.
+                              <br /><br />
                               Das Attribut <tt>provideStammzahl</tt> bestimmt, 
                               ob die Stammzahl in den Anmeldedaten aufscheint 
-                              oder ob der Wert ausgeblendet (d.h. auf den Leerstring) 
+                              oder ob der Wert ausgeblendet (d.h. auf den Leerstring gesetzt) 
                               wird. Die Attribute <tt>provideAUTHBlock</tt> und 
-                              <tt>provideIdentityLink</tt> steuern ob die Anmeldedaten 
+                              <tt>provideIdentityLink</tt> steuern, ob die Anmeldedaten 
                               den Auth-Block bzw. die Personenbindung enthalten. 
+                              Ab Version 1.3 kann das Attribut <tt>provideSignerCertificate</tt> 
+                              verwendet werden, um das Signatorzertifikat in die
+                              Anmeldedaten aufzunehmen.
                               Alle Attribute sind optional und haben den Default-Wert 
                               <tt>false</tt>. <br />
                               <br />
                             </p>
+                            <div id="OnlineApplication/AuthComponent/IdentificationNumber" /> 
+                            <p id="block"> <b>OnlineApplication/AuthComponent/IdentificationNumber</b> 
+                              <br />
+                              Das <tt>wirtschaftsbereichsspezifische Personenkennzeichens</tt> (<tt>wbPK</tt>)
+                              wird aus der auf der B&uuml;rgerkarte gespeicherten Stammzahl des B&uuml;rgers
+                              und der Stammzahl des Wirtschaftsunternehmens berechnet.
+                              Laut <a href="http://reference.e-government.gv.at/E-Government-Gesetz.394.0.html" target="_new">E-Governmentgesetz</a>
+                              darf die <i>Errechnung eines wbPK aus der Stammzahl nicht beim Auftraggeber eines 
+                              privaten Bereichs durchgeführt werden</i> (vgl. E-GovGesetz §12(1).4), und muss deshalb 
+                              an die Bürgerkartenumgebung ausgelagert werden.
+                              Das <tt>OnlineApplication/AuthComponent/IdentificationNumber</tt> Element
+                              wird nun verwendet, um die Stammzahl des Wirtschaftsunternehmens zu spezifizieren,
+                              welche in weiterer Folge von MOA-ID an die B&uuml;rgerkartenumgebung übergeben
+                              wird.<br /> Dieses Element muss bei privatwirtschaftlichen Applikationen
+                              vorhanden sein und wird ignoriert, falls es im Kontext von Anwendungen aus
+                              dem &ouml;ffentlichen Bereich verwendet wird. <br />
+                              Das Element hat genau eines der folgenden m&ouml;glichen Kindelemente
+                              aus dem <a href="http://www.buergerkarte.at/konzept/personenbindung/spezifikation/20050214/" target="_new">PersonData</a>
+                              Namespace, die als einzigen Inhalt die jeweilige Stammzahl des Unternehmens enthalten:
+                              <ul>  
+                                  <li>
+                                  Das Element <tt>pr:Firmenbuchnummer</tt> enth&auml;lt als einzigen Inhalt
+                                  die Firmenbuchnummer des Unternehmens.
+                                  </li>
+                                  <li>
+                                  Das Element <tt>pr:Vereinsnummer</tt> enth&auml;lt als einzigen Inhalt
+                                  die Vereinsregisternummer des Unternehmens.
+                                  </li>
+                                  <li>
+                                  Das Element <tt>pr:ERJPZahl</tt> enth&auml;lt als einzigen Inhalt eine
+                                  Zahl aus dem Erg&auml;nzungsregister für nicht-natürliche Personen (CorporateBody).
+                                  </li>
+                                  <li>
+                                  Das Element <tt>pr:ZMRzahl</tt> enth&auml;lt als einzigen Inhalt eine
+                                  Stammzahl einer nat&uuml;rlichen in &Ouml;sterreich meldepflichtigen Person.
+                                  </li> 
+                              </ul>
+                              
+                              Die Stammzahl ist jeweils ohne Pr&auml;fix anzugeben, also wird zum Beispiel 
+                              die Firmenbuchnummer <tt>FN468924i</tt> folgendermaßen definiert:
+                              <br /> <br />
+                              <tt>&lt;pr:Firmenbuchnummer&gt;468924i&lt;/pr:Firmenbuchnummer&gt;</tt>
+				   			  <br /><br />
+				   			  Leerzeichen werden ignoriert und im Falle einer Firmenbuchnummer werden
+				   			  f&uuml;hrende Nullen gel&ouml;scht und Bindestriche aus der Nummer entfernt.
+				   			  <br /><br />
+				   			  Beispiele:<br />
+				   			  <blockquote>
+				   			  <tt>468924 i</tt> wird zu <tt>468924i</tt><br />
+				   			  <tt>00468924</tt> wird zu <tt>468924i</tt><br />
+				   			  <tt>468924-i</tt> wird zu <tt>468924i</tt><br />
+				   			  </blockquote>                               
+                            </p>
+                            
+                            <div id="OnlineApplication/AuthComponent/TransformsInfo" /> 
+                            <p id="block"> <b>OnlineApplication/AuthComponent/TransformsInfo</b> 
+                              <br />
+                            Dieses Kindelement kann mehrfach vorkommen und entspricht in seiner Struktur  
+                            dem Element <tt>AuthComponent/SecurityLayer/TransformsInfo</tt>.
+                            Das Element kann verwendet werden, um f&uuml;r unterschiedliche
+                            Online-Applikationen unterschiedliche Transformationen zu spezifizieren.
+                            Alle über dieses Element definierten Transformationen haben 
+                            Vorrang gegen&uuml;ber die durch <tt>AuthComponent/SecurityLayer/TransformsInfo</tt>
+                            angegebenen Transformationen. Das heißt, ist f&uuml;r eine 
+                            Online-Applikation das Kindelement <tt>AuthComponent/TransformsInfo</tt>
+                            vorhanden, so wird f&uuml;r diese Applikation die durch dieses Element
+                            spezifizierte Transformation verwendet (das Element kann nat&uuml;rlich
+                            mehrfach vorkommen, wodurch mehrere Transformationen bezeichnet werden).
+                            F&uuml;r alle Applkikationen, die kein Kindelement vom Typ
+                            <tt>AuthComponent/TransformsInfo</tt> enthalten, werden die unter
+                            <tt>AuthComponent/SecurityLayer/TransformsInfo</tt> spezifizierten
+                            &quot;Default-Transformationen&quot; verwendet. <br />
+                            Dabei ist zu beachten, dass f&uuml;r jede definierte Transformation
+                            ein entsprechendes <tt>MOA-SP/VerifyAuthBlock/VerifyTransformsInfoProfileID</tt>
+                            Element vorhanden sein muss.</p>                             
+                            </p>                           
+                            
                             <div id="OnlineApplication/ProxyComponent" /> 
                               <p id="block"> <b>OnlineApplication/ProxyComponent</b> 
                                 <br />
@@ -363,7 +465,7 @@ Projekt <span style="font-size:48pt; ">moa</span>&#160;
                                 <br />
                                 Das optionale Attribut <tt>configFileURL</tt> 
                                 verweist auf eine Konfigurationsdatei die dem 
-                                Schema <a href="../MOA-ID-Configuration-1.2.xsd" target="_new">MOA-ID-Configuration-1.2.xsd</a> 
+                                Schema <a href="../MOA-ID-Configuration-1.3.xsd" target="_new">MOA-ID-Configuration-1.3.xsd</a> 
                                 entspricht mit Dokument-Element <tt>Configuration</tt>. 
                                 Die Angabe erfolgt relativ zur verwendeten MOA-ID 
                                 Konfigurationsdatei. Beispiel f&uuml;r das Element 
@@ -623,7 +725,7 @@ Der Name der Konfigurationsdatei wird in der Konfiguration von MOA-ID als Wert d
 wobei <tt>&lt;realURLPrefix&gt;</tt> dem Konfigurationswert <tt>OnlineApplication/ProxyComponent/ConnectionParameter/@URL</tt> entspricht.
 <br /><br />
 Die Konfigurationsdatei ist eine XML-Datei, die dem Schema
-<a href="../MOA-ID-Configuration-1.2.xsd" target="_new">MOA-ID-Configuration-1.2.xsd</a> mit dem Wurzelelement 
+<a href="../MOA-ID-Configuration-1.3.xsd" target="_new">MOA-ID-Configuration-1.3.xsd</a> mit dem Wurzelelement 
 <tt>Configuration</tt> entspricht.
 </div>
 
diff --git a/id.server/doc/moa_id/id-anwendung_2.htm b/id.server/doc/moa_id/id-anwendung_2.htm
index a9b30b139..4622811e6 100644
--- a/id.server/doc/moa_id/id-anwendung_2.htm
+++ b/id.server/doc/moa_id/id-anwendung_2.htm
@@ -137,7 +137,7 @@ MOA-ID-AUTH liefert als Antwort einen &lt;samlp:Response&gt;. Die Anmeldedaten s
 <br/>
 <a href="../cs-sstc-schema-assertion-01.xsd">SAML 1.0 Assertion Schema</a>
 <br/>
-Der detaillierte Aufbau der &lt;saml:Assertion&gt; zu den Anmeldedaten ist in der <a href="../MOA_ID_1.2_20040315.pdf">Spezifikation MOA-ID 1.2</a> beschrieben.
+Der detaillierte Aufbau der &lt;saml:Assertion&gt; zu den Anmeldedaten ist in der <a href="../MOA_ID_1.3_20050722.pdf">Spezifikation MOA-ID 1.3</a> beschrieben.
 <br/><br/>
 <h4>Beispiel LoginServletExample</h4>
 Das Abholen der Anmeldedaten durch Aufruf des Web Service von MOA-ID-AUTH wird anhand eines beispielhaften Java Servlet gezeigt.