dRO - DSI Info voor software leveranciers Wim De Smet
Overleg SW-leveranciers – 15-01-2015
1
Architectuur • Service Oriented Architecture – Services onderdeel van het platform – Clients in gebruikerstoepassing
• Gelaagde architectuur – Databank – Services – Gebruikersinterface (gebruikerstoepassing): web of desktop
• Generisch en uitbreidbaar ontwerp • Integreerbaar met andere services – CRAB – GRB – ...
• Waar mogelijk volgens MAGDA standaarden – SOAP 1.2 services – Beschreven in WSDL
• Data aangeboden volgens INSPIRE en GDI • Hosting bij Afdeling Centraal Databeheer (ACD) bij LNE Overleg SW-leveranciers – 15-01-2015
2
Architectuur
Overleg SW-leveranciers – 15-01-2015
3
Rollen Gebruikers kunnen een of meerdere van de volgende 4 rollen bevatten: - Bronbeheerder: Kan (eigen) nieuwe plannen opladen, publiceren, wijzigen en verwijderen (gemeenten en provincies) - Databaheerder: Kan ieders plannen opladen, publiceren, wijzigen en verwijderen (Ruimte Vlaanderen) - Adviesverlener: Advies verlenen op bestaande dossiers - Raadpleger: Default rol, kan gepubliceerde dossiers bekijken maar niet wijzigen
Overleg SW-leveranciers – 15-01-2015
4
Databanken • Transactiedatabank – Alle opgeladen dossiers – Archief voor data dump
• Publicatiedatabanken – – – –
Alle gepubliceerde dossiers Afgeleide geografische datasets Metadata over datasets en services Bevraging van data
• Connectie met Digitale Bouwaanvraag – Goedgekeurde vergunningen die nodig zijn voor verduidelijking bij nieuwe aanvragen zullen worden gepubliceerd in het platform
Overleg SW-leveranciers – 15-01-2015
5
Modules • Transactieservice – Data bevragen en beheren in transactiedatabank – Bevragings- & beheersoperaties – Toegankelijk voor • Bronbeheerder (Dossier beheren) • Adviesverlener (Advies verlenen)
• Publicatieservice – Data bevragen in publicatiedatabank – Enkel bevragingsoperaties – Toegankelijk voor Raadpleger (=> alle rollen)
• Webloket – GUI voor beheren dossiers – Spreekt Transactieservice aan – Toegankelijk voor Bronbeheerder en Adviesverlener Overleg SW-leveranciers – 15-01-2015
6
Modules • OGC Server – – – –
Aanbieden cartografische en vectordata Web Map Service (WMS) Web Feature Service (WFS) Toegankelijk voor Raadpleger (=> alle rollen)
• Catalogus – Beschrijving geografische datasets en services – Catalogue Service for the Web (CS-W) – Beschreven aan de hand van ISO19115, ISO19119 en ISO19139 – Laat toe metadata te harvesten vanuit andere node – Toegankelijk voor Raadpleger (=> alle rollen)
Overleg SW-leveranciers – 15-01-2015
7
Web Services • SOAP Services – https://ro.ruimtevlaanderen.be/cxf/drodsi-transactieservice/services/TransactieService?wsdl – https://ro.ruimtevlaanderen.be/cxf/drodsi-publicatieservice/services/PublicatieService?wsdl
• OGC Service – https://ro.ruimtevlaanderen.be/drodsi-geoserver/ – https://ro.ruimtevlaanderen.be/drodsigeoserverproxy/<dossierid>/<dossierfase>
• Catalogus – https://ro.ruimtevlaanderen.be/drodsi-geonetwork/
Overleg SW-leveranciers – 15-01-2015
8
Web Services: ontwikkeling • SOAP Services – https://oefen.ruimtevlaanderen.be/cxf/drodsi-transactieservice/services/TransactieService?wsdl – https://oefen.ruimtevlaanderen.be/cxf/drodsi-publicatieservice/services/PublicatieService?wsdl
• OGC Service – https://oefen.ruimtevlaanderen.be/drodsi-geoserver/ – https://oefen.ruimtevlaanderen.be/drodsigeoserverproxy/<dossierid>/<dossierfase>
• Catalogus – https://oefen.ruimtevlaanderen.be/drodsi-geonetwork/
Overleg SW-leveranciers – 15-01-2015
9
Operaties • Beheersoperaties – Creeer*: Maak een nieuw Dossier/DossierFase/DossierStuk/Voorwerp aan in de database – Laad*: Maak een volledig Dossier/Voorwerp-collectie aan op basis van een – Verwijder*: Verwijder een Dossier/DossierFase/DossierStuk/Voorwerp uit de database – PubliceerDossier, HerroepDossier: Zet de status van een dossier op ‘te publiceren’ of ‘te herroepen’
• Bevragingsoperaties – Zoek*: Geef een samenvatting van Dossiers/DossierFases/Dossierstukken/Voorwerpen die aan een query beantwoorden – Geef*: Geef een volledige beschrijving van een Dossier/DossierFase/Dossierstuk/Voorwerp Overleg SW-leveranciers – 15-01-2015
10
Operaties – Maak*Zip: Creëer een downloadbare zip van een Dossier/Voorwerp-collectie
• SynchroniseerOperaties – SynchroniseerDossiers: • Opvragen alle dossiers – die veranderd in de DSI publicatiedatabank zijn – voor bepaalde gebied – en bepaalde periode
• Dossiers ophalen in batch • Vraag – Gebied – Tijdsperiode van aanpassing – Downloadformaat (ZIP ovv XML, Shape)
• Kan enkel ‘s nachts bevraagd worden (20u tot 6u)
Overleg SW-leveranciers – 15-01-2015
11
Security: Individuele gebruikers •
Web services – Authenticatie en autorisatie: • • • •
Creatie account via WebIDM, koppeling bij ACD Oproepen van de web services met credentials Controle authenticatie en autorisatie via OpenAM WebIDM bevat koppeling gebruiker – werkentiteit en gebruiker – rol, intern gemapt bij ACD
– Integriteit en vertrouwelijkheid van de berichten • 3Des encryptie: IEFT SSL/TLS (HTTPS) • Digitale handtekening: SSL / TLS X.509 Certificaten
• Loket – Authenticatie en autorisatie • Registratie gebruiker in ACM / IDM • Controle authenticatie en autorisatie via OpenAM • Login via identiteitskaart/VO token/Federaal token op authenticatie.vlaanderen.be
– Integriteit en vertrouwelijkheid van de berichten • 3Des encryptie: IEFT SSL/TLS (HTTPS)
Overleg SW-leveranciers – 15-01-2015
12
Security: Frontend software •
X.509 Certificaten – Digitale handtekening van services – Op te slaan in locale store van gebruikersapplicatie – Aangevraagd in het kader van Digitale Bouwaanvraag voor elke gemeente/provincie – Creëer CSR met CN=gemeente.be/dsi-test, CN=gemeente.be/dsi, laten tekenen door WebIDM verantwoordelijke bij gemeente. – Aanpassing aan url: http://services-ro.ruimtevlaanderen.be ipv http://ro.ruimtevlaanderen.be (om te kunnen onderscheiden van browser-gegeneerde certificaten).
Overleg SW-leveranciers – 15-01-2015
13
Security Transactieomgeving
Overleg SW-leveranciers – 15-01-2015
14
Security Publicatieomgeving
Overleg SW-leveranciers – 15-01-2015
15
Frameworks gebruikt bij DSI ontwikkeling • SOAP Services – – – – –
SOAP 1.2 MTOM met XOP JAX-WS CXF Spring
• OGC Server – OGC WMS 1.0.0 / 1.1.1 / 1.3.0 – OGC WFS 1.0.0 / 1.1.0 – Geoserver 2.1
• Catalogus – OGC CSW 2.0.2 – Geonetwork 2.8 Overleg SW-leveranciers – 15-01-2015
16
DSI SDK • Nodige informatie om DSI cliëntsoftware te ontwikkelen • Inhoud – – – – –
DSI Service interface omschrijving Bijlage beschrijving -> dossierstypes en hun bijlages WSDL & XSD voor aanspreken van services JAX-WS client JAR Voorbeeld dossier data
• Ter beschikking op Sharepoint Ruimtelijke Ordening
Overleg SW-leveranciers – 15-01-2015
17
Uitwisselingsformaten • Beschrijving uitwisselformaat wordt ter beschikking gesteld eind oktober • Uitwisselformaten – – – –
ZIP – SHAPE ZIP – XML XML SLD 1.0
Overleg SW-leveranciers – 15-01-2015
18
ZIP - SHAPE • ZIP bestand – Dossier.properties -> key-value pairs – Dossierstukken • Lijst van verplichte / optionele / conditionele bijlagen: zie xls in SDK
– Shape-bestanden • • • •
Contour: verplicht Deelgebieden: optioneel PlanElementen PlanAfgeleiden
Overleg SW-leveranciers – 15-01-2015
19
ZIP - XML • ZIP bestand – Dossier.xml conform Dossier xml (zie SDK) – Dossierstukken • Lijst van verplichte / optionele / conditionele bijlagen: zie xls in SDK
– Geometrie van contour, deelgebieden, planelementen, planafgeleiden opgenomen in Dossier.xml als WKT
Overleg SW-leveranciers – 15-01-2015
20
ZIP - XML
Overleg SW-leveranciers – 15-01-2015
21
XML • XML bestand – XML conform Dossier xml (zie SDK) – Geometrie van contour, deelgebieden, planelementen, planafgeleiden opgenomen in xml als WKT
• Dossierstukken – Worden apart ingeladen via specifieke web service • Lijst van verplichte / optionele / conditionele bijlagen: zie xls in SDK
Overleg SW-leveranciers – 15-01-2015
22
Symbologie • Geografische web services – wms / wfs
Overleg SW-leveranciers – 15-01-2015
23
SLD – Styled Layer Descriptor
Overleg SW-leveranciers – 15-01-2015
24
DSI Client Ontwikkeling • Java – – – –
JAX-WS: Client JAR in SDK (manueel) CXF: Client JAR in SDK (configuratie) SoapUI: Testen via WSDL Andere frameworks: Client genereren via WSDL
• .net – WCF: Client genereren via WSDL (getest)
Overleg SW-leveranciers – 15-01-2015
25
Uitwisselloket DSI • Voorbeeldtoepassing – aanspreken DSI web services
Overleg SW-leveranciers – 15-01-2015
26