Zum Hauptinhalt springen

Datenaustausch mittels SFTP Server

Workist stellt im Standard einen SFTP Server zur Verfügung, welcher zum Datenaustausch verwendet werden kann. Dieser Server ist mittels private/public Key Authentifizierung gesichert. Für die Verwendung dieses Servers muss auf Kundenseite ein SSH-Key Pair erstellt werden.

info

Anleitung: SSH Key Pair erstellen

Verbindungsdetails​

info

Die vollständigen Verbindungsdetails (Host, Port, RSA-Fingerprint und IP-Adressen) finden Sie in der Workbench unter SFTP Public Keys.

Verzeichnisstruktur​

VerzeichnisVerwendungszweck
/exportStammdatenlisten für Validierungssuchen (aus ERP exportiert)
/incomingAusgabedatei mit Dokumentdaten (z.B. XML) und Originalanhang (PDF)
/archiveOptional für bevorzugte Verwendung

Verbindung testen​

sftp -i <path/to/private_key> -P <port> <user>@<sftp-host>
scp -i <path/to/private_key> <path/to/test_file> <user>@<sftp-host>:/export
scp -i <path/to/private_key> <user>@<sftp-host>:/export/<test_file> <path/to/local_dir>

Erstellen eines SSH Key Pairs​

Windows​

ssh-keygen -t ed25519 -C "ihre_email@beispiel.com"

Für ältere Systeme ohne Ed25519-Unterstützung:

ssh-keygen -t rsa -b 4096 -C "ihre_email@beispiel.com"

Hinweis: ssh-keygen erfordert, dass OpenSSH installiert ist.

Linux und Mac​

ssh-keygen -t ed25519 -C "ihre_email@beispiel.com"

Folgen Sie den Eingabeaufforderungen im Terminal:

  1. Speicherpfad bestätigen oder anpassen (Standard: ~/.ssh/id_ed25519)
  2. Optionale Passphrase eingeben
  3. Schlüssel wird generiert und gespeichert

PuTTY (Windows)​

  1. PuTTY von der offiziellen Website herunterladen
  2. PuTTY Key Generator öffnen
  3. RSA auswählen, auf „Generate" klicken und die Maus über den leeren Bereich bewegen
  4. Den öffentlichen Schlüssel kopieren oder direkt an Workist senden
  5. Den privaten Schlüssel speichern: Conversions → Export OpenSSH Key

Verwendung des Key Pairs​

  • Teilen Sie den öffentlichen Schlüssel (Dateiendung .pub) mit Workist
  • Speichern Sie den privaten Schlüssel (ohne Dateiendung) auf dem System, das mit dem SFTP-Server kommuniziert