| ... |
... |
@@ -1,5 +3,3 @@ |
| 1 |
|
-[[**Plugin-Download**>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/B%C3%BCrgerservice%20Plugin%20(buerger-service)&fileid=52647||rel="noopener noreferrer" target="_blank"]] (erfordert Anmeldung) |
| 2 |
|
- |
| 3 |
3 |
{{content depth="4"/}} |
| 4 |
4 |
|
| 5 |
5 |
== Initiale Installation == |
| ... |
... |
@@ -127,8 +127,8 @@ |
| 127 |
127 |
dass der anfragende Service dem Portal nicht bekannt ist. |
| 128 |
128 |
{{/info}} |
| 129 |
129 |
))) |
| 130 |
|
-* Nach Aktivierung des Logins erweitert sich die Konfigurationsoberfläche des Authentikators. |
| 131 |
|
-* Unter dem Punkt //Erweiterte Einstellungen// > //Konfiguration Identity Provider Anfrageverhalten// kann das Anfrageverhalten für **alle** Formulare, welche diesen Authentikator später über den Formularzugriff angebunden haben, beeinflusst werden. Dabei sind folgende Einstellungen möglich:((( |
|
128 |
+* ((( |
|
129 |
+Nach Aktivierung des Logins erweitert sich die Konfigurationsoberfläche des Authentikators.* Unter dem Punkt //Erweiterte Einstellungen// > //Konfiguration Identity Provider Anfrageverhalten// kann das Anfrageverhalten für **alle** Formulare, welche diesen Authentikator später über den Formularzugriff angebunden haben, beeinflusst werden. Dabei sind folgende Einstellungen möglich:((( |
| 132 |
132 |
; Vertrauensniveau |
| 133 |
133 |
: Angaben in dieser Eigenschaft dienen zum Einschränken der Authentisierungsverfahren auf zugelassene Vertrauensniveaus. |
| 134 |
134 |
Einschränkungen dieser Art werden an referenzierende Identity Provider weitergereicht, wenn dies durch den aufrufenden Identity Provider unterstützt wird. |
| ... |
... |
@@ -160,109 +160,10 @@ |
| 160 |
160 |
** Achtung: Der Livesystem Postkorb-Webservice ist **nicht** direkt aus dem Internet erreichbar! |
| 161 |
161 |
{{/warning}} |
| 162 |
162 |
))) |
|
161 |
+))) |
| 163 |
163 |
|
| 164 |
164 |
== Details für die Anbindung des ELSTER //Mein Unternehmenskontos// == |
| 165 |
165 |
|
| 166 |
|
-Um das Unternehmenskonto **ELSTER** anzubinden ist ein neuer Externer Benutzer anzulegen und als Authentifizierungstyp **ELSTER Unternehmenskonto** auszuwählen. |
| 167 |
|
- |
| 168 |
|
-=== Schritt 1: Konfiguration anlegen === |
| 169 |
|
- |
| 170 |
|
-{{figure image="elster_config1.png"}} |
| 171 |
|
-Schritt 1: Notwendige Daten für Erzeugung der Service Metadaten festlegen |
| 172 |
|
-{{/figure}} |
| 173 |
|
- |
| 174 |
|
-* Im 1. Schritt der Konfiguration erscheint eine Eingabeoberfläche, wo folgende Festlegungen getroffen werden müssen: |
| 175 |
|
-** Festlegung, ob Test- oder Live-Umgebung des **ELSTER** Portals anzubinden ist. |
| 176 |
|
-** Definition einer eindeutigen ID. Diese ID dient im weiteren Verlauf als //Entity-ID// innerhalb der SAML-Metadatenkonfiguration und wird in einer URL-Notation angegeben. |
| 177 |
|
-** Erhebung von Zertifikatsinformationen, welche anschließend zur Generierung eines privaten und öffentlichen Schlüssels herangezogen werden. Dieses Schlüsselpaar dient zur Ver- und Entschlüsselung der Kommunikation, zwischen {{formcycle/}} und dem **ELSTER** Portal. |
| 178 |
|
-* Speichern der Eingaben. Danach gelangt man zum 2. Schritt der Anbindung. |
| 179 |
|
- |
| 180 |
|
-=== Schritt 2: Vorbereitung für Registrierung im MUK Portal === |
| 181 |
|
- |
| 182 |
|
-{{figure image="elster_config2.png"}} |
| 183 |
|
-Schritt 2 und 3: Anzeige der für die Registrierung im MUK Portal notwendigen Daten; Aktivierung der ELSTER Authentifizierung für Formulare |
| 184 |
|
-{{/figure}} |
| 185 |
|
- |
| 186 |
|
-* In diesem Schritt werden die Daten angezeigt, die für eine Anbindung von FORMCYCLE an das ELSTER **M**ein **U**nternehmens**k**onto (**MUK**) notwendig sind: |
| 187 |
|
-** Entity-ID |
| 188 |
|
-** Assertion Consumer-Service-URLs: Hier werden alle URL's aus dem FORMCYCLE-System aufgeführt (Master-Server sowie Frontend-Server Verbindungen), über die später eine Kommunikation zwischen dem **ELSTER **Portal und dem {{formcycle/}} möglich wäre. Im MUK müssen nur die URL(s) hinterlegt werden, über die am Ende eine Kommunikation stattfinden soll. |
| 189 |
|
-** Öffentlicher Schlüssel: Dieses Zertifikat ist im **MUK **als Signatur- und Verschlüsselungszertifikat zu hinterlegen |
| 190 |
|
-* Damit ist der 1. Teil der Registrierung abgeschlossen und es muss in das **ELSTER** //Self Service Portal// gewechselt werden. |
| 191 |
|
-** Im Portal sind anschießend ein Vorhaben und ein Service-Provider anzulegen.((( |
| 192 |
|
-{{warning}} |
| 193 |
|
-Um sich am //Self Service Portal// zu authentifizieren ist ein Organisationszertifikat notwendig. |
| 194 |
|
-Wenn ihre Organisation noch nicht über ein solches verfügt können Sie dieses über folgende [[Website >>https://www.elster.de/eportal/unternehmerorientiert/registrierungsprozess||rel="noopener noreferrer" target="_blank"]] beantragen. |
| 195 |
|
-{{/warning}} |
| 196 |
|
-))) |
| 197 |
|
- |
| 198 |
|
-=== Registrierung eines NEZO Vorhabens im MUK Portal === |
| 199 |
|
- |
| 200 |
|
-((( |
| 201 |
|
-{{info}} |
| 202 |
|
-Die nachfolgenden Angaben in diesem Abschnitt beziehen sich auf die durchzuführenden Schritte im MUK Portal, welche außerhalb von {{formcycle/}} stattfinden. |
| 203 |
|
-{{/info}} |
| 204 |
|
-))) |
| 205 |
|
- |
| 206 |
|
-**NEZO** steht für "Nutzung der ELSTER-Zertifikate im Rahmen des **O**nline**z**ugangs**g**esetzes (OZG)". |
| 207 |
|
- |
| 208 |
|
- |
| 209 |
|
-==== NEZO Schritt 1: Anmeldung ==== |
| 210 |
|
- |
| 211 |
|
-{{figure image="elsterSsp_MUK_Login.png"}} |
| 212 |
|
-Anmeldebildschirm zum MUK Self-Service-Portal. Hier muss ein Organisations-Zertifikat für die Anmeldung verwendet werden. |
| 213 |
|
-{{/figure}} |
| 214 |
|
- |
| 215 |
|
-* Das **ELSTER MUK** //Self Service Portal// ist über https://service.mein-unternehmenskonto.de erreichbar. |
| 216 |
|
-* Die Anmeldung am MUK Portal kann nur mit einen Organisationszertifikat durchgeführt werden. |
| 217 |
|
- |
| 218 |
|
-==== NEZO Schritt 2: Vorhaben hinzufügen ==== |
| 219 |
|
- |
| 220 |
|
-{{figure image="elsterSsp_Meine_Vorhaben.png"}} |
| 221 |
|
-Mit einem Klick auf "Hinzufügen" unter "Meine Vorhaben" kann im MUK Self-Service-Portal ein neues NEZO-Vorhaben erstellt werden. Ein NEZO-Vorhaben ist die Voraussetzung für die Anbindung des Unternehmenskonto-Logins. Durch einen Klick auf ein Vorhaben auf der Übersichtsseite "Meine Vorhaben" gelangt man auf die Übersichtsseite des Vorhabens, auf welcher Service-Provider beantragt / bearbeitet werden können. |
| 222 |
|
-{{/figure}} |
| 223 |
|
- |
| 224 |
|
-{{figure image="elsterSsp_Vorhaben_Verantwortlichkeiten_redacted.png"}} |
| 225 |
|
-Beantragung eines NEZO-Vorhabens zum Zweck der Anbindung des Unternehmenskonto-Logins zu FORMCYCLE über das MUK Self-Service-Portal. Im Abschnitt Dienstleiter ist die **XIMA MEDIA GmbH** anzugeben. |
| 226 |
|
-{{/figure}} |
| 227 |
|
- |
| 228 |
|
-Nach der Anmeldung im MUK //Self Service Portal// mit einem ELSTER-Organisationszertifikat, muss über dieses Portal ein NEZO-Vorhaben bei MUK beantragt werden. |
| 229 |
|
- |
| 230 |
|
-Mit einem Klick auf "Hinzufügen" unter "Meine Vorhaben" kann im MUK Self-Service-Portal ein neues NEZO-Vorhaben erstellt werden. Ein NEZO-Vorhaben ist die Voraussetzung für die Anbindung des Unternehmenskonto-Logins. Durch einen Klick auf ein Vorhaben auf der Übersichtsseite "Meine Vorhaben" gelangt man auf die Übersichtsseite des Vorhabens, auf welcher Service-Provider beantragt / bearbeitet werden können. |
| 231 |
|
- |
| 232 |
|
-==== NEZO Schritt 3: Service-Provider beantragen ==== |
| 233 |
|
- |
| 234 |
|
-{{figure image="elsterSsp_Serviceprovider.png"}} |
| 235 |
|
-In der Übersicht eines Vorhabens kann ein Service-Provider bei MUK beantragt werden. Bei der Beantragung eines Service-Providers müssen verschiedene technische Angaben gemacht werden, welche im Schritt 2 dieser Anleitung erzeugt wurden. |
| 236 |
|
-{{/figure}} |
| 237 |
|
- |
| 238 |
|
-Beantragung eines NEZO-Vorhabens zum Zweck der Anbindung des Unternehmenskonto-Logins zu FORMCYCLE über das MUK Self-Service-Portal. Im Abschnitt Dienstleiter ist die XIMA MEDIA GmbH anzugeben. |
| 239 |
|
-Ein NEZO-Vorhaben ist die Voraussetzung für die Anbindung des Unternehmenskonto-Logins. Für ein NEZO-Vorhaben müssen verschiedene Angaben gemacht werden, wie z.B. die konkrete Zeitplanung des Vorhabens oder die voraussichtliche Anzahl der Unternehmenskonto-Logins pro Tag. Für die Beantragung das Vorhabens ist ein Dienstleister nötig. Hier muss die XIMA MEDIA GmbH angegeben werden (siehe Abbildung rechts). Weitere Informationen zum Beantragungsprozess können Sie auf https://service.mein-unternehmenskonto.de/https://service.mein-unternehmenskonto.de/ finden. |
| 240 |
|
- |
| 241 |
|
-=== Schritt 3: ELSTER-Login Aktivierung === |
| 242 |
|
- |
| 243 |
|
-{{figure image="elster_config3.png"}} |
| 244 |
|
-Anbindung des ELSTER Postkorbs mittels ELSTER-Transfer-Client |
| 245 |
|
-{{/figure}} |
| 246 |
|
- |
| 247 |
|
-* Dieser Schritt sollte erst durchgeführt werden, wenn Sie vom **ELSTER** //Self Service Portal// Rückmeldung erhalten haben, dass beantragtes Vorhaben genehmigt und der konfigurierte Service-Provider freigegeben wurde. Erst mit dem Button //ELSTER Login aktivieren// wird der Authentikator im System aktiviert. Er ist damit in den Formularen verfügbar und kann eingebunden werden.((( |
| 248 |
|
-{{info}} |
| 249 |
|
-Hinweis: Wenn Sie den Login **vor** einer positiven Rückmeldung aus dem //Self Service Portal// aktivieren, |
| 250 |
|
-kann der **ELSTER** Unternehmenslogin zwar bereits in den Formularen eingebunden werden, |
| 251 |
|
-wird aber beim Aufruf in einem Fehler resultieren. |
| 252 |
|
-{{/info}} |
| 253 |
|
-))) |
| 254 |
|
-* Nach Aktivierung des Logins erweitert sich die Konfigurationsoberfläche des Authentikators. |
| 255 |
|
-* Unter dem Punkt //Erweiterte Einstellungen// > //Konfigurtion ELSTER Postkorbanbindung// können Sie die Daten für die Anbindung des ELSTER Transfer Clients hinterlegen. Dieser muss im System extra installiert werden und regelt die Weiterleitung von Nachrichten aus FORMCYCLE an das ELSTER Portal. |
| 256 |
|
-Folgende Eigenschaften für die Transfer-Client Anbindung sind konfigurierbar:((( |
| 257 |
|
-; URL ELSTER Transfer-Client |
| 258 |
|
-: URL zu dem Transfer-Client, über den die Weiterleitung von Postkorb-Nachrichten an ELSTER erfolgen soll. |
| 259 |
|
-; Proxy Host: |
| 260 |
|
-: Host Angabe für einen Proxy-Server, wenn die Kommunikation mit dem Transfer-Client über einen Proxy-Server erfolgen soll. |
| 261 |
|
-; Proxy Port: |
| 262 |
|
-: Port-Angabe für einen Proxy-Server, wenn die Kommunikation mit dem Transfer-Client über einen Proxy-Server erfolgen soll. |
| 263 |
|
-))) |
| 264 |
|
-* Über den Button //Postkorb Verbindung prüfen// kann der Zugriff auf den angebundenen ELSTER Transfer Client getestet werden. |
| 265 |
|
- |
| 266 |
266 |
== Details für die Anbindung der BayernID == |
| 267 |
267 |
|
| 268 |
268 |
Um das Servicekonto der **BayernID** anzubinden ist ein neuer Externer Benutzer anzulegen und als Authentifizierungstyp **BayernID** auszuwählen. |
| ... |
... |
@@ -305,12 +305,14 @@ |
| 305 |
305 |
{{info}} |
| 306 |
306 |
Hinweis: Wenn Sie den Login **vor** einer positiven Rückmeldung des BayernID-Portals aktivieren, |
| 307 |
307 |
so kann das die **BayernID** zwar bereits in den Formularen eingebunden werden, |
| 308 |
|
-wird aber beim Aufruf in einem Fehler resultieren. |
|
207 |
+wird aber beim Aufruf in einem Fehler resultieren, |
|
208 |
+dass der anfragende Service dem Portal nicht bekannt ist. |
| 309 |
309 |
{{/info}} |
| 310 |
310 |
))) |
| 311 |
|
-* Nach Aktivierung des Logins erweitert sich die Konfigurationsoberfläche des Authentikators. |
| 312 |
|
-* Unter dem Punkt //Erweiterte Einstellungen// > //Konfigurtion BayernID Postkorbanbindung// können Sie das Zertifikat, welches Sie im Zuge der Registrierung ihrer Metadaten vom **BayernID **Portal erhalten haben sollten, hochladen und zusammen mit dem zugehörigen Passwort an der Authentikator-Konfiguration abspeichern. |
| 313 |
313 |
* ((( |
|
212 |
+Nach Aktivierung des Logins erweitert sich die Konfigurationsoberfläche des Authentikators.* Unter dem Punkt //Erweiterte Einstellungen// > //Konfigurtion BayernID Postkorbanbindung// können Sie das Zertifikat, welches Sie im Zuge der Registrierung ihrer Metadaten vom **BayernID **Portal erhalten haben sollten, hochladen und zusammen mit dem zugehörigen Passwort an der Authentikator-Konfiguration abspeichern. |
|
213 |
+ |
|
214 |
+* ((( |
| 314 |
314 |
Über den Button //Postkorb Verbindung prüfen// kann der Zugriff auf den Postkorb-Webservice getestet werden. |
| 315 |
315 |
Der Webservice muss dabei vom {{formcycle/}} Master-Server aus erreichbar sein (dafür sind im System unter Umständen Firewall Freigaben notwendig). |
| 316 |
316 |
|
| ... |
... |
@@ -334,3 +334,4 @@ |
| 334 |
334 |
))) |
| 335 |
335 |
))) |
| 336 |
336 |
* Sollte für die Kommunikation ein Proxy-Server notwendig sein, so kann dieser in den Eingabefeldern //Proxy Host //und //Proxy Port// konfiguriert werden. |
|
238 |
+))) |
