SFTP-Fehlerbehebung

Informationen zur SFTP-Fehlerbehebung

SFTP steht für SSH File Transfer Protocol. Im Wesentlichen ist dies eine Methode, mit der Dateien von Ihrem Server an Qualtrics oder umgekehrt übertragen werden. Diese Seite behandelt die häufigsten Probleme, die beim Einrichten einer SFTP-Verbindung auftreten, und die Fehlerbehebung. Bei der Fehlerbehebung für SFTP-Verbindungen sollten Sie mit Ihrem IT-Team zusammenarbeiten, das bei Server- und Netzwerkproblemen helfen kann.

Wo Qualtrics SFTP verwendet

Im Folgenden finden Sie eine Liste aller Stellen im Qualtrics-Produkt, an denen Sie SFTP-Verbindungen verwenden können:

• Kontaktimportautomatisierung: Importieren Sie Kontakte automatisch in Ihr XM-Verzeichnis.
• Antwortimport & Automatisierungen exportieren: Umfragedaten automatisch importieren oder exportieren.
• Automatisierungen des Mitarbeiterverzeichnisses: Mitarbeiterdaten automatisch in Ihr EX-Verzeichnis importieren.
• Aufgabe „Daten aus SFTP-Dateien extrahieren“: Importieren Sie Daten von Ihrem SFTP-Server, um sie in Qualtrics zu verwenden.

Allgemeine SFTP Best Practices

Dieser Abschnitt enthält Empfehlungen zu bewährten Geschäftsverfahren, um sicherzustellen, dass Ihre SFTP-Verbindung so reibungslos wie möglich ist.

• Verwenden Sie keine Sonderzeichen in Ihren SFTP-Anmeldeinformationen.
• Qualtrics muss die Datei mehrmals auf Ihrem Server „berühren“ (d. h. aufrufen), bevor sie erfolgreich an Qualtrics übertragen wird. Stellen Sie sicher, dass Ihr SFTP-Server so konfiguriert ist, dass mehrere Zugriffe auf Dateien zulässig sind. Wenn Ihr Server so eingerichtet ist, dass die Datei nach einer Berührung gelöscht wird, schlägt die Verbindung fehl.
• Stellen Sie sicher, dass Sie die Qualtrics-IP-Bereiche auf die Erlaubtliste gesetzt haben. Die Bereiche für die Erlaubtliste finden Sie hier.
  Tipp: Dies sind dieselben IP-Bereiche für E-Mail-Verteilungen, SSO-Konfigurationen, Automatisierungen usw.
  Tipp: Wenn sich Ihr Konto in unserer FedRAMP-Umgebung befindet, unterscheiden sich die IP-Adressen für die Erlaubtliste von denen auf dieser Seite. Um sicher auf Ihre IP-Adressinformationen zuzugreifen, melden Sie sich bei Ihrem FedRAMP Customer Success Hub an.

SFTP-Netzwerkprobleme

Es gibt mehrere häufige Netzwerkprobleme, die beim Einrichten einer SFTP-Verbindung auftreten können. Um Netzwerkprobleme zu diagnostizieren, wenden Sie sich an den Qualtrics Support, der Ihnen mitteilen kann, ob Ihr SFTP aufgrund eines Netzwerkproblems fehlschlägt.

Wenn ein Support-Mitglied feststellt, dass die SFTP-Verbindung aufgrund eines Netzwerkproblems fehlschlägt, müssen Sie mit Ihrem IT-Team zusammenarbeiten, um das Problem zu beheben. Die häufigsten Netzwerkprobleme sind:

• E/A-Timeouts: E/A-Timeouts werden dadurch verursacht, dass der SFTP-Server nicht auf die Anforderungen des Qualtrics-SFTP-Clients antwortet. Ein falscher Benutzername/Hostname führt häufig zu E/A-Timeout-Fehlern.
• Verbindung durch Peer-Fehler zurückgesetzt: Das Zurücksetzen der Verbindung durch Peer-Fehler wird dadurch verursacht, dass der Qualtrics-SFTP-Server ein RST-TCP-Paket empfängt. Dieses Paket signalisiert, dass der Server die Verbindung schließen soll.

Die meisten Netzwerkprobleme, einschließlich der beiden oben genannten, werden durch eine Firewall, IPS oder ein anderes Netzwerksteuerungssystem innerhalb des Netzwerks des SFTP-Servers verursacht. Qualtrics hat kein System in unserem Netzwerk, das solche Probleme verursachen würde. Um diese Probleme zu beheben, können Sie Ihr IT-Team die Qualtrics-IP-Bereiche zur Erlaubtliste Ihres Servers hinzufügen lassen, um sicherzustellen, dass kein Datenverkehr von uns auf Ihrem Server blockiert wird.

Wenn die Erlaubtliste das Problem nicht behebt, sollte Ihr IT-Team ein Paket-Trace im Netzwerk des SFTP-Servers ausführen, um zu ermitteln, was im Netzwerk das Problem verursacht. Häufige Probleme sind gelöschte Pakete oder falsch gesendete RST-Pakete. Wenn Ihr IT-Team der Meinung ist, dass die ungewöhnliche Netzwerkaktivität durch Qualtrics verursacht wird, bitten wir darum, dass es uns eine Paketsicherung am Rand des Netzwerks sendet.

SFTP-Serverprobleme

SFTP-Serverprobleme treten auf, wenn ein Problem mit dem Rechner auftritt, auf dem der SFTP-Server ausgeführt wird. Um Serverprobleme zu diagnostizieren, wenden Sie sich an den Qualtrics Support, der Ihnen mitteilen kann, ob Ihr SFTP aufgrund eines Serverproblems fehlschlägt.

Die häufigsten SFTP-Serverprobleme sind:

• Nicht übereinstimmende Verschlüsselungsmethoden.
  Tipp: Verschlüsselung wird beim Antwortimport &amp nicht unterstützt; exportieren Sie Automatisierungen.
• Benutzerdefinierte Skripte oder Bots, die auf dem SFTP-Server ausgeführt werden und Dateien verwalten und mit dem Aufnahmeprozess der Automatisierungsdatei in Konflikt stehen.
• Die Schrägstriche (/) im Ordnerpfad haben eine falsche Richtung. Wenn Sie erfolgreich eine Verbindung mit SFTP hergestellt haben, aber immer noch keine für den Import verfügbaren Dateien sehen, müssen Sie möglicherweise die Richtung der Schrägstriche ändern.

Um nicht übereinstimmende Verschlüsselungsmethoden zu beheben, stellen Sie sicher, dass Ihr Server eine der von Qualtrics unterstützten Verschlüsselungen verwendet.

Qualtrics-Automatisierungen unterstützen keine zusätzliche Dateiverwaltung zusätzlich zum grundlegenden SFTP-Protokoll. Wenn Sie ein System haben, das eine Datei löscht oder verschiebt, nachdem sie „angefasst“ wurde, oder wenn Ihr System eine Datei nur so oft „Berühren“ zulässt, bevor sie fehlschlägt, müssen Sie diese zusätzlichen Maßnahmen entfernen, damit der SFTP-Server mit Qualtrics-Automatisierungen kompatibel ist. Qualtrics verwaltet die Aufnahme der Dateien selbst auf dem Server und „berühren“ die Dateien mehrmals, bevor sie entfernt werden.

Wenn Ihre IT-/Netzwerkabteilung vermutet, dass unregelmäßige Aktivitäten auf dem SFTP-Server von Qualtrics stammen, bitten wir um eine Kopie der relevanten SFTP-Protokolle an unser Support-Team. Es ist wichtig, dass Ihre IT-Abteilung alle in den Protokollen gefundenen Auffälligkeiten eindeutig identifiziert und erläutert, da wir diese Protokolle ohne korrekten Kontext nicht interpretieren können.

Alternative Importquellen

Wenn die oben genannten Empfehlungen Ihnen und Ihrem IT-Team beim Beheben des Problems nicht geholfen haben, können Sie sich alternative Möglichkeiten zum Importieren Ihrer Dateien ansehen. Wir empfehlen, zu einer alternativen Datenimportquelle zu wechseln. Sie können eine der folgenden Alternativen verwenden:

• Der Qualtrics-Dateiservice ist ein HTTPS-Datei-Hosting-Service, der kostenlos mit Automatisierungen bereitgestellt wird und direkt mit Automatisierungen arbeitet. Eine detaillierte API-Dokumentation zur Verwendung dieses Service finden Sie hier. Wenn Sie beim Einrichten Ihrer Automatisierung den Qualtrics-Dateidienst auswählen, werden Sie durch die Verwendung geführt.
• Qualtrics bietet über unser Professional-Services-Team unsere eigenen SFTP-Server für Kunden an. Mit diesem Service sind Kosten verbunden. Wir garantieren jedoch, dass diese Server mit Automatisierungen funktionieren. Weitere Informationen erhalten Sie von unserem Professional-Services-Team.
• Sie können Google Drive und Dropbox als alternative Dateilöschdienste verwenden, wenn Sie Ihre Automatisierung einrichten.
• Versuchen Sie es mit einem alternativen SFTP-Server. Wir haben derzeit keine empfohlenen Anbieter.

SSH-Schlüsselauthentifizierung

Sie können sich bei einem SFTP-Server entweder mit einem Benutzernamen und einem Kennwort oder mit einem Benutzernamen und einem SSH-Schlüssel authentifizieren. Wenn Sie sich erfolgreich mit einem Benutzernamen und einem Kennwort authentifizieren können, dies jedoch nicht mit dem SSH-Schlüssel tun können, können Sie Folgendes testen:

1. Stellen Sie sicher, dass der öffentliche Teil des SSH-Schlüsselpaars der Datei authorized_keys des Servers hinzugefügt wurde. Wenn Sie das SSH-Schlüsselpaar generieren, werden Sie aufgefordert, den öffentlichen Schlüssel herunterzuladen, den Sie Ihrem Server hinzufügen sollten.
   
2. Wenn Sie ein SSH-Schlüsselpaar anlegen, müssen Sie sicherstellen, dass Ihr öffentlicher Schlüssel auch auf dem Server aktualisiert wird. Um sicherzustellen, dass Ihrem Server derzeit der richtige öffentliche Schlüssel hinzugefügt wird, überprüfen Sie die Integrität mit dem Fingerabdruck, der auf der Qualtrics-Benutzeroberfläche angezeigt wird. (Der genaue Fingerabdruck variiert für jede Automatisierung.)
   
   Tipp: Der Fingerabdruck des öffentlichen Schlüssels wird in Qualtrics angezeigt, während Sie Ihren SSH einrichten. Nachdem Sie die öffentliche Schlüsseldatei heruntergeladen haben, können Sie auch den folgenden Befehl auf dem Computer ausführen, auf dem Ihr öffentlicher Schlüssel gespeichert ist, um seinen Fingerabdruck zu erhalten:
   ssh-keygen -lf <path_to_public_key_file>
   Wenn Sie sich nicht sicher sind, wie Sie Befehle ausführen, wenden Sie sich an Ihr IT-Team, um Unterstützung zu erhalten.
3. Wenn die Berechtigungen für das .ssh-Verzeichnis oder für die authorized_keys-Datei auf dem Fremdserver nicht strikt genug sind, kann der SSH-Server die Authentifizierung mit dem Schlüsselpaar ablehnen. Der Ordner .ssh sollte 700 und die Datei authorized_keys 600 lauten.
4. SSH erfordert strikt, dass das SSH-Verzeichnis, die authorized_keys-Datei und das Home-Verzeichnis des Benutzers von anderen Benutzern nicht schreibbar sind. Wenn dies der Fall ist, schlägt die Schlüsselauthentifizierung fehl. Nur der Verzeichniseigentümer (der in der Regel der Benutzer ist, der den SSH-Service ausführt) sollte in der Lage sein, diese Dateien und Verzeichnisse zu ändern (zu schreiben). Gruppen und andere Benutzer sollten nicht berechtigt sein, Änderungen vorzunehmen.
   
5. Möglicherweise wurde der SSH/SFTP-Server nicht für die Schlüsselauthentifizierung konfiguriert. In diesem Fall könnten die Einstellungen in der SSHD-Konfigurationsdatei des Servers die Authentifizierung mit öffentlichen Schlüsseln deaktiviert haben.
   Tipp: Sie können das Kennzeichen PubkeyAuthentication in Ihrer Datei /etc/ssh/sshd_config prüfen und auf yes setzen. Die öffentlichen Schlüssel sollten zu authorized_keys hinzugefügt werden. Qualtrics verwendet einen privaten Schlüssel, um sich anzumelden. Wenn ein privater Schlüssel für die Anmeldung am SSH-Server verwendet wird, prüft der Server den entsprechenden öffentlichen Schlüssel in der Datei authorized_keys. Wenn der öffentliche Schlüssel gefunden wird und übereinstimmt, wird der Benutzer authentifiziert und erhält Zugriff.
6. Ein Firewall-Setup könnte verhindern, dass die Verbindung über Schlüsselpaare hergestellt wird. Wenden Sie sich an Ihren Netzwerkadministrator, um das Problem zu beheben. Nachfolgend sind einige weitere hilfreiche Tipps aufgeführt:

• • Sie können Ihre SFTP-Server-IP mit dig your.SFTPserver.com abrufen.
    Tipp: Um die IP-Adresse Ihres SFTP-Servers zu finden, wenden Sie sich an das IT-Team Ihres Unternehmens.
  • Stellen Sie sicher, dass Sie Qualtrics-Server-IPs auf die Erlaubtliste setzen und dass Ihre Firewall diese Informationen nicht blockiert.