Zum Inhalt springen

Änderungen von Dokument Autista

Zuletzt geändert von MACH ProForms GmbH am 02.07.2024
Von Version 17.1
bearbeitet von MACH ProForms GmbH
am 11.05.2022
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 2.1
bearbeitet von MACH ProForms GmbH
am 17.12.2020
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -9,10 +9,11 @@
9 9  
10 10  Dabei kommen im Verlagsassistent die folgenden Werte zum Einsatz
11 11  
12 -- portal2StA.Geburt.081030#@#1.7.6 für Geburtsurkunden
13 -- portal2StA.Ehe.082030#@#1.7.6 für Eheurkunden
14 -- portal2StA.LP.083030#@#1.7.6 für Lebenspartnerschaftsurkunden
15 -- portal2StA.Sterbefall.084030#@#1.7.6 für Sterbefallurkunden
12 +- portal2StA.Geburt.081030#@#1.7.4 für Geburtsurkunden
13 +- portal2StA.Ehe.082030#@#1.7.4 für Eheurkunden
14 +- portal2StA.Geburt.081030#@#1.7.4 für Geburtsurkunden
15 +- portal2StA.LP.083030#@#1.7.4 für Lebenspartnerschaftsurkunden
16 +- portal2StA.Sterbefall.084030#@#1.7.4 für Sterbefallurkunden
16 16  
17 17  Sollten Sie die Schema-Dateien unter einem anderen Namen und Version hochgeladen haben, so sind die Werte von oben entsprechend zu ersetzen. Als Trennzeichen zwischen Schema-Namen und Schema-Version ist immer #@# zu verwenden.
18 18  
... ... @@ -34,6 +34,165 @@
34 34  
35 35  Die Dokumentation zur Konfiguration sowie Veröffentlichung des Assistenten finden Sie [hier](https://wiki.form-solutions.de/wiki/docwiki/view/Main/09_Schnittstellen/01_Fachschnittstellen/02_Autista/)
36 36  
38 +___
37 37  
40 +## Konfiguration der Autista Pull-Variante auf Seiten des Form-Solutions Formularservers
38 38  
42 +Das Autista Pull System steht ab Version 4.22.0 des Formularservers zur Verfügung.
39 39  
44 +### 1) Konfiguration des Apache Reverse Proxy
45 +
46 +Der Apache Reverse Proxy muss folgendermaßen konfiguriert werden (siehe vhost-ofs.conf, im Unterverzeichnis customerArea/httpd.conf.d):
47 +
48 +### 1.1) Konfiguration der ProxyPass Einträge
49 +
50 +Falls die folgenden ProxyPass Einträge nicht vorhanden sind, so müssen diese hinzugefügt werden (falls auf dem System bereits Autista in der Version 1 eingesetzt wurde, so sollte diese Einträge bereits vorhanden sein):
51 +
52 +```
53 +ProxyPass /autista-webservice http://servername:8080/autista-webservice
54 +ProxyPassReverse /autista-webservice http://servername:8080/autista-webservice
55 +```
56 +
57 +Der Servername muss durch Ihre konkrete Domain ersetzt werden.
58 +
59 +### 1.2) Konfiguration der Zertifikatsweiterleitung
60 +
61 +Für die korrekte Weiterleitung von Client Zertifikaten an den Wildfly Applikationsserver müssen die nachfolgenden Einträge hinzugefügt werden:
62 +Diese Einstellungen sollten im `<IfModule ssl_module>` Block stehen, am besten direkt nach den Server-Zertifikatseinstellungen ("SSLCertificate*File")
63 +
64 +```
65 +## pass SSL client certificates to wildfly (required for Autista Webservice)
66 +SSLVerifyClient optional_no_ca
67 +
68 +RequestHeader set SSL_CLIENT_CERT ""
69 +RequestHeader set SSL_CLIENT_VERIFY ""
70 +RequestHeader set SSL_CLIENT_S_DN ""
71 +RequestHeader set SSL_CLIENT_I_DN ""
72 +RequestHeader set SSL_SERVER_S_DN_OU ""
73 +RequestHeader set SSL_CLIENT_CERT "%{SSL_CLIENT_CERT}s"
74 +RequestHeader set SSL_CLIENT_VERIFY "%{SSL_CLIENT_VERIFY}s"
75 +RequestHeader set SSL_CLIENT_S_DN "%{SSL_CLIENT_S_DN}s"
76 +RequestHeader set SSL_CLIENT_I_DN "%{SSL_CLIENT_I_DN}s"
77 +RequestHeader set SSL_SERVER_S_DN_OU "%{SSL_SERVER_S_DN_OU}s"
78 +```
79 +
80 +### 2) Konfiguration der Mandanten (Kundenbereich)
81 +
82 +Die folgenden Konfigurationen müssen zum jetzigen Zeitpunkt manuell durch Manipulation auf Datenbankebene vorgenommen werden.
83 +
84 +#### 2.1) Konfiguration des Client
85 +
86 +Damit Ausfülldaten über den Autista Webservice abgeholt werden können, muss für jedes abholende Autista System (Autista Backend) das verwendete Client-Zertifikat oder alternativ die Remote-IP je Mandant hinterlegt werden.
87 +
88 +Wird ein und dasselbe Client-Zertifikat oder Remote-IP bei mehreren Mandanten hinterlegt, so kann das zugehörige Autista System die Ausfülldaten für all diese Mandanten abholen.
89 +
90 +Client Zertifikate und Remote-IP werden momentan direkt durch manuelle Änderungen an der Datenbank im System hinterlegt.
91 +Der entsprechende Datenbankname lautet "fsadministrationCenter" und die Collection wird als "apiKey" bezeichnet.
92 +
93 +#### 2.2) Einrichten mit Client-Zertifikat
94 +
95 +Ein Eintrag in der apiKey Collection muss die Attribute "certificate" und "certificateSha1Fingerprint" enthalten.
96 +`certificate` enthält das base-64-codiert (.pem) Zertifikat (zu beachten ist, dass Zeilenumbrüche durch `\n` ersetzt werden müssen).
97 +`certificateSha1Fingerprint` enthält den SHA-1 Fingerabdruck des Zertifikats.
98 +
99 +Zum Anlegen eines entsprechenden Eintrages in der apiKey Tabelle muss wie folgt aussehen (der Zertifikat-Eintrag ist gekürzt):
100 +
101 +```
102 +use fsadministrationCenter
103 +```
104 +
105 +```
106 +db.apiKey.save({
107 + "_id" : "CMS_Key...",
108 + "_class" : "de.formsolutions.administrationcenter.model.entities.ApiKey",
109 + "organizationId" : "22222222-2222",
110 + "validUntil" : ISODate("2020-06-14T13:16:27.626Z"),
111 + "createdAt" : ISODate("2017-06-14T13:16:27.626Z"),
112 + "description" : "Test Key",
113 + "certificate" : "-----BEGIN CERTIFICATE-----\nMIIDxzCCAq+gAwIBAgIEGdOgVzANBgkqhkiG9w0BAQsFADCBkzELMAkGA1UEBhMC\n___BEISPIELEINTRAG_GEKÜRZT___\nZ1UA5Z7b0EYYTOY=\n-----END CERTIFICATE-----",
114 + "certificateSha1Fingerprint" : "dfa4139224337185428ebf8d7d4eeed93a6f0000"
115 +});
116 +```
117 +
118 +#### 2.2) Konfiguration des Clients mit Remote-IP
119 +
120 +Sollte es mit der zertifikatsbasierten Abholung Probleme geben, gibt es alternativ noch die Möglichkeit die Abholung via Remote-IP abzusichern. Dazu muss der API-Key wie folgt angelegt werden:
121 +
122 +```
123 +use fsadministrationCenter
124 +```
125 +
126 +```
127 +db.apiKey.save({
128 +
129 + "_id" : "CMS_Key...",
130 + "_class" : "de.formsolutions.administrationcenter.model.entities.ApiKey",
131 + "organizationId" : "22222222-2222",
132 + "validUntil" : ISODate("2020-06-14T13:16:27.626Z"),
133 + "createdAt" : ISODate("2017-06-14T13:16:27.626Z"),
134 + "description" : "Test Key",
135 + "remoteIp" : "<IP-Adresse>"
136 +});
137 +```
138 +
139 +Die entsprechende Remote-IP-Adresse können Sie aus dem access-Log des Formularservers ermitteln.
140 +
141 +#### 2.2) Konfiguration von Standesamtzuweisungen
142 +
143 +Welche Standesämter zu einem Mandanten gehören, wird in der Mandantenkonfiguration hinterlegt. Diese Konfiguration enthält eine Menge von Modulkonfigurationen und eine davon (de.formsolutions.administrationcenter.organization.OrganizationAutistaConfiguration) enthält die Standesamtnummern eines Mandanten.
144 +Diese befindet sich in der Datenbank `administrationCenter` und hier in der Collection `organizationConfiguration`.
145 +Diese Modulkonfiguration hat ein Attribut `civilRegistryOfficeIds`, welches eine Liste von Standesamtnummern enthält.
146 +
147 +Ein Beispieleintrag in der Mandantenkonfiguration für den Mandanten "12345678-1234" würde wie folgt aussehen:
148 +
149 +```
150 + {
151 + "_id" : "12345678-1234",
152 + "_class" : "de.formsolutions.administrationcenter.organization.OrganizationConfiguration",
153 + "moduleConfigurations" : [
154 + ... GEKÜRZTER_EINTRAG ...
155 + {
156 + "civilRegistryOfficeIds" : [
157 + "05362020"
158 + ],
159 + "_class" : "de.formsolutions.administrationcenter.organization.OrganizationAutistaConfiguration"
160 + }
161 +
162 + ]
163 + }
164 +```
165 +
166 +Beispiele für das Anlegen der Struktur
167 +
168 +```
169 +use administrationCenter
170 +```
171 +
172 +Sofern für den Mandanten bereits eine Modulkonfiguration wie z.B. Payment vorliegt können Sie den Eintrag wie folgt hinzufügen:
173 +
174 +```
175 +db.organizationConfiguration.update({"_id" : "organizationid"}, {$push: {"moduleConfigurations" : {"civilRegistryOfficeIds" : ["standesamtsnummer"], "_class" : "de.formsolutions.administrationcenter.organization.OrganizationAutistaConfiguration"}}})
176 +```
177 +
178 +Sollte noch keine Modulkonfiguration für den Mandanten vorhanden sein, bitte wie folgt vorgehen:
179 +
180 +```
181 +db.organizationConfiguration.insert({
182 + "_id" : "organiazationID",
183 + "_class" : "de.formsolutions.administrationcenter.organization.OrganizationConfiguration",
184 + "moduleConfigurations" : [
185 + {
186 + "civilRegistryOfficeIds" : [
187 + "standesamtsnummer"
188 + ],
189 + "_class" : "de.formsolutions.administrationcenter.organization.OrganizationAutistaConfiguration"
190 + }
191 +
192 + ]
193 + })
194 +```
195 +
196 +In beiden Fällen sind die Werte für `_id` und `civilRegistryOfficeIds`durch die entsprechenden Werte Kundennummer und Standesamtsnummer zu ersetzen.
197 +
198 +
199 +
ApiKeyAnlegen_Stammdaten.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -xwiki:XWiki.Dokumentation
Größe
... ... @@ -1,1 +1,0 @@
1 -136.5 KB
Inhalt