Zugriff auf Web-Dienste

Für den Zugriff auf Web-Dienste (WFS, WMS, etc.) gibt es entsprechende Argumente in den Ebenentypen. Diese sind intern als WebResource definiert.

Der Typ wird hier im folgenden beschrieben.

Allgemein

• Url: die i.d.R. absolute Adresse des Endpunktes (http(s)://...)

• timeoutMilliseconds: optionales Timeout in Millisekunden, wie lange auf eine Antwort gewartet werden soll (30sek)

Anmeldung am Dienst (optional)

• serverUser: Benutzername für das Login am Dienst

• serverPwd: Kennwort zum serverUser

  Diese Daten werden via Http-Authentifikation an den angefragten Server gesendet (welche Art genau, handelt der Dienst mit dem Client aus, bspw. Basic-Auth)

  Ab Version 7.9.9 kann noch eine weitere Eigenschaft definiert werden, wie mit den Login Daten für die Ressource umzugehen ist. Dafür gibt es intern Handler die hierfür verwendet werden können.

  • authHandler: (optional)

    • type: Art des Handlers, mögliche Werte:

      • ESRI: Implementierung für das Abrufen von ArcGIS Server-Token

    • url: absolute Adresse des Endpunktes für diesen Handler (http(s)://...)

    • config: Z.Z. nicht verwendet

  Die mit serverUser hinterlegten Anmeldedaten werden dabei an die URL des hinterlegten Handler übergeben. Dieser erzeugt ein Token, welches dann an die Anfrage an den ursprünglichen Dienst anstatt der hinterlegten Anmeldedaten übergeben wird.

  Beachten Sie dabei folgendes:

  • der Aufruf an den Endpunkt verwendet die gleichen Proxy-Einstellungen wie auch für den angefragten Dienst,
  • der Aufruf an den authHandler erfolgt vor Abruf des ursprünglichen Dienstes, d.h. es gibt keine Prüfung, ob der authHandler mit diesem Dienst überhaupt in Beziehung steht (das ist technisch nicht möglich),
  • die Anmeldedaten werden im Klartext übermittelt, verwenden Sie nur authHandler mit SSL Verschlüsselung für den Endpunkt,
  • die Token werden mit einer Gültigkeit von 1 Stunde angefordert und global anhand Endpunkt+Nutzername gecached.

Proxy (optional)

• useDefaultProxy: Standard-Proxy des OS verwenden (false)

• proxyUri: die URL zum Proxyserver meist mit Port , http://myProxy:8080

• proxyUser: Benutzername für Anmeldung am Proxyserver (optional)

• proxyPwd: Kennwort des proxyUser (optional)

• proxyBypassList: Eine optionale Liste (mit Semikolon getrennt) regulärer Ausdrücke (ECMAScript, Case-insensitiv), wenn die URL mit dem Ausdruck übereinstimmt, wird der Proxy nicht verwendet.

SSL

Standardmäßig werden Zertifikate validiert, einzige zulässige Ausnahmen ist (z.Z.) IGNORE_CERT_DATE_INVALID.

• ignoreAllSslErrors (false)

  mit aktivierte Option ignoreAllSslErrors werden folgende Ausnahmen gesetzt: IGNORE_UNKNOWN_CA, IGNORE_CERT_WRONG_USAGE, IGNORE_CERT_CN_INVALID, IGNORE_CERT_DATE_INVALID