FTP Download

Der FTP Download Job ermöglicht das Herunterladen von Dateien von einem anderen Server. Er unterstützt die Standard-FTP, sowie sichere Verbindungen mit SSH. Die resultierenden Dateien werden von nachfolgender Aktion berücksichtigt und verarbeitet.

Um den FTP Download Job verwenden zu können, ist das Konfigurationsrecht nötig.

Anwendungsfälle

Mit dem FTP Download Job können immer wieder Sätze von Dateien geladen werden. Diese können dann entweder direkt via z.B. E-Mail-Aktion verschickt oder in einem weiteren Task verarbeitet werden.

Berichts Beispiel

  • Aufgabe 1:
    • Job: Download von *.json-Dateien die als Datenquelle eines Berichts definiert sind
    • Action: Trigger Aufgabe 2
  • Aufgabe 2:
    • Job: Bericht mit der Datenquelle, die auf den *.json-Dateien beruht, erstellen

PDF Vergleich Beispiel

  • Aufgabe 1:
    • Job: Download von *.pdf-Dateien die miteinander verglichen werden sollen
    • Action: Trigger Aufgabe 2
  • Aufgabe 2:
    • Job: (Batch-) Vergleich der *.pdf-Dateien vom Download-Ort

FTP

Die Übertragung von Dateien an einen entfernten Standort ist der Hauptzweck dieser Aktion. Es unterstützt die Standard-FTP, sowie sichere Verbindungen mit SSH.

Unterstützte Protokolle

Folgende Protokolle stehen zur Verfügung und können im Konfigurationsdialog ausgewählt werden:

  • FTP: die Standard-FTP-Verbindung zum Server via Port 21
  • FTP mit impliziten TLS 1); sichere Verbindung zum Server via Port 990
  • FTP mit explizitem TLS 2): sichere Verbindung zum Server via Port 21
  • Sicheres FTP 3): sichere Verbindung zum Server mit SSH via Port 22

Verbindung zum FTP-Server

Die Verbindung zum FTP-Server wird über das gewählte Protokoll hergestellt. Folgende Optionen müssen im Konfigurationsdialog der Aufgabe eingestellt werden.

Server-Informationen

  • Server: der Hostname oder die IP, unter der der FTP-Server zu erreichen ist
  • Port: die Portnummer, unter der der FTP-Server zu erreichen ist - wird nur benötigt, wenn sie nicht dem Standardport des gewählten Protokolls entspricht
  • Passive Verbindung: wird verwendet, wenn der Server keine Verbindung zum Client herstellen kann. Dies ist z.B. der Fall, wenn sich der Client hinter einem Router befindet, der seine IP-Adresse mittels NAT geändert hat, oder wenn eine Firewall das Netzwerk des Clients vor Zugriffen von außen abschirmt.
    • <Farbe #ff3300>Hinweis:</color> Diese Option ist nicht für Secure FTP-Verbindungen verfügbar

Authentifizierung

  • Login-Typ: bestimmt, welche Authentifizierungsfelder angeboten werden.
    • Anonym - kann aktiviert werden, wenn der Server diese Art der Anmeldung unterstützt. Benutzer und Passwort sind nicht erforderlich. Kann nur mit dem Standard-FTP-Protokoll verwendet werden
    • Benutzername und Passwort - Authentifizierungsdaten werden eingegeben. Kann sowohl mit Standard-FTP als auch mit Secure FTP-Protokollen verwendet werden. Ist bei TLS-Protokolltypen implizit, also nicht sichtbar.
  • Benutzername: Anmeldename des Benutzers zur Authentifizierung gegenüber dem FTP-Server
  • Passwort: Passwort des Benutzers zur Authentifizierung gegenüber dem FTP-Server
  • Privater Schlüssel: ein Schlüssel für die Authentifizierung mit öffentlichem/privatem Schlüssel. Dieser Schlüssel kann optional mit einem Passwort gesichert werden, das anstelle des Benutzerkennworts gesetzt werden muss.

Authentifizierung mit öffentlichem/privatem Schlüssel

Die Authentifizierung mit öffentlichem/privatem Schlüssel kann mit dem Secure FTP-Protokoll verwendet werden. Der private Schlüssel muss in voller Länge in das Textfeld eingefügt werden. Er wird nur einmal angezeigt und wird mit einer zusätzlichen Verschlüsselung zusammen mit der Aufgabenkonfiguration gespeichert. Wenn der private Schlüssel mit einem Passwort gesichert ist, muss dieses ebenfalls angegeben werden und wird ebenfalls verschlüsselt gespeichert.

Hinweis: Fehler bei den Verschlüsselungsschlüsseln können ein Hinweis auf das falsche Format des Schlüssels sein. Er muss dann auf ein RSA- oder PEM-Format umgestellt werden und sollte wie der folgende Block aussehen:

-----BEGIN RSA PRIVATE KEY-----
...
-----END RSA PRIVATE KEY-----

Unter Verwendung von OpenSSH und ssh-keygen können auf unterstützten Systemen die folgenden Befehle verwendet werden:

[dev@localhost] $ ssh-keygen -t rsa -b 4096 -C "<Benutzerhinweis>"
# Erzeugen des oeffentlichen/privaten rsa-Schluesselpaares.
# Datei angeben, in der der Schluessel gespeichert werden soll (/Users/dev/.ssh/id_rsa):
# Passphrase eingeben (leer fuer keine Passphrase): 
# Dieselbe Passphrase erneut eingeben: 
# Ihre Identifikation wurde in /Users/dev/.ssh/id_rsa gespeichert.
# Ihr oeffentlicher Schluessel wurde in /Benutzer/dev/.ssh/id_rsa.pub gespeichert.
# ...
 
[dev@localhost] $ ssh-keygen -p -f /Benutzer/dev/.ssh/id_rsa -m pem
# ...

Wo werden die Dateien gespeichert

Der Zielpfad bestimmt den Ort, an dem die Dateien auf der FTP-Server-Seite gespeichert werden. Verzeichnisse, die nicht existieren, werden erstellt.

Das Format des Dateinamens ist ein Namensschema mit dem die Dateien gespeichert werden.

Format des Dateinamens

Es gibt drei Platzhalter um den Dateinamen dynamisch zu erstellen:

  • [filename] - Name der Datei wie er vom Job übergeben wurde
  • [date] - Datum an dem der Job ausgeführt wurde
  • [time] - Zeit zu der der Job ausgeführt wurde

Note: Die Dateiendung wird später zum Dateinamen hinzugefügt und sollte hier nicht angegeben werden.

Beispiel

Format:        [filename] [date] [time]

Datei Eingabe: abc.pdf
Datei Ausgabe: abc 2017-04-07 09-45.pdf

Pfad Eingabe:  abc/def.pdf
Pfad Ausgabe:  abc 2017-04-07 09-45/def.pdf

FTP

Die Übertragung von Dateien an einen entfernten Standort ist der Hauptzweck dieser Aktion. Es unterstützt die Standard-FTP, sowie sichere Verbindungen mit SSH.

Unterstützte Protokolle

Folgende Protokolle stehen zur Verfügung und können im Konfigurationsdialog ausgewählt werden:

  • FTP: die Standard-FTP-Verbindung zum Server via Port 21
  • FTP mit impliziten TLS 4); sichere Verbindung zum Server via Port 990
  • FTP mit explizitem TLS 5): sichere Verbindung zum Server via Port 21
  • Sicheres FTP 6): sichere Verbindung zum Server mit SSH via Port 22

Verbindung zum FTP-Server

Die Verbindung zum FTP-Server wird über das gewählte Protokoll hergestellt. Folgende Optionen müssen im Konfigurationsdialog der Aufgabe eingestellt werden.

Server-Informationen

  • Server: der Hostname oder die IP, unter der der FTP-Server zu erreichen ist
  • Port: die Portnummer, unter der der FTP-Server zu erreichen ist - wird nur benötigt, wenn sie nicht dem Standardport des gewählten Protokolls entspricht
  • Passive Verbindung: wird verwendet, wenn der Server keine Verbindung zum Client herstellen kann. Dies ist z.B. der Fall, wenn sich der Client hinter einem Router befindet, der seine IP-Adresse mittels NAT geändert hat, oder wenn eine Firewall das Netzwerk des Clients vor Zugriffen von außen abschirmt.
    • <Farbe #ff3300>Hinweis:</color> Diese Option ist nicht für Secure FTP-Verbindungen verfügbar

Authentifizierung

  • Login-Typ: bestimmt, welche Authentifizierungsfelder angeboten werden.
    • Anonym - kann aktiviert werden, wenn der Server diese Art der Anmeldung unterstützt. Benutzer und Passwort sind nicht erforderlich. Kann nur mit dem Standard-FTP-Protokoll verwendet werden
    • Benutzername und Passwort - Authentifizierungsdaten werden eingegeben. Kann sowohl mit Standard-FTP als auch mit Secure FTP-Protokollen verwendet werden. Ist bei TLS-Protokolltypen implizit, also nicht sichtbar.
  • Benutzername: Anmeldename des Benutzers zur Authentifizierung gegenüber dem FTP-Server
  • Passwort: Passwort des Benutzers zur Authentifizierung gegenüber dem FTP-Server
  • Privater Schlüssel: ein Schlüssel für die Authentifizierung mit öffentlichem/privatem Schlüssel. Dieser Schlüssel kann optional mit einem Passwort gesichert werden, das anstelle des Benutzerkennworts gesetzt werden muss.

Authentifizierung mit öffentlichem/privatem Schlüssel

Die Authentifizierung mit öffentlichem/privatem Schlüssel kann mit dem Secure FTP-Protokoll verwendet werden. Der private Schlüssel muss in voller Länge in das Textfeld eingefügt werden. Er wird nur einmal angezeigt und wird mit einer zusätzlichen Verschlüsselung zusammen mit der Aufgabenkonfiguration gespeichert. Wenn der private Schlüssel mit einem Passwort gesichert ist, muss dieses ebenfalls angegeben werden und wird ebenfalls verschlüsselt gespeichert.

Hinweis: Fehler bei den Verschlüsselungsschlüsseln können ein Hinweis auf das falsche Format des Schlüssels sein. Er muss dann auf ein RSA- oder PEM-Format umgestellt werden und sollte wie der folgende Block aussehen:

-----BEGIN RSA PRIVATE KEY-----
...
-----END RSA PRIVATE KEY-----

Unter Verwendung von OpenSSH und ssh-keygen können auf unterstützten Systemen die folgenden Befehle verwendet werden:

[dev@localhost] $ ssh-keygen -t rsa -b 4096 -C "<Benutzerhinweis>"
# Erzeugen des oeffentlichen/privaten rsa-Schluesselpaares.
# Datei angeben, in der der Schluessel gespeichert werden soll (/Users/dev/.ssh/id_rsa):
# Passphrase eingeben (leer fuer keine Passphrase): 
# Dieselbe Passphrase erneut eingeben: 
# Ihre Identifikation wurde in /Users/dev/.ssh/id_rsa gespeichert.
# Ihr oeffentlicher Schluessel wurde in /Benutzer/dev/.ssh/id_rsa.pub gespeichert.
# ...
 
[dev@localhost] $ ssh-keygen -p -f /Benutzer/dev/.ssh/id_rsa -m pem
# ...

Wo werden die Dateien gespeichert

Der Zielpfad bestimmt den Ort, an dem die Dateien auf der FTP-Server-Seite gespeichert werden. Verzeichnisse, die nicht existieren, werden erstellt.

Das Format des Dateinamens ist ein Namensschema mit dem die Dateien gespeichert werden.

Format des Dateinamens

Es gibt drei Platzhalter um den Dateinamen dynamisch zu erstellen:

  • [filename] - Name der Datei wie er vom Job übergeben wurde
  • [date] - Datum an dem der Job ausgeführt wurde
  • [time] - Zeit zu der der Job ausgeführt wurde

Note: Die Dateiendung wird später zum Dateinamen hinzugefügt und sollte hier nicht angegeben werden.

Beispiel

Format:        [filename] [date] [time]

Datei Eingabe: abc.pdf
Datei Ausgabe: abc 2017-04-07 09-45.pdf

Pfad Eingabe:  abc/def.pdf
Pfad Ausgabe:  abc 2017-04-07 09-45/def.pdf

Dateien laden

Die letzten beiden Optionen des Dialogs bestimmen, von wo und wohin die Dateien geladen werden sollen:

  • Verzeichnis zum Herunterladen: Quellverzeichnis auf dem FTP-Server. Es ist zu beachten:
    • Der Ausgangsort muss absolut sein.
    • Der Ausgangsort (/) kann je nach verwendetem Protokoll ein anderes Verzeichnis auf dem Server meinen
    • Jede sichtbare Datei aus diesem Verzeichnis wird heruntergeladen. Unterverzeichnisse werden nicht berücksichtigt.
  • Zielpfad: ein Verzeichnis auf dem lokalen Server, in dem die Dateien gespeichert werden sollen. Wenn der Zielpfad nicht existiert, wird versucht, ihn anzulegen.
1) , 4)
FTPS
2) , 5)
FTPES
3) , 6)
SFTP