Úvod

Stránka Nastavení > SFTP slouží ke správě technických účtů pro přístup na Targito SFTP úložiště. Na jednom místě zde vytvoříte a spravujete SFTP uživatele, určíte jim oprávnění k jednotlivým složkám (např. pouze import) a zvolíte způsob ověření – heslem nebo SSH certifikátem.
SFTP přístup se používá pro dávkovou výměnu dat (import kontaktů, produktů, objednávek, exporty pro BI apod.) a je jedním z hlavních kanálů, jak Targito přijímá a předává data.

Podrobné technické informace k samotnému připojení (server, port, bezpečnost) najdete v dokumentaci Integrace > Synchronizace dat > SFTP přístup.

Jak to funguje

Architektura SFTP úložiště

• Každý zákaznický účet v Targitu má vlastní oddělené SFTP úložiště, které slouží pro všechny importy a exporty dat.

• Z úložiště jsou data v pravidelných intervalech importována do hlavní (master) databáze, kde nad nimi běží všechny datové úlohy a výpočty.

• Targito uchovává revize souborů a umožňuje vracet se k historickým verzím dat (dle nastavení licence).

Na SFTP jsou typicky k dispozici složky:

• import – pro CSV soubory k importu (kontakty, objednávky, produkty, seznamy pro transakční rozesílky, atd.).

• export – pro exporty dat (např. export Targito ID kontaktů pro napojení trackingu nebo BI).

• případně další složky pro specifické exporty či logy (liší se podle nastavení účtu).

SFTP uživatelé a oprávnění

Na stránce Nastavení > SFTP vidíte přehled všech SFTP účtů:

• Uživatelské jméno – přihlašovací jméno pro daný SFTP účet.

• Ověření – typ ověření:

  • Heslo – uživatel se přihlašuje kombinací jména a hesla.

  • Certifikát – uživatel se ověřuje SSH klíčem (doporučený a bezpečnější způsob).

• Složka s přístupem – jakou část úložiště může účet vidět:

  • Plný přístup (všechny složky) – uživatel vidí kompletní strukturu (import, export, …).

  • Pouze složka „import“ – uživatel má přístup jen do složky import (typicky systémy, které jen posílají data do Targita, ale nepotřebují číst exporty).

• Heslo – u účtů s heslem můžete kliknutím na tlačítko „Ukázat“ zobrazit aktuální heslo.

• Akce – mazání účtu (ikona koše).

Každý SFTP účet je na serveru technicky omezen tak, aby se nedostal mimo definovanou složku (chroot / jailed přístup). Informativní upozornění na toto omezení vidíte i v pravém panelu „Jak se připojit“.

Přístup na SFTP (včetně správy účtů) mají jen uživatelé s odpovídající rolí – typicky Vývojář nebo Správce účtu.

Bezpečnost

• SFTP běží výhradně přes šifrované SSH spojení, HTTP přístupy jsou z bezpečnostních důvodů zcela zakázané.

• Data jsou šifrována jak při přenosu, tak při uložení („data in transit“ i „data at rest“).

• Ověřování pomocí certifikátu/SSH klíče je bezpečnější než heslo – proto je doporučujeme využívat všude, kde je to možné (právě tomu odpovídá druhý screenshot se sekcí „Importovat veřejný klíč“).

Jak nastavit / použít SFTP

1. Otevření stránky SFTP

1. V hlavním menu přejděte do Nastavení.

2. V levém sloupci v sekci Data a integrace klikněte na SFTP.

3. Zobrazí se stránka se třemi hlavními částmi:

   • Přehled „Vaše SFTP účty“ (horní tabulka).

   • Formulář „Vytvořit nový SFTP účet“ (prostředek).

   • Pravý panel „Jak se připojit“ s rychlým návodem pro SFTP klienta.

Screenshot: Přehled SFTP účtů a formulář pro vytvoření nového účtu s heslem (viz první přiložený obrázek).

2. Vytvoření nového SFTP účtu s heslem

Heslo je vhodné zejména v situaci, kdy přístup potřebuje získat člověk (nebo systém), kde je složitější správa SSH klíčů. Z pohledu bezpečnosti je ale stále lepší certifikát.

1. Na stránce Nastavení > SFTP v sekci „Vytvořit nový SFTP účet“:

   • Uživatelské jméno (volitelné)

     • Můžete doplnit vlastní suffix (např. import, export, bi) k předvyplněnému prefixu účtu.

     • Pokud pole necháte prázdné, Targito vygeneruje výchozí uživatelské jméno.

     • Povolené jsou pouze písmena, čísla a podtržítko.

   • Složka s přístupem

     • Z rozbalovací nabídky vyberte:

       • Plný přístup (všechny složky) – účet uvidí import i export (vhodné pro interní systémy, které potřebují párovat importy s exporty).

       • Pouze složka „import“ – vhodné pro externí partnery nebo systémy, které mají jen posílat podklady k importu a nemají vidět ostatní data.

2. V části „Metoda ověřování“ klikněte na tlačítko „Vytvořit s heslem“.

3. Systém vytvoří nový SFTP účet a:

   • zobrazí ho v tabulce „Vaše SFTP účty“,

   • vygeneruje bezpečné heslo, které můžete zobrazit kliknutím na „Ukázat“ v příslušném řádku.

Doporučení: heslo si bezpečně uložte pouze do firemního password manageru a neměňte ho v SFTP klientovi (může dojít k rozchodu s uloženým heslem v Targitu).

3. Vytvoření nového SFTP účtu s certifikátem (SSH klíčem)

Tento způsob je bezpečnější – heslo se nikde neukládá, přístup je vázaný na párový SSH klíč.

1. V sekci „Vytvořit nový SFTP účet“ vyplňte:

   • Uživatelské jméno (volitelné) – stejně jako u účtu s heslem.

   • Složka s přístupem – plný přístup nebo pouze import.

2. V části „Metoda ověřování“ klikněte na „Vytvořit s certifikátem“.
   Formulář se rozšíří o blok „Importovat veřejný klíč“ (viz druhý screenshot).

3. Vygenerujte si nový SSH pár klíčů na vašem serveru nebo pracovním počítači. Typický postup:

   Na Mac/Linux:

   • Otevřete terminál.

   • Spusťte např.:
     ssh-keygen -t rsa -b 4096

   • Postupujte podle průvodce a jako výchozí umístění zvolte např. ~/.ssh/id_rsa.

   • Po dokončení získáte soubor id_rsa (soukromý klíč – ten nikomu nedávejte) a id_rsa.pub (veřejný klíč).

   Na Windows (OpenSSH / PowerShell / Git Bash):

   • Otevřete PowerShell nebo Git Bash.

   • Spusťte:
     ssh-keygen -t rsa -b 4096

   • Potvrďte umístění a případně nastavte passphrase.

   • Výsledkem je opět dvojice souborů id_rsa a id_rsa.pub.

4. V Targitu v části „Importovat veřejný klíč“:

   • buď nahrajte soubor veřejného klíče (id_rsa.pub) přes tlačítko „Vybrat soubor“,

   • nebo zkopírujte celý obsah souboru id_rsa.pub (typicky začíná ssh-rsa AAAA…) do textového pole „Nebo vložte obsah veřejného klíče“.

   Nikdy nenahrávejte ani nevkládejte obsah soukromého klíče (id_rsa bez .pub).

5. Klikněte na „Vytvořit uživatele“.

   • Nový účet se objeví v tabulce „Vaše SFTP účty“ s typem ověření Certifikát.

   • Přihlašování pak probíhá bez hesla – přístup je vázaný na vámi nahraný veřejný klíč.

Screenshot: Formulář pro vytvoření SFTP účtu s ověřením certifikátem včetně nápovědy, jak vygenerovat SSH klíč (viz druhý přiložený obrázek).

4. Připojení k SFTP z klienta (WinSCP, FileZilla, Transmit…)

Pro samotné připojení postupujte podle pravého panelu „Jak se připojit“ na stránce SFTP a podrobné instrukce najdete v dokumentaci SFTP přístup – včetně konkrétního hostitele a portu.

Obecný postup:

1. Nainstalujte a otevřete SFTP klienta (např. WinSCP, FileZilla pro Windows, Transmit pro Mac).

2. Vytvořte nové připojení typu SFTP.

3. Vyplňte:

   • Server / Hostitel – podle instrukcí v dokumentaci SFTP přístup (stejná hodnota je zobrazena v pravém panelu stránky SFTP).

   • Port – standardní SFTP port.

   • Jméno – uživatelské jméno z tabulky „Vaše SFTP účty“.

   • Heslo nebo SSH klíč – podle typu ověření:

     • u hesla zkopírujte hodnotu, kterou zobrazíte tlačítkem „Ukázat“,

     • u certifikátu vyberte ve vašem klientovi soukromý klíč odpovídající nahranému veřejnému klíči.

4. Uložte připojení pro pozdější použití.

Reálné (anonymizované) příklady využití

Příklad 1 – Import databáze kontaktů z interního CRM

Situace:
Klient má interní CRM systém, ze kterého každou noc generuje CSV soubor s kompletní databází kontaktů. Cílem je každý den aktualizovat kontakty v Targitu.

Nastavení SFTP:

• Vytvoří technický účet crm_import:

  • složka s přístupem: Pouze složka „import“,

  • metoda ověření: certifikát.

• Na straně CRM se nastaví cron úloha, která:

  • vygeneruje CSV soubor,

  • přes SFTP přihlásí účet crm_import a nahraje soubor do složky import.

Výsledek:

• Targito v noci soubor automaticky naimportuje do master databáze kontaktů.

• CRM ani skript nemají přístup k exportům či jiným citlivým datům, protože účet je omezen jen na složku import.

Příklad 2 – Export dat pro BI nástroj

Situace:
Marketingový tým a BI oddělení potřebují každý den kompletní přehled o chování kontaktů, objednávkách a mailingových reakcích, které se zpracovávají v externím BI nástroji.

Nastavení SFTP:

• Vytvoří SFTP účet bi_full:

  • složka s přístupem: Plný přístup (všechny složky),

  • metoda ověření: certifikát (protože přístup používá automatizovaný skript na serveru).

• V Targitu je nakonfigurováno pravidelné generování exportů do složky export.

• BI server se 1× denně přihlásí přes bi_full, stáhne nové soubory ze složky export a načte je do datového skladu.

Výsledek:

• BI tým pracuje s aktuálními daty z Targita bez nutnosti manuálního exportu.

• Přístup je technicky oddělený od produkčního rozhraní Targita – není potřeba sdílet osobní přístupy uživatelů.