diff options
Diffstat (limited to 'id.server/readme.txt')
| -rw-r--r-- | id.server/readme.txt | 138 |
1 files changed, 0 insertions, 138 deletions
diff --git a/id.server/readme.txt b/id.server/readme.txt deleted file mode 100644 index bea3de757..000000000 --- a/id.server/readme.txt +++ /dev/null @@ -1,138 +0,0 @@ -=============================================================================== -MOA ID Version 1.3.3 - Wichtige Informationen zur Installation -=============================================================================== - -------------------------------------------------------------------------------- -A. Neuerungen/Änderungen -------------------------------------------------------------------------------- - -MOA ID Version 1.3.3 bringt folgende Neuerungen: - -- Unterstützung der Parameterübertragung mittels multipart/form-data in den - Servlets VerifyIdentityLinkServlet (Entgegenname der Personenbindung von der - BKU) und VerifyAuthBlockServlet (Entgegenname des signierten AuthBlocks von - der BKU). Diese Form der Parameterübertragung wurde von Security Layer - Version 1.2 verpflichtend eingeführt. Damit funktioniert MOA-ID nun auch mit - Security Layer Requests der Version 1.2, was eine Voraussetzung für die - Verwendung von MOA ID im Bereich der Privatwirtschaft (wbPK als eindeutiges - Personenkennzeichen) ist. - -- Die Templates für den sogenannten AuthBlock, also jenes Dokument, das im Zuge - der Anmeldung vom Bürger/Kunden elektronisch signiert wird, wurden in der - ausgelieferten Musterkonfiguriation so erweitert, dass sowohl aktuelle BKU - (Security-Layer Version 1.2, Anzeigeformat SLXHTML) als auch ältere BKU - (Security-Layer Version 1.1, z.B. hot:Sign Version 1.3 mit einem propriätären - HTML-Dialekt als Anzeigeformat) unterstützt werden. - -------------------------------------------------------------------------------- -B. Gründe für ein Update -------------------------------------------------------------------------------- - -Sie sollten Ihre bestehende, ältere Installation von MOA ID auf die Version -1.3.3 aktualisieren, wenn einer der folgenden Punkte zutrifft: - -- Sie möchten Ihre Installation für Anwendungen im Bereich der Privatwirtschaft - verwenden (Verwendung des wirtschaftsbereichspezifischen Personenkennzeichens - wbpk). - -- Sie möchten Ihre Installation mit Templates für den AuthBlock (also jenes - Dokument, das im Zuge der Anmeldung vom Bürger/Kunden elektronisch signiert - wird) betreiben, die sowohl von aktuellen als auch von älteren Bürgerkarten- - umgebungen (BKU) unterstützt werden. - -------------------------------------------------------------------------------- -C. Durchführung des Updates -------------------------------------------------------------------------------- - -............................................................................... -C.1 Durchführung eines Updates von der Version 1.3.1 oder 1.3.2 -............................................................................... - -1. Stoppen Sie den Tomcat, in dem Ihre bisherige Installation betrieben wird. - Fertigen Sie eine Sicherungskopie Ihrer kompletten Tomcat-Installation an. - -2. Entpacken Sie die Distribution von MOA ID Auth (moa-id-auth-1.3.3.zip) in - ein temporäres Verzeichnis, in weiterer Folge als MOA_ID_AUTH_INST - bezeichnet. - -3. Wechseln Sie in jenes Verzeichnis, das die Webapplikation von MOA ID Auth - beinhaltet (für gewöhnlich ist dieses Verzeichnis CATALINA_HOME_ID/webapps, - wobei CATALINA_HOME_ID für das Basisverzeichnis der Tomcat-Installation - für MOA ID steht). Löschen Sie darin sowohl die Datei moa-id-auth.war als - auch das komplette Verzeichnis moa-id-auth. - -4. Kopieren Sie die Datei MOA_ID_AUTH_INST/moa-id-auth.war nach - CATALINA_HOME_ID/webapps. - -5. Kopieren Sie die vier Dateien aus dem Verzeichnis - MOA_ID_AUTH_INST/conf/moa-id/transforms in das Verzeichnis transforms Ihres - Stammverzeichnises für die MOA ID Konfiguration (für gewöhnlich lautet - dieses Stammverzeichnis CATALINA_HOME_ID/conf/moa-id; in weiterer Folge wird - davon ausgegangen). - -6. Kopieren Sie die vier Dateien aus dem Verzeichnis - MOA_ID_AUTH_INST/conf/moa-spss/profiles in das Verzeichnis profiles Ihres - Stammverzeichnises für die MOA SPSS Konfiguration (für gewöhnlich lautet - dieses Stammverzeichnis CATALINA_HOME_SPSS/conf/moa-spss, wobei - CATALINA_HOME_SPSS für das Basisverzeichnis der Tomcat-Installation - für MOA SPSS steht; wenn Sie MOA SPSS nicht als eigenes Webservice - betreiben, sondern es von MOA ID über die API-Schnittstelle angesprochen - wird, lautet dieses Stammverzeichnis für gewöhnlich - CATALINA_HOME_ID/conf/moa-spss; in weiterer Folge wird von letzerer - Variante ausgegangen). - -7. Öffen Sie die XML-Konfiguration von MOA ID (für gewöhnlich finden Sie diese - XML-Datei direkt im Stammverzeichnises für die MOA ID Konfiguration, z.B. - CATALINA_HOME_ID/conf/moa-id/SampleMOAIDConfiguration.xml); führen Sie - folgende Modifikationen an der XML-Konfiguration durch: - - a. Ändern Sie die applikationsübergreifende Konfiguration der AuthBlock - Transformationen. Sie finden diese Konfiguration im XML-Element - /MOA-IDConfiguration/AuthComponent/SecurityLayer. Ersetzen Sie den - bisherigen Inhalt dieses Elements (für gewöhnlich ein Element - TransformInfo, dessen Attribut filname den Wert - transforms/TransformsInfoAuthBlockText.xml aufweist), durch den Inhalt - des gleichnamigen Elements aus der Musterkonfiguration dieser Distri- - bution (MOA_ID_AUTH_INST/conf/moa-id/SampleMOAIDConfiguration.xml). - - b. Ändern Sie die Profilbezeichner für die Transformationsprofile in der - Konfiguration für MOA SP. Sie finden diesen Bezeichner im XML- - Element /MOA-IDConfiguration/AuthComponent/MOA-SP/VerifyAuthBlock. - Ersetzen Sie den kompletten bisherigen Inhalt dieses Elements durch - den Inhalt des gleichnamigen Elements aus der Musterkonfiguration dieser - Distribution (MOA_ID_AUTH_INST/conf/moa-id/SampleMOAIDConfiguration.xml). - - c. Ändern Sie gegebenenfalls die applikationsspezifische Konfiguration - der Authblock-Tranformationen. Führen Sie dazu die folgende Tätigkeit - für jedes XML-Element /MOA-IDConfiguration/OnlineApplicaton/AuthComponent - durch: Ersetzen Sie das ggf. bisher in diesem XML-Element vorkommende - Element des Namens TransformInfo durch durch die beiden XML-Elemente - des Namens TransformInfo, die Sie bereits in Schritt a. aus der - Musterkonfiguration übernommen haben (wenn Sie dieses Element nicht - vorfinden, oder es auskommentiert ist, brauchen Sie das Ersetzen nicht - durchführen). - -8. Öffnen Sie die XML-Konfiguration von MOA SPSS (für gewöhnlich finden Sie - XML-Datei direkt im Stammverzeichnises für die MOA SPSS Konfiguration, z.B. - CATALINA_HOME_ID/conf/moa-spss/SampleMOASPSSConfiguration.xml); führen Sie - folgende Modifikationen an der XML-Konfiguration durch: - - a. Ändern Sie die konfigurierten Profile für die zulässigen Transformationen - über die signierten Daten. Sie finden diese Profile am Ende der - XML-Konfiguration von MOA SPSS (Elemente des Namens - cfg:VerifyTransformsInfoProfile). Ersetzen Sie alle vorkommenden Elemente - dieses Namens (für gewöhnlich zwei Elemente) durch die vier Elemente - dieses Namens aus der Musterkonfiguration dieser Distribution - (MOA_ID_AUTH_INST/conf/moa-spss/SampleMOASPSSConfiguration.xml). - -9. Starten Sie den Tomcat neu, achten Sie auf eventuelle Fehlermeldungen im - Logging von MOA ID beim Einlesen der erneuerten Konfiguration. - -............................................................................... -C.2 Durchführung eines Updates von einer älteren Version -............................................................................... - -Bitte führen Sie eine Neuinstallation von MOA ID laut Handbuch durch und passen -Sie die mitgelieferte Musterkonfiguration entsprechend Ihren Bedürfnissen unter -Zuhilfenahme Ihrer bisherigen Konfiguration an. - |