SFTP – Návod na nastavení

OBSAH

• SFTP – Návod na nastavení
  • Hosting a ověření
  • Nastavení
  • Frekvence a plánování
  • Reporty a řešení chyb
    • Související časté dotazy
  • Jak vytvořit veřejný SSH klíč pro SFTP server
    • Formát
    • Vzor
    • Vytvoření SSH klíčů 
    • Vzorový klíč
  • Pokyny pro konkrétní typy záznamů

Hosting a ověření

Váš SFTP adresář je uložen na samostatném SFTP serveru (přes AWS). Každý klient má svůj vlastní uživatelský účet s přímým přístupem pouze do svého adresáře. Podporujeme ověřování pomocí klíče. Proto je potřeba vytvořit dvojici klíčů (veřejný a soukromý) a veřejný klíč zadat do pole Veřejný klíč při nastavování složky. Klíč musí být ve formátu openSSH RSA . Jak klíče vytvořit, najdete v části Jak vytvořit veřejný SSH klíč pro SFTP server níže.

Nastavení

1. Veřejný klíč, který jste si vytvořili, zadejte do pole Veřejný klíč . Volitelně můžete upravit pole Uživatelské jméno . Hodnota v poli Uživatelské jméno musí začínat písmenem, číslicí nebo podtržítkem a obsahovat 3 až 100 znaků. Povolené jsou písmena, číslice, podtržítka, zavináče (@), tečky (.) a pomlčky (-).

2. Zkopírujte si Uživatelské jméno, URL domény Spotnanaa číslo portu a uložte si tyto údaje na bezpečné místo. Budou je potřebovat kolegové, kteří budou nastavovat odesílání souborů do nově vytvořené složky. 
   Poznámka: Po dokončení nastavení SFTP složky najdete tyto údaje kdykoliv v sekci Spravovat.

3. Do pole SFTP e-mailová notifikace zadejte e-mailovou adresu (nebo více adres), na kterou si přejete dostávat reporty o nahraných souborech. Podrobnosti najdete v části Reporty a řešení chyb níže.

4. Klikněte na Připojit.

Jakmile přidáte veřejný klíč, počáteční stav bude nastaven na Neověřeno. Tento stav se bude zobrazovat v OBT do doby, než do složky dorazí první soubor. Může to být testovací soubor dle vašeho výběru nebo ostrý HR feed či soubor s vlastními poli (zpracovávají se pouze podporované formáty). Pokud veřejný klíč později změníte, stav se opět nastaví na Neověřeno až do doručení dalšího souboru.

Pokud potřebujete SFTP složku odstranit, klikněte na Odpojit. Tím dojde k odstranění vaší SFTP složky. Pokud ji budete chtít později znovu nastavit, bude nutné všechny údaje zadat znovu od začátku.

Frekvence a plánování

Frekvenci a časování nahrávání souborů si určujete sami. Zpracování souboru začíná v okamžiku, kdy do vaší složky na našem SFTP serveru nahrajete nový soubor – aplikace jej začne ihned zpracovávat. 

Doporučení k frekvenci a časování pro jednotlivé typy záznamů (například uživatelé, vlastní pole, právní subjekty) najdete v sekci Frekvence a plánování v návodu k SFTP pro každý typ záznamu.

Reporty a řešení chyb

Po každém nahrání souboru shromažďujeme informace o nahraných datech a vytváříme interní report. Tento report je automaticky zaslán na e-mailovou adresu (nebo adresy), kterou jste zadali v poli SFTP e-mailová notifikace při nastavování. U každého nahraného souboru report obsahuje: 

• důvody, proč se soubor nepodařilo nahrát (například špatný formát, chybějící názvy sloupců apod.).

• důvody, proč se některý řádek v souboru nepodařilo nahrát. Nepodporujeme částečné aktualizace – pokud je v konkrétním sloupci chyba nebo chybí povinný údaj, celý řádek bude odmítnut. 

• stav nahrání (čeká na zpracování, úspěšné, neúspěšné).

Tento report můžete použít k vyhledání a odstranění chyb. Pokud se vám chybu nepodaří opravit, kontaktujte technickou podporu. 

Související časté dotazy

1. Přijímáme i přírůstkové soubory, které obsahují pouze záznamy určené k aktualizaci nebo přidání?

   • Ano

2. Musí nahrávaný soubor (ať už přes SFTP nebo ručně) obsahovat i volitelné sloupce, pokud je nepoužíváte?

   • Ne

Jak vytvořit veřejný SSH klíč pro SFTP server

Postupujte podle níže uvedených pokynů pro vytvoření veřejného SSH klíče, který nám následně předáte.

Formát

• Typ: Řetězec

• Omezení délky: maximálně 2048 znaků.

Vzor

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

Vytvoření SSH klíčů 

Pro vytvoření SSH klíčů spusťte tento příkaz v příkazovém řádku Windows nebo v terminálu na macOS, Linuxu či UNIXu:

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

Kde 

• -t určuje typ šifrování

• -b znamená délku klíče (v bitech)

• -f je název klíče

Vzorový klíč

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

Pokyny pro konkrétní typy záznamů

Podrobnější návod pro nahrávání jednotlivých typů záznamů přes SFTP najdete v těchto tématech:

• HR feedy (uživatelé)
• Role
• Vlastní pole
• Pobočky
• Právní subjekty