CSW Proxy

Dieses Kapitel enthält die grundlegenden Konfigurationseinstellung des CSW Proxy (smartfinder-csw).

Der CSW Proxy ist unter folgender URL erreichbar: http(s)://[HOST]:[PORT]/smartfinder-csw/api

Properties

Da diese Komponente als Proxy vor dem Backend fungiert, muss die URL zum Backend konfiguriert werden. Dies ist erläutert im Abschnitt Anpassen der URL-Konfiguration

CSW Capabilities

Um die Capabilities des CSW Proxy zu konfigurieren, müssen folgende Dateien im Order /smartfinder-csw/WEB-INF/classes/capabilities angepasst werden:

Capabilities.xml
languages.xml

Hierfür ist ein UTF-8 fähiger Editor notwendig.

Datei Capabilities.xml

Dies ist die Hauptdatei für die Beschreibung der Capabilities gemäß OGC Catalog Service for the Web 2.0.2. Zudem sind sämtliche Anforderungen seitens INSPIRE Discovery Service Spezifikation bereits berücksichtigt. Es müssen lediglich die Angaben ergänzt werden, die für den Betrieb in einer konkreten Umgebung durch einen konkreten Anbieter erforderlich sind. Dazu zählen:

Service Identifikation

Title: Wird in languages.xml erläutert
Abstract: Wird in languages.xml erläutert
Keywords: Die Liste der Schlüsselwörter ist bereits mit einigen Begriffen gefüllt. Diese können ergänzt oder gelöscht werden.
ServiceType: Der Wert CSW muss beibehalten werden.
ServiceTypeVersion: Der Wert 2.0.2 muss beibehalten werden.
Fees: Falls Gebühren für die Dienstinstanz anfallen, können diese hier beschrieben werden.
AccessConstraints: Falls Zurgiffsrestriktionen auf diese Dienstinstanz existieren, können diese hier beschrieben werden.

ServiceProvider

ProviderName: Es wird der Name des Dienstanbieters angegeben. Der vorhandene Wert (con terra) kann ersetzt werden.
ProviderSite: Es wird die URL zur Web-Seite des Dienstanbieters angegeben. Der vorhandene Wert (https://www.conterra.de) kann ersetzt werden.
ServiceContact: Hier wird der Kontakt zum Anbieter des Dienstes detailliert angegeben. Vorhandene Einträge können ersetzt werden.

INSPIRE Metadaten Elemente

Diese Elemente befinden sich im XML Tag inspire_ds:ExtendedCapabilities. Hier müssen lediglich zwei Einträge innerhalb von inspire_com:MetadataPointOfContact angepasst werden:

OrganisationName: Es wird der Name des Dienstanbieters angegeben. Der vorhandene Wert (con terra) kann ersetzt werden.
EmailAddress: Es wird die E-Mail-Adresse des Dienstanbieters angegeben. Der vorhandene Wert (info@conterra.de) kann ersetzt werden.

Datei languages.xml

In dieser Datei werden alle Inhalte des Capabilities-Dokumentes erfasst, die sprachabhängig sind. Hierzu zählen:

Title
Abstract

Die Datei ist für die Sprachen Deutsch und Englisch vorkonfiguriert. Falls weitere oder andere Sprachen erforderlich sind, können diese entsprechend mit angegeben und beschrieben werden. Die Akronyme der verwendeten Sprachen sind determiniert durch ISO 639-3.

Folgende Angaben sind in dieser Datei durchzuführen:

defaultLanguageCode: Hier wird die Standardsprache festgelegt (default: ger). Falls die Capabilities des Dienstes ohne sprachspezifische Parameter angefragt werden, wird diese Sprache verwendet.
language.code: Hier wird die Sprache des jeweiligen Abschnittes gemäß ISO 639-3 angegeben.
Title: Hier wird der Titel des Katalogdienstes in der Sprache angegeben, die dem language.code des Abschnittes entspricht. Dieser Text wird bei der Abfrage der Capabilities automatisch im Abschnitt ServiceIdentification.Title eingefügt.
Abstract: Hier wird eine kurze Zusammenfassung in der Sprache angegeben, die dem language.code des Abschnittes entspricht. Dieser Text wird bei der Abfrage der Capabilities automatisch im Abschnitt ServiceIdentification.Abstract eingefügt.

SSL/TLS Unterstützung

Der CSW Proxy kann für eine gesichter SSL/TLS Verbindung konfiguriert werden. Hierzu wird ein selbst-signiertes Zertifikat mit ausgeliefert. Folgende Properties zeigen die Standardeinstellungen für dieses Zertifikat:

#
# SSL configuration
#
# The format used for the keystore. It could be set to JKS in case it is a JKS file
server.ssl.key-store-type=PKCS12

# The path to the keystore containing the certificate
server.ssl.key-store=classpath:keystore.p12

# The password used to generate the certificate
server.ssl.key-store-password=changeit

# The alias mapped to the certificate
server.ssl.key-alias=ct-security

# enable SSL for this service instance
server.ssl.enabled=false

Wenn Sie eine HTTPS Verbindung einrichten wird dringend empfohlen, ein signiertes SSL/TLS Zertifikates zu verwendet. Das ausgelieferte selbst-signierte Zertifikat dient lediglich der Demonstration. Die o.g. Properties sind auf die Eigenschaften des neuen Zertifikats entsprechend anzupassen.