SFTP – Vejledning til opsætning

INDHOLDSFORTEGNELSE

• SFTP – Vejledning til opsætning
  • Hosting og godkendelse
  • Konfiguration
  • 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 for 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 den relevante SFTP-mappe. Vi understøtter nøglebaseret godkendelse. Derfor skal du oprette et sæt af offentlig og privat nøgle og indtaste den offentlige nøgle i feltet Offentlig nøgle , når du opsætter din mappe. Nøglen skal være i openSSH RSA format. Se hvordan du opretter nøgler under 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 feltet Brugernavn . Værdien i feltet 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æne-URLog Portnummer til et sikkert sted, da disse oplysninger skal bruges af det team i din organisation, der står for at sende filer til den nye mappe. 
   Bemærk: Når SFTP-mappen er sat op, kan du tilgå disse oplysninger igen under Administrer.

3. Indtast den eller de e-mailadresser, hvor du ønsker at modtage rapporter om dine filoverførsler, i feltet SFTP e-mail notifikation . Læs mere under Rapportering og håndtering af fejl nedenfor.

4. Klik på Opret forbindelse.

Når en offentlig nøgle er tilføjet, vil status som udgangspunkt stå til Ikke bekræftet. Denne status vises på OBT, indtil der modtages en fil i mappen. Du kan sende en testfil efter eget valg eller en rigtig HR-fil eller fil med brugerdefinerede felter (kun filer i understøttede formater behandles). Hvis den offentlige nøgle senere opdateres, sættes status igen til Ikke bekræftet indtil næste fil modtages.

Hvis du vil fjerne din SFTP-mappe, skal du klikke på Afbryd forbindelse. Dette sletter din SFTP-mappe. Hvis du senere ønsker at sætte den op igen, skal du indtaste alle oplysningerne fra starten igen.

Frekvens og tidsplan

Du bestemmer selv, hvor ofte og hvornår filer skal overføres. Vi starter behandlingen af filen, så snart vi registrerer, at en fil er lagt i din mappe på vores SFTP-server. Det betyder, at vores system automatisk går i gang med at behandle filen, så snart du har uploadet den. 

For anbefalinger om frekvens og tidsplan for de enkelte posttyper (fx brugere, brugerdefinerede felter, juridiske enheder), se afsnittet Frekvens og tidsplan i SFTP-vejledningen for hver posttype.

Rapportering og håndtering af fejl

Vi samler data om dine filoverførsler og bruger dem til at lave en intern rapport efter hver filoverførsel. Rapporten sendes til de e-mailadresser, du har angivet i feltet SFTP e-mail notifikation under opsætningen. For hver fil, du uploader, vil rapporten indeholde: 

• årsager til, at en filoverførsel eventuelt er mislykkedes (forkert format, manglende kolonnenavne osv.).

• årsager til, at enkelte rækker i en fil ikke kunne uploades. Vi laver ikke delvise opdateringer – hvis der er fejl i en bestemt kolonne eller et påkrævet felt mangler for en række, vil rækken fejle. 

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

Du kan bruge indholdet af rapporten til at fejlfinde. Hvis du ikke selv kan løse fejlen, er du velkommen til at kontakte teknisk support. 

Relaterede ofte stillede spørgsmål

1. Accepterer vi en inkrementel fil, der kun indeholder de poster, der skal opdateres eller tilføjes?

   • Ja

2. Skal filen, 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, du skal sende til os.

Format

• Type: Streng

• Længdekrav: Maksimal længde er 2048.

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 i Windows eller i terminalen på macOS, Linux eller UNIX:

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

Her betyder 

• -t er 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 ønsker mere detaljerede instruktioner om upload af bestemte posttyper via SFTP, kan du finde dem i følgende emner:

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