Risoluzione dei problemi SFTP

Informazioni sulla risoluzione dei problemi SFTP

SFTP è l’acronimo di SSH File Transfer Protocol. In sostanza, si tratta di un metodo utilizzato per trasferire i file dal server a Qualtrics o viceversa. Questa pagina illustra i problemi più comuni che si verificano durante la configurazione di una connessione SFTP e come risolvere il problema. Quando si risolvono gli errori delle connessioni SFTP, è necessario collaborare con il team IT che sarà in grado di risolvere i problemi relativi a server e rete.

Dove Qualtrics utilizza l’SFTP

Di seguito è riportata una lista di tutto il prodotto Qualtrics in cui puoi utilizzare le connessioni SFTP:

• Automazione dell’importazione contatti: importa automaticamente i contatti nella tua directory XM.
• Import&amp delle risposte; Esporta automazioni: importa o esporta automaticamente i dati del sondaggio.
• Automazioni della directory dei dipendenti: importa automaticamente i dati dei dipendenti nella tua directory EX.
• Attività Estrai dati da file SFTP: importa dati dal tuo server SFTP da utilizzare in Qualtrics.

Best practice SFTP generali

Questa sezione contiene consigli sulle best practice per assicurarsi che la connessione SFTP sia il più semplice possibile.

• Non utilizzare caratteri speciali nelle credenziali SFTP.
• Qualtrics deve “toccare” (ovvero accedere) il file più volte sul tuo server prima che venga trasferito correttamente a Qualtrics. Assicurarsi che il server SFTP sia configurato per consentire più tocchi nei file. Se il server è configurato per eliminare il file dopo un contatto, la connessione non riuscirà.
• Assicurati di aver inserito nella lista di elementi consentiti gli intervalli IP di Qualtrics. Gli intervalli da includere nella lista di elementi consentiti sono disponibili qui.
  Qtip: sono gli stessi intervalli IP per distribuzioni e-mail, configurazioni SSO, automazioni, ecc.
  Qtip: se l’account si trova all’interno dell’ambiente FedRAMP, gli indirizzi IP per l’inserimento nell’elenco di elementi consentiti sono diversi da quelli presenti in questa pagina. Per accedere in modo sicuro alle informazioni sull’indirizzo IP, accedi al tuo FedRAMP Customer Success Hub.

Problemi di rete SFTP

Esistono diversi problemi di rete comuni che possono verificarsi durante la configurazione di una connessione SFTP. Per diagnosticare problemi di rete, contatta il supporto Qualtrics che sarà in grado di dirti se l’SFTP non riesce a causa di un problema di rete.

Se un membro dell’assistenza rileva che un problema di rete sta causando l’errore della connessione SFTP, sarà necessario collaborare con il team IT per risolvere il problema. Le questioni di rete più comuni sono:

• Timeout I/O: i timeout I/O sono causati dal fatto che il server SFTP non risponde alle richieste del client SFTP Qualtrics. Nome utente/nome host errato causa comunemente errori di timeout I/O.
• Connessione resettata da errori di peer: la connessione reimpostata da errori di pari livello è causata dal server SFTP Qualtrics che riceve un pacchetto RST TCP. Questo pacchetto segnala che il server deve chiudere la connessione.

La maggior parte dei problemi di rete, inclusi i due sopra menzionati, sono causati da un firewall, un IPS o un altro sistema di controllo della rete all’interno della rete del server SFTP. Qualtrics non dispone di alcun sistema nella nostra rete che possa causare tali problemi. Per contribuire a mitigare questi problemi, puoi fare in modo che il tuo team IT aggiunga gli intervalli IP Qualtrics alla lista di elementi consentiti del tuo server per assicurarti che nessun traffico proveniente da noi sia bloccato sul tuo server.

Se l’inserimento nella lista di elementi consentiti non risolve il problema, il team IT deve eseguire un monitoraggio dei pacchetti all’interno della rete del server SFTP per determinare cosa sta causando il problema nella rete. I problemi comuni sono i pacchetti rilasciati o i pacchetti RST inviati in modo errato. Se il tuo team IT ritiene che l’insolita attività di rete sia causata da Qualtrics, chiediamo che ci invii un dump del pacchetto al limite della rete.

Problemi del server SFTP

I problemi del server SFTP si verificano quando si verifica un problema con il computer che esegue il server SFTP. Per diagnosticare i problemi del server, contatta il Supporto Qualtrics che sarà in grado di dirti se l’SFTP non riesce a causa di un problema del server.

I problemi più comuni del server SFTP sono:

• Metodi di crittografia non corrispondenti.
  Consiglio Q: Crittografia non supportata su importazione risposte & esporta automazioni.
• Script o bot personalizzati in esecuzione sul server SFTP che gestiscono i file e sono in conflitto con il processo di inserimento dei file di automazione.
• Le barre ( / ) nel percorso della cartella sono nella direzione errata. Se la connessione all’SFTP è stata eseguita correttamente ma non sono ancora visibili i file disponibili per l’importazione, potrebbe essere necessario cambiare la direzione delle barre.

Per correggere metodi di crittografia non corrispondenti, assicurati che il tuo server utilizzi una delle crittografie supportate da Qualtrics.

Le automazioni Qualtrics non supportano alcuna gestione file aggiuntiva oltre al protocollo SFTP di base. Se disponi di un sistema che elimina o sposta un file dopo che è stato “toccato”, o se il tuo sistema consente solo un file “toccare” così tante volte prima che fallisca, dovrai rimuovere queste misure aggiuntive affinché il server SFTP sia compatibile con le automazioni Qualtrics. Qualtrics gestisce l’inserimento dei file sul server e li “toccherà” diverse volte prima di rimuoverli.

Nel caso in cui il reparto IT/Networking sospetti che attività irregolari sul server SFTP provengano da Qualtrics, chiediamo che forniscano al nostro team di supporto una copia dei registri SFTP rilevanti. È importante che il reparto IT identifichi e spieghi chiaramente eventuali anomalie riscontrate nei registri, poiché non siamo in grado di interpretarli senza un contesto appropriato.

Sorgenti di importazione alternative

Se le raccomandazioni di cui sopra non hanno aiutato te e il tuo team IT a risolvere il problema, potresti voler cercare modi alternativi per importare i tuoi file. Si consiglia di passare a una sorgente di importazione dati alternativa. È possibile utilizzare una delle seguenti alternative:

• Il file service di Qualtrics è un servizio di hosting di file HTTPS fornito gratuitamente con automazioni e che funziona direttamente con le automazioni. Qui è possibile trovare una documentazione API dettagliata su come utilizzare questo servizio. Se selezioni il file service di Qualtrics durante l’impostazione della tua automazione, ti guideremo nell’utilizzo.
• Qualtrics offre i nostri server SFTP per i clienti attraverso il nostro team di servizi professionali. Esiste un costo associato a questo servizio; tuttavia, garantiamo che questi server funzioneranno con le automazioni. Per ulteriori informazioni, contatta il nostro team di servizi professionali.
• È possibile utilizzare Google Drive e Dropbox come servizi di trasferimento file alternativi durante la configurazione dell’automazione.
• Provare a utilizzare un server SFTP alternativo. Al momento non sono presenti fornitori consigliati.

Autenticazione chiave SSH

È possibile eseguire l’autenticazione a un server SFTP utilizzando un nome utente e una password oppure un nome utente e una chiave SSH. Se puoi autenticarti con successo con un nome utente e una password, ma non puoi farlo con la chiave SSH, ecco alcune cose che puoi testare:

1. Assicurarsi che la parte pubblica della coppia di chiavi SSH sia stata aggiunta al file authorized_keys del server. Quando si genera la coppia di chiavi SSH, si viene quindi indirizzati a scaricare la chiave pubblica, che si dovrebbe aggiungere al server.
   
2. Se si crea una coppia di chiavi SSH, sarà necessario assicurarsi che la chiave pubblica venga aggiornata anche nel server. Per assicurarti che la chiave pubblica corretta sia attualmente aggiunta al tuo server, ricontrolla la sua integrità con l’impronta digitale mostrata nell’interfaccia utente Qualtrics. (L’impronta digitale esatta varia per ogni automazione.)
   
   Consiglio Q: L’impronta digitale della chiave pubblica viene visualizzata in Qualtrics mentre stai configurando il tuo SSH. Una volta scaricato il file della chiave pubblica, è anche possibile eseguire il seguente comando sul computer in cui è memorizzata la chiave pubblica per ottenere la relativa impronta digitale:
   ssh-keygen -lf <path_to_public_key_file>
   Se non sei sicuro di come eseguire i comandi, contatta il tuo team IT per ricevere assistenza.
3. Se le autorizzazioni per la directory .ssh o per il file authorized_keys sul server remoto non sono abbastanza rigide, il server SSH può rifiutarsi di autenticarsi con la coppia di chiavi. La cartella .ssh deve essere 700 e il file authorized_keys 600.
4. SSH richiede rigorosamente che la directory SSH, il file authorized_keys e la home directory dell’utente non siano scrivibili da altri utenti. In caso affermativo, l’autenticazione della chiave non riuscirà. Solo il proprietario della directory (che è generalmente l’utente che esegue il servizio SSH) dovrebbe avere la possibilità di modificare (scrivere) questi file e directory. I gruppi e gli altri utenti non devono essere autorizzati ad apportare modifiche.
   
5. È possibile che il server SSH/SFTP non sia stato configurato per consentire l’autenticazione della chiave. Nel suo caso, nel file di configurazione SSHD del server, le impostazioni potrebbero aver disabilitato l’autenticazione a chiave pubblica.
   Qtip: È possibile controllare l’indicatore PubkeyAuthentication nel file /etc/ssh/sshd_config e impostarlo su yes. Le chiavi pubbliche devono essere aggiunte alle authorized_keys. Qualtrics utilizza una chiave privata per accedere. Quando si utilizza una chiave privata per accedere al server SSH, il server controlla la chiave pubblica corrispondente nel file authorized_keys. Se la chiave pubblica viene trovata e corrisponde, l’utente viene autenticato e gli viene concesso l’accesso.
6. La configurazione di un firewall potrebbe impedire la connessione tramite coppie di chiavi. Collaborare con l’amministratore di rete per risolvere il problema. Alcuni altri suggerimenti utili elencati di seguito:

• • È possibile recuperare l’IP del server SFTP utilizzando dig your.SFTPserver.com.
    Consiglio Q: Per trovare l’indirizzo IP del server SFTP, contatta il team IT della tua organizzazione.
  • Assicurati di inserire gli IP dei server Qualtrics nella lista di elementi consentiti e che la tua parete antincendio non stia bloccando queste informazioni.