SFTP – Pokyny na nastavenie

OBSAH

• SFTP – Pokyny na nastavenie
  • Hosting a overovanie
  • Nastavenie
  • Frekvencia a plánovanie
  • Prehľady a riešenie chýb
    • Súvisiace často kladené otázky
  • Ako vytvoriť verejný SSH kľúč pre SFTP server
    • Formát
    • Vzor
    • Vytvorenie SSH kľúčov
    • Ukážkový kľúč
  • Pokyny pre konkrétne typy záznamov

Hosting a overovanie

Váš SFTP priečinok je umiestnený na samostatnom SFTP serveri (cez AWS). Každý klient má vlastné používateľské konto s priamym prístupom do svojho priečinka. Podporujemeoverovanie pomocou kľúčov. Preto je potrebné vytvoriť si dvojicu verejného a súkromného kľúča a verejný kľúč zadať do poľaVerejný kľúč pri nastavovaní priečinka. Kľúč musí byť vo formáte openSSH RSA formáte. Ako vytvoriť kľúče, nájdete v časti Ako vytvoriť verejný SSH kľúč pre SFTP server nižšie.

Nastavenie

1. Verejný kľúč, ktorý ste vytvorili, zadajte do poľa Verejný kľúč. Voliteľne môžete upraviť aj Používateľské meno . Hodnota v poli Používateľské meno musí začínať písmenom, číslicou alebo podčiarkovníkom a obsahovať 3 až 100 znakov. Povolené sú písmená, číslice, podčiarkovníky, zavináče (@), bodky (.) a pomlčky (-).

2. Skopírujte si používateľské meno, adresu domény Spotnana a číslo portu a uložte si tieto údaje na bezpečné miesto. Budú ich potrebovať kolegovia, ktorí budú nastavovať odosielanie súborov do novovytvoreného priečinka. 
   Poznámka: Po dokončení nastavenia SFTP priečinka sa k týmto údajom môžete kedykoľvek vrátiť v časti Spravovať.

3. Do poľa SFTP e-mailové upozorneniepole. Podrobnosti nájdete vPrehľady a spracovanie chýb nižšie.

4. Kliknite na Pripojiť.

Keď pridáte verejný kľúč, počiatočný stav bude nastavený na Noverené. Tento stav sa zobrazí v OBT, kým do priečinka nepríde prvý súbor. Môže to byť testovací súbor podľa vášho výberu alebo skutočný HR feed či súbor s vlastnými údajmi (spracujú sa len podporované formáty). Ak neskôr verejný kľúč zmeníte, stav sa opäť nastaví na Noverené až do prijatia ďalšieho súboru.

Ak chcete svoj SFTP priečinok odstrániť, kliknite na Odpojiť. Týmto sa SFTP priečinok vymaže. Ak ho budete chcieť opätovne nastaviť, bude potrebné všetky údaje zadať znova od začiatku podľa vyššie uvedeného postupu.

Frekvencia a plánovanie

Plánovanie a frekvenciu nahrávania súborov si určujete sami. Na spracovanie súboru používame spúšťač vytvorenia objektu súboru. To znamená, že akonáhle uložíte súbor do svojho priečinka na našom SFTP serveri, naša aplikácia automaticky začne s jeho spracovaním. 

Odporúčania týkajúce sa frekvencie a načasovania pre jednotlivé typy záznamov (napríklad používatelia, vlastné polia, právnické osoby) nájdete v sekcii Frekvencia a plánovanie v pokynoch pre SFTP pre každý typ záznamu.

Reportovanie a spracovanie chýb

Zbierame údaje o vašich nahraných súboroch a po každom nahraní vytvárame interný report. Tento report zasielame na e-mailovú adresu (alebo adresy), ktorú ste uviedli v poli SFTP e-mailové upozorneniepole počas nastavenia. Pre každý nahraný súbor bude správa obsahovať:

• všetky dôvody, prečo sa nahrávanie súboru nepodarilo (nesprávny formát, chýbajúce názvy stĺpcov a pod.).

• všetky dôvody, prečo sa konkrétny riadok v súbore nepodarilo nahrať. Čiastočné aktualizácie nerobíme – ak dôjde k chybe v konkrétnom stĺpci alebo chýba povinný údaj, celý riadok sa nenahrá. 

• stav nahrávania (čaká na spracovanie, úspešné, neúspešné).

Tieto informácie môžete využiť na riešenie prípadných chýb. Ak sa vám problém nepodarí odstrániť, obráťte sa na technickú podporu. 

Súvisiace často kladené otázky

1. Akceptujeme aj súbor, ktorý obsahuje iba záznamy určené na aktualizáciu alebo pridanie?

   • Áno

2. Musí súbor, ktorý nahrávate (či už cez SFTP alebo ručne), obsahovať aj voliteľné stĺpce, ak ich nevyužívate?

   • Nie

Ako vytvoriť verejný SSH kľúč pre SFTP server

Na vytvorenie verejného SSH kľúča, ktorý nám poskytnete, použite nižšie uvedený postup.

Formát

• Typ: Reťazec

• Obmedzenia dĺžky: Maximálne 2048 znakov.

Vzor

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

Vytvorenie SSH kľúčov 

Ak chcete vytvoriť SSH kľúče, použite tento príkaz v príkazovom riadku vo Windows alebo v termináli na macOS, Linuxe či UNIXe:

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

Kde 

• -t označuje typ šifrovania

• -b je dĺžka kľúča (v bitoch)

• -f je názov kľúča

Ukážka kľúča

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

Pokyny pre konkrétne typy záznamov

Ak potrebujete presnejší postup pre nahrávanie konkrétnych typov záznamov cez SFTP, pozrite si tieto témy podľa typu záznamu:

• HR feedy (používatelia)
• Vlastné polia
• Pobočky
• Právne subjekty