Ir para o conteúdo

Conexão FTP

Introdução

Uma conexão FTP, criada usando o conector FTP, estabelece acesso a um servidor FTP. Uma vez que a conexão é estabelecida, é possível criar instâncias de atividades FTP associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Nota

Este conector suporta a política organizacional Habilitar Re-autenticação em Caso de Alteração. Se habilitada, uma alteração no Host ou Nome de Usuário na conexão de um endpoint exigirá que os usuários reentrem a Senha para a conexão.

Criar ou editar uma conexão FTP

Uma nova conexão FTP é criada usando o conector FTP a partir de uma destas localizações:

Uma conexão FTP existente pode ser editada a partir destas localizações:

Configurar uma conexão FTP

Cada elemento da interface do usuário da tela de configuração da conexão FTP é descrito abaixo.

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir um menu com as variáveis existentes para escolher.

  • Nome da conexão: Insira um nome 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 às 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 não seguro: 21
    • FTPS explícito: 21
    • FTPS implícito: 990

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

  • Porta: Insira uma porta personalizada apenas se o servidor FTP estiver ouvindo em uma porta não padrão. Este campo é habilitado apenas se a caixa Usar porta padrão não estiver selecionada.

  • Opções de segurança: Use o dropdown para selecionar entre estas opções de segurança:

    • SFTP: Esta opção utiliza o protocolo SFTP e deve ser usada apenas 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 ao SFTP com chaves SSH. Observe que SFTP e FTP/FTPS são protocolos diferentes e usam portas padrão diferentes.

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

      Aviso

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

    • FTPS Explícito: Esta opção utiliza FTP explícito com SSL, exigindo que o cliente FTP solicite informações de segurança antes que a transferência de arquivos comece. Quando esta opção é selecionada, campos adicionais para definir Opções de SSL e escolher o Modo de Autenticação ficam disponíveis (cobertos a seguir).

      • Opções de SSL: Quando FTPS Explícito é selecionado, use o menu suspenso para selecionar uma dessas opções:

        • Tentar SSL: Isso tenta iniciar uma transferência criptografada por TLS/SSL. Se isso falhar, o FTP não criptografado é utilizado.

        • 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 senhas seja criptografada. A transferência em si não é criptografada, mas pelo menos a senha não é enviada em texto claro. Se os dados em si não forem sensíveis ou já estiverem criptografados, você pode usar esta opção. Se o servidor não suportar FTPS, a transferência falha.

        • Exigir TLS/SSL para toda transferência de dados: Selecionada por padrão, esta opção exige que tanto a conexão de controle quanto a conexão de dados sejam criptografadas usando TLS/SSL. Se o servidor não suportar SSL, a transferência falha.

      • Modo de Autenticação: Quando FTPS Explícito é selecionado, use o menu suspenso para selecionar uma dessas 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.

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

  • Configurações de Proxy: Se você deseja especificar um proxy personalizado, use o menu suspenso para selecionar uma dessas 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 estão habilitadas, utilizando a configuração de proxy do agente privado se existir uma. Se as configurações de proxy não forem especificadas na configuração do agente, então a configuração Padrão tem o mesmo resultado que a configuração Desativar.

    • Personalizado: As configurações de proxy estã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 uma, e em vez disso utiliza informações de proxy personalizadas. Quando Personalizado é selecionado, campos adicionais ficam disponíveis para você configurar. Para detalhes sobre esses campos, consulte Habilitando proxy para agentes privados.

  • Nome de usuário e Senha: Insira um nome de usuário e uma senha (se aplicável) que permitem o 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 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 de número alto.

    • Tempo limite de transferência: Especifique o número de segundos após os quais 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 pede 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 (veja Dependências de componentes, exclusão e remoção). Uma mensagem solicita que você confirme que deseja excluir a conexão.

Próximos passos

As ações do menu para uma conexão e seus tipos de atividade estão acessíveis a partir do painel do projeto e da paleta de componentes de design. Para mais detalhes, veja Menus de ações em Noções básicas sobre conectores.

Após configurar uma conexão FTP, você pode configurar uma ou mais atividades FTP associadas a essa conexão para serem usadas como uma fonte para fornecer dados a uma operação ou como um destino para consumir dados em uma operação.

Para mais informações, veja estas atividades:

  • Ler: Lê dados de um endpoint FTP e é destinada a ser usada como uma fonte em uma operação ou chamada em um script.

  • Escrever: Escreve dados em um endpoint FTP e é destinada a ser usada como um destino em uma operação ou chamada em um script.