diff options
| -rw-r--r-- | spss/handbook/handbook/usage/usage.html | 7 | ||||
| -rw-r--r-- | spss/server/history.txt | 11 | ||||
| -rw-r--r-- | spss/server/readme.update.txt | 69 |
3 files changed, 25 insertions, 62 deletions
diff --git a/spss/handbook/handbook/usage/usage.html b/spss/handbook/handbook/usage/usage.html index 690b7120f..d36fb13d1 100644 --- a/spss/handbook/handbook/usage/usage.html +++ b/spss/handbook/handbook/usage/usage.html @@ -63,8 +63,9 @@ <li><a href="#webservice_clients_gemeinsamkeiten">Gemeinsamkeiten</a></li> <li><a href="#webservice_clients_httpsserverauth">Besonderheiten von <code>HTTPSServerAuth.java</code></a></li> <li><a href="#webservice_clients_httpsclientauth">Besonderheiten von <code>HTTPSClientAuth.java</code></a></li> - </ol> + </ol> </li> + <li><a href="#readcert">Zertifikat einer Schlüsselgruppe auslesen</a></li> </ol> </li> <li><a href="#klassenbibliothek">Verwendung der Klassenbibliothek</a> @@ -1304,6 +1305,10 @@ Ich habe weiters ein eigenens ID-Attribut bekommen.</doc:Paragraph> <p>Diese Variante des Webservice-Clients baut im Schritt 3 des Kernablaufs aus <a href="#webservice_clients_gemeinsamkeiten">Abschnitt 2.2.2</a> eine SSL-Verbindung mit Server- und Client-Authentifizierung zum MOA SP/SS Server auf. In dieser SSL-Verbindung sendet der Webservice-Client dann den erstellten SOAP-Request über HTTPS.</p> <p>Die gegenüber <a href="#webservice_clients_httpsserverauth">Abschnitt 2.2.3</a> zusätzlich notwendige Konfiguration (Speicher für das SSL-Client-Zertifikat sowie den dazugehörigen privaten Schlüssel, Typ dieses Speichers, Passwort für diesen Speicher) wird mittels zusätzlicher Parameter in der in <a href="#webservice_clients_gemeinsamkeiten">Abschnitt 2.2.2</a> besprochenen Java-Properties-Datei vorgenommen. Genaue Infos zu diesen Konfigurationsparametern entnehmen Sie bitte der Quellcodedokumentation von <code><a href="../../clients/webservice/src/main/java/at/gv/egovernment/moa/spss/handbook/clients/webservice/HTTPSClientAuth.java">HTTPSClientAuth.java</a></code>. <a href="../../clients/webservice/conf/http.properties"><code>http.properties</code></a> enthält eine auf dieses Handbuch abgestimmte Konfiguration.</p> <p>Beachten Sie bitte auch den Hinweis zum SSL Logging aus <a href="#webservice_clients_httpsserverauth">Abschnitt 2.2.3</a>.</p> +<h2><a name="readcert" id="webservice_clients_httpsclientauth2"></a>2.3 Zertifikat einer Schlüsselgruppe auslesen</h2> +<p>Ab der Version 2.0.3 von MOA-SPSS kann das Zertifikat einer Schlüsselgruppe über ein Web Interface abgerufen werden. MOA-SPSS bietet hierfür folgenden Endpunkt:</p> +<pre>http(s)://......../moa-spss/Certificate?id=<Name der Schlüsselgruppe></pre> +<p>Mit dem http GET Parameter id kann die gewünsche Schlüsselgruppe ausgewählt werden.</p> <h1><a name="klassenbibliothek" id="klassenbibliothek"></a>3 Verwendung der Klassenbibliothek</h1> <p>Neben dem Betrieb von MOA SP/SS als Webservice ist als Alternative auch die Verwendung von MOA SP/SS als Klassenbibliothek möglich, also die direkte Einbindung in ein Java-Programm unter Verwendung des Application Programmers Interface (API) von MOA SP/SS. </p> <h2><a name="klassenbibliothek_vorbereitung" id="klassenbibliothek_vorbereitung"></a>3.1 Vorbereitung</h2> diff --git a/spss/server/history.txt b/spss/server/history.txt index 2dbd62760..9fbfd6a7d 100644 --- a/spss/server/history.txt +++ b/spss/server/history.txt @@ -1,4 +1,15 @@ ############## +2.0.3 +############## +- Neues Endpunkt zum Auslesen des Zertifikats einer Schlüsselgruppe hinzugefügt +- Libraries aktuallisert + > javax.xml.bind.jaxb-api 2.2.12 + > xerces.xercesImpl 2.11.0 + > xalan 2.7.2 + > serializer 2.7.2 + + +############## 2.0.2 ############## - Libraries aktuallisert diff --git a/spss/server/readme.update.txt b/spss/server/readme.update.txt index 144abc5bc..3ebf15565 100644 --- a/spss/server/readme.update.txt +++ b/spss/server/readme.update.txt @@ -1,5 +1,5 @@ ------------------------------------------------------------------------------- - Update einer bestehenden MOA-SPSS-Installation auf Version 2.0.2 + Update einer bestehenden MOA-SPSS-Installation auf Version 2.0.3 ------------------------------------------------------------------------------- Es gibt zwei Moeglichkeiten (im Folgenden als "Update Variante A" und "Update Variante B" bezeichnet), das Update von MOA-SPSS auf Version @@ -23,12 +23,9 @@ Update Variante A 1.) Erstellen Sie eine Sicherungskopie des kompletten Tomcat-Verzeichnisses Ihrer MOA-SPSS-Installation. -2.) Erstellen Sie eine Sicherungskopie aller "iaik*.jar"-Dateien im Verzeichnis - JAVA_HOME\jre\lib\ext, und loeschen Sie diese Dateien danach. +2.) Fuehren Sie eine Neuinstallation gemaess Handbuch durch. -3.) Fuehren Sie eine Neuinstallation gemaess Handbuch durch. - -4.) Kopieren Sie etwaige Konfigurationsdateien, Trust-Profile und Key-Stores, +3.) Kopieren Sie etwaige Konfigurationsdateien, Trust-Profile und Key-Stores, die Sie aus Ihrer alten Installation beibehalten moechten, aus Ihrer Sicherungskopie in die entsprechenden Verzeichnisse der neuen Installation. @@ -36,7 +33,7 @@ Update Variante A Update Variante B, Punkt 9 beschrieben vor, um Ihre alten Trustprofile auf einen aktuellen Stand zu bringen. -5.) Nur wenn alte Installation aelter als Version 1.3.0: +4.) Nur wenn alte Installation aelter als Version 1.3.0: Falls Sie Ihre alte MOA-SP Konfigurationsdatei weiterverwenden wollen: Seit dem Wechsel auf Version 1.3.1 verwendet MOA SP ein neues Format fuer die XML-Konfigurationsdatei. Sie muessen die Konfigurationsdatei fuer MOA-SP aus @@ -51,9 +48,9 @@ Update Variante B 1.) Erstellen Sie eine Sicherungskopie des kompletten Tomcat-Verzeichnisses Ihrer MOA-SPSS-Installation. -2.) Entpacken Sie die Datei "moa-spss-2.0.2.zip" in das Verzeichnis MOA_SPSS_INST. +2.) Entpacken Sie die Datei "moa-spss-2.0.3.zip" in das Verzeichnis MOA_SPSS_INST. -3.) Erstellen Sie eine Sicherungskopie aller "iaik*.jar"-Dateien im Verzeichnis +3.) Erstellen Sie eine Sicherungskopie aller "*.jar"-Dateien im Verzeichnis JAVA_HOME\jre\lib\ext und loeschen Sie diese Dateien danach. 4.) Kopieren Sie alle Dateien aus dem Verzeichnis MOA_SPSS_INST\ext in das @@ -71,58 +68,8 @@ Update Variante B MOA_SPSS_INST\moa-spss.war. 8.) Loeschen Sie das Verzeichnis CATALINA_HOME\work. - -9.) Update der Trust-Profile. - Wenn Sie Ihre alten Trust-Profile durch die neuen ersetzen wollen, dann gehen - Sie vor, wie in Punkt a). Wenn Sie Ihre eigenen Trust-Profile beibehalten wollen, - dann gehen Sie vor, wie in Punkt b). - - a) Gehen Sie wie folgt vor, um die Trust-Profile auszutauschen: - - 1) Loeschen Sie das Verzeichnis CATALINA_HOME\conf\moa-spss\trustProfiles. - 2) Kopieren Sie das Verzeichnis MOA_SPSS_INST\conf\moa-spss\trustProfiles - in das Verzeichnis CATALINA_HOME\conf\moa-spss. - - b) Falls Sie Ihre alten Trust-Profile beibehalten wollen, gehen Sie wie folgt vor, - um die Profile auf den aktuellen Stand zu bringen: - - 1) Loeschen Sie die Datei "C=AT,O=Hauptverband oesterr. Sozialvers.,CN=CRL-Signer.der" - aus jedem Trustprofil, in dem sie enthalten ist. (Je nachdem welche Version Sie - ursprünglich verwendet haben kann diese Datei auch in keinem Trustprofile vorhanden sein) - - 2) Loeschen Sie die Datei "OCSP Responder 02-20051027-20101027.der" aus jedem - Trustprofil, in dem sie enthalten ist. (Je nachdem welche Version Sie - ursprünglich verwendet haben kann diese Datei auch in keinem Trustprofile vorhanden sein) - - 3) Ergaenzen Sie ihre Trustprofile durch alle Zertifikate aus den entsprechenden Profilen - im Verzeichnis MOA_SPSS_INST\conf\moa-spss\trustProfiles, die nicht in Ihren - Profilen enthalten sind. Am einfachsten ist es, wenn Sie den Inhalt der einzelnen Profile - aus der Distribution (MOA_SPSS_INST\conf\moa-spss\trustProfiles) in die entsprechenden - Profile Ihrer Installation (CATALINA_HOME\conf\moa-spss\trustProfiles) kopieren und - dabei die vorhandenen gleichnamigen Zertifikate �berschreiben), also z.B: - - Kopieren des Inhalts von - MOA_SPSS_INST\conf\moa-spss\trustProfiles\certifiedSignature - nach - CATALINA_HOME\conf\moa-spss\trustProfiles\certifiedSignature - usw. - -10.) Update des Cert-Stores. - a) Kopieren Sie den Inhalt des Verzeichnisses MOA_SPSS_INST\conf\moa-spss\certstore - in das Verzeichnis CATALINA_HOME\conf\moa-spss\certstore. Wenn Sie gefragt werden, ob Sie - vorhandene Dateien oder Unterverzeichnisse ueberschreiben sollen, dann bejahen Sie das. - - b) Falls vorhanden, loeschen Sie die Datei "890A4C8282E95EBB398685D9501486EF213941B5" aus dem - Verzeichnis CATALINA_HOME\conf\moa-spss\certstore\10F17BDACD8DEAA1E8F23FBEAE7B3EC3D9773D1D. - - c) Falls die Datei "E7340D1FB627D8917A9C0D23F21515C441BF1214" noch nicht im Verzeichnis - CATALINA_HOME\conf\moa-spss\certstore\10F17BDACD8DEAA1E8F23FBEAE7B3EC3D9773D1D - enthalten ist, dann kopieren Sie diese Datei aus dem Verzeichnis - MOA_ID_INST_AUTH\conf\moa-spss\certstore\10F17BDACD8DEAA1E8F23FBEAE7B3EC3D9773D1D - in das Verzeichnis - CATALINA_HOME\conf\moa-spss\certstore\10F17BDACD8DEAA1E8F23FBEAE7B3EC3D9773D1D. - -11.) Nur wenn alte Installation aelter als Version 1.3.0: + +9.) Nur wenn alte Installation aelter als Version 1.3.0: Mit dem Wechsel auf Version 1.3.0 verwendet MOA SP ein neues Format fuer die XML-Konfigurationsdatei. Sie muessen die Konfigurationsdatei fuer MOA-SP aus Ihrer alten Installation auf das neue Format konvertieren. Details dazu |