From 0dad4c7ff1b60d517d9f1a4ba121d083cfe5c036 Mon Sep 17 00:00:00 2001 From: Thomas Lenz Date: Mon, 22 Sep 2025 15:03:16 +0200 Subject: doc(core): add readme and update handbook --- .../handbook/config/MOA-SPSS-config-3.2.0.xsd | 386 -------------------- .../handbook/config/MOA-SPSS-config-3.3.0.xsd | 392 +++++++++++++++++++++ release-infos/handbook/handbook/config/config.html | 22 +- release-infos/handbook/handbook/index.html | 2 +- release-infos/readme_3.3.0.txt | 76 ++++ 5 files changed, 490 insertions(+), 388 deletions(-) delete mode 100644 release-infos/handbook/handbook/config/MOA-SPSS-config-3.2.0.xsd create mode 100644 release-infos/handbook/handbook/config/MOA-SPSS-config-3.3.0.xsd create mode 100644 release-infos/readme_3.3.0.txt diff --git a/release-infos/handbook/handbook/config/MOA-SPSS-config-3.2.0.xsd b/release-infos/handbook/handbook/config/MOA-SPSS-config-3.2.0.xsd deleted file mode 100644 index d9cecf1..0000000 --- a/release-infos/handbook/handbook/config/MOA-SPSS-config-3.2.0.xsd +++ /dev/null @@ -1,386 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/release-infos/handbook/handbook/config/MOA-SPSS-config-3.3.0.xsd b/release-infos/handbook/handbook/config/MOA-SPSS-config-3.3.0.xsd new file mode 100644 index 0000000..57c2e1d --- /dev/null +++ b/release-infos/handbook/handbook/config/MOA-SPSS-config-3.3.0.xsd @@ -0,0 +1,392 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/release-infos/handbook/handbook/config/config.html b/release-infos/handbook/handbook/config/config.html index a80c346..cd3e8d3 100644 --- a/release-infos/handbook/handbook/config/config.html +++ b/release-infos/handbook/handbook/config/config.html @@ -66,6 +66,7 @@
  • Profil für Transformationen
  • Profil für Signaturumgebung
  • XAdES Version
    • +
  • Allgemeine Signaturparameter
  • Parameter für MOA SP
      @@ -143,7 +144,7 @@

      1.2 Zentrale Konfigurationsdatei

      -

      Die Konfiguration von MOA SP/SS erfolgt zentral über eine einzige Konfigurationsdatei. Das Format der Konfigurationsdatei ist XML und muss dem Schema MOA-SPSS-config-3.2.0.xsd entsprechen. Abschnitt 2 erläutert die Konfigurationsmöglichkeiten im Einzelnen.

      +

      Die Konfiguration von MOA SP/SS erfolgt zentral über eine einzige Konfigurationsdatei. Das Format der Konfigurationsdatei ist XML und muss dem Schema MOA-SPSS-config-3.3.0.xsd entsprechen. Abschnitt 2 erläutert die Konfigurationsmöglichkeiten im Einzelnen.

      1.2.1 Aktualisierung auf das Format von MOA SP/SS 1.3

      Mit dem Wechsel auf Version 1.3 verwendet MOA SP/SS ein neues, übersichtlicheres Format für die @@ -401,6 +402,7 @@

    1. Element cfg:DigestMethodAlgorithm: Dieses optionale Element spezifiert einen Digest-Algorithmus, der für das Erstellen von XML-Signaturen mittels dieser Schlüsselgruppe verwendet werden soll. Der Default-Wert bzw. ein allfällig in Abschnitt "Parameter für XML-Signaturen" definierter Wert, werden dadurch für diese Schlüsselgruppe überschrieben. Mögliche Werte sind dem Element cfg:SignatureCreation/cfg:XMLDSig/cfg:DigestMethodAlgorithm ebenfalls in Abschnitt "Parameter für XML-Signaturen" zu entnehmen.
      2. +
    2. Attribut cfg:RSASSA-PSS: Dieses Attribut ermöglicht die Deaktivierung von RSASSA-PSS Algorithmen bei Verwendung von RSA Schlüsselmaterial. Falls nicht vorhanden wird der Defaultwert aus cfg:SignatureCreation/cfg:Signing verwendet.

      3. Um auf einfache Weise für alle in Ihren Schlüsselspeichern enthaltenen privaten Schlüssel die jeweiligen Werte für dsig:X509IssuerName und dsig:X509SerialNumber zu @@ -617,6 +619,24 @@ http://www.w3.org/2000/09/xmldsig#sha256
      http://www.w3.org/2000/09/xmldsig#sh +

      2.2.8 Allgemeine Signaturparameter

      + + + + + + + + + + + + + +
      Namecfg:SignatureCreation/cfg:Signing
      GebrauchNull mal bis einmal
      Erläuterung

      Dieses Element ermöglicht die Konfiguration allgemeiner Signaturparameter.

      +
        +
      • Attribut cfg:RSASSA-PSS: Dieses Attribut ermöglicht die Deaktivierung von RSASSA-PSS Algorithmen bei Verwendung von RSA Schlüsselmaterial. Falls nicht vorhanden oder der true als Attributwert wird RSASSA-PSS verwendet.
        • +

      2.3 Parameter für MOA SP

      diff --git a/release-infos/handbook/handbook/index.html b/release-infos/handbook/handbook/index.html index a0202a3..6672b68 100644 --- a/release-infos/handbook/handbook/index.html +++ b/release-infos/handbook/handbook/index.html @@ -15,7 +15,7 @@

      MOA: Serversignatur (SS) und Signaturprüfung (SP)

      -

      Übersicht zur Dokumentation der Version 3.2.x

      +

      Übersicht zur Dokumentation der Version 3.3.0

      Einführung
      diff --git a/release-infos/readme_3.3.0.txt b/release-infos/readme_3.3.0.txt new file mode 100644 index 0000000..b4bd661 --- /dev/null +++ b/release-infos/readme_3.3.0.txt @@ -0,0 +1,76 @@ +Releaseinfos zu MOA-SPSS Version 3.3.0 + - Änderungen: + - Mindestanforderungen + - Java 17 + - Apache Tomcat 10.1 (Jakarta Servlet 6.0) + - Verwendung von RSASSA-PSS Algorithmen als Default bei RSA Schlüsselmaterial + - Verbessertes Fehlerhändling in Trust-Status-List (TSL) Implementierung + - Aktualisierung von Drittherstellerbibliotheken + + +------------------------------------------------------------------------------- + Update einer bestehenden MOA-SPSS-Installation auf Version 3.3.0 +------------------------------------------------------------------------------- +Es gibt zwei Moeglichkeiten (im Folgenden als "Update Variante A" und +"Update Variante B" bezeichnet), das Update von MOA-SPSS auf Version +3.2.2 durchzufuehren. Update Variante A geht dabei den Weg ueber eine +vorangestellte Neuinstallation, waehrend Variante B direkt eine +bestehende Installation aktualisiert. + +Folgende Begriffe werden verwendet: + +JAVA_HOME bezeichnet das Wurzelverzeichnis der JDK-Installation + +CATALINA_HOME bezeichnet das Wurzelverzeichnis der Tomcat-Installation + +MOA_SPSS_WAR bezeichnet die Applikation MOA-SPSS in der Datei moa-spss-3.3.0.war + +MOA_SPSS_HANDBOOK bezeichnet das Archiv mit dem Handbuch und der Default Konfiguration + +-------------------------- +Update Variante A +-------------------------- + +1.) Erstellen Sie eine Sicherungskopie des kompletten Tomcat-Verzeichnisses + Ihrer MOA-SPSS-Installation. + +2.) Fuehren Sie eine Neuinstallation gemaess Handbuch durch. + +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. + + +-------------------------- +Update Variante B +-------------------------- + +1.) Erstellen Sie eine Sicherungskopie des kompletten Tomcat-Verzeichnisses + Ihrer MOA-SPSS-Installation. + +2.) Umstellung auf des Applikationsservers und der verwendeten Java Version + - Applikationsserver mindestes Apache Tomcat 10.1 + - JavaVM mindestens Java 17 + - Aktualisierung entsprechend der von Ihnen verwendeten Betriebsumgebung + +3.) Loeschen Sie das Verzeichnis CATALINA_HOME\webapps\moa-spss + +4.) Ersetzen Sie die Datei CATALINA_HOME\webapps\moa-spss.war durch die Datei + MOA_SPSS_WAR. + +5.) Loeschen Sie das Verzeichnis CATALINA_HOME\work. + +6.) Falls Sie eine externe Logger-Konfiguration verwenden müssen Sie die Logger-Konfiguration anpassen. + z.B. -Dlogback.configurationFile=CATALINA_HOME\config\moa-spss\logback.xml + Eine Beispielkonfiguration finden Sie unter MOA_SPSS_HANDBOOK\handbook\conf\moa-spss\logback.xml + +6.) Falls sie MOA-SP mit Trust-Status List (TSL) Unterstützung betreiben passen Sie + die Konfiguration entsprechend der TSL Konfiguration im Handbuch an. + +7.) Falls sie MOA-SP ohne Trust-Status List (TSL) Unterstützung betreiben gleichen Sie + nach bedarf die in der Konfiguration begelegten TrustStore für Zertifikate + MOA_SPSS_HANDBOOK/conf/moa-spss/trustProfiles/* + udnd das toBeAdded Verzeichnis des CertStores + MOA_SPSS_HANDBOOK/conf/moa-spss/certstore/toBeAdded/* + mit der von Ihnen aktuell verwendeten Konfiguration ab. -- cgit v1.2.3