Zum Hauptinhalt springen

(S)FTP-Verbindung

Überblick​

Mit SFTP Dispatch können Sie Analytics-Ergebnisse (die CSV-Ausgabedateien) automatisch auf Ihren eigenen SFTP-Server exportieren.
Dies ist besonders nützlich für die Integration von Berichtsdaten in Ihre internen Systeme.

warnung

SFTP Dispatch ist nur im Advanced Analytics-Paket enthalten. Im Kapitel „Analytics“, zu dem diese Seite gehört, wird beschrieben, was die einzelnen Pakete umfassen.

Voraussetzungen​

Bevor Sie die Verbindung einrichten, stellen Sie bitte sicher, dass Sie Folgendes haben:

  • Ein aktives Advanced Analytics-Abonnement.
  • Zugriff auf Ihren Ziel-SFTP-Server (Hostname, Port, Verzeichnis).
  • Ein öffentlicher Server-Schlüssel (RSA oder ED25519 im OpenSSH-Format), falls Sie die schlüsselbasierte Authentifizierung verwenden.
  • Ein Client-Benutzername und entweder ein Passwort oder ein Client-Schlüsselpaar.

Eine neue SFTP-Verbindung erstellen​

  1. Navigieren Sie zu SFTP-Verbindungen
    Gehen Sie im Portal zu Konto > SFTP-Versand > SFTP-Verbindungen.
  2. Klicken Sie auf „Als Entwurf erstellen“
    Dadurch wird die Seite „Details zur neuen SFTP-Verbindung (Entwurf)“ geöffnet.
  3. Geben Sie die allgemeinen Informationen ein
    • Verbindungsname – Ein aussagekräftiger Name für diese Verbindung (z. B. Finance CSV Export).
  4. SFTP-Serverdaten (Ziel) eingeben
    • Host – Der Hostname oder die IP-Adresse Ihres SFTP-Servers.
    • Port – Der Port des SFTP-Servers (Standard ist 22).
    • Verzeichnis – Der Pfad, in den Dateien auf dem SFTP-Server hochgeladen werden sollen.
    • Öffentlicher Schlüssel des Servers – Fügen Sie den öffentlichen Schlüssel des SFTP-Servers im OpenSSH-Format ein.
      Er muss mit ssh-rsa oder ssh-ed25519 beginnen.
  5. SFTP-Client-Daten eingeben
    • Client-Benutzername – Der Benutzername, mit dem Sie sich bei Ihrem SFTP-Server anmelden.
    • Client-Authentifizierungsmethode – Wählen Sie zwischen:
  • Schlüsselpaar
    • Optional können Sie vom Portal ein Schlüsselpaar automatisch generieren lassen.
  • Oder geben Sie Ihren eigenen privaten Client-Schlüssel im OpenSSH-Format an.
  • Sie können außerdem optional eine Passphrase für Ihren privaten Schlüssel hinzufügen.
  • Passwort
  • Geben Sie das SFTP-Passwort für den angegebenen Benutzernamen ein.
  1. Entwurf speichern
    Klicken Sie auf Als Entwurf erstellen, um Ihre Verbindungseinstellungen zu speichern.
    Sie können die Verbindung später nach Bedarf bearbeiten oder aktivieren.

Authentifizierungsmethoden​

Schlüsselpaar (empfohlen)​

  • Sicherer als die Passwortauthentifizierung.
  • Sie müssen Ihren SFTP-Server so konfigurieren, dass er dem im Portal generierten oder bereitgestellten öffentlichen Schlüssel des Clients vertraut.

Passwort​

  • Einfach einzurichten, aber weniger sicher.
  • Achten Sie auf sichere Passwörter und aktivieren Sie zusätzliche serverseitige Sicherheitsmaßnahmen.

Bewährte Verfahren​

  • Verwenden Sie aus Sicherheitsgründen stets die Authentifizierung per Schlüsselpaar.
  • Beschränken Sie das Verzeichnis des SFTP-Servers auf das für den Export erforderliche Minimum.
  • Wechseln Sie Schlüssel oder Passwörter regelmäßig aus.
  • Testen Sie die Verbindung, bevor Sie Exporte planen.

Überwachung von Versandversuchen​

Sobald Ihre SFTP-Verbindung eingerichtet ist und zum Exportieren von Analytics-Ergebnissen verwendet wird, können Sie den Status jedes einzelnen Versandversuchs überwachen.

  1. Zu den Versandversuchen navigieren
    Gehen Sie zu Konto > SFTP-Versand > Versandversuche.
  2. Details zu den Versuchen anzeigen
    Jeder Versandversuch enthält:
    • ID des Übertragungsversuchs – Eindeutige Kennung des Übertragungsversuchs.
    • Status – Gibt an, ob die Übertragung erfolgreich war (z. B. SUCCESS) oder fehlgeschlagen ist.
    • Gesendete Bytes – Größe der übertragenen Datei in Bytes.
    • Bytes des Originalinhalts – Größe der Originaldatei vor der Übertragung (sollte bei Erfolg Sent Bytes entsprechen).
    • ID der Verbindungseinstellungen – Verweist auf die verwendete SFTP-Verbindung.
    • Versand initiiert von – Der Benutzer oder die Anwendung, die den Export ausgelöst hat.
    • Referenz-ID – Abfrage- oder Auftragsreferenz der auslösenden Anwendung.
    • Versuch erstellt am – Datum und Uhrzeit, zu denen der Versand gestartet wurde.
    • Versuch aktualisiert am – Datum und Uhrzeit, zu denen der Versand abgeschlossen wurde.

Fehlerbehebung​

  • Wenn der Status nicht SUCCESS lautet, überprüfen Sie die Verbindungseinstellungen und die Serverprotokolle.
  • Stellen Sie sicher, dass die Anmeldedaten oder Schlüssel noch gültig sind.
  • Überprüfen Sie die Netzwerkverbindung zum SFTP-Server.