SFTP – Instrukcja konfiguracji

SPIS TREŚCI

• SFTP – Instrukcja konfiguracji
  • Hosting i uwierzytelnianie
  • Konfiguracja
  • Częstotliwość i harmonogram
  • Raportowanie i obsługa błędów
    • Powiązane pytania i odpowiedzi
  • Jak utworzyć klucz publiczny SSH do serwera SFTP
    • Format
    • Wzorzec
    • Tworzenie kluczy SSH
    • Przykładowy klucz
  • Instrukcje dla wybranych typów rekordów

Hosting i uwierzytelnianie

Twój folder SFTP znajduje się na wydzielonym serwerze SFTP (w chmurze AWS). Każdy klient otrzymuje indywidualne konto użytkownika z bezpośrednim dostępem do swojego folderu SFTP. Obsługujemyuwierzytelnianie za pomocą klucza. Oznacza to, że należy wygenerować parę kluczy (publiczny i prywatny), a klucz publiczny wpisać w poluKlucz publicznypodczas konfigurowania folderu. Klucz musi być w formacieopenSSH RSA format. Jak utworzyć klucze, opisaliśmy niżej w części „Jak wygenerować publiczny klucz SSH do serwera SFTP”. Poniżej znajdziesz szczegółowe instrukcje.

Konfiguracja

1. Wprowadź wygenerowany wcześniej klucz publiczny w polu Klucz publiczny. Opcjonalnie możesz zaktualizować także nazwę użytkownika w odpowiednim polu.Nazwa użytkownika musi zaczynać się od litery, cyfry lub podkreślenia i mieć od 3 do 100 znaków. Może zawierać litery, cyfry, podkreślenia, znak @, kropki oraz myślniki.

2. Skopiuj nazwę użytkownika, adres URL domeny Spotnana oraz numer portu i zapisz te dane w bezpiecznym miejscu – będą potrzebne zespołowi w Twojej organizacji, który będzie konfigurować przesyłanie plików do nowo utworzonego folderu. 
   Uwaga:Gdy konfiguracja folderu SFTP zostanie zakończona, te dane będą ponownie dostępne w sekcji Zarządzaj.

3. W polu SFTP email notificationpole. Szczegółowe informacje znajdują się wRaportowanie i obsługa błędówponiżej.

4. Kliknij Połącz.

Gdy zostanie dodany klucz publiczny, początkowy status zostanie ustawiony na Niezweryfikowany. Taki status będzie widoczny w OBT do momentu otrzymania pierwszego pliku w folderze. Może to być testowy plik według Twojego wyboru albo właściwy plik HR lub plik z polami niestandardowymi (przetwarzane są tylko pliki w obsługiwanych formatach). Jeśli później klucz publiczny zostanie zaktualizowany, status ponownie zmieni się na Niezweryfikowany, aż do otrzymania kolejnego pliku.

Aby usunąć swój folder SFTP, kliknijOdłącz. Spowoduje to usunięcie folderu SFTP. Jeśli w przyszłości będziesz chciał go skonfigurować ponownie, wszystkie dane trzeba będzie wprowadzić od początku.

Częstotliwość i harmonogram

To Ty decydujesz, jak często i w jakich godzinach przesyłasz pliki. Przetwarzanie pliku rozpoczynamy w momencie, gdy tylko pojawi się on w Twoim folderze na naszym serwerze SFTP. Oznacza to, że zaraz po przesłaniu pliku nasza aplikacja automatycznie zaczyna go przetwarzać. 

Zalecenia dotyczące częstotliwości i harmonogramu przesyłania plików dla poszczególnych typów rekordów (np. użytkownicy, pola niestandardowe, podmioty prawne) znajdziesz w sekcji Częstotliwość i harmonogram w instrukcji SFTP dla każdego typu rekordu.

Raportowanie i obsługa błędów

Gromadzimy informacje o przesłanych przez Ciebie plikach i na ich podstawie tworzymy wewnętrzny raport po każdym przesłaniu. Raport ten wysyłamy na adres e-mail podany w polu SFTP email notification podczas konfiguracji. W raporcie po każdym przesłaniu znajdziesz: 

• wszystkie powody, dla których przesłanie pliku się nie powiodło (np. nieprawidłowy format, brakujące nazwy kolumn itp.).

• wszystkie powody, dla których konkretne wiersze w pliku nie zostały przesłane. Nie wykonujemy częściowych aktualizacji – jeśli w danym wierszu wystąpi błąd w kolumnie lub brakuje wymaganej wartości, cały wiersz zostanie odrzucony. 

• status przesyłki (oczekuje, zakończona sukcesem, niepowodzenie).

Dzięki tym informacjom możesz samodzielnie zdiagnozować ewentualne błędy. Jeśli nie uda Ci się ich rozwiązać, skontaktuj się z pomocą techniczną. 

Powiązane pytania i odpowiedzi

1. Czy akceptujemy pliki przyrostowe, które zawierają tylko rekordy do aktualizacji lub dodania?

   • Tak

2. Czy przesyłany plik (zarówno przez SFTP, jak i ręcznie) musi zawierać kolumny opcjonalne, nawet jeśli ich nie używasz?

   • Nie

Jak utworzyć klucz publiczny SSH do serwera SFTP

Skorzystaj z poniższych wskazówek, aby utworzyć klucz publiczny SSH, który następnie przekażesz naszemu zespołowi.

Format

• Typ: Ciąg znaków

• Ograniczenia długości: maksymalnie 2048 znaków.

Wzorzec

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

Tworzenie kluczy SSH

Aby wygenerować klucze SSH, należy uruchomić poniższe polecenie w wierszu poleceń Windows lub w terminalu na macOS, Linuxie albo UNIX-ie:

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

Gdzie:

• -t oznacza typ szyfrowania

• -b to długość klucza (w bitach)

• -f to nazwa klucza

Przykładowy klucz

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

Instrukcje dla wybranych typów rekordów

Jeśli potrzebują Państwo szczegółowych wskazówek dotyczących przesyłania określonych typów rekordów przez SFTP, prosimy zapoznać się z poniższymi tematami:

• Import użytkowników z systemów HR
• Pola niestandardowe
• Biura
• Podmioty prawne