| ... |
... |
@@ -1,10 +8,3 @@ |
| 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. |
| 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. |
| 6 |
|
-{{/info}} |
| 7 |
|
- |
| 8 |
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 |
9 |
|
| 10 |
10 |
{{content/}} |
| ... |
... |
@@ -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// |
|
23 |
+Einstellungen am Formular-Element //AKDB Bürgerkonto// bis Version {{version major="3" minor="6"}}{{/version}} |
| 31 |
31 |
{{/figure}} |
| 32 |
32 |
|
|
26 |
+{{figure image="hilfe_bk_button_v3_6.png"}} |
|
27 |
+Einstellungen am Formular-Element //AKDB Bürgerkonto// ab Version {{version major="3" minor="6"}}{{/version}} |
|
28 |
+{{/figure}} |
|
29 |
+ |
| 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 |
|
60 |
+; --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: |
|
63 |
+:; keine Einschränkung |
|
64 |
+:: Login mittels Passwort, Authega-Zertifikat oder Personalausweis steht zur Auswahl |
|
65 |
+:; Authega |
|
66 |
+:: Nur die Authentifizierung mittels Authega-Zertifikat steht zur Auswahl |
|
67 |
+:; Authega oder Personalausweis |
|
68 |
+:: Login mittels Authega-Zertifikat oder Personalausweis steht zur Auswahl |
|
69 |
+:; Personalausweis |
|
70 |
+:: nur Authentifizierung mittels Personalausweis steht zur Auswahl |
|
71 |
+; Einschränkung der Authentisierungsverfahren (Eigenschaft steht ab Version {{version major="3" minor="6"}}{{/version}} zur Verfügung) |
|
72 |
+: Über diese Checkbox-Auswahl kann das dem Nutzer zur Verfügung stehende Authentifizierungsverfahren eingeschränkt werden. |
|
73 |
+: Ist nichts ausgewählt, erfolgt keine Einschränkung. |
|
74 |
+:; Benutzername |
|
75 |
+:: Authentifizierung erfolgt über Login / Passwort |
|
76 |
+:; Authega-Zertifikat |
|
77 |
+:; Elster-Zertifikat |
|
78 |
+:; FINK |
|
79 |
+:: Authentifizierung erfolgt über ein Identifikationsmittel aus dem Portfolio des //Föderierten Identitätsmanagements Interoperable Nutzerkonten// |
|
80 |
+:; eID (Personalausweis) |
|
81 |
+:; eIDAS |
|
82 |
+:: Authentifizierung mittels Identifikationsmittels nach eIDAS-Verordnung (//electronic IDentification, Authentication and Trust Services//) |
|
83 |
+; Postkorbversand obligatorisch |
|
84 |
+: Diese Einstellung ermöglich es die Postkorb-ID als verpflichtendes Rückgabe-Attribut zu kennzeichnen. |
|
85 |
+: 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 |
|
|
118 |
+ |
|
119 |
+ |
| 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 |
|
125 |
+; --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. |
|
129 |
+; LoginMethod (ersetzt die Eigenschaft AuthTyp ab Version {{version major="3" minor="6"}}{{/version}}) |
|
130 |
+: Über diese Einstellung kann das geforderte Authentisierungsverfahren eingeschränkt werden. |
|
131 |
+: Es können dabei ein oder mehrere Werte (mit Komma getrennt) der folgenden Auflistung angegeben werden: |
|
132 |
+:; Benutzername |
|
133 |
+:; Authega |
|
134 |
+:; Elster |
|
135 |
+:; FINK |
|
136 |
+:; eID |
|
137 |
+:; eIDAS |
|
138 |
+: Ist kein Wert gesetzt, erfolgt keine Einschränkung der Authentisierungsverfahren und dem Nutzer |
|
139 |
+: werden alle vom Identity-Provider zur Verfügung gestellten Anmeldeverfahren zur Auswahl angezeigt. |
|
140 |
+; PflichtElemente (ab Version {{version major="3" minor="6"}}{{/version}}) |
|
141 |
+: Über diese Eigenschaft können Attribute als verpflichtende Nutzereigenschaften angefordert werden. |
|
142 |
+: Alle Authentisierungsverfahren, welche die geforderten Attribute nicht erfüllen, werden dadurch ausgeblendet. |
|
143 |
+: Sofern der Formular-Workflow beispielsweise die Kommunikation mit dem Postkorb zwingend erfordert, |
|
144 |
+: kann hier der Wert **Postkorb** angegeben werden, wodurch das Ausblenden der temporären Anmeldung erreicht wird. |
|
145 |
+: Als Werte können können folgende Begriffe angegeben werden (Bei mehreren Werten sind diese durch Komma zu trennen): |
|
146 |
+:; PIN |
|
147 |
+:: In diesem Fall wird die sektor-spezifische Personen-Identifikations-Nummer (ssPIN) angefordert |
|
148 |
+:; Postkorb |
|
149 |
+:: In diesem Fall wird die Postkorb-Id als verpflichtender Wert angefordert, sodass im Workflow |
|
150 |
+:: 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,14 @@ |
| 397 |
397 |
|
| 398 |
398 |
== Versionshistorie == |
| 399 |
399 |
|
|
439 |
+=== 3.6.0 - Bereitstellung erfolgt nach offiziellen Release der AKDB === |
|
440 |
+ |
|
441 |
+* Erweiterungen / Anpassungen aufgrund von Schnittstellenanpassungen im Bürgerservice-Portal der AKDB: |
|
442 |
+** Möglichkeit zur Anforderung von Pflicht-Attributen (Postkorb-ID) |
|
443 |
+** Umstellung der Auswahlmöglichkeiten für das geforderte Authentifizierungsverfahren auf eine weiter reichende Auswahl (+Migration bestehender Konfigurationen am BK-Login-Button) |
|
444 |
+* Anpassung AKDB-Setup: Hinweis auf freizugebende URL's (Firewall-Einstellungen) hinzugefügt |
|
445 |
+* Fehlerbehebung: Fehlerbehandlung im Plugin-Action-Servlet 'AKDBLogin' angepasst |
|
446 |
+ |
| 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) |
