From ffc1157b1ba58848f1c56000cb17aaf4b9885f56 Mon Sep 17 00:00:00 2001 From: Thomas <> Date: Fri, 1 Jul 2022 17:12:22 +0200 Subject: doc: add first draft of readme and update handbook --- infos/readme_1.3.1.md | 49 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 infos/readme_1.3.1.md (limited to 'infos/readme_1.3.1.md') diff --git a/infos/readme_1.3.1.md b/infos/readme_1.3.1.md new file mode 100644 index 00000000..36746f64 --- /dev/null +++ b/infos/readme_1.3.1.md @@ -0,0 +1,49 @@ +# MS-Connector v1.3.1 Release vom xx.07.2022 + +Der MS-Connector implementiert eine Bridge zwischen dem österreichischen E-ID System und dem eIDAS Framework um ausländischen Benutzern eine Anmeldung am österreichischen Service-Providern zu ermöglichen. + +### Änderungen in dieser Version + + - Mindestens Java 11 erforderlich + - Erweitertes Identitätsmatching welches sowohl bestehende ZMR und ERnP Einträge berücksichtigt + - Integration der vom BM.I übermittelten UX Templates in die Beispielkonfiguration + - Bugfix + - Fehler bei der Verarbeitung von leeren Attributewerten behoben + - Akutalisierung von Drittherstellerbibliotheken + - openSAML 4.0.1 + - EAAF-Components 1.3.2 + - SpringBoot 2.5.13 + - Spring-Framework 5.3.20 + - Apache CXF 3.5.2 + + +### Durchführen eines Updates + +Nachfolgend finden Sie die erforderlichen Schritte für das Update eines bestehenden MS-specific eIDAS Connectors auf die aktuelle Version 1.3.1. Das vollständige Handbuch mit allen Konfigurationsparametern finden Sie im Releasepackage im Verzeichnis: _infos/handbook/_ + +### Ausgehend von einer bestehenden Version 1.2.x + +1. Stoppen Sie die *MS-Connector* Applikation und fertigen Sie eine Sicherungskopie Ihrer Applikation inklusive Konfiguration an + +2. Entpacken Sie das Releasepacket *ms_specific_connector-1.3.1-dist.zip* in ein temporäres Verzeichnis welches in weiterer Folge __MsConnectorPackage__ bezeichnet wird. + +3. Kopieren sie die Applikation __MsConnectorPackage__/ms_connector.war nach in das Applikationsverzeichnis ihres Applikationsservers + +4. Update bestehender Dateien . Die nachfolgenden Dateien wurden geändert und erfordern eine Anpassung oder eine Übernahme dem Releasepacket, sofern die Anpassung nicht bereits durchgeführt wurde + + * Vollständige Übernahme: __MsConnectorPackage__/config/templates/other_login_method.html + * Vollständige Übernahme: __MsConnectorPackage__/config/templates/residency.html + * Vollständige Übernahme: __MsConnectorPackage__/config/properties/messages.properties + * Vollständige Übernahme: __MsConnectorPackage__/config/properties/messages_de.properties + * Vollständige Übernahme: __MsConnectorPackage__/config/keys/id_austria_truststore.jks + +6. Neue optionale Konfigurationsparameter + + - *Matching allgemein* + + - ```eidas.ms.auth.eIDAS.matching.byaddress.enable``` + - ```eidas.ms.auth.eIDAS.matching.byaddress.maxresults``` + + + + -- cgit v1.2.3 From e74f79ea814da1e0dafec9adfe56ed2fba0b6ed5 Mon Sep 17 00:00:00 2001 From: Thomas <> Date: Tue, 5 Jul 2022 15:58:54 +0200 Subject: doc: finalize readme and history for next release --- infos/readme_1.3.1.md | 52 +++++++++++++++++++++++++++++++++++---------------- 1 file changed, 36 insertions(+), 16 deletions(-) (limited to 'infos/readme_1.3.1.md') diff --git a/infos/readme_1.3.1.md b/infos/readme_1.3.1.md index 36746f64..a32eaacd 100644 --- a/infos/readme_1.3.1.md +++ b/infos/readme_1.3.1.md @@ -1,27 +1,21 @@ -# MS-Connector v1.3.1 Release vom xx.07.2022 +# MS-Connector v1.3.1 Release vom 05.07.2022 Der MS-Connector implementiert eine Bridge zwischen dem österreichischen E-ID System und dem eIDAS Framework um ausländischen Benutzern eine Anmeldung am österreichischen Service-Providern zu ermöglichen. ### Änderungen in dieser Version - - Mindestens Java 11 erforderlich - - Erweitertes Identitätsmatching welches sowohl bestehende ZMR und ERnP Einträge berücksichtigt - - Integration der vom BM.I übermittelten UX Templates in die Beispielkonfiguration + - Optimierung und Fehlerkorrektur für UX basierten Matching-Schritten + - Konfigurierbare Maximalanzahl von Ergebnissen bei Adresssuche + - Statistiklogger um Matching-Informationen erweitert - Bugfix - - Fehler bei der Verarbeitung von leeren Attributewerten behoben - - Akutalisierung von Drittherstellerbibliotheken - - openSAML 4.0.1 - - EAAF-Components 1.3.2 - - SpringBoot 2.5.13 - - Spring-Framework 5.3.20 - - Apache CXF 3.5.2 + - Sortierung bei Adresssuchergebnissen optimiert ### Durchführen eines Updates Nachfolgend finden Sie die erforderlichen Schritte für das Update eines bestehenden MS-specific eIDAS Connectors auf die aktuelle Version 1.3.1. Das vollständige Handbuch mit allen Konfigurationsparametern finden Sie im Releasepackage im Verzeichnis: _infos/handbook/_ -### Ausgehend von einer bestehenden Version 1.2.x +### Ausgehend von einer bestehenden Version 1.3.0 1. Stoppen Sie die *MS-Connector* Applikation und fertigen Sie eine Sicherungskopie Ihrer Applikation inklusive Konfiguration an @@ -35,15 +29,41 @@ Nachfolgend finden Sie die erforderlichen Schritte für das Update eines bestehe * Vollständige Übernahme: __MsConnectorPackage__/config/templates/residency.html * Vollständige Übernahme: __MsConnectorPackage__/config/properties/messages.properties * Vollständige Übernahme: __MsConnectorPackage__/config/properties/messages_de.properties - * Vollständige Übernahme: __MsConnectorPackage__/config/keys/id_austria_truststore.jks - + 6. Neue optionale Konfigurationsparameter - *Matching allgemein* - ```eidas.ms.auth.eIDAS.matching.byaddress.enable``` - ```eidas.ms.auth.eIDAS.matching.byaddress.maxresults``` - - +6. Aktualisierung Statistiklogger + + Der CSV Eintrag des Statistikloggers wurde um ein Element erweitert, welches den für den Anmeldeprozess erfolgreichen Matchingschritt ausweist. + + z.B.: + + ```2022.07.01-16:51:58+CEST,65ed49c5-a494-4bfd-a860-ae7988dbf010,https://eid.egiz.gv.at/authHandler/restricted/eidas/metadata,https://eid.egiz.gv.at/openID_demo/,urn:publicid:gv.at:cdid+GH,EE,BY_PERSONALID,success,,``` + + + + Folgende Matching-Status werden durch den Statistik-Logger gesetzt: + + - BY_PERSONALID --> Matching über eIDAS PersonalIdentifier + + BY_COUNTRY_SPECIFIC --> Matching über länderspezifische Eigenschaften (z.B. für DE) + + BY_ID_AUSTRIA --> Matching via ID Austria Login + + BY_EIDAS --> Matching via alternativer eIDAS Anmeldung + + BY_ADDRESS --> Matching über Adresssuche + + BY_NEW_ERNP_ENTRY --> falls die Person neu angelegt wurde + + CANCELED_BY_USER --> Anmeldeprozess wurde durch den Benutzer bei GUI basierten Matching-Prozess abgebrochen + + NO_REQUIRED --> Falls für den aktuellen Anmeldeprozess kein / noch kein Matching erforderlich war (z.B. Fehler am eIDAS Node vor Matching) + + + + + + + + + -- cgit v1.2.3 From 48695aa01a86890990dc4e42b9d44493ec840b25 Mon Sep 17 00:00:00 2001 From: Thomas <> Date: Tue, 5 Jul 2022 17:21:35 +0200 Subject: doc: add some missing release information --- infos/readme_1.3.1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'infos/readme_1.3.1.md') diff --git a/infos/readme_1.3.1.md b/infos/readme_1.3.1.md index a32eaacd..70db47a9 100644 --- a/infos/readme_1.3.1.md +++ b/infos/readme_1.3.1.md @@ -4,7 +4,7 @@ Der MS-Connector implementiert eine Bridge zwischen dem österreichischen E-ID S ### Änderungen in dieser Version - - Optimierung und Fehlerkorrektur für UX basierten Matching-Schritten + - Optimierung und Fehlerkorrektur bei UX basierten Matching-Schritten - Konfigurierbare Maximalanzahl von Ergebnissen bei Adresssuche - Statistiklogger um Matching-Informationen erweitert - Bugfix -- cgit v1.2.3