SFTP – Veiledning for oppsett

INNHOLDSFORTEGNELSE

• SFTP – Veiledning for oppsett
  • Lagring og autentisering
  • Konfigurasjon
  • Frekvens og tidsplan
  • Rapportering og feilhåndtering
    • Relaterte vanlige spørsmål
  • Slik lager du en offentlig SSH-nøkkel til SFTP-serveren
    • Format
    • Mønster
    • Opprette SSH-nøkler 
    • Eksempel på nøkkel
  • Veiledning for spesifikke registertyper

Lagring og autentisering

Vi lagrer SFTP-mappen din på en egen SFTP-server (via AWS). Hver kunde får en unik brukerkonto med tilgang kun til sin egen SFTP-mappe. Vi benytter nøkkelbasert autentisering, så du må opprette et nøkkelpar (offentlig og privat nøkkel) og legge inn den offentlige nøkkelen i feltet Offentlig nøkkel når du setter opp mappen. Nøkkelen må være i openSSH RSA format. For å opprette nøklene, se Slik lager du en offentlig SSH-nøkkel til SFTP-serveren nedenfor.

Konfigurasjon

1. Skriv inn den offentlige nøkkelen du har laget i feltet Offentlig nøkkel . Du kan også endre Brukernavn om ønskelig. Verdien i feltet Brukernavn må starte med en bokstav, et tall eller en understrek, og være mellom 3 og 100 tegn lang. Det er tillatt å bruke bokstaver, tall, understrek, alfakrøll (@), punktum (.) og bindestrek (-).

2. Kopier Brukernavn, Spotnana-domene-URLog Portnummer til et sikkert sted, da disse opplysningene trengs av de i virksomheten din som skal sette opp sending av filer til den nye mappen. 
   Obs: Når SFTP-mappen er satt opp, kan du finne disse verdiene igjen under Administrer.

3. Skriv inn e-postadressen(e) du ønsker å motta rapporter om filopplastinger til i feltet SFTP e-postvarsling . For mer informasjon, se Rapportering og feilhåndtering nedenfor.

4. Klikk Koble til.

Når en offentlig nøkkel er lagt til, vil statusen først vises som Ikke verifisert. Dette er statusen som vises i OBT frem til det faktisk er mottatt en fil i mappen. Du kan sende inn en testfil du selv velger, eller en faktisk HR-feed eller fil med egendefinerte felt (kun støttede filformater blir behandlet). Dersom den offentlige nøkkelen senere blir oppdatert, settes statusen tilbake til Ikke verifisert helt til neste fil mottas.

For å fjerne SFTP-mappen din, klikk på Koble fra. Dette vil fjerne SFTP-mappen din. Dersom du senere ønsker å sette den opp på nytt, må du legge inn all informasjonen som er beskrevet ovenfor fra starten av.

Frekvens og tidsplan

Du bestemmer selv hvor ofte og når filer skal lastes opp. Vi bruker tidspunktet filen legges til som utløser for behandlingen. Det betyr at så snart du overfører en fil til mappen din på vår SFTP-server, starter applikasjonen vår å behandle opplastingen. 

For anbefalinger om frekvens og tidsplan for ulike registertyper (for eksempel brukere, egendefinerte felt, juridiske enheter), se Frekvens og tidsplan seksjonen i SFTP-veiledningen for hver registertype.

Rapportering og feilhåndtering

Vi samler inn informasjon om filopplastingene dine og bruker dette til å lage en intern rapport etter hver opplasting. Denne rapporten sendes til e-postadressen(e) du oppga i feltet SFTP e-postvarsling under oppsettet. For hver fil du laster opp, vil rapporten inneholde: 

• årsaker til at en filopplasting eventuelt har feilet (feil format, manglende kolonnenavn osv.).

• årsaker til at en rad i filen ikke kunne lastes opp. Vi støtter ikke delvise oppdateringer, så dersom det er feil i en bestemt kolonne eller et obligatorisk felt mangler for en rad, vil raden feile. 

• status for opplastingen (venter, vellykket, feilet).

Du kan bruke innholdet i denne filen til å feilsøke eventuelle problemer. Får du ikke løst feilen selv, kan du ta kontakt med brukerstøtte. 

Relaterte vanlige spørsmål

1. Godtar vi en inkrementell fil som kun inneholder de postene som skal oppdateres eller legges til?

   • Ja

2. Må filen du laster opp (enten via SFTP eller manuelt) inneholde valgfrie kolonner selv om du ikke bruker dem?

   • Nei

Slik lager du en offentlig SSH-nøkkel til SFTP-serveren

Bruk veiledningen nedenfor for å lage den offentlige SSH-nøkkelen du skal sende til oss.

Format

• Type: Streng

• Lengdebegrensning: Maksimalt 2048 tegn.

Mønster

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

Opprette SSH-nøkler 

For å opprette SSH-nøkler, kjør denne kommandoen i ledeteksten i Windows eller i terminalen på macOS, Linux eller UNIX:

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

Der 

• -t er krypteringstype

• -b er nøkkellengde (i biter)

• -f er navnet på nøkkelen

Eksempel på nøkkel

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

Veiledning for spesifikke registertyper

For mer informasjon om hvordan du laster opp bestemte registertyper via SFTP, se følgende temasider:

• HR-feeder (brukere)
• Roller
• Egendefinerte felt
• Kontorer
• Juridiske enheter