2.1 Einrichtung der Sage 100

Die Konnektivitätslösung über das Sage Connectivity Gateway ermöglicht die Verbindung zu einem in der Kundeninstallation gehosteten Applikationsserver über das Internet.

Die wichtigsten Bestanteile der Lösung sind:

• „Connectivity Gateway“ und „Entitlement Service“, die in der Microsoft Azure Cloud betrieben werden.
  Das „Connectivity Gateway“ ermöglicht eine sichere Verbindung zu einer Kundeninstallation.
  Der „Entitlement Service“ verwaltet die Autorisierung. Er stellt sicher, dass nur berechtigte SageID-Benutzer auf eine Kundeninstallation (repräsentiert durch eine EntitlementID) zugreifen können.

• SageID wird für die Authentifizierung verwendet

• Der „Connectivity Client“, installiert in der Kunden-Umgebung, stellt die Verbindung mit dem „Connectivity Gateway“ her und leitet einkommende Anfragen an den konfigurierten Applikationsserver weiter.

Pro Kundeninstallation ist genau eine Verbindung mit dem „Connectivity Gateway“ möglich.

Wenn ein Kunde die Verwendung des „3rd Party Gateways“ lizensiert, wird die Email-Adresse des Hauptansprechpartners des Kunden bei Sage mit einer KundenID (=EntitlementID) im „Entitlement Service“ registriert.

Die Einrichtung der Verbindung erfolgt über den Sage 100 Server Manager.

Jeder Kommunikationsdienst trägt sich beim Start in die Remote-Registry ein. Im Server Manager werden diese unterhalb von „Externe API“ im Navigationsbaum angezeigt. Die Konfiguration kann von jeder Server Manager Installation aus erfolgen.

Der Screenshot zeigt den initialen Zustand einer Installation, bei der noch keine Verbindung erfolgt ist.

Über den Button „Verbindung herstellen“ wird der Prozess der Initiierung der Verbindung gestartet.

Als erstes muss eine Anmeldung gegen SageID erfolgen; und zwar mit der Email-Adresse des Hauptbenutzers, der bei Sage hinterlegt ist. Sofern noch kein SageID Konto mit dieser Email-Adresse vorhanden ist, muss es angelegt werden.

Nach der Anmeldung werden die Entitlements (d.h. die Kunden), für die der Benutzer berechtigt ist ermittelt und zur Auswahl angezeigt. I.d.R. ist es genau ein Eintrag.

Im zweiten Feld „Applikationsserver“ ist der Applikationsserver auszuwählen, an den die Anfragen vom Connectivity Gateway weitergeleitet werden sollen.

Nach dem Klick auf „OK“ wird die Verbindung eingerichtet und der Status aktualisiert. Dies dauert einige Sekunden.

Wurde die Verbindung erfolgreich etabliert, zeigt der Server Manager die Verbindungen in grün an.

Über den Button „Verbindung anhalten“ wird der „Cloud Connectivity Client“ Dienst gestoppt. Es sind dann keine Verbindungen von Außen möglich. Eine angehaltene Verbindung kann ohne weitere Konfiguration wieder gestartet werden. Dabei wird die Verbindung neu aufgebaut.

„Verbindung löschen“ beendet die Verbindung und löscht deren Konfiguration.

In dem Dialog „Konfiguration“ ist zum Einen die EntitlementID (=ID der Kunden-Installation im Connectivity Gateway) ersichtlich. Anfragen werden auf Basis dieser ID an die richtige Kundeninstanz weitergeleitet.

Im Feld „Url des Applikationsservers“ kann der Applikationsserver geändert werden, an den die Anfragen weitergeleitet werden sollen.

Desweiteren ist es möglich einen Proxy für die Verbindung einzurichten.

Das Freischalten der Datenbanken und die Verwaltung der Benutzer, die via Konnektivität zugreifen dürfen, erfolgt im Sage 100 Administrator.

Für die Verbindung über das Sage Connectivity Gateway ist eine Lizenz erforderlich. Sie begrenzt die mögliche Anzahl von Benutzern.

Ob eine solche Lizenz vorhanden ist, kann man in dem Dialog „Lizenzinformationen“ im Sage 100 Administrator überprüfen.

Die Datenbanken, die über das Sage Connectivity Gateway erreicht werden können, müssen explizit freigegeben werden.

Die Verbindung über das Sage Connectivity Gateway wird über SageID abgesichert. Nur die SageID Konten, die hier eingetragen sind, sind autorisiert.

Die maximale Anzahl von autorisierten Benutzern ergibt sich aus der Lizenz.

Für ein SageID Konto muss es einen entsprechenden Sage 100 Benutzer mit identischem Sage Konto Eintrag geben. Die Berechtigungen ergeben sich aus den Berechtigungen des Sage 100 Benutzers.

Bei Verwendung von M2M Kommunikation, wir anstelle der Sage ID die von Sage zugewiesene Client-ID verwendet.

Bitte verwenden Sie für Name und Bezeichnung sprechende Begriffe, so dass sich daraus erkennen lässt, mit welchem Partner-Service der Benutzer verbunden ist.

Prozess für M2M

• Partner erhält auf ClientID und Client-Secret
  (per Partner; nicht per Partner-App)

• Partner erzeugt App und übermittelt die ClientID an seine Kunden

• Der Kunde bestimmt, via Registrierung der freigegebenen ClientIDs in seinem Entitlement (über Sage 100 Administrator), welche ClientIDs auf seine Installation mit welchen Rechten zugreifen dürfen

• Einem Sage 100 Benutzer wird entweder eine SageID oder einer ClientID zugeordnet.

• Wird beim Zugriff via CSP überprüft.

Wesentliche Bestandteile sind:

• Cloud Connectivity Client

• Kommunikationsdienst

• Mehrbenutzerdienst

Deren Aufgaben werden im Folgenden erklärt.

• Ist ein Windows-Dienst. Er wird bei der Einrichtung der Konnektivität konfiguriert und gestartet.

• Stellt die sichere Verbindung mit dem Connectivity Gateway her

• Es ist keine Änderung im Kunden-Netzwerk erforderlich. Er verwendet Port 443 für die Verbindung.

• Die Authentifizierung erfolgt via individuellen X.509 Zertifikaten signiert von Sage CA

• Leitet die Anfragen an den konfigurierten Applikationsserver weiter

• Ist im Verzeichnis „ C:\Program Files (x86)\Common Files\Sage Software Shared\Sage Connectivity Client” installiert.

• Ist ein Windows-Dienst der eine API zur Administration des „Cloud Connectivity Clients“ zur Verfügung stellt. Der Dienst ist immer gestartet. Er trägt sich beim Start in die Remote Registry ein. Ist der Dienst nicht gestartet, kann keine Konnektivität über ihn administriert werden.

• Wird immer zusammen mit dem „Cloud Connectivity Client“ auf jedem Applikationsserver installiert.

• Ist im Verzeichnis „ C:\Program Files (x86)\Common Files\Sage Software Shared\Sage Communication” installiert.

• Status und Konfiguration der Konnektivität werden in der Remote Registry hinterlegt.

• In der Windows-Registry des Mehrbenutzerdienst-Server-Rechners gibt es einen neuen Knoten unterhalb der Version der Anwendung: „Connectivity Server“

• Jeder „Kommunikationsdienst“ trägt sich beim Start mit seinem Status ein.

• Der Sage 100 Administrator ermittelt aus der Remote Registry die EntitlementID, für die er die Benutzer verwaltet, aus dem Eintrag mit dem eingerichteten „Connectivity Server“. Ein eingerichteter „Connectivity Server“ hat die Einstellungen: IsConfigured=1 und eine eingetragene EntitlementID.