Dzięki konektorowi SFTP możesz używać poleceń w łańcuchu do zarządzania plikami i katalogami na serwerze Secure File Transfer Protocol (SFTP). Na przykład, za pomocą tego konektora możesz użyć szablonów do utworzenia łańcucha w celu bezpiecznego pobrania pliku z serwera SFTP, a następnie przesłania go do tabeli Wdata.
Wymagania wstępne
Aby korzystać z SFTP Connector, Twoja organizacja potrzebuje dostępu do własnego serwera SFTP. Workiva nie może hostować ani dostarczać tych serwerów.
Aby zabezpieczyć połączenie z serwerem SFTP, konektor obsługuje podstawowe uwierzytelnianie za pomocą nazwy użytkownika i hasła lub uwierzytelnianie za pomocą klucza publicznego/klucza prywatnego. Aby skonfigurować połączenie, będziesz potrzebować:
- Nazwa hosta lub adres IP serwera
- Port, na którym działa serwer
- Nazwa użytkownika używana do uzyskania dostępu do serwera
- Poświadczenia uwierzytelniania nazwy użytkownika
- W przypadku uwierzytelniania podstawowego hasło
- W przypadku uwierzytelniania kluczem publicznym, plik klucza prywatnego jako PEM lub PPK oraz jego hasło (jeśli dotyczy). Dowiedz się więcej o kluczach prywatnych.
Skonfiguruj złącze SFTP
Uwaga: Aby udostępnić łącznik do użytku w łańcuchach organizacji, administrator bezpieczeństwa organizacji najpierw włącza go z Konfiguracja.
- Na stronie Chain Builder kliknij Connections, a następnie Create w prawym górnym rogu.
- W sekcji Connector Connection wybierz SFTP Connector i swój runner.
- W sekcji Basic Info wprowadź unikalną nazwę i opis, aby ułatwić identyfikację połączenia.
- Jeśli korzystasz z uwierzytelniania kluczem publicznym, na stronie Resources prześlij plik klucza prywatnego serwera.
- W sekcji Properties wprowadź szczegóły połączenia:
Właściwość Szczegóły Gospodarz Wprowadź nazwę hosta lub adres IP serwera SFTP, np. 34.23.34.45lubsftp.example.net.Port Wprowadź port, na którym działa serwer. Nazwa użytkownika Wprowadź nazwę użytkownika używaną do logowania się do serwera. Hasło W przypadku uwierzytelniania podstawowego wprowadź hasło dla Username. W przypadku uwierzytelniania kluczem publicznym pozostaw puste. Klucz prywatny W przypadku uwierzytelniania kluczem publicznym wprowadź nazwę pliku klucza prywatnego przesłanego pod adresem Resources. Hasło klucza prywatnego W przypadku uwierzytelniania kluczem publicznym wprowadź hasło do pliku klucza prywatnego. Jeśli klucz prywatny nie ma hasła, pozostaw puste pole. Limit czasu połączenia Wprowadź liczbę minut oczekiwania na połączenie z serwerem SFTP. Jeśli serwer działa wolno lub ma duże obciążenie, wprowadź dużą liczbę. Uwaga: Wszystkie poufne dane uwierzytelniające są automatycznie szyfrowane i przechowywane przy użyciu szyfrowania Advanced Encryption Standard (AES) -256.
- Wybierz środowiska, w których ma być używane połączenie i kliknij Zapisz.
- Jeśli Twoja sieć wymaga listy dozwolonych domen wychodzących, zezwól na adres IP wymieniony w dokumencie Allow hosts and emails for Workiva.
- Aby przetestować połączenie, utwórz i uruchom łańcuch za pomocą polecenia SFTP Connector List Directory i sprawdź, czy zwraca prawidłowe dane wyjściowe.
Rozwiązywanie problemów
Jeśli połączenie z serwerem SFTP nie powiedzie się:
- Sprawdź, czy poświadczenia uwierzytelniania łącznika są prawidłowe. Na przykład użyj tych samych poświadczeń, aby połączyć się z serwerem za pośrednictwem aplikacji klienckiej SFTP, takiej jak FileZilla lub WinSCP.
- Sprawdź, czy hasło nie zaczyna się od znaku "at" (@).
- Jeśli połączenie zostanie przerwane, zwiększ limit czasu połączenia .
- Jeśli Twoja sieć wymaga listy dozwolonych domen wychodzących, postępuj zgodnie z dokumentem Allow hosts and emails for Workiva.
Klucze prywatne
Jeśli twoja aplikacja kliencka SFTP nie umożliwia wygenerowania pary kluczy publiczny/prywatny, użyj narzędzia takiego jak PuTTYgen lub ssh-keygen. W przypadku kluczy prywatnych obsługujemy następujące formaty:
- Klucze generowane przez PuTTy, które zazwyczaj kończą się rozszerzeniem .ppk.
- Klucze RSA używające standardu PKCS#1 w formacie PEM, który zazwyczaj kończy się rozszerzeniem .pem.
Możesz także wyświetlić swoje klucze RSA w edytorze tekstu. Jeśli tekst zawiera -----BEGIN RSA PRIVATE KEY----- i -----END RSA PRIVATE KEY-----, wówczas formaty te są obsługiwane przez Workiva. Jeśli brakuje tych wierszy lub zawierają one inne terminy, musisz przekonwertować klucz do tego formatu lub wygenerować nowy.