# 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```