Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung Nächste Überarbeitung Beide Seiten der Revision | ||
developer:client [2019/01/28 18:48] oesi |
developer:client [2019/01/28 18:59] oesi |
||
---|---|---|---|
Zeile 5: | Zeile 5: | ||
* Clients können auf einem eigenem Host installiert werden und müssen nicht am selben Host wie der Core liegen. | * Clients können auf einem eigenem Host installiert werden und müssen nicht am selben Host wie der Core liegen. | ||
* Getrennte Codebasis, Kommunikation mit dem Core erfolgt ausschließlich über die API / REST Services | * Getrennte Codebasis, Kommunikation mit dem Core erfolgt ausschließlich über die API / REST Services | ||
- | * Sind zusätzliche Erweiterungen des Core erforderlich muss zusätzlich eine Extension erstellt werden. | + | * Sind zusätzliche Erweiterungen des Core erforderlich muss zusätzlich eine [[developer:extensions|Extension]] erstellt werden. |
{{:developer:clientaufbau.png?600|}} | {{:developer:clientaufbau.png?600|}} | ||
Zeile 17: | Zeile 17: | ||
Die restlichen Dateien dienen Dateien dienen der Kommuniktion und brauchen nicht verändert werden. | Die restlichen Dateien dienen Dateien dienen der Kommuniktion und brauchen nicht verändert werden. | ||
- | config | + | * config |
- | config.php.ex -> Konfiguration für die Anbindung an FH-Complete Core | + | * config.php.ex -> Konfiguration für die Anbindung an FH-Complete Core |
- | config.js.ex -> Konfiguration für die Kommunikation zwischen FHC-Client und Enduser | + | * config.js.ex -> Konfiguration für die Kommunikation zwischen FHC-Client und Enduser |
- | hooks | + | * hooks |
- | CoreClient.hooks.php.ex -> Beispiele für Hooks zwischen FHC-Client und Core API | + | * CoreClient.hooks.php.ex -> Beispiele für Hooks zwischen FHC-Client und Core API |
- | js | + | * js |
- | CoreClient.js.ex -> Beispiel für Kommunikation zwischen FHC-Client und Enduser | + | * CoreClient.js.ex -> Beispiel für Kommunikation zwischen FHC-Client und Enduser |
- | css | + | * css |
- | CoreClient.css.ex -> Beispiel CSS | + | * CoreClient.css.ex -> Beispiel CSS |
+ | |||
+ | ==== Core Anbindung ==== | ||
+ | Um einen Client mit dem Core zu verbinden sind folgende Schritte nötig: | ||
+ | * User im FH-Complete erstellen | ||
+ | * API Key erstellen | ||
+ | * Berechtigungen zuteilen | ||
+ | * Client Whitelist anpassen | ||
+ | |||
+ | |||
+ | === User === | ||
+ | Für die Anbindung muss ein User im FH-Complete erstellt werden. Dieser kann als Mitarbeiter oder als Student angelegt werden. | ||
+ | |||
+ | === API Key === | ||
+ | Der Zugriff erfolgt über einen API Key. Dazu muss in der Datenbank in der Tabelle public.ci_apikey ein neuer Eintrag hinzugefügt werden. Wichtig ist hier der Wert "Key". Dieser muss beim Zugriff angegeben werden. | ||
+ | |||
+ | === Berechtigung zuteilen === | ||
+ | Damit der Zugriff auf die REST Schnittstelle möglich ist, muss der neue User die entsprechenden Berechtigungen für den Zugriff auf die Funktionen erhalten. Dies kann im Vilesci über Stammdaten->Berechtigungen zugeordnet werden. | ||
+ | |||
+ | === Whitelist === | ||
+ | Per Default ist der Zugriff auf die REST Schnittstelle per Whitelist gesperrt. Damit der Zugriff auf die Schnittstelle möglich ist, muss die Client IP in die Whitelist mitaufgenommen werden. | ||
+ | Die entsprechende Konfiguration dazu findet sicht unter /application/config/rest.php | ||
+ | |||
+ | <code> | ||
+ | $config['rest_ip_whitelist'] = '127.0.0.1'; | ||
+ | </code> | ||
- | |||