Changes for page Plugin Setup

From 10.1 to 11.1 From 11.2 to 12.1

From version 11.1

edited by rth
on 01.06.2023, 12:21

Change comment: Neues Bild elster_config3.png hochladen

To version 11.2

edited by rth
on 01.06.2023, 13:58

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -1,3 +1,5 @@
++[[**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)
++
  {{content depth="4"/}}
  == Initiale Installation ==
@@ -125,8 +125,7 @@
  dass der anfragende Service dem Portal nicht bekannt ist.
  {{/info}}
  )))
--* (((
--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:(((
++* 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:(((
  ; Vertrauensniveau
  : Angaben in dieser Eigenschaft dienen zum Einschränken der Authentisierungsverfahren auf zugelassene Vertrauensniveaus.
  Einschränkungen dieser Art werden an referenzierende Identity Provider weitergereicht, wenn dies durch den aufrufenden Identity Provider unterstützt wird.
@@ -158,10 +158,63 @@
  ** Achtung: Der Livesystem Postkorb-Webservice ist **nicht** direkt aus dem Internet erreichbar!
  {{/warning}}
  )))
--)))
  == Details für die Anbindung des ELSTER //Mein Unternehmenskontos// ==
++Um das Unternehmenskonto **ELSTER** anzubinden ist ein neuer Externer Benutzer anzulegen und als Authentifizierungstyp **ELSTER Unternehmenskonto** auszuwählen.
++
++=== Schritt 1: Konfiguration anlegen ===
++
++{{figure image="elster_config1.png"}}
++Schritt 1: Notwendige Daten für Erzeugung der Service Metadaten festlegen
++{{/figure}}
++
++* Im 1. Schritt der Konfiguration erscheint eine Eingabeoberfläche, wo folgende Festlegungen getroffen werden müssen:
++** Festlegung, ob Test- oder Live-Umgebung des **ELSTER** Portals anzubinden ist.
++** Definition einer eindeutigen ID. Diese ID dient im weiteren Verlauf als //Entity-ID// innerhalb der SAML-Metadatenkonfiguration und wird in einer URL-Notation angegeben.
++** 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.
++* Speichern der Eingaben. Danach gelangt man zum 2. Schritt der Anbindung.
++
++=== Schritt 2: Registrierung im MUK Portal ===
++
++{{figure image="elster_config2.png"}}
++Schritt 2 und 3: Anzeige der für die Registrierung im MUK Portal notwendigen Daten; Aktivierung der ELSTER Authentifizierung für Formulare
++{{/figure}}
++
++* 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:
++** Entity-ID
++** 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.
++** Öffentlicher Schlüssel: Dieses Zertifikat ist im **MUK **als Signatur- und Verschlüsselungszertifikat zu hinterlegen
++* Damit ist der 1. Teil der Registrierung abgeschlossen und es muss in das **ELSTER** Self Service Portal gewechselt werden.
++** Das **ELSTER** Self Service Portal ist über https://service.mein-unternehmenskonto.de erreichbar.
++** Im Portal ist ein Vorhaben und ein Service-Provider anzulegen.
++** Um sich am Self Service Portal zu authentifizieren ist ein ELSTER-Unternehmenszertifikat notwendig (Hinweis: ELSTER-Testzertifikate werden hier **nicht** unterstützt.)
++
++=== Schritt 3: ELSTER-Login Aktivierung ===
++
++{{figure image="elster_config3.png"}}
++Anbindung des ELSTER Postkorbs mittels ELSTER-Transfer-Client
++{{/figure}}
++
++* 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.(((
++{{info}}
++Hinweis: Wenn Sie den Login **vor** einer positiven Rückmeldung aus dem Self Service Portal aktivieren,
++kann der **ELSTER** Unternehmenslogin zwar bereits in den Formularen eingebunden werden,
++wird aber beim Aufruf in einem Fehler resultieren.
++{{/info}}
++)))
++* Nach Aktivierung des Logins erweitert sich die Konfigurationsoberfläche des Authentikators.
++* 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.
++Folgende Eigenschaften für die Transfer-Client Anbindung sind konfigurierbar:(((
++; URL ELSTER Transfer-Client
++: URL zu dem Transfer-Client, über den die Weiterleitung von Postkorb-Nachrichten an ELSTER erfolgen soll.
++; Proxy Host:
++: Host Angabe für einen Proxy-Server, wenn die Kommunikation mit dem Transfer-Client über einen Proxy-Server erfolgen soll.
++; Proxy Port:
++: Port-Angabe für einen Proxy-Server, wenn die Kommunikation mit dem Transfer-Client über einen Proxy-Server erfolgen soll.
++)))
++* Über den Button //Postkorb Verbindung prüfen// kann der Zugriff auf den angebundenen ELSTER Transfer Client getestet werden.
++
  == Details für die Anbindung der BayernID ==
  Um das Servicekonto der **BayernID** anzubinden ist ein neuer Externer Benutzer anzulegen und als Authentifizierungstyp **BayernID** auszuwählen.
@@ -204,18 +204,13 @@
  {{info}}
  Hinweis: Wenn Sie den Login **vor** einer positiven Rückmeldung des BayernID-Portals aktivieren,
  so kann das die **BayernID** zwar bereits in den Formularen eingebunden werden,
--wird aber beim Aufruf in einem Fehler resultieren,
--dass der anfragende Service dem Portal nicht bekannt ist.
++wird aber beim Aufruf in einem Fehler resultieren.
  {{/info}}
  )))
++* 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.
  * (((
--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.
--
--* (((
  Über den Button //Postkorb Verbindung prüfen// kann der Zugriff auf den Postkorb-Webservice getestet werden.
--Der Webservice muss dabei vom {{formcycle/}} Master-Server aus erreichbar sein (dafür sind im System unter Umständen Firewall Freigaben notwendig).
--
--(((
++Der Webservice muss dabei vom {{formcycle/}} Master-Server aus erreichbar sein (dafür sind im System unter Umständen Firewall Freigaben notwendig).(((
  {{warning}}
  Folgende URL muss **vom FORMCYCLE Master-Server** **aus erreichbar** sein:
@@ -235,4 +235,3 @@
  )))
  )))
  * Sollte für die Kommunikation ein Proxy-Server notwendig sein, so kann dieser in den Eingabefeldern //Proxy Host //und //Proxy Port// konfiguriert werden.
--)))