DHO – Web Services Resultaten Ricky Nuyens – EDS-Telindus

Agenda Technische Architectuur Versiebeheer Web Service Veranderingen Client Side SSL Volgende stappen

Technische Architectuur

Technische Architectuur upload 3 Unix ACM Student internet XCom Transfer 2 offload Cert 1 Mainframe DB2 Unix Instellingen PEP Onderwijs & Vorming

Versiebeheer

Versiebeheer URL OperatieMetadata XML Voorbeeld https://webservice.vlaanderen.be/OnderwijsEnVorming/DHO/InschrijvingDienst_vX_y OperatieMetadata Het OperatieMetaData element bevat de Versie en de Naam van de operatie De inhoud van deze elementen staat vast door de beschrijving van het XML Schema en kan NIET veranderd worden Zowel in Verzoek als Repliek Operationele Ondersteuning XML Voorbeeld <wsdlsoap:address location="https://webservice.vlaanderen.be/OnderwijsEnVorming/DHO/InschrijvingDienst_v1_1/" />  <xs:element name="Versie" fixed="1.1" type="xs:string"></xs:element> in OperatieMetaData.xsd

Versiebeheer Service (WSDL) Grote wijziging Kleine wijziging vX_y notatie Service (WSDL) Grote wijziging Kleine wijziging Verwijderen of hernoemen operatie Grote wijziging op minstens 1 operatie Toevoegen operatie Kleine wijziging op operatie Operatie(XSD) Grote wijziging Kleine wijziging Elke wijziging waarbij de xml berichten (verzoek en repliek) conform de oude versie van de xsd, NIET meer conform de nieuwe versie van de xsd zijn (exclusief het versie veld). Toevoegen van een verplicht veld … Bij Verzoek vergroten variabele lengte optioneel veld toevoegen enumeraties uitbreiden Bij Repliek verkleinen lengte enumeraties beperken optioneel veld verwijderen

Web Service Veranderingen

Diensten overzicht Ongewijzigd Gewijzigd Gewijzigd Nieuwe Nieuwe TestDienst InschrijvingDienst StudentDienst ResultaatDienst DiplomaDienst Gewijzigd Nieuwe Nieuwe

TestDienst Ongewijzigde dienst TestDienst_v1_0 VerifieerBasisveiligheid_v1_0

Gewijzigde Dienst Nieuwe “grote” versie InschrijvingDienst Gewijzigde Dienst Nieuwe “grote” versie InschrijvingDienst_v2_0 SchrijfStudentInVoorOpleiding_v1_1 SchrijfStudentInVoorOpleidingsonderdeel _v1_1 AnnuleerInschrijvingVoorOpleiding_v1_1 AnnuleerInschrijvingVoorOpleidingsonderdeel_v1_1 SchrijfStudentUitVoorOpleiding_v1_1 SchrijfStudentUitVoorOpleidingsonderdeel_v1_1 AnnuleerUitschrijvingVoorOpleiding_v1_1 AnnuleerUitschrijvingVoorOpleidingsonderdeel_v1_1 WijzigInschrijvingVoorOpleiding_v1_1 WijzigInschrijvingVoorOpleidingsonderdeel_v1_1 RaadpleegLijstInschrijvingen_v1_1 RaadpleegInschrijving_v2_0 Gewijzigde operatie Nieuwe “grote” versie

Nieuwe “kleine” versie StudentDienst Gewijzigde Dienst Nieuwe “kleine” versie StudentDienst_v1_2 RaadpleegLeerkredietsaldo_v1_1 RaadpleegGegevensSecundairOnderwijs_v1_0 Buiten bereik ZoekStudent : Op basis van student gegevens het RR-/BIS-nummer vinden Nieuwe operatie

ResultaatDienst Nieuwe dienst ResultaatDienst_v1_0 RegistreerResultaat_v1_0 RegistreerVerworvenStudiepuntenInUitwisseling_v1_0 WijzigResultaat_v1_0 AnnuleerResultaat_v1_0 AnnuleerVerworvenStudiepuntenInUitwisseling_v1_0

DiplomaDienst Nieuwe dienst DiplomaDienst_v1_0 RegistreerDiploma_v1_0 AnnuleerDiploma_v1_0

Use case <–> Web Service - Operatie Actor Use Case RaadpleegLeerkredietSaldo Verzoek Vragen Instelling Vraag Vraag Vraag Student Repliek Domein Antwoorden Vraag Vraag Antwoord Instelling Inschrijving Meeste gevallen is er een een-een relatie tussen use case en operatie … maar er zijn ook uitzonderingen waarbij 1 use case gerealiseerd wordt door meerdere operaties : RaadpleegInschrijvingen en SchrijfStudentInVoorOpleiding StudentDienst WSDL Functioneel Technisch

Publicatie https://team.vlaanderen.be/ov/onderwijsenvorming/DHO/default.aspx Onder de hoofding “Technische Documenten” staan alle documenten nodig voor de implementatie van de web services

Publicatie DHO_Diensten_V2_0RC1.zip (z01, z02, z03) (uitpakken in C:\temp) Document XML Richtlijnen Technisch Ontwerp Webservices Generiek InschrijvingDienst O&V_DHO_DienstSpecificatie_InschrijvingDienst.doc Operaties default.html …. Domein ResultaatDienst StudentDienst …

Publicatie dho-Toelichting-gepubliceerde-zip-bestanden_v2.0.doc dho-DienstSpecificatie-Wijzigingshistoriek_v2.0.doc DHO_Bevindingen_WebServices_v2.0RC1-naam-instelling.xls O&V_DHO_FunctioneleAnalyseTG1_V01.08_TG2_V01.03.zip Functionele Analyse TG1 & TG2 Klassemodel

Client Side SSL

Client Side SSL Laatste stap in ultieme beveiliging Stappenplan IP gebaseerd Server certificaat Client certificaat Stappenplan Einddoel : 2 omgevingen met client side ssl webservice.vlaanderen.be (nu enkel server side ssl) webservice-iio.vlaanderen.be Altijd een overgangsperiode voorzien voor elke omgeving met server side ssl webservice-wss.vlaanderen.be webservice-iio-wss.vlaanderen.be

1 Dec 2008 1 9 Jan 2009 Geen DigSig Geen DigSig Geen DigSig Geen Prod Geen DigSig Prod Geen DigSig Prod Geen DigSig Prod Geen DigSig Prod C-SSL DigSig Prod C-SSL DigSig v2_0 v2_0 v2_0 v2_0 webservice.vlaanderen.be Prod Geen DigSig Prod Geen DigSig v2_0 v2_0 webservice-wss.vlaanderen.be Acc C-SSL DigSig Acc C-SSL DigSig Acc C-SSL DigSig v2_0 v2_0 v2_0 webservice-iio.vlaanderen.be Acc Geen DigSig Acc Geen DigSig Acc Geen DigSig Acc Geen DigSig Acc Geen DigSig v2_0 v2_0 v2_0 v2_0 webservice-iio-wss.vlaanderen.be Nu Stap 1 Stap 2 Stap 3 Stap 4 Stap 5 1 Dec 2008 1 9 Jan 2009 page 21 21

Volgende Stappen

Werk Product Nazicht Nakijken van de WSDL en XSD’s Opmerkingen per dienst Bemerkingen worden Geconsolideerd Geëvalueerd Gecommuniceerd via forum/rechtstreeks Feedback ten laatste tegen 1 Nov 2008

Vragen

DHO – Web Services Resultaten Ricky Nuyens – EDS-Telindus