Ä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

...	...	@@ -83,24 +83,65 @@
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.
	86	+Die folgenden Konfigurationen müssen zum jetzigen Zeitpunkt manuell durch Manipulation auf Datenbankebene vorgenommen werden.
87	87
	88	+#### 2.1) Konfiguration des Client
88	88
89		-#### 2.1) Konfiguration des Clients
	90	+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.
	92	+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]]
	94	+Client Zertifikate und Remote-IP werden momentan direkt durch manuelle Änderungen an der Datenbank im System hinterlegt.
	95	+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.
	99	+Ein Eintrag in der apiKey Collection muss die Attribute "certificate" und "certificateSha1Fingerprint" enthalten.
	100	+`certificate` enthält das base-64-codiert (.pem) Zertifikat (zu beachten ist, dass Zeilenumbrüche durch `\n` ersetzt werden müssen).
	101	+`certificateSha1Fingerprint` enthält den SHA-1 Fingerabdruck des Zertifikats.
98	98
	103	+Zum Anlegen eines entsprechenden Eintrages in der apiKey Tabelle muss wie folgt aussehen (der Zertifikat-Eintrag ist gekürzt):
	104	+
	105	+```
	106	+use fsadministrationCenter
	107	+```
	108	+
	109	+```
	110	+db.apiKey.save({
	111	+ "_id" : "CMS_Key...",
	112	+ "_class" : "de.formsolutions.administrationcenter.model.entities.ApiKey",
	113	+ "organizationId" : "22222222-2222",
	114	+ "validUntil" : ISODate("2020-06-14T13:16:27.626Z"),
	115	+ "createdAt" : ISODate("2017-06-14T13:16:27.626Z"),
	116	+ "description" : "Test Key",
	117	+ "certificate" : "-----BEGIN CERTIFICATE-----\nMIIDxzCCAq+gAwIBAgIEGdOgVzANBgkqhkiG9w0BAQsFADCBkzELMAkGA1UEBhMC\n___BEISPIELEINTRAG_GEKÜRZT___\nZ1UA5Z7b0EYYTOY=\n-----END CERTIFICATE-----",
	118	+ "certificateSha1Fingerprint" : "dfa4139224337185428ebf8d7d4eeed93a6f0000"
	119	+});
	120	+```
	121	+
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.
	124	+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
	126	+```
	127	+use fsadministrationCenter
	128	+```
103	103
	130	+```
	131	+db.apiKey.save({
	132	+
	133	+ "_id" : "CMS_Key...",
	134	+ "_class" : "de.formsolutions.administrationcenter.model.entities.ApiKey",
	135	+ "organizationId" : "22222222-2222",
	136	+ "validUntil" : ISODate("2020-06-14T13:16:27.626Z"),
	137	+ "createdAt" : ISODate("2017-06-14T13:16:27.626Z"),
	138	+ "description" : "Test Key",
	139	+ "remoteIp" : "<IP-Adresse>"
	140	+});
	141	+```
	142	+
	143	+Die entsprechende Remote-IP-Adresse können Sie aus dem access-Log des Formularservers ermitteln.
	144	+
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