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:

      • OIDC: Implementierung des OAuth Client Credentials Flow (OAuth 2.0 RFC 6749, section 4.4) (Sie benötigen client_id und client_secret vom Dienstanbieter, als Benutzer/Kennwort in serverUser/serverPassword zu hinterlegen.)

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

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

    • config: optional, nur in OIDC ausgewertet. Ein JSON Objekt, alle Werte müssen vom Typ String sein, die Argumente werden als Form-Werte mit übergeben.

  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,
  • bei ESRI Tokenservice werden die Tokens werden mit einer Gültigkeit von 1 Stunde angefordert bei OIDC liefert der Dienst die Lebensdauer, wenn nicht werden 24h verwendet.
  • die Tokens werden global anhand Endpunkt+Nutzername gecached für die Gültigkeitsdauer 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