SUP dokumentation - Anvendelse af FTP

Owned by Peter Tilsted
Last updated: Nov 29, 2021
4 min read

INDHOLDSFORTEGNELSE

Indledning

Dokumentets formål

Dette dokument har til formål at vejlede aftagere af data på STAR's udstillingsplatform (SUP) i brug SUP's FTP server

Vigtigt

  • Bemærk at alle henvendelser vedr. adgang til FTP-server skal rettes til BI/Backend eller STAR's systemforvalter via FogBugz

  • Bemærk at beskrivelsen af Dataområder (BILAG) kan blive justeret.

Adgang

Bestilling af bruger

For at kunne hente data, skal Aftager have en bruger til ftp://ftpams.bm.dk. Denne bestilles via FogBugz https://manuscript.star.dk/, hvor der oprettes en sag til BI/Backend.
Vejledning til FogBugz finder du i den generelle SUP dokumentation: Bestillingen skal indeholde oplysning om:

  • Virksomhed (aftager)

  • Kontakt navn

  • Kontakt E-mail

  • Kontakt mobilnummer

  • Kode og navn på myndighed / myndigheder der skal leveres data for

  • Nummer og navn på dataområder

  • Startdato eller "Hurtigst muligt"

Eksempel:

 

Proces for godkendelse og oprettelse af bruger

Bestillingen håndteres af BI/Backend, Systemforvaltningen, STAR og STARs applikationsdriftsleverandør (KMD) i fællesskab:

  • BI/Backend udfylder på baggrund af de i FB-sagen modtagne oplysninger rekvisition om oprettelse. Der tilføjes blandt andet oplysning om FTP brugernavn, så denne overholder den fastlagte standard

  • Rekvisitionen vedhæftes FB-sagen, der assignes til STAR til evt. godkendelse

  • STAR vurderer om de nødvendige formalia er overholdt. Er formalia overholder, assignes FB-sagen til Systemforvaltning, ellers returneres den til BI/Backend.

  • Systemforvaltning ekspederer FB-sagen og bestiller oprettelse hos KMD (Systemleverandør)

  • KMD opretter bruger og tildeler password. Brugeroplysninger sendes til "Kontakt E-mail", password til "Kontakt Mobilnummer". Systemforvalter orienteres om at bruger er oprettet

  • Systemforvalter opdaterer FB-sagen og returnerer den til BI/Backend

  • BI/Backend og Aftager tester i fællesskab brugeradgang via PreProd.

  • BI/Backend Resolver FB-sagen og sender den retur til opretter (Aftager)

  • Aftager lukker FB-sagen.

Regler for FTP bruger

Brugeren er omfattet af de almindelige krav gældende på STAR, hvilket betyder, at Passwords skal overholder følgende krav:

  • Mindst 10 tegn.

  • Må ikke indeholde dele af brugernavnet.

  • Seneste 24 passwords må ikke genbruges.

  • Skal indeholde mindst 3 af følgende 4 kategorier:

    • Skal indeholde mindst ét stort bogstav (A - Z).

    • Skal indeholde mindst ét lille bogstav (a - z).

    • Skal indeholde mindst ét tal (0 - 9).

    • Skal indeholde mindst ét special tegn (f. eks. !, $, #, %)

På FTP Serveren er der pt. ingen udløbsdato for passwords, men det forventes at der fra revisionens side vil komme krav om password ændring hver 42. dag.

Folder beskrivelse

Organisering og navngivning

På SUP FTP er data organiseret med en hovedfolder for hver myndighed (kommune) og herunder subfolder for hvert Dataområde.
Hovedfoldere er navngivet med det 3-cifrede kommunenummer (se bilag).
Subfoldere med Dataområder er navngivet med en tildelt 2-cifret kode, der anvendes som tværgående identifikation, blandt andet som link til dokumentation (se bilag)
Under hver Dataområder ligger 2 foldere, én med "Delta" leverancer, en med ét sæt "Full" leverance.
Første datapakke er kodelister og hvis en sådan skal hentes for Københavns kommune er dette stien: \101\01\Full\kodeliste.csv
Organiseringen kan visuelt beskrives således:

Teknisk dokumentation

Pre-Produktion og Produktion

Bestillingen af adgang til FTP, udløser oprettelse af 2 brugere, én til STAR's Pre-Produktion miljø og én til STAR's produktionsmiljø.
Brugeren til Pre-Produktion, benyttes primært til test af funktionalitet for afhentning af data.
På Pre-Produktion er strukturen den samme som beskrevet herover, men der vil kun ligger data Dataområde 01 Kodelister.
Pre-Produktion vil blive anvendt som udvekslingspunkt for aftagere, der ønsker at deltage i teste af nye datapakker.

Adgang til Pre-Produktion - 131.165.62.66

Tilgås via IP adressen 131.165.62.66
FTP serveren vil tillade kommunikation via port 22 (SFTP) og via port 990 (FTPS) på port ranges fra 25580 - 25600
Hvis der skal laves ændringer i aftagers firewall for at kunne kommunikere med 131.165.62.66, skal der åbnes op for nedenstående:
IP adresse: 131.165.62.66 port 22
IP adresse: 131.165.62.66 port 990
IP adresse: 131.165.62.66 port range 25580 til 25600

Adgang til Produktion - ftp://ftpams.bm.dk

Tilgås via navnet ftp://ftpams.bm.dk eller via IP adressen 131.165.62.135
FTP serveren skal tillade kommunikation via port 22 (SFTP) og via port 990 (FTPS) på port ranges fra 25580 - 25600
Hvis der skal laves ændringer i aftagers firewall for at kunne kommunikere med ftp://ftpams.bm.dk, skal der åbnes op for nedenstående:
IP adresse: 131.165.62.135 port 22
IP adresse: 131.165.62.135port 990
IP adresse: 131.165.62.135 port range 25580 til 25600

BILAG – Kommunenumre (hoved folder)


101København
147Frederiksberg
151Ballerup
153Brøndby
155Dragør
157Gentofte
159Gladsaxe
161Glostrup
163Herlev
165Albertslund
167Hvidovre
169Høje-Taastrup
173Lyngby-Taarbæk
175Rødovre
183Ishøj
185Tårnby
187Vallensbæk
190Furesø
201Allerød
210Fredensborg
217Helsingør
219Hillerød
223Hørsholm
230Rudersdal
240Egedal
250Frederikssund
253Greve
259Køge
260Halsnæs
265Roskilde
269Solrød
270Gribskov
306Odsherred
316Holbæk
320Faxe
326Kalundborg
329Ringsted
330Slagelse
336Stevns
340Sorø
350Lejre
360Lolland
370Næstved
376Guldborgsund
390Vordingborg
400Bornholm
410Middelfart
420Assens
430Faaborg-Midtfyn
440Kerteminde
450Nyborg
461Odense
479Svendborg
480Nordfyns
482Langeland
492Ærø
510Haderslev
530Billund
540Sønderborg
550Tønder
561Esbjerg
563Fanø
573Varde
575Vejen
580Aabenraa
607Fredericia
615Horsens
621Kolding
630Vejle
657Herning
661Holstebro
665Lemvig
671Struer
706Syddjurs
707Norddjurs
710Favrskov
727Odder
730Randers
740Silkeborg
741Samsø
746Skanderborg
751Århus
756Ikast-Brande
760Ringkøbing-Skjern
766Hedensted
773Morsø
779Skive
787Thisted
791Viborg
810Brønderslev
813Frederikshavn
820Vesthimmerlands
825Læsø
840Rebild
846Mariagerfjord
849Jammerbugt
851Aalborg
860Hjørring

BILAG – Dataområder (sub folder)


01 Kodelister Codelists indeholdende masterdata , der alene opdateres i forbindelses med de 4 årlige releases.
02 Aktiviteter Aktiviteter fra Plan-data indeholdende Virksomhedsrettede aktiviteter, Kurser, Hjælpemidler og Personlig assistance, der har til formål at bringe borgeren tættere på et job eller en uddannelse.
03 Borgerdata Borgerdata indeholder borgerspecifikke grundregistreringer, herunder CPR-nummer, CPR status, Kommunekode, Jobcenter kode og DFDG postnummer.
04 Grupper Kontaktgrupperegistrering, Visitationsgrupper, Til og afmelding

06 Planer Planer fra Plan-data
07 Booking En pakke bestående af diverse relevante samtale-data – Booking, Selv- booking, Ledige tider og Frister
08 Samtaler Afholdte samtaler


Tilgængelighed: https://starwiki.atlassian.net/was