Zeige letzte Bearbeiter
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
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
5 {{content/}}
6
7
8 {{figure image="form_cntr_template_de.PNG"}}
9 Formularelementvorlage //ELSTER Accountdaten// für einen Nutzer mit persönlichem Zertifikat.
10 {{/figure}}
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. 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.
13
14 Die Nutzung des Self Service Portals setzt in jedem Fall zwingend eine Anmeldung mit einem ELSTER-Organisationszertifikat voraus. Dieser Login ist von demjenigen durchzuführen, der für die Verwaltung der Anbindung des Vorhabens verantwortlich ist. Es steht den Nutzern frei, ob die Auftrag gebende Behörde oder der Auftrag nehmende Dienstleister die Verwaltung des Vorhabens im Self Service Portal vornimmt. Hier obliegt diese Entscheidung den konkreten organisatorischen Strukturen/Voraussetzungen des Projektes/der Projekte. Das heißt, das Organisationszertifikat wird rein für den Anbindungsprozess benötigt. Weitere Personen bzw. „Organisationszertifikate“ können derzeit nicht an demselben Vorhaben gleichzeitig arbeiten. Die Funktionalität, andere Projektbeteiligte für die Mitarbeit am Vorhaben im Self Service Portal zu berechtigen, folgt im weiteren Entwicklungsprozess.
15
16 Auf folgender [[Website>>https://www.elster.de/eportal/registrierung-auswahl]] kann das Organisationszertifikat beantragt werden. Weitere Details zur Anbindung finden Sie im Abschnitt //Setup//.
17
18 == Setup ==
19
20 Das Plugin kann nur als Mandantplugin installiert werden. Eine Anleitung zur Installation von Plugins finden Sie [[hier>>doc:Formcycle.UserInterface.Client.Plugins.WebHome]]. Nach Installation des Plugins gibt es einen neuen Menüeintrag //ELSTER-Konfiguration// in der Verwaltungsoberfläche. Sollten Sie diesen Menüeintrag nicht sehen, stellen Sie sicher, dass der angemeldete Benutzer die Rollenberechtigung "Externe Benutzer" sowie "ELSTER-Konfiguration" besitzt. Über die ELSTER-Konfigurationsseite kann nun ein neuer ELSTER-Login erstellt werden und der sog. Entity-Descriptor für diesen Login erstellt werden. Diese Schritte sind notwendig um den ELSTER-Login bei ELSTER zu registrieren.
21
22 === ELSTER-Login erstellen ===
23
24 Mit einem Klick auf //ELSTER-Login erstellen// in der Konfigurationsoberfläche kann ein neuer ELSTER-Login erstellt werden. Hierzu sind nun folgende Informationen nötig:
25
26 ==== Allgemeine Informationen ====
27
28 ; Name
29 : Wie soll der ELSTER-Login heißen? Dieser Name wird für den Anmeldebutton im Formular verwendet. (Soll ein alternativer Name verwendet werden, kann dies am ELSTER-Login nach der Erstellung konfiguriert werden)
30 ; Beschreibung
31 : Eine optionale Beschreibung
32
33 ==== Zertifikatsinformationen ====
34
35 Für die Kommunikation mit der ELSTER-Schnittstelle sind Zertifikate für die Verschlüsselung & Signierung der Nachrichten nötig. Sie haben die Möglichkeit bei der Erstellung des ELSTER-Logins einen Zertifikatsspeicher automatisch erstellen zu lassen oder einen Zertifikatsspeicher (einen sog. KeyStore) hochzuladen. Für die automatische Generierung des Zertifikatsspeichers sind folgende Angaben nötig:
36
37 ; Allgemeiner Name (CN)
38 : Der sog. Common name des Zertifikats. Z.B.: ELSTER-Login
39 ; Organisationseinheit (OU)
40 : Bezeichnung der Abteilung, z.B. IT-Abteilung
41 ; Organisationsname (O)
42 : Name des Unternehmens bzw. der Behörde
43 ; Ortsbezeichnung (L)
44 : Stadt oder Ort, in dem das Unternehmen bzw. die Behörde ansässig ist
45 ; Bundesland (ST)
46 : Bundesland, in dem das Unternehmen bzw. die Behörde ansässig ist
47 ; Land (C)
48 : Der aus zwei Buchstaben bestehende Ländercode im ISO-Format desjenigen Landes, in dem das Unternehmen bzw. die Behörde rechtmäßig registriert ist z.B. DE
49
50 Mit diesen Informationen wird bei der Erstellung des ELSTER-Logins ein Zertifikatsspeicher für die Signierung & Verschlüsselung erstellt. Möchten Sie einen eigenen Zertifikatsspeicher verwenden, ist darauf zu achten, dass das darin enthaltene Zertifikat eine Schlüssellönge von 4096 Bit hat und den Algorithmus RSA (SHA-256) verwendet.
51
52 === Entity-Descriptor erstellen ===
53
54 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.
55
56 {{id name="sec_form_access"/}}
57
58 == Einbindung des ELSTER-Logins in Formularen ==
59
60 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.
61 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:
62
63 {{table dataTypeAlpha="0"}}
64 |=Formularfeldname|=Bemerkung|=optional|=für Zertifikatstyp
65 |tfDatenkranzTyp|StNr (bei einem Organisationszertifikat) oder IdNr (bei einem persönlichen Zertifikat)|nein|beide
66 |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
67 |tfTrustLevelIdentifizierung|"SUBSTANZIELL" für alle, die per Brief oder persönlich Identifiziert wurden. "HOCH" für die mit nPA|nein|beide
68 |tfTrustLevelAuthentifizierung|"SUBSTANZIELL" für alle|nein|beide
69 |tfAccountPseudonymId|Pseudonymisierte ELSTERAccountID. Pro ELSTERZertifikat eine eigene ID, auch wenn die ELSTER Zertifikate zu ein und derselben Organisation gehören.|nein|beide
70 |tfDatenuebermittlerPseudonymId|für den jeweiligen ServiceProvider pseudonymisierte ID der Organisation, der der Account angehört|nein|Organisationszeitifikat
71 |tfAntragstellerAdressTyp|INLAND oder AUSLAND|nein|persönliches Zertifikat
72 |tfAntragstellerStrasse|Inland 5-stellig|nein|persönliches Zertifikat
73 |tfAntragstellerHausnummer|Werte 0-9999, mit Zusatz|nein|persönliches Zertifikat
74 |tfAntragstellerPLZ||nein (bei INLAND) ja (bei AUSLAND)|persönliches Zertifikat
75 |tfAntragstellerOrt||ja|persönliches Zertifikat
76 |tfAntragstellerOrtsteil||ja|persönliches Zertifikat
77 |tfAntragstellerErgaenzung|Nicht gesetzt bei Auskunftssperre|ja|persönliches Zertifikat
78 |tfAntragstellerLand|ALPHA-2 Länderkürzel nach ISO 3166-1. DE bei Inlandsadressen. Nicht gesetzt bei Auskunftssperre|nein|persönliches Zertifikat
79 |tfAntragstellerVorname||nein|persönliches Zertifikat
80 |tfAntragstellerName||nein|persönliches Zertifikat
81 |tfAntragstellerGeburtsdatum||nein|persönliches Zertifikat
82 |tfAntragstellerGeburtsname||ja|persönliches Zertifikat
83 |tfAntragstellerGeburtsort||ja|persönliches Zertifikat
84 |tfAntragstellerGeburtsland||ja|persönliches Zertifikat
85 |tfAntragstellerAkademischerGrad||ja|persönliches Zertifikat
86 |tfOrgAdressTyp||nein|Organisationszertifikat
87 |tfOrgStrasse|Inland 5-stellig|nein|Organisationszeitifikat
88 |tfOrgHausnummer|Werte 0-9999, mit Zusatz|nein|Organisationszeitifikat
89 |tfOrgPLZ||nein (bei INLAND) ja (bei AUSLAND)|Organisationszeitifikat
90 |tfOrgOrt||ja|Organisationszeitifikat
91 |tfOrgOrtsteil||ja|Organisationszeitifikat
92 |tfOrgErgaenzung|Nicht gesetzt bei Auskunftssperre|ja|Organisationszeitifikat
93 |tfOrgLand|ALPHA-2 Länderkürzel nach ISO 3166-1. DE bei Inlandsadressen. Nicht gesetzt bei Auskunftssperre|nein|Organisationszeitifikat
94 |tfOrgFirmenname|Der Name der Organisation. Bei NatPers kann dies auch der konkatenierte Vor- und Nachname des Steuerkontoinhabers sein.|nein|Organisationszeitifikat
95 |tfOrgRechtsformText|Für PersTyp NNATPERS|nein|Organisationszertifikat
96 |tfOrgRechtsform|Für PersTyp NNATPERS|nein|Organisationszertifikat
97 |tfOrgTaetigkeitText|Für PersTyp NATPERS|nein|Organisationszertifikat
98 |tfOrgTaetigkeit|Für PersTyp NATPERS|nein|Organisationszertifikat
99 |tfOrgRegisternummer||ja|Organisationszeitifikat
100 |tfOrgRegisterart||ja|Organisationszeitifikat
101 |tfOrgRegistergericht||ja|Organisationszeitifikat
102 |tfOrgGruendungsDatum||ja|Organisationszeitifikat
103 |tfOrgBetriebsbeendigungsdatum||ja|Organisationszeitifikat
104 |tfOrgUStId||ja|Organisationszeitifikat
105 {{/table}}
106
107 === Protokollierung ===
108
109 Für jedes abgesendete Formular, an welchem sich per ELSTER authentifiziert wurde, wird ein Protokolleintrag am Vorgang erstellt. Diese beinhaltet die AccountPseudonym-ID (sowie die DatenübermittlerPseudonym-ID), die ID der SAML-Response, die IssueInstant der SAML-Response und die InResponseTo-ID der SAML-Response.
110
111 Optional kann für jede ELSTER-Anmeldung (ohne Formularabsendung) eine solche Protkollierung aktiviert werden (siehe Konfiguration des Plugins). Dies ist standardmäßig deaktiviert.
112
113 == ELSTER-Postkorb {{version major="2" minor="1" patch="0"/}} ==
114
115 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.
116
117 === Voraussetzung ===
118
119 Um Nachrichten an den ELSTER-Postkorb von Nutzern/Antragstellern zu senden ist es nötig, dass diese sich an dem Formular authentifizieren. Nachrichten können nur an diese Nutzer gesendet werden. Um den ELSTER-Login in Formularen zu ermöglichen siehe Abschnitt [[Einbindung des ELSTER-Logins in Formularen>>||anchor="sec_form_access"]].
120
121 === Aktion: ELSTER Postkorbnachricht ===
122
123 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:
124
125 ; Datenart (Pflicht)
126 : Angabe der Art des Dokuments. Mögliche Werte sind //EPMitteilung//, //EPBescheid// & Gewerbesteuermitteilung//.//
127
128 ; Absender (Pflicht)
129 : Der Absender der Nachricht, z.B. Stadt XYZ.
130
131 ; Betreff (Pflicht)
132 : Bezeichnung der Nachricht.
133
134 ; E-Mail-Adresse (Pflicht bei EPBescheiden)
135 : Notwendig beim Versand von rechtsverbindlichen Bescheiden. Dies ist die E-Mail-Adresse des Empfängers und soltle bei Bescheiden entsprechend im Formular erfasst werden.
136
137 ; Geschätszeichen (Optional)
138 : Für die Zuordnung des Falles zu einem Geschäftsvorgang kann das Geschäftszeichen angegeben werden.
139
140 ; Lieferticket (Optional)
141 : Eindeutige Kennung, um mit diesem Antwort-(Dokument) einen Bezug zu einem vorhergehenden Antrag herzustellen.
142
143 ; Datei (Pflicht)
144 : Nachrichteninhalt in Form einer PDF-Datei.
145
146 ; Empfänger hat sich in diesem Status per ELSTER authentifiziert (Optional)
147 : Durch Angabe des Status wird der Empfänger der Postkorbnachricht bestimmt. Standarmäßig wird die Nachricht an die Person gesendet, die sich beim initialen Aufruf des Formulars per ELSTER authentifiziert hat. Hat sich keine Person zum angegebenen Status per ELSTER authentifiziert, wird diese Aktion fehlschlagen, da der Empfänger nicht ermittelt werden kann. Wird kein Status angegeben, dann wird die Nachricht an den Nutzer gesendet, welcher sich initial am Formular authentifiziert hat.
148
149 ; Testmerker (Optional)
150 : Wenn angegeben, wird die Nachricht als Testnachricht markiert. Mögliche Werte sind 700000001 oder 700000004.
151
152 === Aktion: ELSTER Postkorbnachricht Status ===
153
154 Mit dieser Aktion kann der Status einer bereits mit der Aktion //ELSTER Postkorbnachricht// versendeten Nachricht abgerufen werden. Für diese Aktion ist lediglich die //ELSTER-Transfer-ID// nötig. Diese wird im Ergebnis der Aktion //ELSTER Postkorbnachricht// zurückgegeben und kann im Formular gespeichert werden. Der Status der Nachricht kann folgende Werte haben:
155
156 |=Status|=Beschreibung
157 |IN_BEARBEITUNG|Die Nachricht wird an ELSTER zum Versand an das Postfach übergeben.
158 |UEBERTRAGUNGSFEHLER|Bei der Übertragung an ELSTER ist ein technischer Fehler aufgetreten. In diesem Fall sollte der Versand nochmals versucht werden. Bei wiederholten Fehlern sollte das Anwendungslog kontrolliert werden.
159 |VERSENDET|Die Nachricht wurde erfolgreich an ELSTER übergeben.
160 |EINGESTELLT|Die Nachricht ist im ELSTER-Postfach angekommen, die Benachrichtigung an den Empfänger wurde jedoch noch nicht zugestellt.
161 |DATEN_FEHLERHAFT|Die Daten konnten auf Grund eines Fehlers (z.B. Virenfund) nicht an den Empfänger bereitgestellt werden. In diesem Fall sollte der Bescheid neu aufgebaut und versandt werden.
162 |BEREIT_ZUR_ABHOLUNG|Die Nachricht wurde an den Empfänger bereitgestellt.
163 |VOM_EMPFAENGER_ABGEHOLT|Die Nachricht wurde vom Empfänger abgeholt.
164 |EINGANG_BESTAETIGT|Der Empfänger hat die Abholung bestätigt.
165 |GELOESCHT|Die Nachricht wurde aus dem Postfach gelöscht.
166 |INTERNAL_ERROR|Es kam zu einem internen Fehler.
167 |UNBEKANNT|Die Nachricht konnte nicht im System gefunden werden.
168
169 == Konfiguration des Plugins ==
170
171 In den Plugineinstellungen können Parameter zu Konfiguration angegeben werden:
172
173 |=Parameter|=Bemerkung|=Standardwert
174 |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]]
175 |elster.bundle.param.protocol.preserve|Ob die angelegten Protokolleinträge löschbar (false) oder nicht löschbar (true) sein sollen|true
176 |elster.bundle.param.protocol.login.callbacks|Gibt an ob für jede Anmeldung bei ELSTER ein Mandantprotokolleintrag erstellt werden soll|false
177 |elster.bundle.param.elster.transfer.client.url|URL zur ELSTER-Transfer-Anwendung. Ist nötig um Nachrichten an den ELSTER-Postkorb zu versenden.|-----
178 |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
179
180 == Versionshistorie ==
181
182 === 2.1.3 ===
183
184 * Der Loginbutton für den ELSTER-Login hat standardmäßig den Titel "Login mit Mein Unternehmenskonto".
185
186 === 2.1.2 ===
187
188 * Behebung eines Fehlers in der Revisionssicherheit bei mehreren ELSTER-Logins innerhalb eines Formulars.
189
190 === 2.1.1 ===
191
192 * Auswahl des Empfänger-Status in der Aktion ELSTER-Postkorbnachricht lässt auch keinen Status zu.
193 * Behebung kleinerer Oberflächenfehler.
194
195 === 2.1.0 ===
196
197 * Neue Workflow-Aktion zum Versenden von Nachrichten an den ELSTER-Postkorb.
198 * Der ELSTER-Login kann auch für Status des neuen Workflow konfiguriert werden.
199
200 === 2.0.1 ===
201
202 * Fehlerbehebung bei der Erstellung/Aktualisierung der Formularvorlage für die ELSTER-Accountdaten in mehreren Mandanten.
203
204 === 2.0.0 {{version major="7" minor="0" patch="0"}}{{/version}} ===
205
206 * Anpassung des Plugins an {{formcycle/}}-Version //7.0.0//
207 * Das Plugin kann nicht im Systemscope installiert werden.
208
209 === 1.0.3 ===
210
211 * Fehlerbehebung bei der Erstellung/Aktualisierung der Formularvorlage für die ELSTER-Accountdaten.
212
213 === 1.0.2 ===
214
215 * Erste öffentliche Version des Plugins. Beinhaltet:
216 ** neue Konfigurationsoberfläche zum Anlegen eines ELSTER-Logins und Erstellung des Entity-Descriptors.
217 ** Formularelementvorlage mit sämtlichen vorbefüllten persönlichen bzw. organisationsbezogenen Formularelementen.
218 * Protokollierung eines ELSTER-Logins nach Absenden eines Formulars.