SFTP – Sådan kommer du i gang

INDHOLDSFORTEGNELSE

• SFTP – Sådan kommer du i gang
  • Hosting og godkendelse
  • Opsætning
  • Frekvens og tidsplan
  • Rapportering og håndtering af fejl
    • Relaterede ofte stillede spørgsmål
  • Sådan opretter du en offentlig SSH-nøgle til SFTP-serveren
    • Format
    • Mønster
    • Oprettelse af SSH-nøgler
    • Eksempel på nøgle
  • Vejledning til specifikke posttyper

Hosting og godkendelse

Vi opretter din SFTP-mappe på en dedikeret SFTP-server (via AWS). Hver kunde får sin egen brugerkonto med adgang direkte til deres egen SFTP-mappe. Vi understøttergodkendelse med nøglepar. Derfor skal du oprette et offentligt og et privat nøglepar og indsætte den offentlige nøgle i feltetOffentlig nøgle, når du opsætter din mappe. Nøglen skal være iopenSSH RSA-format. Hvis du vil oprette nøglerne, kan du se Sådan opretter du en offentlig SSH-nøgle til SFTP-serveren nedenfor.

Konfiguration

1. Indtast den offentlige nøgle, du har oprettet, i feltet Offentlig nøgle. Du har også mulighed for at ændre brugernavnet i Brugernavn feltet. Værdien i Brugernavn skal starte med et bogstav, tal eller en understregning og være mellem 3 og 100 tegn lang. Det er tilladt at bruge bogstaver, tal, understregning, snabel-a (@), punktum (.) og bindestreg (-).

2. Kopiér Brugernavn, Spotnana-domænets URL og portnummer-værdierne til et sikkert sted, da de skal bruges senere af det team i din organisation, som skal sætte filoverførslen op til den nye mappe. 
   Bemærk:Når din SFTP-mappe er oprettet, kan du altid finde disse oplysninger igen under Administrer.

3. Indtast den eller de e-mailadresser, hvor du ønsker at modtage rapporter om dine filoverførsler.SFTP e-mail notifikation. Hvis du vil vide mere, kan du læse afsnittet Rapportering og fejlhåndteringnedenfor.

4. KlikOpret forbindelse.

Når en offentlig nøgle er blevet tilføjet, vil den indledende status blive sat tilIkke bekræftet. Denne status vises i OBT, indtil der modtages en fil i mappen. Du kan sende en testfil eller en rigtig HR-fil eller specialfil (bemærk, at kun filer i understøttede formater bliver behandlet). Hvis den offentlige nøgle senere ændres, vil status igen blive sat til Ikke bekræftet, indtil næste fil modtages.

For at fjerne din SFTP-mappe, skal du klikkeAfbryd forbindelse. Dette sletter din SFTP-mappe. Hvis du senere får brug for at oprette den igen, skal du indtaste alle oplysningerne fra starten som beskrevet ovenfor.

Frekvens og planlægning

Du bestemmer selv, hvor ofte og hvornår du vil uploade filer. Vi starter behandlingen af filen, så snart den er oprettet på vores SFTP-server. Det betyder, at så snart du lægger en fil i din mappe hos os, går vores system straks i gang med at behandle den. 

Hvis du vil have anbefalinger om, hvor tit og hvornår du bør uploade for de enkelte typer af data (f.eks. brugere, brugerdefinerede felter, juridiske enheder), kan du se mere i Frekvens og planlægning afsnittet i SFTP-vejledningen for hver datatype.

Rapportering og fejlhåndtering

Vi registrerer dine filuploads og bruger disse oplysninger til at lave en intern rapport efter hver upload. Rapporten sendes til den eller de e-mailadresser, du har angivet i SFTP e-mail notifikation feltet under opsætningen. For hver fil vil rapporten indeholde: 

• årsager til, at en filupload evt. er mislykkedes (forkert format, manglende kolonnenavne m.m.).

• årsager til, at en række i filen ikke kunne uploades. Vi laver ikke delvise opdateringer – hvis der er fejl i en bestemt kolonne eller et påkrævet felt mangler, bliver rækken afvist. 

• status for uploaden (afventer, gennemført, mislykket).

Du kan bruge rapporten til at finde og rette fejl. Hvis du ikke selv kan løse problemet, er du velkommen til at kontakte teknisk support. 

Relaterede ofte stillede spørgsmål

1. Kan vi sende en fil, der kun indeholder de poster, som skal opdateres eller tilføjes?

   • Ja

2. Skal den fil, du uploader (uanset om det sker via SFTP eller manuelt), indeholde valgfrie kolonner, selvom du ikke bruger dem?

   • Nej

Sådan opretter du en offentlig SSH-nøgle til SFTP-serveren

Følg vejledningen herunder for at oprette den offentlige SSH-nøgle, som du skal sende til os.

Format

• Type: Streng

• Længdekrav: Må højst være på 2048 tegn.

Mønster

 ^ssh-rsa\s+[A-Za-z0-9+/]+[=]{0,3}(\s+.+)?\s*$

Oprettelse af SSH-nøgler 

For at oprette SSH-nøgler skal du køre denne kommando i kommandoprompten på Windows eller i terminalen på macOS, Linux eller UNIX:

ssh-keygen -t rsa -b 4096 -f key_name

Her betyder 

• -t angiver krypteringstype

• -b er nøglens længde (i bits)

• -f er navnet på nøglen

Eksempel på nøgle

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDDJB9oBRPrBegMDPEQo+HmNDb/jKUJL6q2kQpNNMDjNps9mhhwJ1dP/lOavMitBPAndeXlwaNEm2XbGaSrZtD/tbQTX1HQjP6pacy+Alf8kYBm5QFfl/Z6lGC8qHys10fpRXgYE7UhdSv6VyRqt1gELGFQwVBZ2kJJuBGJF1IRywwvG/h68B8iWU1+6KEWYQoUcT45r3j3otnx4NhhzpTiNgDbMk0ix+kar4/IstobRLcb7rt7FoUerTLNrVDi69DqbsGY5LN+NM8jVx0sPQLRC/ruil8pTHP3k4rDCc7a80+sH4sUTW+mHc7MTqbi/CcyyFAD8h7p6WqxEydOaJjMnvqAbE17BOj0TSxv3HMohTf3skzE7PbzVcjIfHTpFPGxmJkghAYAMi5l9VvAs91IpVylxjqPss3xQQJIZEmQdG2k7zk/UpsUFlmaOj6lCHRicFKCixKekzzm3nFuJvDEklurtydOQjZ8WkPzTSJfZBdKMuMUi0SQ9m9ZAw99t0=

Vejledning for specifikke posttyper

Hvis du har brug for mere detaljerede instruktioner til at uploade bestemte posttyper via SFTP, kan du finde dem under følgende emner:

• HR-feeds (brugere)
• Brugerdefinerede felter
• Kontorer
• Juridiske enheder