Das Setup führt Sie durch den Installationsprozess für ein Produktivsystem oder Testsystem. Dabei sind die beiden Begriffe Produktivsystem und Testsystem wie folgt definiert:
Produktivsystem
Beim produktiven System wird die REST-API auf einen Server installiert. Swagger ist aus Sicherheitssicht ausgeschaltet und darf auf einem produktiven System nicht aktiviert sein. Lesen Sie später mehr im Abschnitt sicherheitsrelevante Punkte.
Testsystem
Ein Testsystem ist für einen Entwickler, damit er seine Applikation für die Nutzung der REST-API erstellen kann. Bei einem Testsystem ist Swagger eingeschaltet. Swagger bietet eine Dokumentation über alle Ressourcen und zeigt, welche Operationen auf welchen Ressourcen ausgeführt werden können. Mittels Auto REST kann auf die JSON-Definition-Datei zugegriffen werden, welche man über Swagger aufrufen kann. Mit Auto REST können die Model Klassen und die entsprechenden Methoden generiert werden.
Installation REST-API One 50
Akzeptieren Sie die Lizenzbedingungen
Danach erscheint die Information über den Auftragsverarbeitungsvertrag, welcher Sie ebenfalls akzeptieren müssen.
Hier haben Sie die Möglichkeit, den Installationsort zu ändern.
Danach sehen Sie die Auswahl betreffend dem Zielsystem. Wählen Sie ein System gemäss der Definition (Produktivsystem / Testsystem) von oben aus.
Hier können Sie die "IIS-Site" auswählen sowie den Webseitennamen definieren, unter welchem die REST-API auf dem IIS installiert werden soll.
Und hier noch die Konfiguration für den Startmenü-Eintrag.
Wichtige Punkte zur Installation
Hier noch einige wichtige Punkte zur Installation:
-
Bei der Installation muss der IIS mit einem HTTPS Binding konfiguriert sein. Es ist nur erlaubt, die REST-API unter HTTPS laufen zu lassen. Für produktive Umgebungen müssen unbedingt offizielle Zertifikate verwendet werden. Keine Self Signed Zertifikate.
-
Bitte installieren Sie nur eine REST-API pro Datenbank. Mehrere REST-APIs auf einer Datenbank führen zu Konflikten und es funktioniert nur die zuletzt installierte Version.
-
Um sich mit Swagger bei Infoniqa Cloud Identity anzumelden, müssen Sie die korrekte Redirect-URL, der Firma Infoniqa mitteilen. Lesen Sie dazu das Kapitel Infoniqa Cloud Identity.
-
Lesen Sie den Abschnitt Sicherheitsrelevante Punkte durch.
-
Genauere Informationen über die Verknüpfung ONE 50 Benutzer mit Infoniqa Cloud Identity finden Sie im Abschnitt Infoniqa Cloud Identity. Die Infoniqa Cloud Identity und REST-API sind basierend auf Auth0. Sie finden Beispiele und weitere Informationen unter https://auth0.com.
-
Genauere Informationen über Swagger finden Sie im Abschnitt Swagger (REST-API Online Dokumentation).
Das Tenant Konfigurations-Tool
Nach Fertigstellung der Installation startet das Tenant-Konfigurations-Tool hier werden die Mandanten konfiguriert.
Wählen Sie das Tenantconfiguration file an:
Danach erstellen Sie eine neue Tenant-Verknüpfung (Firma).
- Klicken Sie dafür auf «New tenant»
- Erfassen Sie einen Namen
- Wählen Sie den Pfad zum SPI-Security Pfad.
- Klicken Sie dann auf "Add tenant"
Fügen Sie nun ein Financialyear-ID hinzu.
- klicken Sie dazu auf "New financialyear"
- Financialyear-ID: = frei wählbarerer Name wie z.B. "2024"
- Financial Data Path: = Pfad zum entsprechenden Mandanten
- Klicken Sie dann auf "Add financialyear"
Öffnen Sie noch das Register «Logging»
Dort können Sie die Checkbox bei «Activate SeriLog» setzen und den Loglevel auswählen sowie den Speicherpfad der Logs anwählen.
Zum Schluss können Sie den Button «Save» anwählen.
Starten Sie anschliessend das Tenant-Configuration-Tool neu.
Nachdem Neustart werden Ihnen alle One 50 Benutzer welche Zugriff auf die REST haben aufgelistet.
Hier haben Sie nun die Möglichkeit, für die einzelnen Tenants (Kunden/Mandanten) One 50 Benutzer zu autorisieren.
Default Policy = allow
Alle One 50 Benutzer haben Zugriff auf den entsprechenden Tenant. Diese Einstellung kann verwendet werden, wenn nur mit einem Tenant gearbeitet wird oder alle User auf alle Tenants Zugriff haben sollen.
Default Policy = deny
Verwenden Sie diese Einstellung, wenn nur berechtigte User Zugriff auf den entsprechenden Tenant haben dürfen.
In diesem Beispiel hätten nur "chg" und "REST_User" die Berechtigung auf den Tenant MeyerAG zuzugreifen.