Server-Konfiguration
Bevor ein fertig erstellter OData-Service verwendet werden kann, muss der OData-Anbieter über das Hauptmenü "OData / Einstellungen" oder das entsprechende Kontextmenü aktiviert werden.
OData-Services werden von Intrexx an eine festgelegte TCP/IP-Adresse und Port gebunden und bereitgestellt. Bevor auf einen OData-Service zugegriffen werden kann, muss der OData-Server entsprechend konfiguriert und aktiviert werden.
Einstellungen
Bindungsadresse
Unter der Bindungsadresse soll der Dienst erreichbar sein. Die Bindungsadresse definiert, wer auf den OData-Service zugreifen darf. Mit der Auswahl localhost ist der Service nur vom lokalen PC aus verfügbar. Alternative Auswahlmöglichkeiten sind jede (IPv4), jede (IPv6) oder die manuelle Eingabe einer bestimmten IP-Adresse. Mit "localhost" kann ein OData-Service lokal getestet werden.
Port
Wählen Sie hier einen freien Port, der nicht von einem anderen Dienst verwendet und nicht von einer Firewall blockiert wird. Mit dem Port wird definiert, unter welchem TCP-Port der OData-Service erreichbar sein soll.
Idealerweise wird eine Portnummer zwischen 49152 und 65535, einer der sogenannten Private Ports, gewählt. Diese lassen sich variabel einsetzen, da sie nicht registriert und damit keiner Anwendung zugehörig sind. Host und Port bilden zusammen die Endpunkt-URL, unter der der Service erreichbar sein soll. Der Service kann für die öffentliche Verwendung auch einfach unter der regulären Domain eingebunden werden.
Der hier eingetragene Port darf nicht der Port sein, der vom Intrexx Portal-Servers verwendet wird. Er darf auch von keiner anderen Applikation belegt sein.
Context
Hier kann optional ein Kontext angegeben werden, der als Teil der Service-Endpunkt-URL verwendet wird, z.B. um Services hinter einem Reverse-Proxy zu betreiben. Der Context-Name muss URL-konform sein. Die Endpunkt-URL wird bei Angabe eines Contexts wie folgt gebildet: https://hostname:port/context/service.svc.
Host
Hier kann optional ein Hostname angegeben werden, wenn der Hostname der öffentlichen Service-URL sich vom Hostnamen des Servers unterscheidet, z.B., um Services hinter einem Reverse Proxy zu betreiben.
SSL verwenden
Hier kann die SSL-Verschlüsselung aktiviert werden. Alle Informationen dazu finden Sie hier.
Keystore
Für SSL-Verbindungen wird ein Keystore benötigt, der die Zertifikate bereithält. Geben Sie hier den Dateinamen des Keystores an. Die Keystore-Datei muss sich im Portalverzeichnis "/internal/cfg/odata/producer" befinden.
Keystore Passwort
Hier ist das Passwort für den Keystore anzugeben.
Anbieter ist aktiv
Aktiviert bzw. deaktiviert den OData-Anbieter. Im Auslieferungszustand ist der Anbieter deaktiviert. Nach der Aktivierung werden die Dienste automatisch gestartet.
Dienst testen
Zum Testen eines Dienstes können Sie in einem Browser die Endpunkt-URL (z.B. des Beispieldienstes, der hier beschrieben ist) aufrufen. Das OData-XML-Dokument, das angezeigt wird, zeigt die entsprechende Datengruppe an.
Alternativ können Sie über das Hauptmenü "OData / Metadaten anzeigen" das OData-XML-Dokument anzeigen, das die Service-Metadaten auflistet.
Im nächsten Schritt kann der OData-Dienst konsumiert werden.
Senden Sie uns eine E-Mail