=============================================================================== MOA ID Version 1.4.1 - Wichtige Informationen zur Installation =============================================================================== ------------------------------------------------------------------------------- A. Neuerungen/Änderungen ------------------------------------------------------------------------------- MOA-ID 1.4.1 enthält gegenüber der Version MOA ID 1.4.0 keine Neuigkeiten oder größere Änderungen. Es wurde mit diesem Versionssprung die Projektstruktur angepasst und der Build-Prozess mittels Maven (http://maven.apache.org/) optimiert. Der Inhalt und Funktion dieser Distribution ist derselbe wie von Version 1.4.0. Anstatt jedoch eine Source Distribution beizulegen, ist ab MOA-ID Version 1.4.1 der Sourcecode mittels Versionskontrollsystem Subversion über die Open-Source Plattform http://egovlabs.gv.at/ zugänglich ( http://egovlabs.gv.at/scm/?group_id=6). ------------------------------------------------------------------------------- D. Durchführung des Updates ------------------------------------------------------------------------------- ............................................................................... D.1 Durchführung eines Updates von Version 1.4.0 ............................................................................... 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.4.1.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 Stammverzeichnisses 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 Stammverzeichnisses 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 letzterer Variante ausgegangen). 7. Sollen zusätzliche Templates für ältere Bürgerkartenumgebungen aktiviert werden, öffnen Sie die XML-Konfiguration von MOA ID (für gewöhnlich finden Sie diese XML-Datei direkt im Stammverzeichnis 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. Fügen Sie zusätzlich zum bisherigen Inhalt dieses Elements (für gewöhnlich ein Element TransformsInfo, dessen Attribut filname den Wert transforms/TransformsInfoAuthBlockText.xml aufweist) ein Element TransformsInfo an, dessen Attribut filename auf die Datei für ältere BKU zeigt. Sie können auch auf die vordefinierten Elemente aus den Musterkonfigurationen dieser Distribution ( MOA_ID_AUTH_INST/conf/moa-id/SampleMOAIDConfiguration.xml) zurückgreifen. b. Fügen Sie Profilbezeichner für die Transformationsprofile in der Konfiguration für MOA SP an. Sie finden diesen Bezeichner im XML- Element /MOA-IDConfiguration/AuthComponent/MOA-SP/VerifyAuthBlock. Hängen Sie ein Element VerifyTransformsInfoProfileID an, das für die Über- prüfung der Transformation älterer BKU vorgesehen ist. Siehe auch Inhalt des Elements VerifyAuthBlock 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: Fügen Sie zusätzlich zu einem bestehenden Element TransformsInfo ein Elemnet TransformsInfo an, das die Transformation für ältere BKU enthält - gleich wie dies bereits in Schritt a. durchgeführt wurde (wenn Sie dieses Element nicht vorfinden, oder es auskommentiert ist, muss Schritt c. nicht durchgeführt werden). Öffnen Sie die XML-Konfiguration von MOA SPSS (für gewöhnlich finden Sie XML-Datei direkt im Stammverzeichnisses 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-Konfi- guration von MOA SPSS (Elemente des Namens cfg:VerifyTransformsInfoProfile). Fügen Sie zusätzlich zu den vorkommenden Elementen dieses Namens (für gewöhnlich zwei Elemente) zwei weitere Elemente dieses Namens hinzu, die die Profile für die älteren Bürger- kartenumgebungen aufnehmen - diese sind durch den Namensteil "_deprecated" gekennzeichnet (siehe auch Musterkonfigurationen dieser Distribution MOA_ID_AUTH_INST/conf/moa-spss/SampleMOASPSSConfiguration.xml). 8. Starten Sie den Tomcat neu, achten Sie auf eventuelle Fehlermeldungen im Logging von MOA ID beim Einlesen der erneuerten Konfiguration. ............................................................................... D.2 Durchführung eines Updates von Version 1.3.1, 1.3.2 oder 1.3.3 ............................................................................... 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.4.1.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 Stammverzeichnisses 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 Stammverzeichnisses 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 letzterer Variante ausgegangen). 7. Sollen zusätzliche Templates für ältere Bürgerkartenumgebungen aktiviert werden, öffnen Sie die XML-Konfiguration von MOA ID (für gewöhnlich finden Sie diese XML-Datei direkt im Stammverzeichnis 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. Fügen Sie zusätzlich zum bisherigen Inhalt dieses Elements (für gewöhnlich ein Element TransformsInfo, dessen Attribut filname den Wert transforms/TransformsInfoAuthBlockText.xml aufweist) ein Element TransformsInfo an, dessen Attribut filename auf die Datei für ältere BKU zeigt. Sie können auch auf die vordefinierten Elemente aus den Musterkonfigurationen dieser Distribution ( MOA_ID_AUTH_INST/conf/moa-id/SampleMOAIDConfiguration.xml) zurückgreifen. b. Fügen Sie Profilbezeichner für die Transformationsprofile in der Konfiguration für MOA SP an. Sie finden diesen Bezeichner im XML- Element /MOA-IDConfiguration/AuthComponent/MOA-SP/VerifyAuthBlock. Hängen Sie ein Element VerifyTransformsInfoProfileID an, das für die Über- prüfung der Transformation älterer BKU vorgesehen ist. Siehe auch Inhalt des Elements VerifyAuthBlock 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: Fügen Sie zusätzlich zu einem bestehenden Element TransformsInfo ein Elemnet TransformsInfo an, das die Transformation für ältere BKU enthält - gleich wie dies bereits in Schritt a. durchgeführt wurde (wenn Sie dieses Element nicht vorfinden, oder es auskommentiert ist, muss Schritt c. nicht durchgeführt werden). Öffnen Sie die XML-Konfiguration von MOA SPSS (für gewöhnlich finden Sie XML-Datei direkt im Stammverzeichnisses 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-Konfi- guration von MOA SPSS (Elemente des Namens cfg:VerifyTransformsInfoProfile). Fügen Sie zusätzlich zu den vorkommenden Elementen dieses Namens (für gewöhnlich zwei Elemente) zwei weitere Elemente dieses Namens hinzu, die die Profile für die älteren Bürger- kartenumgebungen aufnehmen - diese sind durch den Namensteil "_deprecated" gekennzeichnet (siehe auch Musterkonfigurationen dieser Distribution MOA_ID_AUTH_INST/conf/moa-spss/SampleMOASPSSConfiguration.xml). 8. Starten Sie den Tomcat neu, achten Sie auf eventuelle Fehlermeldungen im Logging von MOA ID beim Einlesen der erneuerten Konfiguration. ............................................................................... B.3 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.