Workiva Support Center

Mit dem SFTP-Konnektor können Sie Befehle in einer Kette verwenden, um Dateien und Verzeichnisse auf einem Secure File Transfer Protocol (SFTP)-Server zu verwalten. Mit diesem Konnektor können Sie beispielsweise Vorlagen verwenden, um eine Kette zu erstellen, um eine Datei sicher von einem SFTP-Server herunterzuladen und dann in eine Wdata-Tabelle hochzuladen.

Voraussetzungen

Um den SFTP Connector zu verwenden, benötigt Ihre Organisation Zugang zu einem eigenen SFTP-Server. Workiva kann diese Server weder hosten noch zur Verfügung stellen.

Um die Verbindung mit Ihrem SFTP-Server zu sichern, unterstützt der Konnektor entweder die einfache Authentifizierung mit Benutzername und Passwort oder die Authentifizierung mit öffentlichem und privatem Schlüssel. Um die Verbindung herzustellen, benötigen Sie:

• Den Hostnamen oder die IP-Adresse des Servers
• Den Port, auf dem der Server läuft
• Den für den Zugriff auf den Server verwendeten Benutzernamen
• Die Authentifizierungsdaten des Benutzernamens 
  • Das Passwort für die Basisauthentifizierung
  • Für die Authentifizierung mit öffentlichem Schlüssel die private Schlüsseldatei als PEM- oder PPK-Datei und das zugehörige Passwort (falls zutreffend). Erfahren Sie mehr über private Schlüssel.

Einrichten des SFTP-Anschlusses

Hinweis: Um den Konnektor für die Verwendung in den Ketten Ihrer Organisation verfügbar zu machen, muss ein Sicherheitsadministrator der Organisation ihn zunächst aktivieren unter Konfiguration.

1. Klicken Sie unter Chain-Generator auf Verbindungen  compare_arrows und dann auf Erstellen oben rechts.
2. Wählen Sie unter Connector Connection, SFTP Connector und Ihren Läufer.
   
3. Geben Sie unter Basisinformationen einen eindeutigen Namen und eine Beschreibung ein, um die Verbindung zu identifizieren.
4. Wenn Sie die Authentifizierung mit öffentlichem Schlüssel verwenden, laden Sie unter Ressourcen die Datei mit dem privaten Schlüssel des Servers hoch. 
5. Geben Sie unter Eigenschaften die Details der Verbindung ein:
   

   Eigenschaft	Details
   Host	Geben Sie den Host-Namen oder die IP-Adresse des SFTP-Servers ein, z. B. 34.23.34.45 oder sftp.example.net.
   Port	Geben Sie den Port ein, an dem der Server läuft.
   Benutzername	Geben Sie den Benutzernamen ein, mit dem Sie sich beim Server anmelden.
   Kennwort	Für die Basisauthentifizierung geben Sie das Passwort für Benutzername ein. Für die Authentifizierung mit öffentlichem Schlüssel lassen Sie das Feld leer.
   Privater Schlüssel	Für die Authentifizierung mit dem privaten Schlüssel geben Sie den Dateinamen des hochgeladenen privaten Schlüssels unter Ressourcen ein.
   Passwort für den privaten Schlüssel	Für die Authentifizierung mit dem öffentlichen Schlüssel geben Sie das Kennwort für die private Schlüsseldatei ein. Wenn der private Schlüssel kein Passwort hat, lassen Sie ihn leer.
   Zeitüberschreitung der Verbindung	Geben Sie die Anzahl der Minuten ein, die auf die Verbindung mit dem SFTP-Server gewartet werden soll. Wenn der Server langsam oder stark ausgelastet ist, geben Sie eine große Zahl ein.

   Hinweis: Alle sensiblen Anmeldedaten werden automatisch verschlüsselt und mit Advanced Encryption Standard (AES)-256-Verschlüsselung gespeichert.

6. Wählen Sie die Umgebungen aus, die die Verbindung verwenden sollen, und klicken Sie auf Speichern.
7. Wenn Ihr Netzwerk eine Liste mit erlaubten Domains erfordert, erlauben Sie die IP-Adresse, die im Dokument Allow hosts and emails for Workiva aufgeführt ist.
8. Um die Verbindung zu testen, erstellen Sie und führen Sie eine Kette mit dem Befehl Verzeichnis auflisten des SFTP-Konnektors, und überprüfen Sie, ob eine gültige Ausgabe zurückgegeben wird.

Fehlersuche

Wenn die Verbindung zum SFTP-Server fehlschlägt:

• Überprüfen Sie, ob die Authentifizierungsdaten des Konnektors korrekt sind. Verwenden Sie beispielsweise dieselben Anmeldedaten, um sich über eine SFTP-Client-Anwendung wie FileZilla oder WinSCP mit dem Server zu verbinden.
• Stellen Sie sicher, dass Ihr Kennwort nicht mit einem "at"-Zeichen (@) beginnt.
• Wenn die Verbindung eine Zeitüberschreitung aufweist, erhöhen Sie die Zeitüberschreitung der Verbindung.
• Wenn Ihr Netzwerk eine Liste mit erlaubten ausgehenden Domains erfordert, folgen Sie bitte dem Dokument Allow hosts and emails for Workiva.

Private Schlüssel

Wenn Ihre SFTP-Client-Anwendung es Ihnen nicht ermöglicht, ein öffentliches/privates Schlüsselpaar zu erzeugen, verwenden Sie ein Tool wie PuTTYgen oder ssh-keygen. Für private Schlüssel unterstützen wir die folgenden Formate:

• PuTTy-generierte Schlüssel, die in der Regel mit der Erweiterung .ppk enden.
• RSA-Schlüssel im PKCS#1-Standard im PEM-Format, das in der Regel mit der Erweiterung .pem endet.

Sie können Ihre RSA-Schlüssel auch in einem Texteditor anzeigen. Wenn der Text -----BEGIN RSA PRIVATE KEY----- und -----END RSA PRIVATE KEY----- enthält, werden diese Formate von Workiva unterstützt. Wenn diese Zeilen fehlen oder andere Begriffe enthalten, müssen Sie den Schlüssel in dieses Format konvertieren oder einen neuen Schlüssel erstellen.

Aufbau