| ... |
... |
@@ -1,12 +1,10 @@ |
| 1 |
|
-{{info}} |
| 2 |
|
-**Hinweis für Plugin-/{{formcycle/}}-Administratoren:** |
| 3 |
|
-Am 13.04.2021 wurde die Testumgebung des Bürgerservice-Portals aktualisiert. Diese ist jetzt unter [[**BayernID - Startseite**>>url:https://infra-pre-bayernid.freistaat.bayern/de/bayern/freistaat||rel="noopener noreferrer" target="_blank"]] erreichbar. Diese Änderung auf Seiten des Bürgerservice-Portals macht Anpassungen bei den Dienst-Anbindungen notwendig. |
|
1 |
+[[**Plugin-Download**>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/plugin-bundle-akdb-services&fileid=2671||rel="noopener noreferrer" target="_blank"]] (erfordert Anmeldung) |
| 4 |
4 |
|
| 5 |
|
-Bei einer Aktualisierung des Plugins auf mindestens eine Version {{version major="2" minor="15"}}{{/version}} werden die notwendigen Anpassungen automatisch durchgeführt und es sind keine weiteren manuellen Eingriffe durch den Administrator notwendig. |
|
3 |
+{{info}} |
|
4 |
+**Hinweis zur Inbetriebnahme des Plugins:** |
|
5 |
+Im Download-Ordner der jeweilige Plugin-Version befindet sich eine Anleitung zur initialen Inbetriebnahme, sowie zu weiter reichenden Information die den allgemeinen Betrieb dieses Plugins betreffen. |
| 6 |
6 |
{{/info}} |
| 7 |
7 |
|
| 8 |
|
-[[**Plugin-Download**>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/plugin-bundle-akdb-services&fileid=2671||rel="noopener noreferrer" target="_blank"]] (erfordert Anmeldung) |
| 9 |
|
- |
| 10 |
10 |
{{content/}} |
| 11 |
11 |
|
| 12 |
12 |
{{info}} |
| ... |
... |
@@ -27,9 +27,13 @@ |
| 27 |
27 |
== Einbindung des Bürgerkonto Logins im Designer == |
| 28 |
28 |
|
| 29 |
29 |
{{figure image="hilfe_bk_button.png"}} |
| 30 |
|
-Formular-Element //AKDB Bürgerkonto// |
|
28 |
+Einstellungen am Formular-Element //AKDB Bürgerkonto// bis Version {{version major="3" minor="6"}}{{/version}} |
| 31 |
31 |
{{/figure}} |
| 32 |
32 |
|
|
31 |
+{{figure image="hilfe_bk_button_v3_6.png"}} |
|
32 |
+Einstellungen am Formular-Element //AKDB Bürgerkonto// ab Version {{version major="3" minor="6"}}{{/version}} |
|
33 |
+{{/figure}} |
|
34 |
+ |
| 33 |
33 |
{{id name="BK_LoginButton"/}} |
| 34 |
34 |
|
| 35 |
35 |
Zur vereinfachten Einbindung des Bürgerkontos in Formulare gibt es das Formular-Element //AKDB Bürgerkonto//. Dieses kann per "Drag & Drop" in den Seitenbereich gezogen werden. Der dann vorhandene Absende-Button kann im Bereich **Buergerkonto-Login Einstellungen** konfiguriert werden. Die Einstellungen haben folgende Bedeutung: |
| ... |
... |
@@ -60,15 +60,33 @@ |
| 60 |
60 |
: Als Suffix sind Buchstaben, Zahlen und der Unterstrich erlaubt. |
| 61 |
61 |
: __Beispiel:__ |
| 62 |
62 |
Wenn als Suffix "**_1**" definiert wurde, muss das Formularfeld für die Adresse mit dem Namen "tfAntragstellerAdresse**_1**" benannt werden, damit eine Vorbelegung erfolgreich stattfinden kann. |
| 63 |
|
-; gefordertes Authentifizierungsverfahren |
|
65 |
+; --gefordertes Authentifizierungsverfahren-- (Die hier beschriebenen Eigenschaften werden bis zur Version {{version major="3" minor="6"}}{{/version}} unterstützt. Bestehende Konfigurationen werden automatisch in die neue Auswahl //Einschränkung der Authentisierungsverfahren// übernommen.) |
| 64 |
64 |
: Hier kann das dem Nutzer zur Verfügung stehende Authentifizierungsverfahren eingeschränkt werden. |
| 65 |
65 |
: Es gibt folgende Auswahlmöglichkeiten: |
|
68 |
+:; keine Einschränkung |
|
69 |
+:: Login mittels Passwort, Authega-Zertifikat oder Personalausweis steht zur Auswahl |
|
70 |
+:; Authega |
|
71 |
+:: Nur die Authentifizierung mittels Authega-Zertifikat steht zur Auswahl |
|
72 |
+:; Authega oder Personalausweis |
|
73 |
+:: Login mittels Authega-Zertifikat oder Personalausweis steht zur Auswahl |
|
74 |
+:; Personalausweis |
|
75 |
+:: nur Authentifizierung mittels Personalausweis steht zur Auswahl |
|
76 |
+; Einschränkung der Authentisierungsverfahren (Eigenschaft steht ab Version {{version major="3" minor="6"}}{{/version}} zur Verfügung) |
|
77 |
+: Über diese Checkbox-Auswahl kann das dem Nutzer zur Verfügung stehende Authentifizierungsverfahren eingeschränkt werden. |
|
78 |
+: Ist nichts ausgewählt, erfolgt keine Einschränkung. |
|
79 |
+:; Benutzername |
|
80 |
+:: Authentifizierung erfolgt über Login / Passwort |
|
81 |
+:; Authega-Zertifikat |
|
82 |
+:; Elster-Zertifikat |
|
83 |
+:; FINK |
|
84 |
+:: Authentifizierung erfolgt über ein Identifikationsmittel aus dem Portfolio des //Föderierten Identitätsmanagements Interoperable Nutzerkonten// |
|
85 |
+:; eID (Personalausweis) |
|
86 |
+:; eIDAS |
|
87 |
+:: Authentifizierung mittels Identifikationsmittels nach eIDAS-Verordnung (//electronic IDentification, Authentication and Trust Services//) |
|
88 |
+; Postkorbversand obligatorisch |
|
89 |
+: Diese Einstellung ermöglich es die Postkorb-ID als verpflichtendes Rückgabe-Attribut zu kennzeichnen. |
|
90 |
+: Auf Seiten der AKDB werden dann alle Authentifizierungsarten, die keinen Postkorbversand ermöglichen, für den Nutzer ausgeblendet. |
| 66 |
66 |
|
| 67 |
|
-* **keine Einschränkung**: Login mittels Passwort, Authega-Zertifikat oder Personalausweis steht zur Auswahl |
| 68 |
|
-* **Authega**: Nur die Authentifizierung mittels Authega-Zertifikat steht zur Auswahl |
| 69 |
|
-* **Authega oder Personalausweis**: Login mittels Authega-Zertifikat oder Personalausweis steht zur Auswahl **(Achtung: Diese Auswahl wird momentan nicht mehr vom AKDB Portal unterstützt!)** |
| 70 |
|
-* **Personalausweis**: nur Authentifizierung mittels Personalausweis steht zur Auswahl |
| 71 |
|
- |
| 72 |
72 |
== Einbindung des Bürgerkonto Logins als Externer Benutzer == |
| 73 |
73 |
|
| 74 |
74 |
{{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. |
| ... |
... |
@@ -100,15 +100,39 @@ |
| 100 |
100 |
Im letzten Schritt besteht die Möglichkeit die Konfiguration individuell anzupassen. |
| 101 |
101 |
Dazu können folgende Einstellungen getroffen werden: |
| 102 |
102 |
|
|
123 |
+ |
|
124 |
+ |
| 103 |
103 |
; LoginTyp |
| 104 |
104 |
: Mit dieser Einstellung lassen sich die Arten der zurück gelieferten Daten festlegen. |
| 105 |
105 |
: Ist als Wert **Person** definiert, so können nur personenbezogene Daten zurückgeliefert werden. |
| 106 |
106 |
: Ist **Organisation** definiert, so ist es nur möglich organisationsbezogene Daten zurückzuliefern. Das heißt ein Login als natürliche Person ist nicht möglich. |
| 107 |
107 |
: Ist dieser Parameter nicht konfiguriert, so kann der Nutzer selbst bestimmen, welche Datenart (personen- oder organisationsbezogen) er zurück liefern möchte. |
| 108 |
|
-; AuthTyp |
|
130 |
+; --AuthTyp-- (wird ab Version {{version major="3" minor="6"}}{{/version}}nicht mehr unterstützt) |
| 109 |
109 |
: Über diese Einstellung kann das geforderte Authentisierungsverfahren festgelegt werden. |
| 110 |
110 |
: Entweder mit Authega-Zertifikat (Wert: **Authega**) oder Personalausweis (Wert: **NPA**). |
| 111 |
111 |
: Ist nichts gesetzt oder das Attribut nicht vorhanden, so werden dem Nutzer alle möglichen Authentisierungsverfahren zur Auswahl angeboten. |
|
134 |
+; LoginMethod (ersetzt die Eigenschaft AuthTyp ab Version {{version major="3" minor="6"}}{{/version}}) |
|
135 |
+: Über diese Einstellung kann das geforderte Authentisierungsverfahren eingeschränkt werden. |
|
136 |
+: Es können dabei ein oder mehrere Werte (mit Komma getrennt) der folgenden Auflistung angegeben werden: |
|
137 |
+:; Benutzername |
|
138 |
+:; Authega |
|
139 |
+:; Elster |
|
140 |
+:; FINK |
|
141 |
+:; eID |
|
142 |
+:; eIDAS |
|
143 |
+: Ist kein Wert gesetzt, erfolgt keine Einschränkung der Authentisierungsverfahren und dem Nutzer |
|
144 |
+: werden alle vom Identity-Provider zur Verfügung gestellten Anmeldeverfahren zur Auswahl angezeigt. |
|
145 |
+; PflichtElemente (ab Version {{version major="3" minor="6"}}{{/version}}) |
|
146 |
+: Über diese Eigenschaft können Attribute als verpflichtende Nutzereigenschaften angefordert werden. |
|
147 |
+: Alle Authentisierungsverfahren, welche die geforderten Attribute nicht erfüllen, werden dadurch ausgeblendet. |
|
148 |
+: Sofern der Formular-Workflow beispielsweise die Kommunikation mit dem Postkorb zwingend erfordert, |
|
149 |
+: kann hier der Wert **Postkorb** angegeben werden, wodurch das Ausblenden der temporären Anmeldung erreicht wird. |
|
150 |
+: Als Werte können können folgende Begriffe angegeben werden (Bei mehreren Werten sind diese durch Komma zu trennen): |
|
151 |
+:; PIN |
|
152 |
+:: In diesem Fall wird die sektor-spezifische Personen-Identifikations-Nummer (ssPIN) angefordert |
|
153 |
+:; Postkorb |
|
154 |
+:: In diesem Fall wird die Postkorb-Id als verpflichtender Wert angefordert, sodass im Workflow |
|
155 |
+:: die Voraussetzungen für den Versand einer Nachricht an den Postkorb des Nutzers gegeben sind. |
| 112 |
112 |
|
| 113 |
113 |
=== Bürgerkonto Login als Formularanmeldung einrichten === |
| 114 |
114 |
|
| ... |
... |
@@ -397,6 +397,18 @@ |
| 397 |
397 |
|
| 398 |
398 |
== Versionshistorie == |
| 399 |
399 |
|
|
444 |
+=== 3.6.0 - Bereitstellung erfolgt nach offiziellen Release der AKDB === |
|
445 |
+ |
|
446 |
+* Erweiterungen / Anpassungen aufgrund von Schnittstellenanpassungen im Bürgerservice-Portal der AKDB: |
|
447 |
+** Möglichkeit zur Anforderung von Pflicht-Attributen (Postkorb-ID) |
|
448 |
+** Umstellung der Auswahlmöglichkeiten für das geforderte Authentifizierungsverfahren auf eine weiter reichende Auswahl (+Migration bestehender Konfigurationen am BK-Login-Button) |
|
449 |
+* Anpassung Postkorb-Aktion: Im Bereich des Absenders sind //Dienst //und //Mandant //keine Pflichtfelder mehr. Wenn Sie nicht definiert werden, werden die globalen Einstellungen |
|
450 |
+aus den Plugin-Properties herangezogen. |
|
451 |
+* 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. |
|
452 |
+* Anpassung AKDB-Vorlage: Anpassung der Verlage, da im Bereich des Absenders Dienst und Mandant keine Pflichtfelder mehr repräsentieren. |
|
453 |
+* Anpassung AKDB-Setup: Hinweis auf freizugebende URL's (Firewall-Einstellungen) hinzugefügt |
|
454 |
+* Fehlerbehebung: Fehlerbehandlung im Plugin-Action-Servlet 'AKDBLogin' angepasst |
|
455 |
+ |
| 400 |
400 |
=== 3.5.7 === |
| 401 |
401 |
|
| 402 |
402 |
* 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) |
