Änderungen von Dokument Autista

Zusammenfassung

• Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)
• Anhänge (0 geändert, 0 hinzugefügt, 1 gelöscht)
  • ApiKeyAnlegen_Stammdaten.jpg

Details

Seiteneigenschaften

Inhalt

...	...	@@ -62,45 +62,81 @@
62	62
63	63	```
64	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>
	65	+SSLVerifyClient optional_no_ca
	66	+
	67	+RequestHeader set SSL_CLIENT_CERT ""
	68	+RequestHeader set SSL_CLIENT_VERIFY ""
	69	+RequestHeader set SSL_CLIENT_S_DN ""
	70	+RequestHeader set SSL_CLIENT_I_DN ""
	71	+RequestHeader set SSL_SERVER_S_DN_OU ""
	72	+RequestHeader set SSL_CLIENT_CERT "%{SSL_CLIENT_CERT}s"
	73	+RequestHeader set SSL_CLIENT_VERIFY "%{SSL_CLIENT_VERIFY}s"
	74	+RequestHeader set SSL_CLIENT_S_DN "%{SSL_CLIENT_S_DN}s"
	75	+RequestHeader set SSL_CLIENT_I_DN "%{SSL_CLIENT_I_DN}s"
	76	+RequestHeader set SSL_SERVER_S_DN_OU "%{SSL_SERVER_S_DN_OU}s"
82	82	```
83	83
84	84	### 2) Konfiguration der Mandanten (Kundenbereich)
85	85
86		-Die Konfiguration per DB-Eintrag ist mit der im Folgenden beschriebenen Funktionalität obsolet.
	81	+Die folgenden Konfigurationen müssen zum jetzigen Zeitpunkt manuell durch Manipulation auf Datenbankebene vorgenommen werden.
87	87
	83	+#### 2.1) Konfiguration des Client
88	88
89		-#### 2.1) Konfiguration des Clients
	85	+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.
	87	+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]]
	89	+Client Zertifikate und Remote-IP werden momentan direkt durch manuelle Änderungen an der Datenbank im System hinterlegt.
	90	+Der entsprechende Datenbankname lautet "fsadministrationCenter" und die Collection wird als "apiKey" bezeichnet.
94	94
95	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.
	94	+Ein Eintrag in der apiKey Collection muss die Attribute "certificate" und "certificateSha1Fingerprint" enthalten.
	95	+`certificate` enthält das base-64-codiert (.pem) Zertifikat (zu beachten ist, dass Zeilenumbrüche durch `\n` ersetzt werden müssen).
	96	+`certificateSha1Fingerprint` enthält den SHA-1 Fingerabdruck des Zertifikats.
98	98
	98	+Zum Anlegen eines entsprechenden Eintrages in der apiKey Tabelle muss wie folgt aussehen (der Zertifikat-Eintrag ist gekürzt):
	99	+
	100	+```
	101	+use fsadministrationCenter
	102	+```
	103	+
	104	+```
	105	+db.apiKey.save({
	106	+ "_id" : "CMS_Key...",
	107	+ "_class" : "de.formsolutions.administrationcenter.model.entities.ApiKey",
	108	+ "organizationId" : "22222222-2222",
	109	+ "validUntil" : ISODate("2020-06-14T13:16:27.626Z"),
	110	+ "createdAt" : ISODate("2017-06-14T13:16:27.626Z"),
	111	+ "description" : "Test Key",
	112	+ "certificate" : "-----BEGIN CERTIFICATE-----\nMIIDxzCCAq+gAwIBAgIEGdOgVzANBgkqhkiG9w0BAQsFADCBkzELMAkGA1UEBhMC\n___BEISPIELEINTRAG_GEKÜRZT___\nZ1UA5Z7b0EYYTOY=\n-----END CERTIFICATE-----",
	113	+ "certificateSha1Fingerprint" : "dfa4139224337185428ebf8d7d4eeed93a6f0000"
	114	+});
	115	+```
	116	+
99	99	#### 2.2) Konfiguration des Clients mit Remote-IP
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.
	119	+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:
102	102
	121	+```
	122	+use fsadministrationCenter
	123	+```
103	103
	125	+```
	126	+db.apiKey.save({
	127	+
	128	+ "_id" : "CMS_Key...",
	129	+ "_class" : "de.formsolutions.administrationcenter.model.entities.ApiKey",
	130	+ "organizationId" : "22222222-2222",
	131	+ "validUntil" : ISODate("2020-06-14T13:16:27.626Z"),
	132	+ "createdAt" : ISODate("2017-06-14T13:16:27.626Z"),
	133	+ "description" : "Test Key",
	134	+ "remoteIp" : "<IP-Adresse>"
	135	+});
	136	+```
	137	+
	138	+Die entsprechende Remote-IP-Adresse können Sie aus dem access-Log des Formularservers ermitteln.
	139	+
104	104	#### 2.2) Konfiguration von Standesamtzuweisungen
105	105
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.

ApiKeyAnlegen_Stammdaten.jpg

Author

...	...	@@ -1,1 +1,0 @@
1		-xwiki:XWiki.Dokumentation

Größe

...	...	@@ -1,1 +1,0 @@
1		-136.5 KB

Inhalt