Com o conector FTPS, você pode usar os comandos em uma cadeia para interagir com um servidor de protocolo de transferência de arquivos (FTP) ou FTP Secure (FTPS). Por exemplo, com esse conector, você pode:
- Fazer upload e download de arquivos em um servidor
- Criar e excluir diretórios
- Mover ou copiar arquivos
- Listar arquivos e pastas
Observação: Para interagir com um servidor Secure Shell FTP (SFTP) em uma cadeia, use o conector SFTP.
Pré-requisitos
Para usar o conector FTPS, sua organização precisa ter acesso a seu próprio servidor FTP/S. A Workiva não hospeda nem fornece servidores FTP/S. Você pode usar o conector para proteger a conexão com seu servidor.
Para proteger a conexão com o seu servidor, o conector usa autenticação básica de nome de usuário e senha. Para configurar a conexão, você precisará de:
- O nome do host do servidor
- A porta em que o servidor é executado
- As credenciais de autenticação que você deve usar para se conectar ao servidor
- O protocolo que o servidor usa para transmitir dados - FTP ou FTPS
- Para um servidor FTPS, se ele exige transferências de dados criptografadas
- Para conectar-se a um servidor local, o GroundRunner para executar os comandos
Observação: O conector é compatível com explícito FTP/S, não FTP/S implícito.
Configure o conector FTPS
Observação: Para tornar o conector disponível para uso nas cadeias de sua organização, um administrador de segurança da organização primeiro o habilita em Configuração.
- Em Construtor de cadeia, clique em Conexões e, em seguida, Criar no canto superior direito.
- Em Connector Connection, selecione FTPS Connector e o executor a ser usado com o conector.
- Em Informações básicas, digite um nome e uma descrição exclusivos para ajudar a identificar a conexão.
- Em Propriedades, digite os detalhes da conexão:
Propriedade Detalhes Nome do host Digite o nome do host do servidor, como, por exemplo, ftp.domain.com.Porto Digite a porta em que o servidor é executado; por padrão, 21.Observação: O conector oferece suporte a explícito FTP/S pela porta 21, não FTP/S implícito pela porta 990.
Nome de usuário Digite o nome de usuário usado para fazer login no servidor. Senha Digite a senha da propriedade Nome de usuário. Protocolo Selecione se o servidor usa o protocolo FTP ou FTPS para transferir dados. Valor PROT Se a propriedade Protocol for FTPS, selecione como o servidor transfere os dados. - Se você precisar de transferências criptografadas, selecione P (Encrypted).
- Se for compatível com transferências não criptografadas, selecione C (Não criptografado).
Reutilização de sessão Faça a correspondência dessa configuração com a configuração do servidor. O padrão é True.
Observe que o conector sempre tentará reutilizar a sessão SSL/TLS ao executar um comando; essa configuração apenas controla o que acontece depois desse ponto:
- Quando definido como "True": Se a sessão não puder ser reutilizada, o comando falhará.
- Quando definido como "False",: Se a sessão não puder ser reutilizada, o comando mudará para uma nova sessão. Se a nova sessão ainda não puder ser usada, o comando falhará.
Observação: Todas as credenciais confidenciais são automaticamente criptografadas e armazenadas com criptografia Advanced Encryption Standard (AES) 256.
- Selecione os ambientes para usar a conexão e clique em Save.
- Para testar a conexão, crie e execute uma cadeia com o comando Listar arquivos do conector e verifique se ele retorna uma saída válida.
Solução de problemas
Se a conexão com o servidor falhar:
- Verifique se as credenciais de autenticação do conector estão corretas.Por exemplo, use as mesmas credenciais para se conectar ao servidor por meio de um aplicativo cliente SFTP, como ArquivoZilla ou WinSCP.
- Verifique o nome do host, a porta e o protocolo do servidor.
- Verifique a configuração de reutilização da sessão. O padrão é "true" e geralmente não deve ser alterado.