Zum Inhalt springen

Änderungen von Dokument Autista

Zuletzt geändert von MACH ProForms GmbH am 02.07.2024
Von Version 13.1
bearbeitet von MACH ProForms GmbH
am 17.01.2022
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 1.1
bearbeitet von MACH ProForms GmbH
am 08.10.2020
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -1,22 +1,25 @@
1 -## Auswahl des Inhalts-Schema
2 -
1 +# Auswahl des Inhalts-Schema
3 3  Ab der Version 4.33.0 wird die Inhaltsnachricht im xPersonenstandsformat an Autista übergeben.
4 4  Für einen selbstgebauten Assistenten heißt, dies dass je Urkundenart ein Mapping vorgenommen werden muss.
5 5  
6 -Damit der Formularserver unabhängig von der Art der Einreichung (siehe unten) weiß welches Mapping-Schema bei der Übergabe an Autista verwendet werden soll, benötigt er ein Feld namens "mappingSchemaFilter".
5 +Damit der Formularserver unabhängig von der Art der Einreichung (siehe unten) weiss welches Mapping-Schema
6 +bei der Übergabe an Autista verwendet werden soll, benötigt er ein Feld namens mappingSchemaFilter.
7 7  
8 -Über das Feld "mappingSchemaFilter" wird definiert, welche Mapping-Schema für die Inhaltsnachricht verwendet werden soll.
8 +Über das Feld mappingSchemaFilter wird definiert, welche Mapping-Schema für die Inhaltsnachricht verwendet werden soll.
9 9  
10 10  Dabei kommen im Verlagsassistent die folgenden Werte zum Einsatz
11 11  
12 -- portal2StA.Geburt.081030#@#1.7.5 für Geburtsurkunden
13 -- portal2StA.Ehe.082030#@#1.7.5 für Eheurkunden
14 -- portal2StA.LP.083030#@#1.7.5 für Lebenspartnerschaftsurkunden
15 -- portal2StA.Sterbefall.084030#@#1.7.5 für Sterbefallurkunden
12 +//Formatierung noch schauen wegen Aufzählung
13 +portal2StA.Geburt.081030#@#1.7.4 für Geburtsurkunden
14 +portal2StA.Ehe.082030#@#1.7.4 für Eheurukunden
15 +portal2StA.Geburt.081030#@#1.7.4 für Geburtsurkunden
16 +portal2StA.LP.083030#@#1.7.4 für Lebenspartnerschaftsurkunden
17 +portal2StA.Sterbefall.084030#@#1.7.4 für Sterbefallurkunden
16 16  
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.
19 +Sollten Sie die Schema-Dateien unter einem anderen Namen und Version hochgeladen haben, so sind die Werte von oben entsprechend zu
20 +ersetzen. Als Trennzeichen zwischen Schema-Namen und Schema-Version ist immer #@# zu verwenden.
18 18  
19 -Das Feld "mappingSchemaFilter" wird aus einer Konfigurationsliste gezogen, welche von uns (Form-Solutions) gepflegt wird!
22 +Das Feld mappingSchemaFilter wird aus einer Konfigurationsliste gezogen, welche von uns (Form-Solutions) gepflegt wird!
20 20  Falls eigenständige Anpassungen an der Liste vorgenommen werden und sich daraus Fehler ergeben, sind die daraus entstehenden Kosten selbst zu tragen!
21 21  Damit die richtigen Daten aus der Konfigurationsliste gezogen werden, benötigen wir von Ihnen folgende Informationen:
22 22  - Mandantennummer
... ... @@ -24,27 +24,27 @@
24 24  - die eingesetzte Versionsnummer von Autista und xPersonenstand
25 25  - Standesamtsnummer
26 26  
27 -## Konfiguration der Autista Push-Variante auf Seiten des Form-Solutions Formularservers
30 +# Konfiguration der Autista Push-Variante auf Seiten des Form-Solutions Formularservers.
28 28  
29 29  Das Autista Push System steht ab Version 4.22.0 des Formularservers zur Verfügung.
30 30  
31 31  Bei Verwendung der Push-Variante werden die Inhaltsdaten, beim Einreichen des Assistenten, an einen Webservice verschickt.
32 32  Für einen erfolgreichen Versand ist es notwendig, dass die Inhaltsdaten zunächst in ein XML (nach xSta Standard) gemappt werden.
33 -Anschließend wird dieses XML als Inhalt einer Webservice-Nachricht (nach XTA Standard) an die Autista-Webservice-Schnittstelle des Empfängers verschickt.
36 +Anschließend wird dieses XML als Inhalt einer WebService-Nachricht (nach XTA Standard) an die Autista-Webservice-Schnittstelle des Empfängers verschickt.
34 34  
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/)
38 +Die Dokumentation zur Konfiguration sowie Veröffentlichung des Assistenten finden Sie [hier](https://wiki.form-solutions.de/wiki/docwiki/view/Main/12_Anbindungen/02_Autista)
36 36  
37 37  ___
38 38  
39 -## Konfiguration der Autista Pull-Variante auf Seiten des Form-Solutions Formularservers
42 +# Konfiguration der Autista Pull-Variante auf Seiten des Form-Solutions Formularservers
40 40  
41 41  Das Autista Pull System steht ab Version 4.22.0 des Formularservers zur Verfügung.
42 42  
43 -### 1) Konfiguration des Apache Reverse Proxy
46 +## 1) Konfiguration des Apache Reverse Proxy
44 44  
45 45  Der Apache Reverse Proxy muss folgendermaßen konfiguriert werden (siehe vhost-ofs.conf, im Unterverzeichnis customerArea/httpd.conf.d):
46 46  
47 -### 1.1) Konfiguration der ProxyPass Einträge
50 +## 1.1) Konfiguration der ProxyPass Einträge
48 48  
49 49  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):
50 50  
... ... @@ -55,54 +55,90 @@
55 55  
56 56  Der Servername muss durch Ihre konkrete Domain ersetzt werden.
57 57  
58 -### 1.2) Konfiguration der Zertifikatsweiterleitung
61 +## 1.2) Konfiguration der Zertifikatsweiterleitung
59 59  
60 60  Für die korrekte Weiterleitung von Client Zertifikaten an den Wildfly Applikationsserver müssen die nachfolgenden Einträge hinzugefügt werden:
61 61  Diese Einstellungen sollten im `<IfModule ssl_module>` Block stehen, am besten direkt nach den Server-Zertifikatseinstellungen ("SSLCertificate*File")
62 62  
63 63  ```
64 -## pass SSL client certificates to wildfly (required for Autista Webservice)
65 -<Location /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 - ProxyPass http://wildfly:8080/autista-webservice
80 - ProxyPassReverse http://wildfly:8080/autista-webservice
81 - </Location>
67 +# pass SSL client certificates to wildfly (required for Autista Webservice)
68 +SSLVerifyClient optional_no_ca
69 +
70 +RequestHeader set SSL_CLIENT_CERT ""
71 +RequestHeader set SSL_CLIENT_VERIFY ""
72 +RequestHeader set SSL_CLIENT_S_DN ""
73 +RequestHeader set SSL_CLIENT_I_DN ""
74 +RequestHeader set SSL_SERVER_S_DN_OU ""
75 +RequestHeader set SSL_CLIENT_CERT "%{SSL_CLIENT_CERT}s"
76 +RequestHeader set SSL_CLIENT_VERIFY "%{SSL_CLIENT_VERIFY}s"
77 +RequestHeader set SSL_CLIENT_S_DN "%{SSL_CLIENT_S_DN}s"
78 +RequestHeader set SSL_CLIENT_I_DN "%{SSL_CLIENT_I_DN}s"
79 +RequestHeader set SSL_SERVER_S_DN_OU "%{SSL_SERVER_S_DN_OU}s"
82 82  ```
83 83  
84 -### 2) Konfiguration der Mandanten (Kundenbereich)
82 +## 2) Konfiguration der Mandanten (Kundenbereich)
85 85  
86 -Die Konfiguration per DB-Eintrag ist mit der im Folgenden beschriebenen Funktionalität obsolet.
84 +Die folgenden Konfigurationen müssen zum jetzigen Zeitpunkt manuell durch Manipulation auf Datenbankebene vorgenommen werden.
87 87  
86 +### 2.1) Konfiguration des Client
88 88  
89 -#### 2.1) Konfiguration des Clients
88 +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.
90 90  
91 -Damit die 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. Diese Konfiguration kann unter "Einstellungen/Server-Administration/API-Keys" durch die Verwendung eines API-Keys durchgeführt werden. 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.
90 +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.
92 92  
93 -![[API Key Anlegen|@ApiKeyAnlegen_Stammdaten.jpg]]
92 +Client Zertifikaten und Remote-IP werden momentan direkt durch manuelle Änderungen an der Datenbank im System hinterlegt.
93 +Der entsprechende Datenbankname lautet "fsadministrationCenter" und die Collection wird als "apiKey" bezeichnet.
94 94  
95 -#### 2.2) Einrichten mit Client-Zertifikat
95 +### 2.2) Einrichten mit Client-Zertifikat
96 96  
97 -Es ist möglich ein Zertifikat per Upload-Komponente in der Konfiguration des API-Keys hochzuladen.
97 +Ein Eintrag in der apiKey Collection muss die Attribute "certificate" und "certificateSha1Fingerprint" enthalten.
98 +`certificate` enthält das base64-codiert (.pem) Zertifikat (zu beachten ist, dass Zeilenumbrüche durch `\n` ersetzt werden müssen).
99 +`certificateSha1Fingerprint` enthält den SHA-1 Fingerabdruck des Zertifikats.
98 98  
99 -#### 2.2) Konfiguration des Clients mit Remote-IP
101 +Zum Anlegen eines entsprechenden Eintrages in der apiKey Tabelle muss wie folgt aussehen (der Zertifikat-Eintrag ist gekürzt):
100 100  
101 -Sollte es mit der zertifikatsbasierten Abholung Probleme geben, gibt es alternativ noch die Möglichkeit die Abholung via Remote-IP abzusichern. Die Remote-IP kann wie unter dem Punkt 2.1 beschrieben bei einem API-Key hinterlegt werden. Die entsprechende Remote-IP-Adresse können Sie aus dem Access-Log des Formularservers ermitteln.
103 +```
104 +use fsadministrationCenter
105 +```
102 102  
107 +```
108 +db.apiKey.save({
109 + "_id" : "CMS_Key...",
110 + "_class" : "de.formsolutions.administrationcenter.model.entities.ApiKey",
111 + "organizationId" : "22222222-2222",
112 + "validUntil" : ISODate("2020-06-14T13:16:27.626Z"),
113 + "createdAt" : ISODate("2017-06-14T13:16:27.626Z"),
114 + "description" : "Test Key",
115 + "certificate" : "-----BEGIN CERTIFICATE-----\nMIIDxzCCAq+gAwIBAgIEGdOgVzANBgkqhkiG9w0BAQsFADCBkzELMAkGA1UEBhMC\n___BEISPIELEINTRAG_GEKÜRZT___\nZ1UA5Z7b0EYYTOY=\n-----END CERTIFICATE-----",
116 + "certificateSha1Fingerprint" : "dfa4139224337185428ebf8d7d4eeed93a6f0000"
117 +});
118 +```
103 103  
104 -#### 2.2) Konfiguration von Standesamtzuweisungen
120 +### 2.2) Konfiguration dies Clients mit Remote-IP
105 105  
122 +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:
123 +
124 +```
125 +use fsadministrationCenter
126 +```
127 +
128 +```
129 +db.apiKey.save({
130 +
131 + "_id" : "CMS_Key...",
132 + "_class" : "de.formsolutions.administrationcenter.model.entities.ApiKey",
133 + "organizationId" : "22222222-2222",
134 + "validUntil" : ISODate("2020-06-14T13:16:27.626Z"),
135 + "createdAt" : ISODate("2017-06-14T13:16:27.626Z"),
136 + "description" : "Test Key",
137 + "remoteIp" : "<IP-Adresse>"
138 +});
139 +```
140 +
141 +Die entsprechende Remote-IP-Adresse können Sie aus dem access-Log des Formularservers ermitteln.
142 +
143 +### 2.2) Konfiguration von Standesamtzuweisungen
144 +
106 106  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.
107 107  Diese befindet sich in der Datenbank `administrationCenter` und hier in der Collection `organizationConfiguration`.
108 108  Diese Modulkonfiguration hat ein Attribut `civilRegistryOfficeIds`, welches eine Liste von Standesamtnummern enthält.
ApiKeyAnlegen_Stammdaten.jpg
Author
... ... @@ -1,1 +1,0 @@
1 -xwiki:XWiki.Dokumentation
Größe
... ... @@ -1,1 +1,0 @@
1 -136.5 KB
Inhalt