aboutsummaryrefslogtreecommitdiff
path: root/id.server/doc/moa_id
diff options
context:
space:
mode:
authorharald.bratko <harald.bratko@d688527b-c9ab-4aba-bd8d-4036d912da1d>2005-07-22 14:46:24 +0000
committerharald.bratko <harald.bratko@d688527b-c9ab-4aba-bd8d-4036d912da1d>2005-07-22 14:46:24 +0000
commit76a5c49eb5812b040550e3d30dae302487907fd7 (patch)
tree80e91fd2d9eef87bc6a3437d650f005359264ebd /id.server/doc/moa_id
parentd98c22fc6a00a1eeaea0c6ba6fc6da84c87826d0 (diff)
downloadmoa-id-spss-76a5c49eb5812b040550e3d30dae302487907fd7.tar.gz
moa-id-spss-76a5c49eb5812b040550e3d30dae302487907fd7.tar.bz2
moa-id-spss-76a5c49eb5812b040550e3d30dae302487907fd7.zip
Updated documentation to MOA WID mode.
git-svn-id: https://joinup.ec.europa.eu/svn/moa-idspss/trunk@391 d688527b-c9ab-4aba-bd8d-4036d912da1d
Diffstat (limited to 'id.server/doc/moa_id')
-rw-r--r--id.server/doc/moa_id/id-admin.htm2
-rw-r--r--id.server/doc/moa_id/id-admin_1.htm2
-rw-r--r--id.server/doc/moa_id/id-admin_2.htm116
-rw-r--r--id.server/doc/moa_id/id-anwendung_2.htm2
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.