Ir para o conteúdo

Transforme as suas conexões em um bônus de fim de ano com o nosso novo Programa de Indicação de Clientes! Saiba mais

✕

Conexão FTP

Introdução

Uma conexão FTP, criada usando o conector FTP, estabelece acesso a um servidor FTP. Após o estabelecimento de uma conexão, você pode criar instâncias de atividades FTP associadas a essa conexão para serem usadas como origens (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).

Nota

Este conector oferece suporte à política da organização Habilitar Reautenticação na Alteração. Se habilitado, uma alteração no Host ou no Nome de Usuário na conexão de um endpoint exigirá que os usuários digitem novamente a Senha para a conexão.

Criar ou editar uma conexão FTP

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

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

Configurar uma conexão FTP

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

Configuração de conexão FTP

Dica

Campos com ícone de variável suporte usando variáveis globais, variáveis do projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone da variável para exibir uma lista das 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ícitos: 21
    • FTPS implícitos: 990

    Se 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 em uma porta não padrão. Este campo só será habilitado se a caixa Usar Porta Padrão não estiver selecionada.

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

    • SFTP: Esta opção utiliza o protocolo SFTP e deve ser usada somente se você estiver se conectando a um servidor SFTP. Os 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 usa FTP não criptografado e não é segura porque as senhas são enviadas em texto simples 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 da transferência de arquivos. 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).

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

        • Tentar SSL: Isso tenta iniciar uma transferência criptografada por TLS/SSL. Se isso falhar, será usado um 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 senhas 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ê pode 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 exige que tanto a conexão de controle quanto a 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 é preferencial.

        • Preferir autenticação SSL: Esta opção especifica que a autenticação SSL é preferencial.

    • 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.

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

    • Desabilitar: As configurações de proxy são desabilitadas para esta fonte específica, ignorando a configuração de proxy do agente privado se houver.

    • Padrão: As configurações de proxy são habilitadas, usando a configuração de proxy do agente privado se houver. 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 as informações personalizadas fornecidas aqui. Esta opção ignora a configuração de proxy do agente privado se houver, e, em vez disso, usar informações de proxy personalizadas. Quando Personalizado é selecionado, campos adicionais ficam disponíveis para você configurar. Para obter 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 permitam o acesso ao servidor FTP. Você pode deixar esses campos em branco se não for necessário nome de usuário ou senha.

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

    Configurações opcionais de conexão FTP

    • 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 de número alto.

    • 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 de 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 solicitará que você confirme se 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 de componentes, exclusão e remoção). Uma mensagem solicitará que você confirme se deseja excluir a conexão.

Próximos passos

As ações de menu para uma conexão e seus tipos de atividade podem ser acessadas no painel do projeto e na paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas do conector.

Depois de configurar uma conexão FTP, você pode configurar uma ou mais atividades FTP associadas a essa conexão para serem usadas como uma origem 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 deve 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 um alvo em uma operação ou chamado em um script.