| ... |
... |
@@ -82,60 +82,6 @@ |
| 82 |
82 |
|
| 83 |
83 |
== Details für die Anbindung der BundID == |
| 84 |
84 |
|
| 85 |
|
-Um das Servicekonto der **BundID** anzubinden ist ein neuer Externer Benutzer anzulegen und als Authentifizierungstyp **BundID** auszuwählen. |
| 86 |
|
- |
| 87 |
|
-=== Schritt 1: Konfiguration anlegen === |
| 88 |
|
- |
| 89 |
|
-{{figure image="bundID_config1.png"}} |
| 90 |
|
-Schritt 1: Notwendige Daten für Erzeugung der Service Metadaten festlegen |
| 91 |
|
-{{/figure}} |
| 92 |
|
- |
| 93 |
|
-* Im 1. Schritt der Konfiguration erscheint eine Eingabeoberfläche, wo folgende Festlegungen getroffen werden müssen: |
| 94 |
|
-** Festlegung, ob Test- oder Live-Umgebung der **BundID** anzubinden ist. |
| 95 |
|
-** 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 der **BundID**. |
| 96 |
|
-** Angaben zum organisatorischen und technischen Ansprechpartner. Diese Informationen werden im Zuge des Registrierungsprozesses an das **BundID**-Portal innerhalb der generierten SAML-Metadaten weitergegeben. |
| 97 |
|
-* Speichern der Eingaben. Danach gelangt man zum 2. Schritt der Anbindung. |
| 98 |
|
- |
| 99 |
|
-=== Schritt 2: Metadaten erzeugen und registrieren === |
| 100 |
|
- |
| 101 |
|
-{{figure image="bundID_config2.png"}} |
| 102 |
|
-Schritt 2 und 3: Download der erzeugten Metadaten für eine jeweilige Host-Adresse; Aktivierung der BundID Authentifizierung für Formulare |
| 103 |
|
-{{/figure}} |
| 104 |
|
- |
| 105 |
|
-* 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 {{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.((( |
| 106 |
|
-{{info}} |
| 107 |
|
-Hinweis: Soll der BundID-Login über unterschiedliche Host-Adressen erreichbar sein, |
| 108 |
|
-so muss für jeden Host die Metadaten-Datei erzeugt und an das BundID-Portal zur Registrierung übermittelt werden. |
| 109 |
|
-{{/info}} |
| 110 |
|
-))) |
| 111 |
|
-* **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. |
| 112 |
|
-* Damit ist der 1. Teil der Registrierung abgeschlossen und eine Antwort vom **BundID** Portal muss abgewartet werden. |
| 113 |
|
- |
| 114 |
|
-=== Schritt 3: BundID-Login Aktivierung === |
| 115 |
|
- |
| 116 |
|
-{{figure image="bundID_config3.png"}} |
| 117 |
|
-Globale Konfiguration des Anfrageverhalten sowie der Postkorbanbindung |
| 118 |
|
-{{/figure}} |
| 119 |
|
- |
| 120 |
|
-* 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.((( |
| 121 |
|
-{{info}} |
| 122 |
|
-Hinweis: Wenn Sie den Login **vor** einer positiven Rückmeldung des BundID-Portals aktivieren, |
| 123 |
|
-so kann das die **BundID** zwar bereits in den Formularen eingebunden werden, |
| 124 |
|
-wird aber beim Aufruf in einem Fehler resultieren, |
| 125 |
|
-dass der anfragende Service dem Portal nicht bekannt ist. |
| 126 |
|
-{{/info}} |
| 127 |
|
-))) |
| 128 |
|
-* Nach Aktivierung des Logins erweitert sich die Konfigurationsoberfläche des Authentikators. |
| 129 |
|
-** 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 |
| 130 |
|
-** 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. |
| 131 |
|
-** Über den Button //Postkorb Verbindung prüfen// kann der Zugriff auf den Postkorb-Webservice getestet werden. |
| 132 |
|
-Der Webservice muss dabei vom {{formcycle/}} Master-Server aus erreichbar sein (dafür sind im System unter Umständen Firewall Freigaben notwendig).((( |
| 133 |
|
-{{info}} |
| 134 |
|
-**Fehlerbehebung, wenn die Prüfung des Postkorbverbindung fehl schlägt:** |
| 135 |
|
- |
| 136 |
|
-{{/info}} |
| 137 |
|
-))) |
| 138 |
|
- |
| 139 |
139 |
== Details für die Anbindung des ELSTER //Mein Unternehmenskontos// == |
| 140 |
140 |
|
| 141 |
141 |
== Details für die Anbindung der BayernID == |
| ... |
... |
@@ -150,7 +150,7 @@ |
| 150 |
150 |
|
| 151 |
151 |
* Im 1. Schritt der Konfiguration erscheint eine Eingabeoberfläche, wo folgende Festlegungen getroffen werden müssen: |
| 152 |
152 |
** Festlegung, ob Test- oder Live-Umgebung der **BayernID** anzubinden ist. |
| 153 |
|
-** 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 der **BayernID**. |
|
99 |
+** Erhebung von Zertifikatsinformationen, welche anschließend zur Generierung eines privaten und öffentlichen Schlüssels herangezogen werden. Dieses Schlüsselpaar dient zur Ver- und Entschlüssung der Kommunikation, zwischen {{formcycle/}} und der **BayernID**. |
| 154 |
154 |
** Angaben zum organisatorischen und technischen Ansprechpartner. Diese Informationen werden im Zuge des Registrierungsprozesses an das **BayernID**-Portal weitergegeben. |
| 155 |
155 |
* Speichern der Eingaben. Danach gelangt man zum 2. Schritt der Anbindung. |
| 156 |
156 |
|
| ... |
... |
@@ -160,7 +160,8 @@ |
| 160 |
160 |
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 |
| 161 |
161 |
{{/figure}} |
| 162 |
162 |
|
| 163 |
|
-* 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 {{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.((( |
|
109 |
+* 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 {{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) zur Übermittlung der Authentifizierungsdaten genutzt wird. |
|
110 |
+Hinweis: Soll der BayernID-Login über unterschiedliche Host-Adressen erreichbar sein, so muss für jeden Host die Metadaten-Datei erzeugt und an das **BayernID**-Portal zur Registrierung übermittelt werden.((( |
| 164 |
164 |
{{info}} |
| 165 |
165 |
Hinweis: Soll der BayernID-Login über unterschiedliche Host-Adressen erreichbar sein, |
| 166 |
166 |
so muss für jeden Host die Metadaten-Datei erzeugt und an das BayernID-Portal zur Registrierung übermittelt werden. |
| ... |
... |
@@ -179,13 +179,13 @@ |
| 179 |
179 |
* 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.((( |
| 180 |
180 |
{{info}} |
| 181 |
181 |
Hinweis: Wenn Sie den Login **vor** einer positiven Rückmeldung des BayernID-Portals aktivieren, |
| 182 |
|
-so kann das die **BayernID** zwar bereits in den Formularen eingebunden werden, |
|
129 |
+so kann das die BayernID zwar bereits in den Formularen eingebunden werden, |
| 183 |
183 |
wird aber beim Aufruf in einem Fehler resultieren, |
| 184 |
184 |
dass der anfragende Service dem Portal nicht bekannt ist. |
| 185 |
185 |
{{/info}} |
| 186 |
186 |
))) |
| 187 |
187 |
* ((( |
| 188 |
|
-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. |
|
135 |
+Nach Aktivierung des Logins erscheint 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. |
| 189 |
189 |
* ((( |
| 190 |
190 |
Über den Button //Postkorb Verbindung prüfen// kann der Zugriff auf den Postkorb-Webservice getestet werden. |
| 191 |
191 |
Der Webservice muss dabei vom {{formcycle/}} Master-Server aus erreichbar sein (dafür sind im System unter Umständen Firewall Freigaben notwendig).((( |