Conexão FTP¶

Introdução¶

Uma conexão FTP é configurada usando o conector FTP, estabelecendo acesso a um servidor FTP. Depois que uma conexão for estabelecida, você poderá configurar uma ou mais atividades FTP associadas a essa conexão para serem usadas como fonte para fornecer dados a uma operação ou script ou como destino para consumir dados em uma operação ou script.

Crie Ou Edite uma Conexão FTP¶

Uma nova conexão FTP é criada usando o conector FTP de um destes locais:

• A aba Conexões da paleta de componentes de design (consulte Paleta de Componentes de Design).
• A página Conexões globais (consulte Criar uma conexão global em Conexões Globais).

Uma conexão FTP existente pode ser editada nestes locais:

• A aba Conexões da paleta de componentes de design (consulte Paleta de Componentes de Design).
• A aba Componentes do painel do projeto (consulte Menu Ações do componente em Guia Componentes do painel do projeto).
• A página Conexões globais (consulte Editar uma conexão global em Conexões Globais).

Configurar uma Conexão FTP¶

A configuração de uma conexão FTP inclui estes campos:

• Nome do Endpoint: Insira um nome a ser usado para identificar a conexão FTP. O nome deve ser exclusivo para cada conexão FTP e não deve conter barras (/) ou dois pontos (:). Este nome também é usado para identificar o endpoint FTP, que se refere tanto a uma conexão específica quanto a suas atividades.

• Host: Insira um local de servidor FTP válido.

• Usar porta padrão: Mantenha esta caixa de seleção marcada para usar a porta padrão. A porta padrão depende da opção de segurança selecionada:

  • SFTP: 22
  • FTP inseguro: 21
  • FTPS explícito: 21
  • FTPS implícito: 990

  Se você não quiser usar a porta padrão, desmarque a caixa de seleção Usar porta padrão e insira a porta a ser usada no campo Porta abaixo.

• Porta: Insira uma porta personalizada somente se o servidor FTP estiver escutando uma porta não padrão. Este campo estará habilitado somente se a caixa Usar porta padrão não estiver selecionada.

• Opções de segurança: Use o menu suspenso para selecionar uma destas opções de segurança:

  • SFTP: Esta opção usa o protocolo SFTP e deve ser usada somente se você estiver se conectando a um servidor SFTP. Arquivos de chave pública e privada para SFTP podem ser configurados na seção SSH do arquivo de configuração do Agente Privado, conforme descrito em Conectando-se ao SFTP com chaves SSH. Observe que SFTP e FTP/FTPS são protocolos diferentes e usam portas padrão diferentes.

  • FTP inseguro: Esta opção usa FTP não criptografado e não é segura porque as senhas são enviadas em texto não criptografado pela rede.

    Aviso

    Esta opção deve ser usada somente se o ambiente for seguro.

  • FTPS explícito: Esta opção usa FTP explícito com SSL, exigindo que o cliente FTP solicite informações de segurança antes do início de uma transferência de arquivo. Quando esta opção é selecionada, campos adicionais para definir Opções de SSL e escolher o Modo de autenticação ficam disponíveis (abordados a seguir).

  • FTPS implícito: Esta opção usa FTPS implícito ( FTP implícito com TLS/SSL), exigindo uma conexão TLS/SSL antes da transferência de arquivos.

• Opções de SSL: Quando FTPS explícito for selecionado, use o menu suspenso para selecionar uma destas opções:

  • Tente SSL: Isso tenta iniciar uma transferência criptografada por TLS/SSL. Se isso falhar, será usado FTP não criptografado.
  • Exigir TLS/SSL para conexão de controle: Com esta opção, a conexão de controle FTP inicial é criptografada usando TLS/SSL para garantir que a troca de senha seja criptografada. A transferência em si não é criptografada, mas pelo menos a senha não é enviada em texto não criptografado. Se os dados em si não forem confidenciais ou já estiverem criptografados, você poderá usar esta opção. Se o servidor não suportar FTPS, a transferência falhará.
  • Exigir TLS/SSL para todas as transferências de dados: Selecionada por padrão, esta opção requer que a conexão de controle e a conexão de dados sejam criptografadas usando TLS/SSL. Se o servidor não suportar SSL, a transferência falhará.

• Modo de autenticação: Quando FTPS explícito estiver selecionado, use o menu suspenso para selecionar uma destas opções:

  • Preferir autenticação TLS: Selecionada por padrão, esta opção especifica que a autenticação TLS é preferida.
  • Preferir autenticação SSL: Esta opção especifica que a autenticação SSL é preferida.

• Configurações de proxy: Se você quiser especificar um proxy personalizado, use o menu suspenso para selecionar uma destas opções:

  • Desativar: As configurações de proxy estão desativadas para esta fonte específica, ignorando a configuração de proxy do Agente Privado se existir.
  • Padrão: As configurações de proxy são habilitadas, usando a Configuração de proxy do Agente Privado se existir. Se as configurações de proxy não forem especificadas na configuração do agente, a configuração Padrão terá o mesmo resultado que a configuração Desativar.
  • Personalizado: As configurações de proxy são habilitadas para esta fonte específica usando informações personalizadas fornecidas aqui. Esta opção ignora a configuração de proxy do Agente Privado se existir e, em vez disso, usa informações de proxy personalizadas. Quando Personalizado é selecionado, campos adicionais ficam disponíveis para você configurar. Para obter detalhes sobre esses campos, consulte Ativando proxy para Agentes Privados.

• Nome de usuário e Senha: Insira um nome de usuário e senha (se aplicável) que permita acesso ao servidor FTP. Você pode deixar esses campos em branco se nenhum nome de usuário ou senha for necessário.

• Configurações opcionais: Clique para expandir configurações opcionais adicionais:

  

  • Modo Passivo: Mantenha esta caixa de seleção marcada para usar o método PASV do servidor FTP para recuperar arquivos. Quando esta opção está habilitada, o agente abre uma conexão de controle com o servidor FTP, informa ao servidor FTP para esperar uma segunda conexão e, em seguida, abre a conexão de dados com o próprio servidor FTP em uma porta de número alto escolhida aleatoriamente. Isso funciona com a maioria dos firewalls, a menos que o firewall restrinja conexões de saída em portas com números altos.

  • Tempo limite de transferência: Especifique o número de segundos após o qual uma transferência FTP expira. Por padrão, esse número é 14.400 segundos ou 4 horas. Inserir um valor neste campo substitui o valor de tempo limite padrão.

• Teste: Clique para verificar a conexão. O servidor verifica apenas se o diretório especificado existe e não se o usuário especificado tem permissão de gravação no diretório.

• Salvar alterações: Clique para salvar e fechar a configuração da conexão.

• Descartar alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem solicita que você confirme que deseja descartar as alterações.

• Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (consulte Dependências, exclusão e remoção de componentes). Uma mensagem solicita que você confirme que deseja excluir a conexão.

Próximos Passos¶

Após a criação de uma conexão FTP, as ações de menu para essa conexão estarão acessíveis na guia Componentes do aba do projeto. Consulte Menu Ações de conexão para detalhes.

Depois de configurar uma conexão FTP, você pode configurar uma ou mais atividades FTP associadas a essa conexão para serem usadas como origem (para fornecer dados dentro de uma operação) ou como destino (para consumir dados dentro de uma operação), ou para serem usadas em um script.

Use o menu suspenso Mostrar para filtrar Endpoints e, em seguida, clique no bloco de conexão FTP para exibir atividades que estão disponíveis para uso com uma conexão FTP:

Para obter mais informações, consulte estas atividades:

• Ler: Lê dados de um endpoint FTP e destina-se a ser usado como fonte em uma operação ou chamado em um script.
• Escrever: Grava dados em um endpoint FTP e deve ser usado como destino em uma operação ou chamado em um script.