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 jest umieszczony na oddzielnym serwerze SFTP (w infrastrukturze AWS). Każdy klient otrzymuje indywidualne konto użytkownika z bezpośrednim dostępem do swojego folderu SFTP. Obsługujemy uwierzytelnianie za pomocą klucza. Dlatego konieczne będzie wygenerowanie pary kluczy (publicznego i prywatnego) oraz wprowadzenie klucza publicznego w polu Klucz publiczny podczas konfiguracji folderu. Klucz musi być w formacie openSSH RSA . Instrukcję generowania klucza znajdziesz w sekcji Jak utworzyć klucz publiczny SSH do serwera SFTP poniżej.

Konfiguracja

1. Wprowadź wygenerowany klucz publiczny w polu Klucz publiczny . Możesz także opcjonalnie zmienić wartość w polu Nazwa użytkownika . Nazwa użytkownika musi zaczynać się od litery, cyfry lub podkreślenia oraz mieć długość od 3 do 100 znaków. Dozwolone są litery, cyfry, podkreślenia, znak @, kropki (.) i myślniki (-). Skopiuj Nazwę użytkownika

2. , adres URL domeny Spotnana, oraz numer portui zapisz te dane w bezpiecznym miejscu – będą potrzebne zespołowi w Twojej organizacji, który będzie konfigurował wysyłkę plików do nowego folderu. Uwaga: Po zakończeniu konfiguracji folderu SFTP te dane będą ponownie dostępne w sekcji 
   Zarządzaj . Wprowadź adres(y) e-mail, na które mają być wysyłane raporty dotyczące przesyłania plików, w poluPowiadomienia e-mail SFTP

3. . Szczegółowe informacje znajdują się w sekcji Raportowanie i obsługa błędów poniżej. Kliknij Połącz

4. . Gdy dodasz klucz publiczny, początkowy status zostanie ustawiony naNiezweryfikowany

. Taki status będzie widoczny w OBT do momentu, aż do folderu zostanie przesłany pierwszy plik. Może to być dowolny plik testowy lub rzeczywisty plik HR bądź plik z polami niestandardowymi (przetwarzane są tylko pliki w obsługiwanych formatach). Jeśli później klucz publiczny zostanie zmieniony, status ponownie zostanie ustawiony na Niezweryfikowanyi pozostanie taki do czasu przesłania kolejnego pliku. Aby usunąć folder SFTP, kliknij Odłącz

. Spowoduje to usunięcie folderu SFTP. Jeśli w przyszłości będziesz chciał go ponownie skonfigurować, konieczne będzie wprowadzenie wszystkich powyższych danych od nowa. Częstotliwość i harmonogramTo Ty decydujesz, jak często i w jakich godzinach będą przesyłane pliki. Przetwarzanie rozpoczyna się automatycznie w momencie utworzenia pliku w folderze. Oznacza to, że gdy tylko prześlesz plik na nasz serwer SFTP, aplikacja natychmiast rozpocznie jego przetwarzanie.

Zalecenia dotyczące częstotliwości i harmonogramu dla poszczególnych typów rekordów (np. użytkownicy, pola niestandardowe, jednostki prawne) znajdziesz w sekcji

Częstotliwość i harmonogram 

w instrukcji SFTP dla każdego typu rekordu. Raportowanie i obsługa błędów Po każdym przesłaniu pliku zbieramy dane i generujemy wewnętrzny raport, który wysyłany jest na adres(y) e-mail podane w polu

Powiadomienia e-mail SFTP

w trakcie konfiguracji. Dla każdego przesłanego pliku raport zawiera: 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 nie udało się przesłać konkretnego wiersza z pliku. Nie wykonujemy częściowych aktualizacji – jeśli w danym wierszu wystąpi błąd lub brakuje wymaganej wartości, cały wiersz zostanie odrzucony; 

• status przesyłki (oczekuje, zakończone powodzeniem, niepowodzenie).

• Na podstawie tych informacji możesz samodzielnie rozwiązać ewentualne błędy. Jeśli nie uda Ci się ich usunąć, skontaktuj się z pomocą techniczną. 

• Powiązane pytania i odpowiedzi

Czy akceptujemy plik przyrostowy, który zawiera tylko te rekordy, które mają zostać zaktualizowane lub dodane? 

Tak

1. Czy plik przesyłany (przez SFTP lub ręcznie) musi zawierać kolumny opcjonalne, nawet jeśli z nich nie korzystasz?

   • Nie

2. Jak utworzyć klucz publiczny SSH do serwera SFTP

   • Skorzystaj z poniższej instrukcji, aby utworzyć klucz publiczny SSH, który należy nam przekazać.

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, uruchom poniższe polecenie w wierszu poleceń Windows lub w terminalu na macOS, Linux albo UNIX:

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

To create SSH keys, run this command on the command line in Windows or in terminal on the macOS, Linux, or UNIX:

-t oznacza typ szyfrowania

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

• -f to nazwa pliku z kluczem

• 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 potrzebujesz szczegółowych instrukcji dotyczących przesyłania konkretnych typów rekordów przez SFTP, zapoznaj się z poniższymi tematami:

Zasilania HR (użytkownicy)

Role

• Pola niestandardowe
• Biura
• Jednostki prawne
• Offices
• Legal entities