Startpakke - Tilslutning af kommunal planner løsning (Planner Skiftespor)
Nedenfor findes information om, hvordan kommunen får tilsluttet ny kommunal Planner-løsning til DFDG..
Indledning
Den kommunale Planner skal tilsluttes Plannerskiftesporet i DFDG (Det fælles DataGrundlag).
Tilslutningsaftale
Når kommunen vælger egen kommunal plannerløsning skal der foreligge en skriftlig tilslutningsaftale til DFDG. Alle kommuner har i forvejen denne aftale, da deres Kommunale SagsSystem er koblet op mod DFDG.
Hvis kommunen vælger, at få en leverandør til at stå for udvikling og drift af kommuneklienten, skal tilslutningsaftalen suppleres med en skriftlig databehandleraftale, som giver leverandøren tilladelse til at tilgå DFDG.
Det er som dataansvarlig kommunens ansvar, at en sådan aftale foreligger.
Kontaktinformation vedr. tilslutningsaftale kan findes her.
Bestilling af adgange til systemer
I nedennævnte er beskrevet en række systemer den nye leverandør skal have adgang til, for at få adgang til Dokumentation, varslinger, support mv.
For at få adgang til systemerne skal vi bruge navn og mailadresse på de brugere i ønsker oprettet – det kan evt. være én bruger med en fællespostkasse/mail – der skal dog angives navn og mailadresse på den person, som er ansvarlig kontakt vedr. en sådan bruger.
I skal bestille adgang til følgende:
Bestilling af adgange kan ske ved fremsendelse af mail til star-systemforvaltning@startest.dk.
Drejebog for tilslutning
Processen for flytning af en kommune fra en Plannerleverandør til en anden er beskrevet i vedhæftede Drejebog for leverandørskift - Planner skiftespor.
Se også information nedenfor.
STAR Dokumentationsarkiv
Al information vedrørende DFDG Webservices og miljøer udsendes via STAR’s Dokumentationsarkiv. Det er derfor vigtigt at i abonnerer på eller holder øje med information inden for følgende områder:
- Announcements, inkl. webservicevarslinger
- Releaseplan og Indhold
- Miljøstatus
- Kalender
En vejledning til at abonnere på notifikationer fra dokumentationsarkivet.
Support
- Opret sag i Manuscript og assign den til Systemforvaltning (SF)
- Mail: star-systemforvaltning@startest.dk (opretter sag i Manuscript )
- Telefon: 72 18 30 05
STAR Systemforvaltning anvender systemet Manuscript til henvendelser vedr. support, forespørgsler mv. De leverandører der tilsluttes DFDG, skal have oprettet en bruger i Manuscript .
- Link til Manuscript systemet: https://manuscript.star.dk
- Manuscript vejledning kan findes her.
- Nye supportsager skal altid oprettes til Systemforvaltning (SF)
Dokumentation af DFDG webservices
Snitfladerne til DFDG er sammen med valideringsregler m.v. dokumenteret på https://starwiki.atlassian.net/wiki, der indeholder STARs tekniske og forretningsmæssige webservicedokumentation.
På WIKI’en findes også generel information om webservice kommunikation med DFDG.
Webservice og certifikat fra ny leverandør
Den nye leverandør skal fremsende følgende:
- Privat nøgle til SSL certifikater udstedt af den nye leverandør til henholdsvis test og produktion
- Et funktionscertifikat udstedt af den nye leverandør, som skal installeres i STARs systemer til kald af den nye leverandørs webservice.
- Den nye leverandør skal udstille en webservice jf. beskrivelse af krav til Kommunal Plannerløsning. Endpoint/url til leverandørens webservice skal fremsendes til STAR Systemforvaltning.
Testcertifikat
Når adgange er på plads, kan der bestilles et Testcertifikat hos STAR Systemforvaltning (se kontaktinformation nederst på siden).
Systemforvalter opretter et test funktions certifikat til test af webservicekald mod DFDG på STAR’s Testmiljø.
CA certifikatet skal installeres i trusted root certification authority
Funktionscertifikatet skal placeres i ”local machine/personal store”.
Testmiljø
Systemforvalter vil i forbindelse med levering af testcertifikat informere om, hvilket testmiljø der skal anvendes til test, samt endpoints til miljøet der er givet adgang til.
WSDL filer kan findes på STARs wiki under WSDL filer til DFDG Services.
Test ved tilslutning
Der skal gennemføres (mindst) følgende testtyper før første idriftsættelse af en ny kommunal Plannerløsning:
- integrationstest af løsningen udført af leverandøren af løsningen supporteret af STAR's systemforvalter. Denne skal sikre at løsningen udstiller den korrekte webservicessnitflade og i det hele taget følger de krav der er til dette bl.a. omkring sikkerhed.
- end-2-end test udført i samarbejde mellem leverandøren af løsningen og STAR's systemforvalter. Hvor det sikres at den kommunale Plannerløsning fungerer forretningsmæssigt korrekt sammen med bl.a. Jobnet.
Se testplan og testcases på STAR Dokumentationsarkiv.
Når ovennævnte tests er udført i testmiljø, og det er verificeret at kald mellem DFDG og Plannerløsning kan gennemføres, kan åbning for adgang i Produktion bestilles hos Systemforvaltning (se kontaktinformation nederst på siden).
Tilslutning til Produktionsmiljø
Kommunen/Myndigheden skal bestille et produktionscertifikat til løsningen med kommunens CVR via kommunens LRA (det er som regel samme person, der udsteder medarbejdercertifikater som er ansvarlig for bestilling af denne type certifikat).
I certifikatnavn skal indgå: Navnet på det system der skal kalde DFDG samt myndighedsnavnet.
STAR Systemforvaltning skal give adgang til, at Kommunens Funktionscertifikat kan kalde servicen. For at vi kan gøre det, skal i gøre følgende:
- Kommunen skal "banke på" med funktionscertifikatet i Produktionsmiljøet. For at gøre dette skal certifikatet installeres i ”current user/personal store”.
- Herefter banker man på ved at gå på https://amportal.bm.dk/amp/ , og vælge knappen under DFDG og derefter vælge Kommunens funktionscertifikat. Man får nu besked om, at funktionscertifikatet endnu ikke er oprettet - og man har dermed banket på.
- Når der er banket på med kommunens funktionscertifikat, kan man kontakte STAR Systemforvaltning og bestille åbning, så sørger vi for at certifikatet bliver konfigureret.
- Når Kommunen herefter skal kalde servicen, skal Kommunens Funktionscertifikat være installeret i ”local machine/personal store”.
- Hul igennem test før vi åbner for adgang til Certifikatet kan udføres således:
Kald en af de DFDG services aftager systemet skal kalde. Hvis den følgende fejlbesked modtages er det verificeret at kald vil gå igennem til DFDG når vi åbner: "You are not authorized"
Implementering af offentlig nøgle
- For at være i stand til at kalde servicen, skal det kontrolleres at den offentlige nøgle til STAR certifikatet (*.bm.dk) er installeret. Certifikatet skal ligge lokalt på serveren i certifikatstore under ”Local Machine/Personal/Certificate”.
Har man ikke STAR certifikatet installeret er den offentlige nøgle til STAR certifikatet (*.bm.dk) kan den bestilles hos STAR Systemforvaltning (Se nedenfor).
Certifikatet skal installeres (lokalt på serveren i certifikatstore under ”Local Machine/Personal/Certificate”). - Det skal herudover kontrolleres om rodcertifikatet (Globalsign) er installeret på serveren. Hvis man ikke har rodcertifikatet, kan man kontakte STAR Systemforvaltning (Se kontaktinformation nederst på siden).
Hvornår er Produktionsadgangen klar
Der kan gå op til 5 dage fra bestilling til produktionsadgangen er klar.