Einbindung geschützter Dienste

Zur Einbindung geschützter Dienste des BKG innerhalb einer Webanwendung, können dem BKG registrierte Benutzer einen Applikationsschlüssel beantragen. Wenden Sie sich dazu bitte an das Dienstleistungszentrum. Nach Erhalt des Applikationsschlüssels kann die Anwendung mit den freigeschaltenen Diensten konfiguriert werden.

Unabhängig vom eingesetzten Framework bietet das BKG zwei Optionen zur Authentifizierung geschützter Dienste via Applicationsschlüssel an:

Verwendung einer SessionID per URL zur Authentifizierung
Bei der Initialisierung der Anwendung muss ein Session-Token generiert werden, welches beim Aufruf der geschützten Dienste angegeben wird. Dieses Token ist für einen begrenzten Zeitraum gültig.
Verwendung einer SessionID per Cookie zur Authentifizierung
Hierbei wird innerhalb der Browsersitzung ein Cookie gesetzt, welches zur Authentifzierung herangezogen wird. Dies setzt voraus, dass Drittanbietercookies für die Domain sg.geodatenzentrum.de im Browser zugelassen sind. Daher empfehlen wir die Verwendung einer SessionID per URL.
Beachten Sie hierzu auch die Hinweise zur Aktivierung von Drittanbieter-Cookies

geo.okapi mit SessionID per URL

Der Applikationsschlüssel und die Domain der Anwendung müssen in über die Security-Optionen definiert werden:


    new okapi.MapBuilder()
             // ...
             .setSecurity({
               appID: "IHR_API_KEY",
               appDomain: "IHRE_APP_DOMAIN"
             })
             // ...
  

geo.okapi mit SessionID per Cookie

Der Applikationsschlüssel muss beim Aufruf der Javascript-Bibliothek im URL-Parameter bkg_appid übergeben werden:


<script src="https:/sgx.geodatenzentrum.de/geo.okapi/v1.0/dist/geo.okapi.min.js?bkg_appid=IHR_API_KEY"></script>