Con il connettore FTPS, puoi utilizzare i comandi in una catena per interagire con un server FTP (File Transfer Protocol) o FTP Secure (FTPS). Ad esempio, con questo connettore puoi:
- Caricare e scaricare file su un server
- Creare e cancellare directory
- Spostare o copiare file
- Elenco di file e cartelle
Nota: Per interagire con un server Secure Shell FTP (SFTP) all'interno di una catena, utilizza il connettore SFTP.
Prerequisiti
Per utilizzare il connettore FTPS, la tua organizzazione deve avere accesso a un proprio server FTP/S. Workiva non ospita né fornisce server FTP/S.
Per proteggere la connessione al tuo server, il connettore utilizza un'autenticazione di base con nome utente e password. Per configurare la connessione, avrai bisogno di:
- Il nome host del server
- La porta su cui gira il server
- Le credenziali di autenticazione da utilizzare per connettersi al server
- Il protocollo che il server utilizza per trasmettere i dati: FTP o FTPS.
- Per un server FTPS, se richiede trasferimenti di dati crittografati
- Per connettersi a un server on-premise, il GroundRunner per eseguire i comandi
Nota: Il connettore supporta l'FTP/S esplicito, non l'FTP/S implicito.
Imposta il connettore FTPS
Nota: Per rendere il connettore disponibile per l'uso nelle catene della tua organizzazione, un amministratore della sicurezza dell'org deve prima abilitarlo da Configurazione.
- Da Builder catena, clicca su Connessioni e poi su Crea in alto a destra.
- Sotto Connettore Connessione, seleziona Connettore FTPS e il runner da utilizzare con il connettore.
- In Informazioni di base, inserisci un nome e una descrizione unici per identificare la connessione.
- In Proprietà, inserisci i dettagli della connessione:
Proprietà Dettagli Hostname Inserisci il nome host del server, ad esempio ftp.domain.com.Porta Inserisci la porta su cui gira il server; per impostazione predefinita, 21.Nota: Il connettore supporta l'FTP/S esplicito sulla porta 21, non l'FTP/S implicito sulla porta 990.
Nome utente Inserisci il nome utente utilizzato per accedere al server. Password Inserisci la password per la proprietà Nome utente. Protocollo Seleziona se il server utilizza il protocollo FTP o FTPS per trasferire i dati. Valore PROT Se la proprietà Protocollo è FTPS, seleziona la modalità di trasferimento dei dati da parte del server. - Se richiede trasferimenti criptati, seleziona P (Crittografato).
- Se supporta trasferimenti non criptati, seleziona C (Non criptato).
Riutilizzo della sessione Abbina questa impostazione alla configurazione del tuo server. Il valore predefinito è Vero.
Tieni presente che il connettore tenterà sempre di riutilizzare la sessione SSL/TLS durante l'esecuzione di un comando; questa impostazione si limita a controllare cosa succede dopo questo punto:
- Se impostato su "True": Se la sessione non può essere riutilizzata, il comando fallirà.
- Se impostato su "False": Se la sessione non può essere riutilizzata, il comando passerà a una nuova sessione. Se la nuova sessione non può essere utilizzata, il comando fallirà.
Nota: Tutte le credenziali sensibili vengono automaticamente crittografate e memorizzate con la crittografia Advanced Encryption Standard (AES)-256.
- Seleziona gli ambienti da utilizzare per la connessione e clicca su Salva.
- Per testare la connessione, crea ed esegui una catena con il comando List Files/Folders del connettore e verifica che restituisca un output valido.
Risoluzione dei problemi
Se la connessione al server fallisce:
- Verifica che le credenziali di autenticazione del connettore siano corrette. Ad esempio, usa le stesse credenziali per connetterti al server attraverso un'applicazione client SFTP come FileZilla o WinSCP.
- Controlla il nome dell'host, la porta e il protocollo del server.
- Verifica l'impostazione di riutilizzo della sessione. L'impostazione predefinita è "true" e di solito non deve essere modificata.