| ... |
... |
@@ -126,11 +126,13 @@ |
| 126 |
126 |
Formularvorlage //AKDB Basisdienste// |
| 127 |
127 |
{{/figure}} |
| 128 |
128 |
|
| 129 |
|
-Um die Daten aus dem Bürgerservice-Portal im Formular anzuzeigen, existiert die Vorlage //Bürgerkonto personen- und organisationsbezogene Daten.// Die Felder innerhalb dieser Vorlage sind so konfiguriert, dass sie eine automatische Zuordnung und damit die Anzeige der zurück gelieferten Daten ermöglichen. Bei Nutzung des eingangs erwähnten Formular-Templates, ist die Designer-Vorlage bereits eingebunden und je nach Anmeldetyp, werden die organisations-spezifischen Daten automatisch ein- oder ausgeblendet. |
|
129 |
+Um die Daten aus dem Bürgerservice-Portal im Formular anzuzeigen, existieren zwei Vorlagen //Bürgerkonto personenbezogene Daten// und //Bürgerkonto organisationsbezogene Daten//. Die Felder innerhalb dieser Vorlagen sind so konfiguriert, dass sie eine automatische Zuordnung und damit die Anzeige der zurückgelieferten Daten ermöglichen. Die jeweilige Vorlage ist je nach der eingestellten [[Art der Rückgabedaten>>doc:||anchor="Art_Rueckgabedaten"]] am //AKDB Bürgerkonto//-Button zu wählen. Bei Nutzung der eingangs erwähnten Formular-Templates, sind beide Designer-Vorlagen bereits eingebunden und werden nach anzuzeigender Datenart ein- oder ausgeblendet. |
| 130 |
130 |
|
| 131 |
|
-Die vom Bürgerservice-Portal zurück gelieferten Daten können mittels JavaScript auch anderweitig weiterverarbeitet werden. Dafür werden sie in Form einer JSON-Struktur im Zielformular zur Verfügung gestellt. Die JSON Struktur kann über folgende JavaScript-Variable ausgelesen werden: |
|
131 |
+Ab Plugin Version {{version major="2" minor="9"/}} gibt es eine weitere Vorlage, welche die Daten von person- und organisations-bezogenen Daten in einer Vorlage vereint. Das Anzeigeverhalten dieser Vorlage entspricht den eingangs erwähnten Vorlagen. Das heißt, je nach Anmeldetyp, werden die organisations-spezifischen Daten ein- oder ausgeblendet. |
| 132 |
132 |
|
|
133 |
+Die vom Bürgerservice-Portal zurückgelieferten Daten können mittels JavaScript auch anderweitig weiterverarbeitet werden. Dafür werden sie in Form einer JSON-Struktur im Zielformular zur Verfügung gestellt. Die JSON Struktur kann über folgende JavaScript-Variable ausgelesen werden: |
| 133 |
133 |
|
|
135 |
+ |
| 134 |
134 |
{{code language="javascript"}} |
| 135 |
135 |
XFC_METADATA.pluginResults.AKDBLoginAnalyzer |
| 136 |
136 |
{{/code}} |
| ... |
... |
@@ -147,7 +147,8 @@ |
| 147 |
147 |
|
| 148 |
148 |
{{info}} |
| 149 |
149 |
**Hinweis für die vom Bürgerservice-Portal zurück gelieferten Daten:** |
| 150 |
|
-Bei der Authentifizierung mit eIDAS-notifizierten Identifikationsmittel gilt der Mindestdatensatz nach eIDAS-VO, daher kann es zu einem reduzierten Datensatz kommen. |
|
152 |
+Bei der Authentifizierung mit eIDAS-notifizierten Identifikationsmittel gilt der Mindestdatensatz nach eIDAS-VO, daher kann es zu einem |
|
153 |
+reduzierten Datensatz kommen. |
| 151 |
151 |
**[[Attribute im eID Schema>>url:https://ec.europa.eu/cefdigital/wiki/display/EIDCOMMUNITY/Overview+of+available+attributes+of+pre-notified+and+notified+eID+schemes||rel="noopener noreferrer" target="_blank"]]** |
| 152 |
152 |
{{/info}} |
| 153 |
153 |
|
| ... |
... |
@@ -238,7 +238,6 @@ |
| 238 |
238 |
|NPA_PersonalTitle|Akademischer Titel, wie er auf dem NPA vermerkt ist (alles in Großbuchstaben) |
| 239 |
239 |
|IsIndividualPerson|Liefert den Wert **true**, wenn es sich bei den Daten aus dem Bürgerkonto um personenbezogene Daten handelt, sonst **false**. |
| 240 |
240 |
|IsOrganization|Liefert den Wert **true**, wenn es sich bei den Daten aus dem Bürgerkonto um organisationsbezogene Daten handelt, sonst **false**. |
| 241 |
|
-|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. |
| 242 |
242 |
{{/table}} |
| 243 |
243 |
|
| 244 |
244 |
{{info}} |
| ... |
... |
@@ -259,7 +259,7 @@ |
| 259 |
259 |
Für die einzelnen Vertrauensniveaus existieren folgende Beschriftungen: |
| 260 |
260 |
|
| 261 |
261 |
* Level 1 (Authentifizierung mittels Benutzername / Passwort): **Standard** |
| 262 |
|
-* Level 3 (Authentifizierung mittels Authega Zertifikat): **Zertifikat** |
|
264 |
+* Level 3 (Authentifizierung mittels Authega Zertifikat): **Authega** |
| 263 |
263 |
* Level 4 (Authentifizierung mittels nPA): **Personalausweis** |
| 264 |
264 |
|
| 265 |
265 |
{{figure image="hilfe_trustlevel_keine_visualisierung.png"}} |
| ... |
... |
@@ -266,30 +266,6 @@ |
| 266 |
266 |
Wenn keine visuelle Markierung gewünscht ist, so kann dies durch ein zusätzliches Attribut „noRibbon“ am Vorlagen-Fieldset unterbunden werden |
| 267 |
267 |
{{/figure}} |
| 268 |
268 |
|
| 269 |
|
-==== Anpassungen der Darstellung aufgrund reduzierter Nutzerdaten ==== |
| 270 |
|
- |
| 271 |
|
-Mit dem Update des Bürgerservice-Portals (**Release 3.2** vom **18.11.2021**) kann es bei Anmelde-Prozessen zur Übermittlung von reduzierten Nutzerdaten kommen (z.B. Authentifizierung mit eIDAS-notifizierten Identifikationsmittel). Dies äußert sich beispielsweise darin, dass nach der Anmeldung keine Adressdaten vom Nutzer in der Vorlage erscheinen. |
| 272 |
|
- |
| 273 |
|
- |
| 274 |
|
-Mit Plugin Version {{version major="3" minor="5"}}{{/version}} werden nach einer Anmeldung am Bürgerservice-Portal nur noch die Eingabefelder innerhalb der Datenvorlage für eine Bearbeitung gesperrt, welche durch den Authentifizierungsprozess am Bürgerservice-Portal befüllt wurden. |
| 275 |
|
-Alle übrigen Felder innerhalb der Vorlage, können dann standardmäßig durch den angemeldeten Benutzer bearbeitet werden, wenn im Designer für diese Felder nichts gegenteiliges festgelegt wurde. |
| 276 |
|
- |
| 277 |
|
-Zusätzlich werden die Felder bei Wiederanzeige durch kleine Icons gekennzeichnet, wodurch auf einem Blick ersichtlich wird, aus welcher Quelle die Anmeldeinformationen entstammen. |
| 278 |
|
- |
| 279 |
|
-* [[image:verified.png||alt="Icon für Informationen aus Bürgerservice-Portal" height="22" width="21"]] Felder mit diesem Icon wurden aus dem Bürgerservice-Portal übermittelt |
| 280 |
|
-* [[image:none_verified.png||alt="Icon für Informationen die der Nutzer nachträglich eingegeben hat" height="20" width="23"]] Felder mit diesem Icon wurden vom Nutzer nachträglich eingegeben und wurden deshalb nicht durch einen Identitätsprüfer verifiziert |
| 281 |
|
- |
| 282 |
|
-Die Feld-Icons werden mittels CSS-Klassen an den Eingabe-Elementen hinzugefügt und können dadurch mittels eigenem CSS Definitionen übersteuert werden. Die dafür notwendigen Klassen haben folgende Namen: |
| 283 |
|
- |
| 284 |
|
-* //verify_l1//: Kennzeichnet ein Element dessen Inhaltswert einen Level 1 Vertrauensniveaus (Authentifizierung mittels Benutzername / Passwort) entspricht. |
| 285 |
|
-* //verify_l3//: Kennzeichnet ein Element dessen Inhaltswert einen Level 3 Vertrauensniveaus (Authentifizierung mittels Zertifikat) entspricht. |
| 286 |
|
-* //verify_l4//: Kennzeichnet ein Element dessen Inhaltswert einen Level 4 Vertrauensniveaus (Authentifizierung mittels nPA oder eIDAS Identifikationsmittel) entspricht. |
| 287 |
|
-* //no_verify//: Kennzeichnet ein Element dessen Inhaltswert durch einen Nutzer frei eingegeben wurde und damit durch keinen Identitätsprüfer aus dem Umfeld des Bürgerservice-Portals geprüft wurde. |
| 288 |
|
- |
| 289 |
|
-{{figure image="noVerifyInfo.png"}} |
| 290 |
|
-Wenn keine visuelle Markierung der Formularelemente gewünscht ist, so kann dies durch ein zusätzliches Attribut „noVerifyInfo“ am Vorlagen-Fieldset unterbunden werden |
| 291 |
|
-{{/figure}} |
| 292 |
|
- |
| 293 |
293 |
== AKDB Postkorbanbindung in der Statusverarbeitung == |
| 294 |
294 |
|
| 295 |
295 |
|
| ... |
... |
@@ -298,7 +298,7 @@ |
| 298 |
298 |
|
| 299 |
299 |
Die Konfigurationsoberfläche des Aktions-Plugins ist in einzelne Bereiche unterteilt die nachfolgend kurz beschrieben werden. |
| 300 |
300 |
|
| 301 |
|
-{{panel title="Einstellungen für Absender und Empfänger" fullwidth="true" triggerable="true"}} |
|
279 |
+{{panel title="Einstellungen für Absender und Empfänger" fullwidth="true" initial="visible" triggerable="true"}} |
| 302 |
302 |
|
| 303 |
303 |
|
| 304 |
304 |
{{figure image="postkorb_absender.png"}} |
| ... |
... |
@@ -313,7 +313,7 @@ |
| 313 |
313 |
: 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. |
| 314 |
314 |
; Postkorb ID aus den Vorgangsdaten ermitteln? |
| 315 |
315 |
: Diese Angabe dient zur Bestimmung der Postkorb-ID. Über die Postkorb-ID wird das genaue Ziel für den Nachrichtenversand bestimmt, also der Nachrichten-Empfänger. |
| 316 |
|
-Wird bei einem AKDB Bürgerkonto-Login die Postkorb-ID mit übermittelt, so wird diese standardmäßig am Formulareingang hinterlegt. |
|
294 |
+Bei einem AKDB Bürgerkonto-Login wird die Postkorb-ID immer mit übermittelt und standardmäßig am Formulareingang hinterlegt. |
| 317 |
317 |
Für den Fall, dass es mehrere konfigurierte Anmeldungen innerhalb eines Formulars gibt, kann hier die Auswahl über den [[Bürgerdaten Parameter-Suffix>>doc:||anchor="BK_Parameter_Suffix"]] eingegrenzt werden. |
| 318 |
318 |
Darüber hinaus ist es möglich die Postkorb-ID fest oder über einen Platzhalter (**[%$POSTKORB_ID%]**) zu definieren. (Der Platzhalter wird über das Plugin zur Verfügung gestellt und kann in der Statusverarbeitung verwendet werden.) |
| 319 |
319 |
|
| ... |
... |
@@ -372,6 +372,7 @@ |
| 372 |
372 |
|
| 373 |
373 |
Wenn in einem Formular beide Login-Arten (//personenbezogenes// und //organisationsbezogenes// Login) zugelassen sind und man unterschiedliche Nachrichten an den Postkorb senden möchte, so ist dies ebenfalls möglich. |
| 374 |
374 |
Im Formular müssen dann versteckte Eingabefelder mit den Element-Namen **IsIndividualPerson** und **IsOrganization** vorhanden sein. |
|
353 |
+(Dies ist automatisch der Fall, wenn die entsprechenden Vorlagen //Bürgerkonto personenbezogene Daten// und //Bürgerkonto organisationsbezogene Daten// verwendet werden). |
| 375 |
375 |
|
| 376 |
376 |
Die Konfiguration einer Ausführungs-Bedingung an einer Aktion //AKDB:Postkorbnachricht senden// für eine **personenbezogene** Anmeldung wäre dann folgendermaßen: |
| 377 |
377 |
|
| ... |
... |
@@ -396,23 +396,6 @@ |
| 396 |
396 |
== Versionshistorie == |
| 397 |
397 |
|
| 398 |
398 |
(% class="wikigeneratedid" %) |
| 399 |
|
-=== 3.5.4 === |
| 400 |
|
- |
| 401 |
|
-* Erweiterung Postkorb-Aktion: Prüfroutine für Postkorb-Webservice-Kommunikation in Konfigurationsoberfläche hinzugefügt. |
| 402 |
|
- |
| 403 |
|
-=== 3.5.3 === |
| 404 |
|
- |
| 405 |
|
-* Fehlerbehebung: Es wurde ein Sicherheitsproblem behoben, welches bei Laden von zwischengespeicherten Formulardaten auftreten kann. |
| 406 |
|
- |
| 407 |
|
-=== 3.5.2 === |
| 408 |
|
- |
| 409 |
|
-* Fehlerbehebung: Bei Rückleitung aus dem Bürgerservice-Portal und wenn Kommunikation nicht über Frontend-Server stattgefunden hat, wurde teilweise die Seite "Formular nicht gefunden" ausgeliefert. Dies wurde behoben. |
| 410 |
|
-* Fehlerbehebung: Bei Verwendung mehrerer Anmeldungen innerhalb eines Formulars und damit unterschiedlichen Bürgerdaten-Suffix, kam es zu falschen Formatierungen der Datenfelder. Dies wurde behoben. |
| 411 |
|
- |
| 412 |
|
-=== 3.5.1 === |
| 413 |
|
- |
| 414 |
|
-* Fehlerbehebung: Bei Rückleitung aus dem Bürgerservice-Portal und wenn Kommunikation nicht über Frontend-Server stattgefunden hat, wurde teilweise die Seite "Formular nicht gefunden" ausgeliefert. Dies wurde behoben. |
| 415 |
|
- |
| 416 |
416 |
=== 3.5.0 === |
| 417 |
417 |
|
| 418 |
418 |
* Erweiterung der zurück gelieferten Authentifizierungsdaten: Das JSON-Objekt //authVerifyInfos// enthält die Namen der Elemente aus den Bürgerkontodaten, welche über die Authentifizierung am Bürgerservice-Portal übermittelt wurden. |
| ... |
... |
@@ -606,3 +606,19 @@ |
| 606 |
606 |
|
| 607 |
607 |
* Umstellung intern genutztes SAML-Framework. Dieses wird nicht mehr durch das Plugin selbst, sondern vom {{formcycle/}}-Core zur Verfügung gestellt. |
| 608 |
608 |
* **Achtung:** alle neueren Versionen des Plugins benötigen mindestens {{formcycle/}} Version {{version major="6" minor="4" patch="0"/}} oder höher |
|
571 |
+ |
|
572 |
+=== 2.6.2 === |
|
573 |
+ |
|
574 |
+* Umbenennung Menüpunkt für Metadaten-Generierung für Registrierung bei AKDB, neuer Name: "AKDB Setup" |
|
575 |
+ |
|
576 |
+=== 2.6.1 === |
|
577 |
+ |
|
578 |
+* Fehlerbehebung bei Verwendung des BK-Logins über Frontend-Server |
|
579 |
+ |
|
580 |
+=== 2.6.0 === |
|
581 |
+ |
|
582 |
+* Einbindung {{formcycle/}} Version 6.2.0 |
|
583 |
+* Unterstützung Blanko-Druck: |
|
584 |
+** Login-Button wird ausgeschlossen |
|
585 |
+** Steuerfelder und Trustlevel in den Vorlagen werden standardmäßig vom Druck ausgeschlossen |
|
586 |
+* Login-Button um Auswahlmöglichkeit für Seitenvalidierung vor Beginn BK-Login erweitert. |
