Änderungen von Dokument AKDB: Bürgerkonto-Service-Plugin

Von 11.2 nach 11.1 Von 13.3 nach 13.2

Von Version 13.2

bearbeitet von rth
am 25.08.2022, 14:25

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Auf Version 11.2

bearbeitet von rth
am 10.02.2022, 13:35

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Rohform
Im Layout

Zusammenfassung

Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)

Details

Seiteneigenschaften

Inhalt

@@ -88,14 +88,11 @@
  ; Postkorbversand obligatorisch
  : Diese Einstellung ermöglich es die Postkorb-ID als verpflichtendes Rückgabe-Attribut zu kennzeichnen.
  : Auf Seiten der AKDB werden dann alle Authentifizierungsarten, die keinen Postkorbversand ermöglichen, für den Nutzer ausgeblendet.
--; Einschränkung der angeforderten Eigenschaften (Eigenschaft steht ab Version {{version major="3" minor="7"}}{{/version}} zur Verfügung)
--: Über diese Checkbox-Auswahl kann der Nutzer die zurück gelieferten Eigenschaften einer erfolgreichen Authentifizierung einschränken.
--: Damit wird dem Grundsatz der Datensparsamkeit der DSGVO (Datenschutz-Grundverordnung) entsprochen. Sind beispielsweise nur der Name und der Vorname einer Person in einem Formularprozess notwendig,
--: so sind nur die entsprechenden Felder in dieser Auswahlliste zu selektieren.
--: Ist nichts ausgewählt, erfolgt keine Einschränkung und alle möglichen Eigenschaften werden vom Bürgerservice-Portal angefordert.
  == Einbindung des Bürgerkonto Logins als Externer Benutzer ==
++{{version major="6" minor="4" patch="0"/}} Die Option steht in der {{formcycle/}} - Version ab **6.4.0** mit der Plugin - Version ab **2.8.1** zur Verfügung.
++
  === Konfiguration eines Externen Benutzers für das Bürgerkonto Login ===
  {{figure image="externer_benutzer_akdb.png"}}
@@ -156,59 +156,6 @@
  :; Postkorb
  :: In diesem Fall wird die Postkorb-Id als verpflichtender Wert angefordert, sodass im Workflow
  :: die Voraussetzungen für den Versand einer Nachricht an den Postkorb des Nutzers gegeben sind.
--; AngeforderteEigenschaften (ab Version {{version major="3" minor="7"}}{{/version}})
--: Diese Eigenschaft dient zum Einschränken der zurück gelieferten Attribute aus einer erfolgreichen Nutzer-Anmeldung.
--: In erster Linie ist diese Eigenschaft dazu gedacht dem Grundsatz der Datensparsamkeit aus den Vorgaben der DSGVO (Datenschutz-Grundverordnung) gerecht zu werden.
--: Sind keine Werte gesetzt, erfolgt keine Einschränkung und es werden alle vom Identity-Provider zur Verfügung gestellten Nutzer-Eigenschaften zurück geliefert.
--: Zu beachten ist, dass die angeforderten Eigenschaften mit dem unter LoginTyp angegebenen Wert korrespondieren. Dies bedeutet, dass beispielsweise bei einer angeforderten Authentifizierungsverfahren als Person, keine Organisations-Eigenschaften zurück geliefert werden können.
--: Es können ein oder mehrere Werte aus der nachfolgenden Auflistung (mit Komma getrennt) angegeben werden:
--:
--:; FIRST_NAME
--:: Vorname
--:; LAST_NAME
--:: Nachname
--:; EMAIL
--:: Email
--:; ADDRESS_STREET
--:: Adresse
--:; ADDRESS_ZIP_CODE
--:: PLZ
--:; ADDRESS_CITY
--:: Ort
--:; COUNTRY
--:: Land
--:; PERSONAL_TITLE
--:: Titel
--:; GENDER_TYPE
--:: Geschlecht
--:; BIRTHDATE
--:: Geburtsdatum
--:; PLACE_OF_BIRTH
--:: Geburtsort
--:; BIRTH_NAME
--:: Geburtsname, nur bei Anmeldung als natürliche Person verfügbar
--:; NATIONALITY
--:: Staatsangehörigkeit, nur bei Anmeldung als natürliche Person verfügbar
--:; DE_MAIL
--:: DE-Mail-Adresse
--:; TELEPHONE_NUMBER
--:: Telefon
--:; ORGANIZATION_NAME
--:: Name der Organisation, nur bei Anmeldung als Organisation verfügbar
--:; ORGANIZATION_ID
--:: Organisations-Id, nur bei Anmeldung als Organisation verfügbar
--:; HOUSE_NUMBER
--:: Hausnummer, nur bei Anmeldung als Organisation verfügbar
--:; HOUSE_NUMBER_ADDITION
--:: Hausnummern-Zusatz, nur bei Anmeldung als Organisation verfügbar
--:; ADDRESS_ADDITION
--:: Adress-Zusatz, nur bei Anmeldung als Organisation verfügbar
--:; UK_HANDLE
--:: Unternehmenskonto-Handle, nur bei Anmeldung als Organisation verfügbar
--:; REGISTER_LOCATION
--:: Register(gerichts)-Ort, nur bei Anmeldung als Organisation verfügbar
--:; REGISTER_NUMBER
--:: Registernummer, nur bei Anmeldung als Organisation verfügbar
  === Bürgerkonto Login als Formularanmeldung einrichten ===
@@ -338,8 +338,7 @@
  |NPA_PersonalTitle|Akademischer Titel, wie er auf dem NPA vermerkt ist (alles in Großbuchstaben)
  |IsIndividualPerson|Liefert den Wert **true**, wenn es sich bei den Daten aus dem Bürgerkonto um personenbezogene Daten handelt, sonst **false**.
  |IsOrganization|Liefert den Wert **true**, wenn es sich bei den Daten aus dem Bürgerkonto um organisationsbezogene Daten handelt, sonst **false**.
--|authVerifyInfos|(ab Version {{version major="3" minor="5"}}{{/version}}) Enthält als Wert ein JSON Objekt mit zusammenfassenden Verifikationsinformationen zur durchgeführten Authentifizierung, separiert nach NpaDaten-Suffix. Die Informationen bestehen aus einer Liste aller Element-Namen, welche durch die Authentifizierung befüllt wurden, dem genutzten Identitäts-Prüfer, sowie dem Trust-Level. Die **authVerifyInfos** sind in den XFC_METADATA-Objekt auch dann vorhanden, wenn keine explizite Anmeldung über das Bürgerservice-Portal stattgefunden hat, sondern beispielsweise eine Wiederanzeige des Vorgangsdaten über einen Prozess-Link.
--|bkVorlagenAuswahl|(ab Version {{version major="3" minor="7" patch="1"}}{{/version}}) Enthält im Falle einer Anmeldung als natürliche Person den Wert //IsIndividualPerson//, im Falle der Anmeldung als Organisation den Wert //IsOrganization//.
++|authVerifyInfos|(ab Version {{version major="3" minor="5"}}{{/version}}) Enthält als Wert ein JSON Objekt mit zusammenfassenden Verifikationsinformationen zur durchgeführten Authentifizierung, separiert nach NpaDaten-Suffix. Die Informationen bestehen aus einer Liste aller Element-Namen, welche durch die Authentifizierung befüllt wurden, dem genutzten Identitäts-Prüfer, sowie dem Trust-Level. Die **authVerifyInfos** sind in den XFC_METADATA-Objekt auch dann vorhanden, wenn keine explizite Anmeldung über das Bürgerservice-Portal stattgefunden hat, sondern beispielsweise eine Wiederanzeige des Vorgangsdaten über einen Prozess-Link.
  {{/table}}
  {{info}}
@@ -406,17 +406,17 @@
  Einstellungen für Absender und Empfänger in V6 Formularen
  {{/figure}}
--{{figure image="postkorb_absender_v3_6_fc_V7.png"}}
++{{figure image="postkorb_absender_v3_6.png"}}
  Einstellungen für Absender und Empfänger in V7 Formularen
  {{/figure}}
  ; Mandant (ab Version {{version major="3" minor="6"}}{{/version}} kein Pflichtfeld)
--: Wird als Information in der Postkorb-Ansicht im Bürgerservice-Portal verwendet. Ist an dieser Stelle kein Wert konfiguriert, wird die globale Einstellungen aus den Eigenschaften des Plugins verwendet.
++: Wird als Information in der Postkorb-Ansicht im Bürgerservice-Portal verwendet.
  ; Dienst (ab Version {{version major="3" minor="6"}}{{/version}} kein Pflichtfeld)
--: Wird als Information in der Postkorb-Ansicht im Bürgerservice-Portal verwendet. Ist an dieser Stelle kein Wert konfiguriert, wird die globale Einstellungen aus den Eigenschaften des Plugins verwendet.
++: Wird als Information in der Postkorb-Ansicht im Bürgerservice-Portal verwendet.
  ; Absender-Link
  : Falls sich die Angabe im Feld //Mandant// auf einen Mandanten bezieht, der nicht im Bürgerservice-Portal registriert ist, kann über den //Absender-Link// ein Link mitgegeben werden, mit dem der Mandant bei der Anzeige im AKDB Postkorb verlinkt wird.
--; Vertrauensniveau der Anmeldung für Zugriff auf Postkorb-Nachricht weiterreichen? (verfügbar ab Version {{version major="3" minor="6"}}{{/version}} im V7 Formular Workflow)
++; Vertrauensniveau der Anmeldung für Zugriff auf Postkorb-Nachricht weiterreichen? (ab Version {{version major="3" minor="6"}}{{/version}})
  : Über diese Option können Sie festlegen, ob das Vertrauensniveau der Anmeldung (wenn dies ermittelt werden kann)
  : für den Zugriff auf die Postkorb-Nachricht weitergereicht werden soll.
  : Wenn kein Vertrauensniveau aus den Anmeldedaten ermittelt werden kann, wird das niedrigste Vertrauensniveau gesetzt,
@@ -434,12 +434,9 @@
  {{figure image="postkorb_nachricht.png"}}
--Konfiguration von Betreff, Nachrichteninhalt und Anhängen in V6 Formularen
++Konfiguration von Betreff, Nachrichteninhalt und Anhängen
  {{/figure}}
--{{figure image="postkorb_nachricht_v3_6_fc_V7.png"}}
--Konfiguration von Betreff, Nachrichteninhalt und Anhängen in V7 Formularen
--{{/figure}}
  ; Betreff (Pflicht)
  : Nahrichtenbetreff, es werden Platzhalter unterstützt.
@@ -447,9 +447,7 @@
  : Nachrichtentext, es werden Platzhalter unterstützt.
  ; Anhänge
  : Hier können Dateien als Attachments an die Postkorb-Nachricht gehangen werden.
--: Unterstützte Dateiformate sind: PDF, HTML, Plaintext, MS Word, JPEG, GIF, PNG, ZIP
  : Zur Auswahl stehen dabei:
--: (Auswahlmöglichkeiten in V6-Formularen)
  :; Upload
  :: bezieht sich auf alle Dateianhänge, die über das Formular hochgeladen wurden
  :; Workflow
@@ -456,18 +456,9 @@
  :: bezieht sich auf alle Dateianhänge, die über den aktuellen FORMCYCLE Workflow hochgeladen wurden.
  :; Posteingang
  :: bezieht sich auf alle Dateianhänge, die über das Postfach hochgeladen wurden.
--: (Auswahlmöglichkeiten in V7-Formularen)
--:; Dateien aus vorherigen Aktionen
--:: Eine Liste mit Dateien, von Datei-bereitstellenden Aktionen, die der Postkorb-Aktion vorangestellt sind.
--:; Mandantdateien
--:: Liefert eine Auswahlliste über alle Datei-Ressourcen am Mandanten
--:; Formulardateien
--:: Liefert eine Auswahlliste über alle Datei-Ressourcen, welche am Formular-Projekt hinterlegt sind.
--:; Externe Ressourcen-URL
--:: Dateien die über externe Quellen (HTTP-Requests) ermittelt werden können.
--:; Vorgangsanhänge mittels Dateinamen suchen
--:: Eine Suche innerhalb von Dateinamen mittels übereinstimmenden Suchbegriffs. Es kann dabei mittels Filter eingegrenzt werden, innerhalb welcher Datei-Quellen die Suche ausgeführt wird (Dateien aus Uploads, Datei aus der Statusverarbeitung, Dateien aus dem Posteingang)
++:: Unterstützte Dateiformate sind: PDF, HTML, Plaintext, MS Word, JPEG, GIF, PNG
++
  {{info}}
  **Achtung:**
  Die Schnittstelle zum Postkorb der AKDB unterstützt dabei maximal 20 Anhänge pro Nachricht mit je 50 MByte Maximalgröße.
@@ -521,38 +521,9 @@
  == Versionshistorie ==
--(% class="wikigeneratedid" %)
--=== 3.7.3 ===
++=== 3.6.0 - Bereitstellung erfolgt nach offiziellen Release der AKDB ===
--* Anpassung AKDB-Setup: bei Vorbelegung der Entity-ID mit der URL vom Mandant wird jetzt Port-Nummer entfernt
--* Behebung Anzeigefehler in Datenvorlage: Wenn Anmeldung abgebrochen und anschließend aber erfolgreich durchgeführt wurde, da waren die Felder in der Datenvorlage fehlerhaft markiert (als manuell durch Nutzereingaben vorbelegt). Dies wurde korrigiert.
--
--=== 3.7.2 ===
--
--* Interne Anpassungen zur besseren Fehleranalyse
--
--=== 3.7.1 ===
--
--* Anpassung AKDB-Setup: Erweiterung des Upload-Element für Ausführung eines Viren Scans versehen
--* Erweiterung BuergerkontoData-Struktur: Bei einer Anmeldung über BK wird zusätzlich das Feld 'bkVorlagenAuswahl' zurück gegeben.
--
--=== 3.7.0 ===
--
  * Erweiterungen / Anpassungen aufgrund von Schnittstellenanpassungen im Bürgerservice-Portal der AKDB:
--** Möglichkeit zur Einschränkung der angeforderten Nutzerdaten am BK-Login-Button, sowie in der Plugin-Authenticator Konfiguration.
--
--=== 3.6.2 ===
--
--* Fehlerbehebung: Bei Verwendung der Datenvorlage für //personen- und organisationsbezogene Daten // im Designer wurde nur das erste Element im Container angezeigt. Dies wurde behoben. Der Fehler tritt ab {{formcycle/}} Version {{version major="7" patch="11"}}{{/version}}auf.
--
--=== 3.6.1 ===
--
--* Fehlerbehebung: Beim Drucken eines Formulars mit Anmeldinformationen über den Print-Service erfolgte keine Darstellung des genutzten Authentifizierungsverfahren im erzeugten PDF. Dies wurde behoben.
--* Fehlerbehebung: URL-Rewriting am Login-Button wurde nicht angewendet, wenn hinterlegte Mandant-BaseURL der URL in der SAML-Konfiguration entsprach, obwohl Formular aufgrund eines verwendeten Proxy-Servers über abweichenden Aufruf-URL verwies. Dies wurde angepasst.
--
--=== 3.6.0 ===
--
--* Erweiterungen / Anpassungen aufgrund von Schnittstellenanpassungen im Bürgerservice-Portal der AKDB:
  ** Möglichkeit zur Anforderung von Pflicht-Attributen (Postkorb-ID)
  ** Umstellung der Auswahlmöglichkeiten für das geforderte Authentifizierungsverfahren auf eine weiter reichende Auswahl (+Migration bestehender Konfigurationen am BK-Login-Button)
  * Anpassung Postkorb-Aktion: Im Bereich des Absenders sind //Dienst //und //Mandant //keine Pflichtfelder mehr. Wenn Sie nicht definiert werden, werden die globalen Einstellungen
@@ -559,33 +559,9 @@
  aus den Plugin-Properties herangezogen.
  * Erweiterung Postkorb-Aktion: Im Bereich des Empfängers kann jetzt konfiguriert werden, dass das Vertrauensniveau der Anmeldung für den Zugriff auf die Nachricht im AKDB-Postfach mitgegeben wird.
  * Anpassung AKDB-Vorlage: Anpassung der Verlage, da im Bereich des Absenders Dienst und Mandant keine Pflichtfelder mehr repräsentieren.
--* Anpassung AKDB-Setup: Hinweis auf freizugebende URL's (Firewall-Einstellungen) hinzugefügt, Konfigurationsmöglichkeit für Proxy-Server-Einstellungen
++* Anpassung AKDB-Setup: Hinweis auf freizugebende URL's (Firewall-Einstellungen) hinzugefügt
  * Fehlerbehebung: Fehlerbehandlung im Plugin-Action-Servlet 'AKDBLogin' angepasst
--=== 3.5.13 ===
--
--* Fehlerbehebung: Behebt einen Fehler, welcher im Zusammenhang mit Ajax-Uploads und dem Absenden eines Formulars ab {{formcycle/}} Version {{version major="7" patch="11"}}{{/version}} steht.
--
--=== 3.5.12 ===
--
--* Erweiterung von Log-Ausgaben innerhalb der Postkorb-Kommunikation zum Zwecke der Fehleranalyse.
--
--=== 3.5.11 ===
--
--* Fehlerbehebung: Im Zusammenspiel mit der {{formcycle/}} Version {{version major="7" patch="10"}}{{/version}}konnten Zertifikatsdateien nicht über das AKDB Setup hochgeladen werden. Dieser Fehler wurde behoben.
--
--=== 3.5.10 ===
--
--* Fehlerbehebung: JavaScript für Datenvorlage wurde angepasst um eine zusätzliche Validierungsroutine für die Elemente innerhalb der Vorlage. Diese Validierung wird ausgeführt, wenn die Auswahl 'Privatperson / Organisation' geändert wurde.
--
--=== 3.5.9 ===
--
--* Fehlerbehebung: JavaScript für Datenvorlage wurde angepasst, sodass sich ein Ändern der Steuerfelder 'IsOrganization' und 'IsIndividualPerson' auf alle Elemente innerhalb der Vorlage auswirken kann, wenn diese entsprechend Bedingungen ausweisen.
--
--=== 3.5.8 ===
--
--* Fehlerbehebung: JavaScript für Datenvorlage wurde angepasst, sodass bei Ausblenden von Organisationsdaten, diese geleert werden, wenn dies im Designer konfiguriert ist.
--
  === 3.5.7 ===
  * Erweiterung Postkorb-Aktion: Als Anhang werden jetzt Zip-Dateien unterstützt. (Bitte beachten Sie, dass die Postkorb-Schnittstelle nur das Zip-Format und KEIN GZip-Format (Dateiendung ".gz") unterstützt)
@@ -665,4 +665,34 @@
  * Postkorb-Plugin für V7-Workflow
  * Überarbeitung Formular-Vorlage für Nutzung des V7-Workflows
++=== 2.18.3 ===
++
++* Anpassung JS für Anzeige-Steuerung der BK-Vorlagen: Steuerparameter 'TrustLevel', 'IsOrganization' und 'IsIndividualPerson' können jetzt auch außerhalb des Vorlagen-Containers verwendet werden
++* Fehlerbehebung: Es wurden Fehler bei der Wiederanzeige von zwischengespeicherten Daten bei Kommunikation über FS behoben.
++
++=== 2.18.2 ===
++
++* Anpassung Postkorb: Umstellung von ID auf UUID bei Dateianhängen
++
++=== 2.18.1 ===
++
++* Fehlerbehebung: Es wurde ein Fehler, beim Zwischenspeichern von Formulardaten vor der Weiterleitung zum BK-Portal, behoben.
++
++=== 2.18.0 ===
++
++* Erweiterung AKDB-Setup: Neuer Einrichtungsschritt für die Erhebung von Organisationsdaten für Verwaltungszwecke.
++
++=== 2.17.0 ===
++
++* Abschließende Anpassungen für Einführung Bürgerservice-Portal 2.0:
++** Aktualisierung der Metadaten des Identity Providers, sowie des Postkorb-Webservice-Endpoints für die Anbindung des neuen Live-Systems
++* Änderung im AKDB-Setup:
++** Anpassungen am Layout, da es bei niedrigen Auflösungen dazu kam, dass Navigations-Buttons nicht angezeigt wurden
++** Verbesserung der Logik für die Verbindungsprüfung bei Einrichtung der Postkorb-Anbindung
++
++=== 2.16.0 ===
++
++* Aufnahme zusätzlicher vom Bürgerkonto übermittelter Daten. Die genaue Beschreibung dieser kann der obigen Parameter-Tabelle entnommen werden.
++* Änderung im AKDB-Setup: Möglichkeit zur Prüfung der Erreichbarkeit des Postkorb-Webservice
++
  ===  ===