Startpakke tilslutning til DFDG



Målgruppe og baggrund

Denne information er henvendt til nye kommunale IT-leverandører, som skal levere systemer som skal aftagere af DFDG webservices. Siden beskriver hvad der skal til for at tilslutte sig DFDG Webservices, support, hvordan leverandøren holder sig orienteret om opdateringer mv.

Oplysninger indberettes til det fælles datagrundlag fra kommunernes og arbejdsløshedskassernes fagsystemer og via selvbetjeningsløsninger på Jobnet. Oplysningerne i det it-baserede fælles datagrundlag (DFDG) er tilgængelige for kommuner og arbejdsløshedskasserne via åbne grænseflader således, at den enkelte kommune og arbejdsløshedskasse efter eget valg kan anvende én eller flere leverandører af fagsystemer, støttesystemer m.v.

Tilslutningsaftale

Der skal foreligge en skriftlig aftale mellem en kommune eller en a-kasse og en it-leverandør om en given ydelse, hvor adgang til DFDG er nødvendig for at der kan gives adgang. Det er som dataansvarlig kommunens eller a-kassens ansvar, at den sådan aftale foreligger. Kontakt information vedr. aftaler kan findes her.

Tilslutning til DFDG

Bestilling af adgange til systemer

I nedennævnte er beskrevet en række systemer i 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.

Testcertifikat

Når adgange er på plads, kan der bestilles et Testcertifikat hos STAR Systemforvaltning (se kontaktinformation nederst på siden).

I bestillingen skal det angives hvilke webservices systemet skal kalde.

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.

Når der er udført test i testmiljø, og det er verificeret at kald mod DFDG kan gennemføres, kan åbning for adgang i Produktion bestilles hos Systemforvaltning (se kontaktinformation nederst på siden).

Whitelistning af IP Adresser 

Der kræves der whitelistning af IP-adresser for at kunne tilgå url'er i STAR's testmiljøer.
Webserviceaftagere kan anmode om whitelistning ved at oprette og tildele en Manuscript-sag til STAR Systemforvaltning på https://manuscript.star.dk, og informere om IP adresser der skal have adgang til at tilgå STAR's testmiljøer.

Dokumentation af DFDG webservices

Snitfladerne til DFDG er sammen med valideringsregler m.v. dokumenteret på https://starwiki.atlassian.net/wiki/spaces/WIKI , der indeholder STARs tekniske og forretningsmæssige webservicedokumentation. 

På WIKI’en findes bla. vejledning om https://starwiki.atlassian.net/wiki/spaces/WIKI/pages/25460751

DFDG's sikkerhedsmodel

 Det er vigtigt at nye aftagere sætter sig ind i https://starwiki.atlassian.net/wiki/spaces/FYS/pages/13926415

STAR WIKI

Al information vedrørende DFDG Webservices og miljøer udsendes fra STARs WIKI . I bør derfor sætter “Watch” på følgende sider, så I modtager mail notifikation siderne opdateres (tryk på øjet i øverste højre hjørne af siden).

Support

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 .

Tilslutning til Produktionsmiljø

Tilslutning til STARs produktionsmiljø kan ske, når den kaldende løsning er udviklet færdig og testet i STARs testmiljø. 

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 myndighedens 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. 
    Har man ikke STAR certifikatet installeret er den offentlige nøgle til STAR certifikatet (*.bm.dk
    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).

Ovennævne certifikater kan hentes her: https://starwiki.atlassian.net/wiki/spaces/WIKI/pages/1814855823

Hvornår er Produktionsadgangen klar

Der kan gå op til 5 dage før produktionsadgangen er klar.

Kontaktinfo til STAR systemforvaltning: