| ... |
... |
@@ -1,6 +1,6 @@ |
| 1 |
1 |
[[**Plugin-Download**>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/ELSTER%20(fc-plugin-bundle-elster-authenticator)&fileid=25551||rel="noopener noreferrer" target="_blank"]] (erfordert Anmeldung) |
| 2 |
2 |
|
| 3 |
|
-Min. {{formcycle/}}-Version: {{version major="6" minor="6" patch="11"}}{{/version}}. Für Verwendung der Postkorb-Funktionalität ist min. {{formcycle/}}-Version {{version major="7" minor="0" patch="0" /}} & Pluginversion {{version major="2" minor="1" patch="0" /}} nötig. |
|
3 |
+Min. {{formcycle/}}-Version: {{version major="6" minor="6" patch="11"}}{{/version}}. Für Verwendung der Postkorb-Funktionalität ist min. {{formcycle/}}-Version {{version major="7" minor="0" patch="0"/}} & Pluginversion {{version major="2" minor="1" patch="0"/}} nötig. |
| 4 |
4 |
|
| 5 |
5 |
{{content/}} |
| 6 |
6 |
|
| ... |
... |
@@ -9,7 +9,7 @@ |
| 9 |
9 |
Formularelementvorlage //ELSTER Accountdaten// für einen Nutzer mit persönlichem Zertifikat. |
| 10 |
10 |
{{/figure}} |
| 11 |
11 |
|
| 12 |
|
-Über das kostenpflichtige //ELSTER Service Plugin// ist es möglich authentifizierte ELSTER-Accountdaten in Formularen zu erfassen. Dies geschieht indem dem Formular ein ELSTER-Login vorgeschaltet wird. Um den ELSTER-Login zu ermöglichen, muss der {{formcycle/}}-Server vorerst bei ELSTER registriert werden. Details hierzu finden Sie im Abschnitt Setup. |
|
12 |
+Über das kostenpflichtige //ELSTER Service Plugin// ist es möglich authentifizierte ELSTER-Accountdaten in Formularen zu erfassen. Dies geschieht indem dem Formular ein ELSTER-Login vorgeschaltet wird. Um den ELSTER-Login zu ermöglichen, muss der {{formcycle/}}-Server vorerst bei ELSTER registriert werden. Der technische Anbindungsprozess an die Schnittstellen erfolgt über ein dafür vorgesehenes Portal (Self Service Portal). Die Liveschaltung dieses Self Service Portals wird voraussichtlich gegen Ende Februar 2022 erfolgen. Details hierzu finden Sie im Abschnitt Setup. |
| 13 |
13 |
|
| 14 |
14 |
== Setup == |
| 15 |
15 |
|
| ... |
... |
@@ -47,16 +47,16 @@ |
| 47 |
47 |
|
| 48 |
48 |
=== Entity-Descriptor erstellen === |
| 49 |
49 |
|
| 50 |
|
-Nachdem der ELSTER-Login erstellt wurde, kann für diesen der Entity-Descriptor erstellt werden. Der Entity-Descriptor enthält Metadaten zum {{formcycle/}}-Server und das Schlüsselmaterial für die Signierung & Verschlüsselung der Kommunikation. Diesen Entity-Descriptor müssen Sie an ELSTER senden, damit der {{formcycle/}}-Server für die Authentifizierungen registriert werden kann. |
| 51 |
|
-Werden Frontend-Server verwendet, dann muss für jeden Frontend-Server, für den der ELSTER-Login zur Verfügung stehen soll, ein Entity-Descriptor erstellt und bei ELSTER registriert werden. |
|
50 |
+Nachdem der ELSTER-Login erstellt wurde, kann für diesen der Entity-Descriptor erstellt werden. Der Entity-Descriptor enthält Metadaten zum {{formcycle/}}-Server und das Schlüsselmaterial für die Signierung & Verschlüsselung der Kommunikation. Diesen Entity-Descriptor müssen Sie an ELSTER senden, damit der {{formcycle/}}-Server für die Authentifizierungen registriert werden kann. Wie bereits erwähnt soll das dafür vorgesehenes Self Service Portal gegen Ende Februar 2022 zur Verfügung stehen. Werden Frontend-Server verwendet, dann muss für jeden Frontend-Server, für den der ELSTER-Login zur Verfügung stehen soll, ein Entity-Descriptor erstellt und bei ELSTER registriert werden. |
| 52 |
52 |
|
| 53 |
|
-{{id name="sec_form_access" /}} |
|
52 |
+{{id name="sec_form_access"/}} |
|
53 |
+ |
| 54 |
54 |
== Einbindung des ELSTER-Logins in Formularen == |
| 55 |
55 |
|
| 56 |
56 |
Um den ELSTER-Login in Formularen zu aktivieren, muss dieser über die Zugriffseinstellungen des Formulars aktiviert werden. Nachdem dies geschehen ist, werden Nutzer nun beim Aufruf des Formulars nun aufgefordert sich bei ELSTER anzumelden. |
| 57 |
57 |
Zur Darstellung der ELSTER-Accountdaten gibt es eine Formularvorlage im Designer, welche in das Formular gezogen werden kann. Diese Formularvorlage enthält Datenfelder für perönliche sowie Organisationsaccounts. Je nachdem, welcher Nutzer sich angemeldet hat, wird das passende Fieldset dargestellt. Die Formularfelder können nach der Nutzerauthentifizierung nicht mehr geändert werden und haben festgelegte Namen: |
| 58 |
58 |
|
| 59 |
|
-{{table dataTypeAlpha="0" preSort="0-asc"}} |
|
59 |
+{{table dataTypeAlpha="0"}} |
| 60 |
60 |
|=Formularfeldname|=Bemerkung|=optional|=für Zertifikatstyp |
| 61 |
61 |
|tfDatenkranzTyp|StNr (bei einem Organisationszertifikat) oder IdNr (bei einem persönlichen Zertifikat)|nein|beide |
| 62 |
62 |
|tfPersTyp|NATPERS (Der Inhaber des Steuerkontos ist eine natürliche Person - z.B. ein Einzelunternehmer) oder NNATPERS (nichtnatürliche Person - z.B. eine GmbH)|nein|Organisationszeitifikat |
| ... |
... |
@@ -106,7 +106,7 @@ |
| 106 |
106 |
|
| 107 |
107 |
Optional kann für jede ELSTER-Anmeldung (ohne Formularabsendung) eine solche Protkollierung aktiviert werden (siehe Konfiguration des Plugins). Dies ist standardmäßig deaktiviert. |
| 108 |
108 |
|
| 109 |
|
-== ELSTER-Postkorb {{version major="2" minor="1" patch="0" /}} == |
|
109 |
+== ELSTER-Postkorb {{version major="2" minor="1" patch="0"/}} == |
| 110 |
110 |
|
| 111 |
111 |
Mit Version //2.1.0// des Plugins ist es möglich Nachrichten an den ELSTER-Postkorb von authentifizierten Nutzern zu senden. Hierfür steht eine neue [[Aktion>>doc:Formcycle.Designer.Workflow.Actions.WebHome]] mit dem Namen //ELSTER Postkorbnachricht// zur Verfügung, welche in den [[Workflow>>doc:Formcycle.Designer.Workflow.WebHome]] integriert werden kann. Derzeit ist es somit möglich PDFs an die Nutzer/Antragsteller zu senden. Der Status einer versendeten Nachricht kann mit der Aktion //ELSTER Postkorbnachricht Status// abgerufen werden. |
| 112 |
112 |
|
| ... |
... |
@@ -116,10 +116,10 @@ |
| 116 |
116 |
|
| 117 |
117 |
=== Aktion: ELSTER Postkorbnachricht === |
| 118 |
118 |
|
| 119 |
|
-Mit dieser Aktion können Nachrichten an den ELSTER-Postkorb von authentifizierten Nutzern/Antragstellern gesendet werden. Der Inhalt der Nachricht kann derzeit nur ein PDF sein. Der Empfänger der Nachricht wird über den Status identifiziert, in dem sich der Nutzer/Antragsteller am Formular authentifiziert hat. Folgende Parameter sind für die Konfiguration nötig bzw. optional: |
|
119 |
+Mit dieser Aktion können Nachrichten an den ELSTER-Postkorb von authentifizierten Nutzern/Antragstellern gesendet werden. Der Inhalt der Nachricht kann derzeit nur ein PDF sein. Der Empfänger der Nachricht wird über den Status identifiziert, in dem sich der Nutzer/Antragsteller am Formular authentifiziert hat. Die Aktion gibt die ELSTER-Transfer-ID der veresendeten Nachricht im Ergebnis zurück. Diese kann in der Aktion //ELSTER Postkorbnachricht Status// verwendet werden. Folgende Parameter sind für die Konfiguration nötig bzw. optional: |
| 120 |
120 |
|
| 121 |
121 |
; Datenart (Pflicht) |
| 122 |
|
-: Angabe der Art des Dokuments. Mögliche Werte sind //EPMitteilung//, //EPBescheid// & Gewerbesteuermitteilung//. |
|
122 |
+: Angabe der Art des Dokuments. Mögliche Werte sind //EPMitteilung//, //EPBescheid// & Gewerbesteuermitteilung//.// |
| 123 |
123 |
|
| 124 |
124 |
; Absender (Pflicht) |
| 125 |
125 |
: Der Absender der Nachricht, z.B. Stadt XYZ. |
| ... |
... |
@@ -166,17 +166,24 @@ |
| 166 |
166 |
|
| 167 |
167 |
In den Plugineinstellungen können Parameter zu Konfiguration angegeben werden: |
| 168 |
168 |
|
| 169 |
|
-{{table dataTypeAlpha="0" preSort="0-asc"}} |
| 170 |
|
-|=Parameter|=Bemerkung|Standardwert |
|
169 |
+|=Parameter|=Bemerkung|=Standardwert |
| 171 |
171 |
|elster.bundle.param.supported.issuer.ids|Semikolon-separierte Liste der unterstützten Issuer-IDs|[[https://idp.een.elster.de>>https://idp.een.elster.de]];[[https://www.elster.de>>https://www.elster.de]] |
| 172 |
172 |
|elster.bundle.param.protocol.preserve|Ob die angelegten Protokolleinträge löschbar (false) oder nicht löschbar (true) sein sollen|true |
| 173 |
173 |
|elster.bundle.param.protocol.login.callbacks|Gibt an ob für jede Anmeldung bei ELSTER ein Mandantprotokolleintrag erstellt werden soll|false |
| 174 |
|
-|elster.bundle.param.elster.transfer.client.url|URL zur ELSTER-Transfer-Anwendung. Ist nötig um Nachrichten an den ELSTER-Postkorb zu versenden.|--- |
|
173 |
+|elster.bundle.param.elster.transfer.client.url|URL zur ELSTER-Transfer-Anwendung. Ist nötig um Nachrichten an den ELSTER-Postkorb zu versenden.|----- |
| 175 |
175 |
|elster.bundle.param.inbox.message.test.mode|Gibt an ob Postkorbnachrichten im Testmodus versendet werden. Im Testmodus kann eine konkrete ELSTER-Account-ID angegeben werden, an welche die Postkorbnachricht versendet werden soll.|false |
| 176 |
|
-{{/table}} |
| 177 |
177 |
|
| 178 |
178 |
== Versionshistorie == |
| 179 |
179 |
|
|
178 |
+=== 2.1.2 === |
|
179 |
+ |
|
180 |
+* Behebung eines Fehlers in der Revisionssicherheit bei mehreren ELSTER-Logins innerhalb eines Formulars. |
|
181 |
+ |
|
182 |
+=== 2.1.1 === |
|
183 |
+ |
|
184 |
+* Auswahl des Empfänger-Status in der Aktion ELSTER-Postkorbnachricht lässt auch keinen Status zu. |
|
185 |
+* Behebung kleinerer Oberflächenfehler. |
|
186 |
+ |
| 180 |
180 |
=== 2.1.0 === |
| 181 |
181 |
|
| 182 |
182 |
* Neue Workflow-Aktion zum Versenden von Nachrichten an den ELSTER-Postkorb. |
