Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Lantmäteriet Datasource sköter autentisering och kommunikation mellan Weave och Lantmäteriet och fungerar som en hub för komponenter som är kopplad mot den, som spatiala kopplingar, data definitioner och övriga tjänster. För att kunna skapa en anslutning måste först en “Application“ sättas upp i API-portal hos Lantmäteriet. Guide för uppsättning finns hos Lantmäteriet: https://www.lantmateriet.se/sv/Kartor-och-geografisk-information/geodataprodukter/api-portalen/.

Från den “Application“ i API-portalen som Weave ska använda sig av är det framför allt consumerKey och consumerSecret som Weave behöver känna till för att periodvis kunna generera en nyckel. Om scope används ska det fyllas i konfigurationen också. Scope kan även användas för att särskilja flera instanser som använder samma “Application“ i API-portalen, exempelvis en driftmiljö och en testmiljö. Används samma scope i två miljöer finns risken att de invaliderar varandras nycklar. Läs mer om scope och hur de ska namnges i Lantmäteriets dokumentation.

Namespace

urn:se.viamap.lantmateriet.direkt.source#1.0

Tags

config

Attribut

Namn

Typ

Krävs

Default

Beskrivning

id

string

ja

Unikt id

host

string

ja

URL till tjänster, exempelvis https://api.lantmateriet.se

consumerKey

string

ja

Consumer key för den applikation som Weave ska använda (från API-portal)

consumerSecret

string

ja

Consumer secret för den applikation som Weave ska använda (från API-portal).

Används av Weave för att generera ny API-nyckel vid jämna mellanrum.

scope

string

nej

Möjlighet att sätta en eller flera scope och som används när en nyckel genereras hos Lantmäteriet.

Kan bl.a. vara nödvändig om flera program använder sig av en “Application“ i API-portal

timeout

integer

nej

3 sekunder

Anger maxtiden för anslutning mot Lantmäteriet

readTimeout

integer

nej

30 sekunder

Anger maxtiden för anrop mot Lantmäteriet

disableTests

boolean

nej

false

Sätt till true för att inaktivera validering av anslutningen

testInterval

integer

nej

60 000

millisekunder mellan test när anslutningen fungerar (minst 15 000)

testIntervalWhileFailing

integer

nej

15 000

millisekunder mellan test när anslutningen felar (minst 5 000)

testFailingDuration

integer

nej

300 000

Hur lång tid innan felande anslutning konstateras felaktig (minst 60 000)

testIntervalWhenFailed

integer

nej

600 000

millisekunder mellan test när anslutningen konstaterats felaktig (minst 120 000)

Info

Kryptering av consumerSecret

consumerSecret kan med fördel krypteras. I Weave OSGI console, använd kommandot encrypt följt det faktiska consumerSecret. Ersätt consumerSecret i konfigurationen med resultatet. Exempel:

osgi> encrypt 1234567890
ENCBJZSJQEKPSUMXPACBXCKTTZQPCXJEZGM

Code Block
languagexml
<?xml version="1.0" encoding="UTF-8"?>
<config xmlns="urn:com.cohga.server.config#1.0" xmlns:lmsource="urn:se.viamap.lantmateriet.direkt.source#1.0">

  <!-- Enkel anslutning till Lantmäteriet-->
  <lmsource:config id="lmsource.main.simple">
		<host>https://api-ver.lantmateriet.se</host> <!-- Notera api-ver är testmiljö -->
		<consumerKey>yourConsumerKeyGoesHere</consumerKey>
		<consumerSecret>ENCUFMECJTEXCTCBSXJBBFAFEQQQSPSUUZPSGEJSEGZXUPCXJTTSUCKJMPTXEKBQSUK</consumerSecret>
  </lmsource:config>
  
  <!-- Anslutning med mer konfiguration till Lantmäteriet-->
  <lmsource:config id="lmsource.main">
		<host>https://api.lantmateriet.se</host> <!-- Notera driftmiljö -->
		<consumerKey>yourConsumerKeyGoesHere</consumerKey>
		<consumerSecret>ENCUFMECJTEXCTCBSXJBBFAFEQQQSPSUUZPSGEJSEGZXUPCXJTTSUCKJMPTXEKBQSUK</consumerSecret>
		<scope>device_weave1</scope>
		<timeout>15</timeout>
		<disableTests>false</disableTests>
		<testInterval>60000</testInterval>
		<testIntervalWhileFailing>15000</testIntervalWhileFailing>
		<testFailingDuration>300000</testFailingDuration> 
		<testIntervalWhenFailed>600000</testIntervalWhenFailed>
  </lmsource:config>
  
</config>