Änderungen von Dokument Autista

Zusammenfassung

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

Details

Seiteneigenschaften

Inhalt

...	...	@@ -83,65 +83,24 @@
83	83
84	84	### 2) Konfiguration der Mandanten (Kundenbereich)
85	85
86		-Die folgenden Konfigurationen müssen zum jetzigen Zeitpunkt manuell durch Manipulation auf Datenbankebene vorgenommen werden.
	86	+Die Konfiguration per DB-Eintrag ist mit der im Folgenden beschriebenen Funktionalität obsolet.
87	87
88		-#### 2.1) Konfiguration des Client
89	89
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.
	89	+#### 2.1) Konfiguration des Clients
91	91
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.
	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.
93	93
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.
	93	+![[API Key Anlegen|@ApiKeyAnlegen_Stammdaten.jpg]]
96	96
97	97	#### 2.2) Einrichten mit Client-Zertifikat
98	98
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.
	97	+Es ist möglich ein Zertifikat per Upload-Komponente in der Konfiguration des API-Keys hochzuladen.
102	102
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		-
122	122	#### 2.2) Konfiguration des Clients mit Remote-IP
123	123
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:
	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.
125	125
126		-```
127		-use fsadministrationCenter
128		-```
129	129
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		-
145	145	#### 2.2) Konfiguration von Standesamtzuweisungen
146	146
147	147	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,0 +1,1 @@
	1	+xwiki:XWiki.Dokumentation

Größe

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

Inhalt