Wiki source code of Plugin Setup

Hide last authors

version	line-number	content
11.2	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
15.11	3	(% class="box xm-toc-box" data-content-hide="Verbergen" data-content-show="Anzeigen" style="width:auto;" %)
	4	(((
	5	Inhalt (% class="xm-toc-toggle" %)[ [[Verbergen>>path:javascript:void\|\|class="xm-toc-togglelink"]] ]
1.1	6
15.11	7	(% class="xm-toc numbered-true" %)
	8	(((
	9	(% class="wikitoc" %)
	10	* [[Initiale Installation>>path:#HInitialeInstallation]]
	11	* [[Migration bestehender Service-Konten-Anbindungen>>path:#HMigrationbestehenderService-Konten-Anbindungen]]
	12	** [[Migrations-Beispiel für BayernID Anbindung:>>path:#HMigrations-BeispielfFCrBayernIDAnbindung:]]
	13	** [[Migration für BundID Anbindungen>>path:#HMigrationfFCrBundIDAnbindungen]]
	14	** [[Migration für ELSTER Anbinungen>>path:#HMigrationfFCrELSTERAnbinungen]]
	15	* [[Vorüberlegungen zur Anbindung neuer Servicekonten>>path:#HVorFCberlegungenzurAnbindungneuerServicekonten]]
	16	* [[Allgemeine Informationen zur Anbindung eines Servicekontos>>path:#HAllgemeineInformationenzurAnbindungeinesServicekontos]]
	17	* [[Details für die Anbindung der BundID>>path:#HDetailsfFCrdieAnbindungderBundID]]
	18	** [[Schritt 1: Konfiguration anlegen>>path:#HSchritt1:Konfigurationanlegen]]
	19	** [[Schritt 2: Metadaten erzeugen und registrieren>>path:#HSchritt2:Metadatenerzeugenundregistrieren]]
	20	** [[Schritt 3: BundID-Login Aktivierung>>path:#HSchritt3:BundID-LoginAktivierung]]
	21	* [[Details für die Anbindung des ELSTER Mein Unternehmenskontos>>path:#HDetailsfFCrdieAnbindungdesELSTERMeinUnternehmenskontos]]
	22	** [[FORMCYCLE Schritt 1: Konfiguration anlegen>>path:#HFORMCYCLESchritt1:Konfigurationanlegen]]
	23	** [[FORMCYCLE Schritt 2: Vorbereitung für Registrierung im MUK Portal>>path:#HFORMCYCLESchritt2:VorbereitungfFCrRegistrierungimMUKPortal]]
	24	** [[MUK Self Service Portal: Registrierung eines NEZO Vorhabens>>path:#HMUKSelfServicePortal:RegistrierungeinesNEZOVorhabens]]
	25	*** [[MUK Self Service Portal Schritt 1: Anmeldung>>path:#HMUKSelfServicePortalSchritt1:Anmeldung]]
	26	*** [[MUK Self Service Portal Schritt 2: Vorhaben hinzufügen>>path:#HMUKSelfServicePortalSchritt2:VorhabenhinzufFCgen]]
	27	*** [[MUK Self Service Portal Schritt 3: Service-Provider beantragen>>path:#HMUKSelfServicePortalSchritt3:Service-Providerbeantragen]]
	28	** [[FORMCYCLE Schritt 3: ELSTER-Login Aktivierung>>path:#HFORMCYCLESchritt3:ELSTER-LoginAktivierung]]
	29	* [[Details für die Anbindung der BayernID>>path:#HDetailsfFCrdieAnbindungderBayernID]]
	30	** [[Schritt 1: Konfiguration anlegen>>path:#HSchritt1:Konfigurationanlegen-1]]
	31	** [[Schritt 2: Metadaten erzeugen und registrieren>>path:#HSchritt2:Metadatenerzeugenundregistrieren-1]]
	32	** [[Schritt 3: BayernID-Login Aktivierung>>path:#HSchritt3:BayernID-LoginAktivierung]]
	33	)))
	34	)))
	35
1.1	36	== Initiale Installation ==
	37
18.5	38	Das Bürgerservice Plugin muss im System Bereich von (% class="xm-smallcaps" %)Xima® Formcycle(%%) installiert werden (Menüpunkt: System > [[Systemplugins>>path:/xwiki/bin/view/Formcycle/SystemSettings/UserInterface/SystemPlugins\|\|target="_blank"]]).
1.4	39	Es bietet aktuell die Anbindung an folgende Servicekonten:
1.1	40
1.3	41	* BundID
	42	* BayernID
	43	* ELSTER //Mein Unternehmenskonto//
	44
18.2	45	(% class="box warningmessage" %)
	46	(((
	47	Beachten Sie bitte, dass die einzelnen Servicekonto-Anbindungen lizenzpflichtig sind. Sollten Sie eine Lizenz für das jeweilige Servicekonto erworben
	48	haben und ihnen wird beim Aufrufversuch der Zugriffs auf die Kontoart verweigert, so prüfen Sie bitte die Aktualität ihrer [[FORMCYCLE-System bzw. Mandant-Lizenz>>path:/xwiki/bin/view/Formcycle/SystemSettings/UserInterface/License\|\|target="_blank"]].
	49	)))
	50
18.3	51	== Migration bestehender Service-Konto-Anbindungen ==
1.1	52
5.6	53	* Bestehende Anbindungen zu Service-Konten von BundID, BayernID und ELSTER werden bei der Installation des Plugins automatisch auf das neue Plugin umgestellt.
18.2	54	* (% class="box infomessage" %)
	55	(((
18.4	56	Die veralteten Plugin-Bundles (jar-Dateien) bleiben auf dem FORMCYCLE System erhalten, werden aber deaktiviert.
18.5	57	Folgende Plugins können deshalb auf dem System nach der Installation des Bürgerservice Plugins deaktiviert sein:
18.2	58
	59	* //plugin-bundle-bund-id //(veraltetes Plugin für BundID Anbindung)
	60	* //plugin-bundle-akdb-services.jar //(veraltetes Plugin für BayernID Anbindung)
	61	* //fc-plugin-bundle-elster-authentikator.jar// (veraltetes Plugin für ELSTER Anbindung)
	62	)))
5.6	63	* Alle zuvor konfigurierten Anbindungen werden als Externe Benutzer im jeweiligen Bereich (System oder Mandant) definiert.
	64	* Designer-Vorlagen, die mit den veralteten Plugins in das System gekommen sind, werden entfernt.
	65
5.7	66	=== Migrations-Beispiel für BayernID Anbindung: ===
	67
1.4	68	Ausgangspunkt ist ein FORMCYCLE System mit mehreren Mandanten. In zwei Mandanten ist jeweils das// AKDB: Bürgerkonto-Service-Plugin //(Anbindung an BayernID) installiert.
1.2	69	Einer der BayernID Mandanten hat die Einbindung des Bürgerkonto Logins als Externer Benutzer konfiguriert.
1.1	70
18.5	71	Nachdem das Bürgerservice Plugin im [[System Bereich>>path:/xwiki/bin/view/Formcycle/SystemSettings/UserInterface/SystemPlugins\|\|target="_blank"]] installiert wurde ergibt sich folgendes Bild:
1.2	72
18.6	73	* Die veralteten //AKDB: Bürgerkonto-Service-Plugins// in den jeweiligen Mandanten sind deaktiviert, aber noch vorhanden.(((
	74	{{warning}}
	75	Achtung:
	76	Das veraltete //AKDB: Bürgerkonto-Service-Plugin// darf nach der Migration nicht wieder aktiviert werden. Sollte dies dennoch der Fall sein, so ist das Plugin wieder zu deaktivieren und das Systemplugin Bürgerservice muss nach der Deaktivierung nochmalig gespeichert werden. Das nochmalige Speichern bewirkt die Reinitialisierung eines Servlets, welches für die Entgegenahme und Weiterleitung der BayernID Authentifizierungsdaten zuständig ist.
	77	{{/warning}}
	78	)))
1.3	79	* In beiden Mandanten mit BayernID Anbindung befindet sich jetzt ein Externer Benutzer, welcher zukünftig die Authentifizierung mit dem BayernID-Portal realisiert.
	80	In einem Mandanten wurde dazu im Zuge der Migration der Externe Benutzer neu angelegt. In dem Mandanten, wo bereits ein Externer Benutzer bestand, wurde dieser um notwendige Daten (Zertifikate zur Kommunikation, Anbindungsdaten für den Postkorb-Schnittstelle) erweitert, sodass er auch weiterhin in den bereits bestehenden Formularanbindungen genutzt werden kann.
	81	* Der Menüpunkt //AKDB Setup// ist in den Mandanten nicht mehr vorhanden. Die Einstellungen, welche den Postkorb betreffen (z.B.: Zertifikat für Postkorb-Kommunikation) sind jetzt direkt am neu erstellten bzw. migrierten Externen Benutzer zu finden.
	82	* Alte Designer-Vorlagen für die Anzeige der Bürgerkonto-Daten wurden durch neue Vorlagen ersetzt.
18.5	83	* Die Formulare welche bisher die BayernID über den Login-Button eingebunden hatten müssen nicht angepasst werden. Bei Nutzung des Login-Buttons, sowie der Postkorb-Aktion im Workflow erfolgt eine automatische Weiterleitung an die durch das Bürgerservice Plugin bereitgestellte Funktionalität.
1.4	84
15.11	85	(% class="box infomessage" %)
	86	(((
	87	Hinweis: Es werden nur fertig konfigurierte BayernID Anbindungen migriert. Ist nur das Plugin im Mandaten vorhanden ist, sind aber keine Einstellungen zur Anbindung (Keystore, EntityID etc.) konfiguriert, kann keine Migration in einen [[Externen Benutzer>>path:/xwiki/bin/view/Formcycle/UserInterface/UserSettings/ExternalUsers/\|\|target="_blank"]] erfolgen.
	88	)))
1.13	89
	90
5.7	91	=== Migration für BundID Anbindungen ===
	92
1.13	93	Bei bestehenden BundID Anbindungen werden die vorhandenen Externen Benutzer mit der neuen Konfigurationseinstellungen erweitert. Vorhandene Formulare mit BundID Anbindung, können ähnlich, wie bei der BayernId ohne Anpassung genutzt werden.
	94
5.7	95	=== Migration für ELSTER Anbinungen ===
	96
18.5	97	Bei bereits im System existenten ELSTER Anbindungen werden die vorhandenen Externen Benutzer mit neuen Konfigurationseinstellungen erweitert. Formulare mit einer Zugriffssteuerung über ELSTER können ohne weitere Anpassung genutzt werden. Anbindungen an den ELSTER-Transfer-Client, welche über die entsprechende //ELSTER Postkorbnachricht// Workflow-Aktion in den Formularen eingebunden sind, werden automatisch auf die Bürgerservice Plugin Funktionalität weitergeleitet. Dadurch ergibt sich auch hier keine notwendige Anpassung der vorhandenen Formulare.
5.7	98
5.5	99	== Vorüberlegungen zur Anbindung neuer Servicekonten ==
1.4	100
15.11	101	Neue Anbindungen an Servicekonten müssen im (% class="xm-smallcaps" %)Xima® Formcycle(%%) System als [[Externe Benutzer>>path:/xwiki/bin/view/Formcycle/SystemSettings/UserInterface/ExternalUsers/]] (auch als Authentikatoren bezeichnet) angelegt werden. Dabei ist es möglich diese im System- als auch im Bereich des Mandanten anzulegen.
1.5	102	Folgende Überlegungen sollten für eine Entscheidung des Bereichs, in welchem die Externen Benutzer angelegt werden, herangezogen werden.
1.4	103
15.11	104	Ist ein Multi-Mandanten (% class="xm-smallcaps" %)Xima® Formcycle(%%) System mit unterschiedlichen Host-Adressen für die Ansteuerung der Formulare der einzelnen Mandanten vorhanden? (Meist realisiert über Anbindung mehrerer Frontend-Server)
1.4	105
5.8	106	In diesem Fall sollte jeweils im Mandanten ein Externer Benutzer angelegt werden, welcher die Anbindung an des Servicekonto realisiert.
15.11	107	\\Der Grund für dieses empfohlene Vorgehen ist, dass die aktuellen Anbindungen an die BundID, die BayernID, sowie an das ELSTER-Portal alle auf Grundlage des [[SAML 2.0>>url:https://en.wikipedia.org/wiki/SAML_2.0\|\|rel="noopener noreferrer" target="_blank"]] - Protokolls arbeiten. Eine Festlegung bei der Kommunikation über das SAML 2.0 Protokoll ist es, dass im Vorfeld zwischen dem jeweiligen Identity Provider (Servicekonto-Portal) und dem Service Provider (FORMCYCLE) Metadaten ausgetauscht werden müssen. In diesen Metadaten sind die Rücksprungziele in das jeweils andere System (per URL) fest definiert.
5.8	108	Durch das Anlegen eines Externen Benutzers im Bereich des jeweiligen Mandanten kann hier eine saubere Trennung und damit auch Nutzung in den Formularen stattfinden.
	109	Legt man bei dieser Systemkonstellation verschiedene Externe Benutzer im System - Bereich an, so muss der Formularentwickler innerhalb des Formular die für seinen Mandanten korrekte Anbindung auswählen, was eine potenzielle Fehlerquelle sein kann.
1.5	110
15.11	111	Ist ein Multi-Mandanten- oder ein Single-Mandat- (% class="xm-smallcaps" %)Xima® Formcycle(%%) System mit einer Host-Adresse für die Ansteuerung der Formulare vorhanden?
1.6	112
	113	Hier sollten alle Externen Benutzer für die Servicekonten-Ansteuerung im System-Bereich angelegt werden. Der Vorteil ist an dieser Stelle, dass alle Anbindungen zentral an einer Stelle vorhanden sind und alle Formular-Benutzer in den verschiedenen Mandanten Zugriff auf diese erhalten.
	114
5.5	115	== Allgemeine Informationen zur Anbindung eines Servicekontos ==
1.7	116
17.1	117
	118	(% class="xm-figure xm-float-right xm-clear-h2" data-alt="Auswahl eines Servicekontos" %)
	119	(((
	120	(% class="xm-figure-inner" style="width:310px" %)
	121	(((
18.1	122	[[~[~[image:attach:extUser_selection.png~\|~\|width="300"~]~]>>path:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/Plugin%20Setup/WebHome/extUser_selection.png?rev=1.1\|\|rel="lightbox[$group]" title="Auswahl eines Servicekontos"]]
17.1	123
	124	(% class="xm-figure-caption" %)
	125	(((
2.2	126	Auswahl eines Servicekontos
17.1	127	)))
	128	)))
	129	)))
2.2	130
5.5	131	In diesem Abschnitt werden die Schritte, welche für die Anbindung aller Servicekonten gleichermaßen gelten, erläutert.
1.7	132
2.2	133	Bevor man ein Servicekonto anbindet sollten folgende Voraussetzungen erfüllt sein:
	134
	135	* Die im Unternehmen verantwortlichen technischen und organisatorischen Ansprechpartner müssen bekannt sein (Namen, E-Mail-Adressen). Diese Informationen werden innerhalb des Registrierungs-Prozesses für die einzelnen Servicekonten an unterschiedlichen Stellen benötigt.
	136	* URLs für die Anbindung des FORMCYCLE-Systems müssen eingerichtet und von außen erreichbar sein. Dabei ist zu beachten, dass bei Verwendung eines Frontend-Servers die URL zu diesem verwendet wird.
	137
5.5	138	Die Anbindung eines Servicekontos lässt sich in folgende Schritte gliedern:
2.2	139
15.11	140	1. Anlegen einen neuen Externen Benutzer (Authentikator) unter dem Menüpunkt System > [[Systemplugins>>path:/xwiki/bin/view/Formcycle/SystemSettings/UserInterface/SystemPlugins\|\|target="_blank"]] oder Mandant > [[Plugins>>path:/xwiki/bin/view/Formcycle/UserInterface/Client/Plugins\|\|target="_blank"]].
2.3	141	1. Spezifische Authentikator Konfiguration über die zur Verfügung gestellte Oberfläche ausführen. Die Konfigurationsoberfläche unterscheidet sich je nach ausgewählten Servicekonto. Auf die Unterschiede bei der Anbindung des jeweiligen Servicekonto-Typs wird in den nachfolgenden Abschnitten näher eingegangen.
	142	1. Download und Weiterleitung der festgelegten Konfigurationsdaten (Metadaten), sowie der Vertragsdaten an den jeweiligen Identity Provider (BundID, BayernID) bzw.
2.2	143	selbst durchzuführende Konfiguration auf Seiten des Identity Providers über ein Self-Service Portal (ELSTER)
15.11	144	1. Freigabe des Authentikators in (% class="xm-smallcaps" %)Xima® Formcycle(%%), nach erfolgter Rückmeldung über die erfolgte Registrierung der Metadaten durch den jeweiligen Identity Provider bzw. Freigabe durch Prüfungsinstanz (bei ELSTER Self Service Portal Registrierung) und damit Beginn der Einbindung des Servicekontos in Formulare
1.7	145
5.5	146	== Details für die Anbindung der BundID ==
1.4	147
8.2	148	Um das Servicekonto der BundID anzubinden ist ein neuer Externer Benutzer anzulegen und als Authentifizierungstyp BundID auszuwählen.
	149
	150	=== Schritt 1: Konfiguration anlegen ===
	151
17.1	152
	153	(% class="xm-figure xm-float-right xm-clear-h2" data-alt="Schritt 1: Notwendige Daten für Erzeugung der Service Metadaten festlegen" %)
	154	(((
	155	(% class="xm-figure-inner" style="width:310px" %)
	156	(((
18.1	157	[[~[~[image:attach:bundID_config1.png~\|~\|width="300"~]~]>>path:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/Plugin%20Setup/WebHome/bundID_config1.png?rev=1.1\|\|rel="lightbox[$group]" title="Schritt 1: Notwendige Daten für Erzeugung der Service Metadaten festlegen"]]
17.1	158
	159	(% class="xm-figure-caption" %)
	160	(((
8.2	161	Schritt 1: Notwendige Daten für Erzeugung der Service Metadaten festlegen
17.1	162	)))
	163	)))
	164	)))
8.2	165
	166	* Im 1. Schritt der Konfiguration erscheint eine Eingabeoberfläche, wo folgende Festlegungen getroffen werden müssen:
	167	Festlegung, ob Test- oder Live-Umgebung der BundID** anzubinden ist.
15.11	168	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 (% class="xm-smallcaps" %)Xima® Formcycle(%%) und der BundID**.
8.2	169	Angaben zum organisatorischen und technischen Ansprechpartner. Diese Informationen werden im Zuge des Registrierungsprozesses an das BundID**-Portal innerhalb der generierten SAML-Metadaten weitergegeben.
	170	* Speichern der Eingaben. Danach gelangt man zum 2. Schritt der Anbindung.
	171
	172	=== Schritt 2: Metadaten erzeugen und registrieren ===
	173
17.1	174
	175	(% class="xm-figure xm-float-right xm-clear-h2" data-alt="Schritt 2 und 3: Download der erzeugten Metadaten für eine jeweilige Host-Adresse; Aktivierung der BundID Authentifizierung für Formulare" %)
	176	(((
	177	(% class="xm-figure-inner" style="width:310px" %)
	178	(((
18.1	179	[[~[~[image:attach:bundID_config2.png~\|~\|width="300"~]~]>>path:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/Plugin%20Setup/WebHome/bundID_config2.png?rev=1.1\|\|rel="lightbox[$group]" title="Schritt 2 und 3: Download der erzeugten Metadaten für eine jeweilige Host-Adresse; Aktivierung der BundID Authentifizierung für Formulare"]]
17.1	180
	181	(% class="xm-figure-caption" %)
	182	(((
8.2	183	Schritt 2 und 3: Download der erzeugten Metadaten für eine jeweilige Host-Adresse; Aktivierung der BundID Authentifizierung für Formulare
17.1	184	)))
	185	)))
	186	)))
8.2	187
15.11	188	* In diesem Schritt werden die SAML-Metadaten für die Registrierung auf Seiten der BundID erzeugt. Dafür steht in der Oberfläche ein Button mit Auswahlfeld zur Verfügung. Das Auswahlfeld enthält alle im (% class="xm-smallcaps" %)Xima® Formcycle(%%) System gefundenen Host-Adressen, über die das System erreichbar ist. Auf der Grundlage der jeweiligen Host-Adresse werden dann die Metadaten erzeugt und als Download zurück geliefert. Die jeweilige Host-Adresse bildet dabei einen Teil der Rücksprung-URL, welche später vom Identity Provider (BundID Portal) zur Übermittlung der Authentifizierungsdaten genutzt wird.(((
	189	(% class="box infomessage" %)
	190	(((
8.2	191	Hinweis: Soll der BundID-Login über unterschiedliche Host-Adressen erreichbar sein,
	192	so muss für jeden Host die Metadaten-Datei erzeugt und an das BundID-Portal zur Registrierung übermittelt werden.
	193	)))
15.11	194	)))
	195	* SAML-Metadaten sind zusammen mit weiteren Vertragsdaten an das BundID Portal (Mail: bundID@bmi.bund.de) zu senden, mit der Bitte, um Aufnahme in den Portalverbund. Die genauen Handlungsanweisungen können Sie dem folgenden [[PDF-Dokument>>url:https://customer.formcycle.eu/index.php/s/B2fsZ9mSwdwGwAX/download?path=%2F&files=BundID_Checkliste.pdf\|\|rel="noopener noreferrer" target="_blank"]] entnehmen.
8.2	196	* Damit ist der 1. Teil der Registrierung abgeschlossen und eine Antwort vom BundID Portal muss abgewartet werden.
	197
	198	=== Schritt 3: BundID-Login Aktivierung ===
	199
17.1	200
	201	(% class="xm-figure xm-float-right xm-clear-h2" data-alt="Globale Konfiguration des Anfrageverhalten sowie der Postkorbanbindung" %)
	202	(((
	203	(% class="xm-figure-inner" style="width:310px" %)
	204	(((
18.1	205	[[~[~[image:attach:bundID_config3.png~\|~\|width="300"~]~]>>path:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/Plugin%20Setup/WebHome/bundID_config3.png?rev=1.1\|\|rel="lightbox[$group]" title="Globale Konfiguration des Anfrageverhalten sowie der Postkorbanbindung"]]
17.1	206
	207	(% class="xm-figure-caption" %)
	208	(((
8.2	209	Globale Konfiguration des Anfrageverhalten sowie der Postkorbanbindung
17.1	210	)))
	211	)))
	212	)))
8.2	213
	214	* Dieser Schritt sollte erst durchgeführt werden, wenn Sie vom BundID Portal Rückmeldung erhalten haben, dass ihre übermittelten Metadaten im Portal registriert und freigegeben sind. Erst mit dem Button //BundId-Login aktivieren// wird der Authentikator im System aktiviert. Er ist damit in den Formularen verfügbar und kann eingebunden werden.(((
15.11	215	(% class="box infomessage" %)
	216	(((
8.2	217	Hinweis: Wenn Sie den Login vor einer positiven Rückmeldung des BundID-Portals aktivieren,
	218	so kann das die BundID zwar bereits in den Formularen eingebunden werden,
	219	wird aber beim Aufruf in einem Fehler resultieren,
	220	dass der anfragende Service dem Portal nicht bekannt ist.
	221	)))
15.11	222	)))
15.2	223	* Nach Aktivierung des Logins erweitert sich die Konfigurationsoberfläche des Authentikators.
	224	* 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:(((
8.7	225	; Vertrauensniveau
	226	: Angaben in dieser Eigenschaft dienen zum Einschränken der Authentisierungsverfahren auf zugelassene Vertrauensniveaus.
	227	Einschränkungen dieser Art werden an referenzierende Identity Provider weitergereicht, wenn dies durch den aufrufenden Identity Provider unterstützt wird.
	228	; Login Methoden einschränken
	229	: Angaben in dieser Eigenschaft dienen zum Einschränken der Authentisierungsverfahren. Ist kein Wert gesetzt, erfolgt keine Einschränkung und dem Nutzer werden alle, vom Identity-Provider zur Verfügung gestellten, Anmeldeverfahren zur Auswahl angezeigt.
	230	; Pflichtelemente
	231	: Über diese Eigenschaft können Attribute als verpflichtende Nutzereigenschaften angefordert werden.
	232	Alle Authentisierungsverfahren, welche die geforderten Attribute nicht erfüllen, werden dadurch ausgeblendet.
	233	Sofern der Formular-Workflow beispielsweise die Kommunikation mit dem Postkorb zwingend erfordert,
	234	kann hier der Wert "Postkorb" angegeben werden, wodurch unter anderem das Ausblenden der temporären Anmeldung erreicht wird.
	235	; Angeforderte Eigenschaften einschränken
	236	: Angaben in dieser Eigenschaft dienen zum Einschränken der zurück gelieferten Eigenschaften aus einer erfolgreichen Nutzer-Anmeldung.
	237	In erster Linie ist diese Eigenschaft dazu gedacht, dem Grundsatz der Datensparsamkeit aus den Vorgaben der DSGVO (Datenschutz-Grundverordnung) gerecht zu werden.
	238	Sind keine Werte gesetzt, erfolgt keine Einschränkung und es werden alle vom Identity-Provider zur Verfügung
	239	gestellten Nutzer-Eigenschaften zurück geliefert.
	240	)))
	241	* Unter dem Punkt //Erweiterte Einstellungen// > //Konfigurtion BundID Postkorbanbindung// können Sie die Daten für einen Proxy-Server hinterlegen, wenn dieser für die Kommunikation zum BundID Postkorb notwendig sein sollte.
	242	* Über den Button //Postkorb Verbindung prüfen// kann der Zugriff auf den Postkorb-Webservice getestet werden.(((
15.11	243	(% class="box warningmessage" %)
	244	(((
8.6	245	Folgende URL muss vom FORMCYCLE Master-Server aus erreichbar sein:
8.2	246
8.6	247	* Testsystem: https:~/~/int.id.bund.de/bspx-postkorb-okkomm-ws/bspservices/postkorbkomm
	248	ODER
15.11	249	* Livesystem:
8.6	250	** bei Kommunikation über des Netz des Bundes (NdB):
	251	https:~/~/prod.id.bmi.in.bund.de/bspx-postkorb-okkomm-ws/bspservices/postkorbkomm
	252	** bei Kommunikation über das Verbindungsnetz des Bundes (NdB-VN):
	253	https:~/~/prod.bundid.doi-de.net/bspx-postkorb-okkomm-ws/bspservices/postkorbkomm
8.7	254	Achtung: Der Livesystem Postkorb-Webservice ist nicht** direkt aus dem Internet erreichbar!
8.2	255	)))
15.11	256	)))
8.2	257
5.5	258	== Details für die Anbindung des ELSTER //Mein Unternehmenskontos// ==
1.4	259
11.2	260	Um das Unternehmenskonto ELSTER anzubinden ist ein neuer Externer Benutzer anzulegen und als Authentifizierungstyp ELSTER Unternehmenskonto auszuwählen.
	261
15.7	262	=== FORMCYCLE Schritt 1: Konfiguration anlegen ===
11.2	263
15.11	264
17.1	265	(% class="xm-figure xm-float-right xm-clear-h2" data-alt="Schritt 1: Notwendige Daten für Erzeugung der Service Metadaten festlegen" %)
	266	(((
	267	(% class="xm-figure-inner" style="width:310px" %)
	268	(((
18.1	269	[[~[~[image:attach:elster_config1.png~\|~\|width="300"~]~]>>path:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/Plugin%20Setup/WebHome/elster_config1.png?rev=1.1\|\|rel="lightbox[$group]" title="Schritt 1: Notwendige Daten für Erzeugung der Service Metadaten festlegen"]]
17.1	270
	271	(% class="xm-figure-caption" %)
	272	(((
	273	Schritt 1: Notwendige Daten für Erzeugung der Service Metadaten festlegen
	274	)))
	275	)))
	276	)))
	277
11.2	278	* Im 1. Schritt der Konfiguration erscheint eine Eingabeoberfläche, wo folgende Festlegungen getroffen werden müssen:
	279	Festlegung, ob Test- oder Live-Umgebung des ELSTER** Portals anzubinden ist.
	280	** Definition einer eindeutigen ID. Diese ID dient im weiteren Verlauf als //Entity-ID// innerhalb der SAML-Metadatenkonfiguration und wird in einer URL-Notation angegeben.
15.11	281	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 (% class="xm-smallcaps" %)Xima® Formcycle(%%) und dem ELSTER** Portal.
11.2	282	* Speichern der Eingaben. Danach gelangt man zum 2. Schritt der Anbindung.
	283
15.7	284	=== FORMCYCLE Schritt 2: Vorbereitung für Registrierung im MUK Portal ===
11.2	285
15.11	286
17.1	287	(% class="xm-figure xm-float-right xm-clear-h2" data-alt="Schritt 2 und 3: Anzeige der für die Registrierung im MUK Portal notwendigen Daten; Aktivierung der ELSTER Authentifizierung für Formulare" %)
	288	(((
	289	(% class="xm-figure-inner" style="width:310px" %)
	290	(((
18.1	291	[[~[~[image:attach:elster_config2.png~\|~\|width="300"~]~]>>path:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/Plugin%20Setup/WebHome/elster_config2.png?rev=1.1\|\|rel="lightbox[$group]" title="Schritt 2 und 3: Anzeige der für die Registrierung im MUK Portal notwendigen Daten; Aktivierung der ELSTER Authentifizierung für Formulare"]]
17.1	292
	293	(% class="xm-figure-caption" %)
	294	(((
	295	Schritt 2 und 3: Anzeige der für die Registrierung im MUK Portal notwendigen Daten; Aktivierung der ELSTER Authentifizierung für Formulare
	296	)))
	297	)))
	298	)))
	299
11.2	300	* In diesem Schritt werden die Daten angezeigt, die für eine Anbindung von FORMCYCLE an das ELSTER Mein Unternehmenskonto (MUK) notwendig sind:
	301	** Entity-ID
15.11	302	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 ELSTER **und (% class="xm-smallcaps" %)Xima® Formcycle(%%) möglich wäre.
15.7	303	Im MUK müssen nur die URL(s) hinterlegt werden, über die am Ende wirklich eine Kommunikation stattfinden soll.
	304	Öffentlicher Schlüssel: Dieses Zertifikat ist im MUK** //Self Service Portal// als Signatur- und Verschlüsselungszertifikat zu hinterlegen
	305	* Damit ist der 1. Teil der Registrierung abgeschlossen und es muss in das MUK //Self Service Portal// von ELSTER gewechselt werden.
15.4	306	** Im Portal sind anschießend ein Vorhaben und ein Service-Provider anzulegen.(((
15.11	307	(% class="box warningmessage" %)
	308	(((
15.3	309	Um sich am //Self Service Portal// zu authentifizieren ist ein Organisationszertifikat notwendig.
15.11	310	Wenn ihre Organisation noch nicht über ein solches verfügt können Sie dieses über folgende [[Website >>url:https://www.elster.de/eportal/unternehmerorientiert/registrierungsprozess\|\|rel="noopener noreferrer" target="_blank"]] beantragen.
15.3	311	)))
15.11	312	)))
11.2	313
15.7	314	=== MUK Self Service Portal: Registrierung eines NEZO Vorhabens ===
15.4	315
	316	(((
15.11	317	(% class="box infomessage" %)
	318	(((
	319	Die nachfolgenden Angaben in diesem Abschnitt beziehen sich auf die durchzuführenden Schritte im MUK Self Service Portal, welche außerhalb von (% class="xm-smallcaps" %)Xima® Formcycle(%%) stattfinden.
15.4	320	)))
15.11	321	)))
15.4	322
	323	NEZO steht für "Nutzung der ELSTER-Zertifikate im Rahmen des Onlinezugangsgesetzes (OZG)".
15.5	324
15.7	325	==== MUK Self Service Portal Schritt 1: Anmeldung ====
15.4	326
17.1	327
	328	(% class="xm-figure xm-float-right xm-clear-h2" data-alt="MUK Self Service Portal Schritt 1: Anmeldebildschirm" %)
	329	(((
	330	(% class="xm-figure-inner" style="width:310px" %)
	331	(((
18.1	332	[[~[~[image:attach:elsterSsp_MUK_Login.png~\|~\|width="300"~]~]>>path:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/Plugin%20Setup/WebHome/elsterSsp_MUK_Login.png?rev=1.1\|\|rel="lightbox[$group]" title="MUK Self Service Portal Schritt 1: Anmeldebildschirm"]]
17.1	333
	334	(% class="xm-figure-caption" %)
	335	(((
15.8	336	MUK Self Service Portal Schritt 1: Anmeldebildschirm
17.1	337	)))
	338	)))
	339	)))
15.4	340
15.8	341	* Das MUK //Self Service Portal// von ELSTER ist über https://service.mein-unternehmenskonto.de erreichbar.
	342	* Die Anmeldung am MUK //Self Service Portal// kann nur mit einen Organisationszertifikat durchgeführt werden.
15.4	343
15.7	344	==== MUK Self Service Portal Schritt 2: Vorhaben hinzufügen ====
15.4	345
17.1	346
	347	(% class="xm-figure xm-float-right xm-clear-h2" data-alt="MUK Self Service Portal Schritt 2: Übersicht der NEZO-Vorhaben" %)
	348	(((
	349	(% class="xm-figure-inner" style="width:310px" %)
	350	(((
18.1	351	[[~[~[image:attach:elsterSsp_Meine_Vorhaben.png~\|~\|width="300"~]~]>>path:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/Plugin%20Setup/WebHome/elsterSsp_Meine_Vorhaben.png?rev=1.1\|\|rel="lightbox[$group]" title="MUK Self Service Portal Schritt 2: Übersicht der NEZO-Vorhaben"]]
17.1	352
	353	(% class="xm-figure-caption" %)
	354	(((
15.8	355	MUK Self Service Portal Schritt 2: Übersicht der NEZO-Vorhaben
17.1	356	)))
	357	)))
	358	)))
15.4	359
17.1	360
	361	(% class="xm-figure xm-float-right xm-clear-h2" data-alt="MUK Self Service Portal Schritt 2: Detailansicht eines NEZO Vorhabens" %)
	362	(((
	363	(% class="xm-figure-inner" style="width:310px" %)
	364	(((
18.1	365	[[~[~[image:attach:elsterSsp_Vorhaben_Verantwortlichkeiten_redacted.png~\|~\|width="300"~]~]>>path:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/Plugin%20Setup/WebHome/elsterSsp_Vorhaben_Verantwortlichkeiten_redacted.png?rev=1.1\|\|rel="lightbox[$group]" title="MUK Self Service Portal Schritt 2: Detailansicht eines NEZO Vorhabens"]]
17.1	366
	367	(% class="xm-figure-caption" %)
	368	(((
15.8	369	MUK Self Service Portal Schritt 2: Detailansicht eines NEZO Vorhabens
17.1	370	)))
	371	)))
	372	)))
15.4	373
15.8	374	Nach der Anmeldung im MUK //Self Service Portal//, muss über dieses Portal ein NEZO-Vorhaben beantragt werden.
15.4	375
15.9	376	Mit einem Klick auf "Hinzufügen" unter "Meine Vorhaben" kann ein neues Vorhaben erstellt werden.
	377	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 anschließend Service-Provider beantragt / bearbeitet werden können.
15.4	378
15.9	379	Für die Beantragung eines NEZO-Vorhaben müssen verschiedene Angaben gemacht werden:
	380
	381	* die konkrete Zeitplanung des Vorhabens
	382	* die voraussichtliche Anzahl der Unternehmenskonto-Logins pro Tag.
	383	* Für die Beantragung das Vorhabens ist ein Dienstleister nötig. Hier muss die XIMA MEDIA GmbH angegeben werden (siehe Abbildung rechts)
	384	* Weitere Informationen zum Beantragungsprozess entnehmen Sie bitte direkt der Vorhaben-Erstellungsseite.
	385
	386	Nachdem des NEZO-Vorhaben beantragt wurde, kann ein Service-Provider für das Vorhaben eingerichtet werden. Die dafür notwendigen Schritte werden im nächsten Abschnitt beschrieben.
	387
15.7	388	==== MUK Self Service Portal Schritt 3: Service-Provider beantragen ====
15.4	389
17.1	390
	391	(% class="xm-figure xm-float-right xm-clear-h2" data-alt="MUK Self Service Portal Schritt 3: Detailansicht Service-Provider" %)
	392	(((
	393	(% class="xm-figure-inner" style="width:310px" %)
	394	(((
18.1	395	[[~[~[image:attach:elsterSsp_Serviceprovider.png~\|~\|width="300"~]~]>>path:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/Plugin%20Setup/WebHome/elsterSsp_Serviceprovider.png?rev=1.1\|\|rel="lightbox[$group]" title="MUK Self Service Portal Schritt 3: Detailansicht Service-Provider"]]
17.1	396
	397	(% class="xm-figure-caption" %)
	398	(((
15.8	399	MUK Self Service Portal Schritt 3: Detailansicht Service-Provider
17.1	400	)))
	401	)))
	402	)))
15.4	403
15.9	404	In der Übersicht eines Vorhabens kann ein Service-Provider bei MUK beantragt werden.
	405	Bei der Beantragung eines Service-Providers müssen verschiedene technische Angaben gemacht werden:
15.4	406
15.10	407	; Name
	408	: Der Name des Service-Providers. Dieser kann frei vergeben werden, z.B.: FORMCYCLE Unternehmenskonto-Login Produktiv
	409	; Entity-ID
	410	: Identitfiziert den Service-Provider eindeutig. Muss aus dem zuvor erstellten Authenticator aus FORMCYCLE übernommen werden.
	411	; Datenkranztyp
	412	: Auswahl ist abhängig vom Rechtsrahmen in dem FORMCYCLE eingesetzt wird und bestimmt die Art der zurück gelieferten Daten. In den meisten Fällen ist hier die Auswahl OZG sinnvoll, da hier alle Daten des Rechtsrahmens im Zusammenhang mit dem Onlinezugangsgesetz geliefert werden.
	413	; Kontotyp
	414	: Es besteht die Auswahl zwischen Echt- und Testkonten. Im Zweifel sollte immer "Echt" gewählt werden.
	415	; Zum Login zugelassene(s) Ordnungsmerkmal(e)
	416	: Bestimmt ob sich nur Organisationen (StNr), nur Einzelpersonen (IdNr) oder beide Zertifikats-Typen über diesen Service-Provider in FORMCYLE anmelden können.
	417	; Portalbeschreibung
	418	: Diese Beschreibung wird im Login-Fenster zu Beginn des Authentifizierungsprozesses angezeigt. Wählen Sie eine zu Ihrer Organisation passende Beschreibung.
	419	; Portallogo
	420	: Dieses Logo wird im Login-Fenster zu Beginn des Authentifizierungsprozesses angezeigt. Wählen Sie ein Logo Ihrer Organisation.
	421	; Signaturzertifikat
	422	: Dient dem Identitätsnachweis der übertragenen Daten während des Authentifizierungsprozesses. Die hier notwendige Angabe eines Zertifikats muss aus dem im FORMCYCLE Schritt 2 erzeugten öffentlichen Schlüssels entnommen werden. Die Zertifikatsdaten dürfen keine Zeilenumbrüche enthalten.
	423	; Verschlüsselungszertifikat
	424	: Dient der Verschlüsselung der übertragenen Daten während des Authentifizierungsprozesses. Die hier notwendige Angabe eines Zertifikats muss aus dem im FORMCYCLE Schritt 2 erzeugten öffentlichen Schlüssels entnommen werden. Die Zertifikatsdaten dürfen keine Zeilenumbrüche enthalten.
	425	; Assertion-Consumer-Service-URLs (ACS-URLs)
15.11	426	: Diese URLs stellen die Endpunkte während des Authentifizierungsprozesses dar. Im Dialog FORMCYCLE Schritt 2 wird hier eine Liste aller auf dem (% class="xm-smallcaps" %)Xima® Formcycle(%%) System ermittelten Assertion-Consumer-Service-URLs (ACS-URLs) dargestellt. Es müssen nicht alle ACS-URLs in die Service-Provider-Konfiguration im //MUK Self Service Portal// übernommen werden. Übernehmen Sie nur die URLs für die Server auf denen Sie planen einen Unternehmenskonto-Login in Formularen zu ermöglichen.
15.10	427	; Manage Name ID URLs
	428	: Müssen nicht angegeben werden.
15.6	429
15.10	430	Nach dem Beantragen des Service-Providers ist der Prozess im MUK Self Service Portal abgeschlossen und es muss auf die Freigabe des Service-Provider durch ELSTER gewartet werden.
15.11	431	Danach kann mit FORMCYCLE Schritt 3 im (% class="xm-smallcaps" %)Xima® Formcycle(%%) System fortgefahren werden.
15.10	432
15.7	433	=== FORMCYCLE Schritt 3: ELSTER-Login Aktivierung ===
11.2	434
17.1	435
	436	(% class="xm-figure xm-float-right xm-clear-h2" data-alt="Anbindung des ELSTER Postkorbs mittels ELSTER-Transfer-Client" %)
	437	(((
	438	(% class="xm-figure-inner" style="width:310px" %)
	439	(((
18.1	440	[[~[~[image:attach:elster_config3.png~\|~\|width="300"~]~]>>path:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/Plugin%20Setup/WebHome/elster_config3.png?rev=1.1\|\|rel="lightbox[$group]" title="Anbindung des ELSTER Postkorbs mittels ELSTER-Transfer-Client"]]
17.1	441
	442	(% class="xm-figure-caption" %)
	443	(((
11.2	444	Anbindung des ELSTER Postkorbs mittels ELSTER-Transfer-Client
17.1	445	)))
	446	)))
	447	)))
11.2	448
15.10	449	* Dieser Schritt sollte erst durchgeführt werden, wenn Sie vom MUK //Self Service Portal// Rückmeldung erhalten haben, dass ihr 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.(((
15.11	450	(% class="box infomessage" %)
	451	(((
15.10	452	Hinweis: Wenn Sie den Login vor einer positiven Rückmeldung aus dem MUK //Self Service Portal// aktivieren,
11.2	453	kann der ELSTER Unternehmenslogin zwar bereits in den Formularen eingebunden werden,
	454	wird aber beim Aufruf in einem Fehler resultieren.
	455	)))
15.11	456	)))
11.2	457	* Nach Aktivierung des Logins erweitert sich die Konfigurationsoberfläche des Authentikators.
	458	* 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.
	459	Folgende Eigenschaften für die Transfer-Client Anbindung sind konfigurierbar:(((
	460	; URL ELSTER Transfer-Client
	461	: URL zu dem Transfer-Client, über den die Weiterleitung von Postkorb-Nachrichten an ELSTER erfolgen soll.
	462	; Proxy Host:
	463	: Host Angabe für einen Proxy-Server, wenn die Kommunikation mit dem Transfer-Client über einen Proxy-Server erfolgen soll.
	464	; Proxy Port:
	465	: Port-Angabe für einen Proxy-Server, wenn die Kommunikation mit dem Transfer-Client über einen Proxy-Server erfolgen soll.
	466	)))
	467	* Über den Button //Postkorb Verbindung prüfen// kann der Zugriff auf den angebundenen ELSTER Transfer Client getestet werden.
	468
5.5	469	== Details für die Anbindung der BayernID ==
1.14	470
4.2	471	Um das Servicekonto der BayernID anzubinden ist ein neuer Externer Benutzer anzulegen und als Authentifizierungstyp BayernID auszuwählen.
1.14	472
5.5	473	=== Schritt 1: Konfiguration anlegen ===
1.14	474
17.1	475
	476	(% class="xm-figure xm-float-right xm-clear-h2" data-alt="Schritt 1: Notwendige Daten für Erzeugung der Service Metadaten festlegen" %)
	477	(((
	478	(% class="xm-figure-inner" style="width:310px" %)
	479	(((
18.1	480	[[~[~[image:attach:bayernID_config1.png~\|~\|width="300"~]~]>>path:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/Plugin%20Setup/WebHome/bayernID_config1.png?rev=1.1\|\|rel="lightbox[$group]" title="Schritt 1: Notwendige Daten für Erzeugung der Service Metadaten festlegen"]]
17.1	481
	482	(% class="xm-figure-caption" %)
	483	(((
4.2	484	Schritt 1: Notwendige Daten für Erzeugung der Service Metadaten festlegen
17.1	485	)))
	486	)))
	487	)))
4.2	488
	489	* Im 1. Schritt der Konfiguration erscheint eine Eingabeoberfläche, wo folgende Festlegungen getroffen werden müssen:
4.3	490	Festlegung, ob Test- oder Live-Umgebung der BayernID** anzubinden ist.
15.11	491	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 (% class="xm-smallcaps" %)Xima® Formcycle(%%) und der BayernID**.
4.3	492	Angaben zum organisatorischen und technischen Ansprechpartner. Diese Informationen werden im Zuge des Registrierungsprozesses an das BayernID**-Portal weitergegeben.
	493	* Speichern der Eingaben. Danach gelangt man zum 2. Schritt der Anbindung.
4.2	494
5.5	495	=== Schritt 2: Metadaten erzeugen und registrieren ===
4.2	496
17.1	497
	498	(% class="xm-figure xm-float-right xm-clear-h2" data-alt="Schritt 2 und 3: Download der erzeugten Meta- und vorbefüllten Vertragsdaten für eine jeweiligen Host-Adresse; Aktivierung der BayernID Authentifizierung für Formulare" %)
	499	(((
	500	(% class="xm-figure-inner" style="width:310px" %)
	501	(((
18.1	502	[[~[~[image:attach:bayernID_config2.png~\|~\|width="300"~]~]>>path:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/Plugin%20Setup/WebHome/bayernID_config2.png?rev=1.1\|\|rel="lightbox[$group]" title="Schritt 2 und 3: Download der erzeugten Meta- und vorbefüllten Vertragsdaten für eine jeweiligen Host-Adresse; Aktivierung der BayernID Authentifizierung für Formulare"]]
17.1	503
	504	(% class="xm-figure-caption" %)
	505	(((
4.3	506	Schritt 2 und 3: Download der erzeugten Meta- und vorbefüllten Vertragsdaten für eine jeweiligen Host-Adresse; Aktivierung der BayernID Authentifizierung für Formulare
17.1	507	)))
	508	)))
	509	)))
4.2	510
15.11	511	* In diesem Schritt werden die SAML-Metadaten für die Registrierung auf Seiten der BayernID erzeugt. Dafür steht in der Oberfläche ein Button mit Auswahlfeld zur Verfügung. Das Auswahlfeld enthält alle im (% class="xm-smallcaps" %)Xima® Formcycle(%%) System gefundenen Host-Adressen, über die das System erreichbar ist. Auf der Grundlage der jeweiligen Host-Adresse werden dann die Metadaten erzeugt und als Download zurück geliefert. Die jeweilige Host-Adresse bildet dabei einen Teil der Rücksprung-URL, welche später vom Identity Provider (BayernID Portal) zur Übermittlung der Authentifizierungsdaten genutzt wird.(((
	512	(% class="box infomessage" %)
	513	(((
4.4	514	Hinweis: Soll der BayernID-Login über unterschiedliche Host-Adressen erreichbar sein,
	515	so muss für jeden Host die Metadaten-Datei erzeugt und an das BayernID-Portal zur Registrierung übermittelt werden.
	516	)))
15.11	517	)))
4.3	518	* Weiterhin kann eine vorbefüllte Beitrittserklärung für den jeweiligen Host heruntergeladen werden. Die Beitrittserklärung ist bereits mit den im vorherigen Schritt erhobenen Daten vorbefüllt und muss um die noch fehlenden Daten ergänzt werden.
	519	* Beitrittserklärung und SAML-Metadaten sind an das BayernID Portal (Mail: BayernID@akdb.de) zu senden, mit der Bitte, um Aufnahme in den Portalverbund.
	520	* Damit ist der 1. Teil der Registrierung abgeschlossen und eine Antwort vom BayernID Portal muss abgewartet werden.
	521
5.5	522	=== Schritt 3: BayernID-Login Aktivierung ===
4.3	523
17.1	524
	525	(% class="xm-figure xm-float-right xm-clear-h2" data-alt="BayernID Postkorbanbindung konfigurieren" %)
	526	(((
	527	(% class="xm-figure-inner" style="width:310px" %)
	528	(((
18.1	529	[[~[~[image:attach:bayernID_config3.png~\|~\|width="300"~]~]>>path:/xwiki/bin/download/Formcycle/PluginDocumentation/Buerger%20Services-Plugin/Plugin%20Setup/WebHome/bayernID_config3.png?rev=1.1\|\|rel="lightbox[$group]" title="BayernID Postkorbanbindung konfigurieren"]]
17.1	530
	531	(% class="xm-figure-caption" %)
	532	(((
5.2	533	BayernID Postkorbanbindung konfigurieren
17.1	534	)))
	535	)))
	536	)))
5.2	537
4.4	538	* Dieser Schritt sollte erst durchgeführt werden, wenn Sie vom BayernID Portal Rückmeldung erhalten haben, dass ihre übermittelten Metadaten im Portal registriert und freigegeben sind. Erst mit dem Button //BayernId-Login aktivieren// wird der Authentikator im System aktiviert. Er ist damit in den Formularen verfügbar und kann eingebunden werden.(((
15.11	539	(% class="box infomessage" %)
	540	(((
5.2	541	Hinweis: Wenn Sie den Login vor einer positiven Rückmeldung des BayernID-Portals aktivieren,
8.2	542	so kann das die BayernID zwar bereits in den Formularen eingebunden werden,
11.2	543	wird aber beim Aufruf in einem Fehler resultieren.
4.4	544	)))
15.11	545	)))
15.2	546	* Nach Aktivierung des Logins erweitert sich die Konfigurationsoberfläche des Authentikators.
	547	* 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.
5.9	548	* (((
	549	Über den Button //Postkorb Verbindung prüfen// kann der Zugriff auf den Postkorb-Webservice getestet werden.
15.11	550	Der Webservice muss dabei vom (% class="xm-smallcaps" %)Xima® Formcycle(%%) Master-Server aus erreichbar sein (dafür sind im System unter Umständen Firewall Freigaben notwendig).
15.2	551
	552	(((
15.11	553	(% class="box warningmessage" %)
	554	(((
5.9	555	Folgende URL muss vom FORMCYCLE Master-Server aus erreichbar sein:
	556
	557	* Testsystem: https:~/~/infra-pre-bayernid.freistaat.bayern/bspx-postkorb-okkomm-ws/bspservices/postkorbkomm
	558	ODER
	559	* Livesystem: https:~/~/bayernid.freistaat.bayern/bspx-postkorb-okkomm-ws/bspservices/postkorbkomm
	560	)))
15.11	561	)))
5.9	562
	563	(((
15.11	564	(% class="box infomessage" %)
	565	(((
5.9	566	Fehlerbehebung, wenn die Prüfung des Postkorbverbindung fehl schlägt:
	567
	568	Prüfen Sie, ob die Freischaltung in der Firewall erfolgt ist.
	569	Der Postkorb-Webservice nutzt das HTTPS Protokoll für die Kommunikation, welches im Transport-Layer das TCP Protokoll benutzt. Deshalb sollte in ihrer Firewall die IP 193.28.249.234 (für das Livesystem bayernid.freistaat.bayern) oder IP 193.28.249.228 (für das Testsystem infra-pre-bayernid.freistaat.bayern) als TCP-Verbindungen der Port 443 (das ist der Standard-Https-Port) sowohl für die ausgehende als auch eingehende Kommunikation freigegeben sein.
	570	)))
	571	)))
15.11	572	)))
5.9	573	* Sollte für die Kommunikation ein Proxy-Server notwendig sein, so kann dieser in den Eingabefeldern //Proxy Host //und //Proxy Port// konfiguriert werden.