SFTP - SSH

Este conector está disponível nos seguintes produtos e regiões:

Serviço	Class	Regiões
Estúdio Copiloto	Standard	Todas as regiões do Power Automatic , exceto as seguintes:      - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps
Aplicações Power	Standard	Todas as regiões do Power Apps , exceto as seguintes:      - Departamento de Defesa dos EUA (DoD)
Automatize o poder	Standard	Todas as regiões do Power Automatic , exceto as seguintes:      - Departamento de Defesa dos EUA (DoD)

Contato
Nome	Microsoft
URL	Suporte do Microsoft LogicApps Suporte do Microsoft Power Automate Suporte do Microsoft Power Apps

Metadados do conector
Editora	Microsoft

Guia de instruções do conector

Este artigo descreve as operações para o conector SFTP-SSH gerenciado , que está disponível para Aplicativos Lógicos do Azure, Power Automatize e Power Apps. O conector interno SFTP está disponível apenas para fluxos de trabalho de aplicativos lógicos padrão em Aplicativos Lógicos do Azure. Para obter mais informações, consulte Conectar-se a um servidor SFTP usando SSH em Aplicativos Lógicos do Azure e Referência de conector interno SFTP para Aplicativos Lógicos do Azure.

Diferenças em relação ao conector gerenciado SFTP preterido

Em comparação com o conector gerenciado SFTP preterido, o conector gerenciado SFTP-SSH fornece os seguintes recursos principais:

• Usa a biblioteca SSH.NET, que é uma biblioteca Secure Shell (SSH) de código aberto que suporta .NET.

• Fornece a ação Criar pasta , que cria uma pasta no caminho especificado no servidor SFTP.

• Fornece a ação Renomear arquivo , que renomeia um arquivo no servidor SFTP.

• Armazena em cache a conexão com o servidor SFTP por até 1 hora. Esse recurso melhora o desempenho e reduz a frequência com que o conector tenta se conectar ao servidor. Para definir a duração desse comportamento de cache, edite a propriedade ClientAliveInterval na configuração SSH no servidor SFTP.

Autenticação e permissões

• Quando você cria uma conexão com seu servidor SFTP, você tem que fornecer seu endereço de servidor SFTP, credenciais de conta, uma chave privada SSH e a senha de chave privada SSH. Se sua plataforma suporta o upload de arquivos grandes usando fragmentação, você também precisa de acesso de leitura e gravação para a pasta raiz no seu servidor SFTP.

• O conector SFTP-SSH suporta autenticação de chave privada e autenticação de senha. No entanto, o conector SFTP-SSH suporta apenas os seguintes formatos de chave privada, algoritmos de troca de chaves, algoritmos de encriptação e impressões digitais:

  • Formatos de chave privada: chaves RSA (Rivest Shamir Adleman) e DSA (Digital Signature Algorithm) nos formatos OpenSSH e ssh.com. Se sua chave privada estiver no formato de arquivo PuTTY (.ppk), primeiro converta a chave para o formato de arquivo OpenSSH (.pem).
  • Algoritmos de troca de chaves:
    • Curva25519-SHA256
    • curve25519-sha256@libssh.org
    • ecdh-sha2-nistp256
    • ecdh-sha2-nistp384
    • ECDH-SHA2-NISTP521
    • diffie-hellman-group-exchange-sha256
    • diffie-hellman-grupo-exchange-sha1
    • diffie-hellman-group16-sha512
    • diffie-hellman-group14-sha256
    • diffie-hellman-grupo14-sha1
    • diffie-hellman-grupo1-sha1
  • Algoritmos de encriptação:
    • aes256-ctr
    • 3DES-CBC
    • AES128-CBC
    • AES192-CBC
    • AES256-CBC
    • Blowfish-CBC
    • Dois peixes-CBC
    • dois peixes192-cbc
    • dois peixes128-cbc
    • Dois peixes256-cbc
    • arco quatro
    • arco128
    • Arcfour256
    • cast128-CBC
    • aes128-ctr
    • aes192-ctr
  • Algoritmos de chave de host:
    • SSH-RSA
    • SSH-DSS
    • SSH-ED25519
    • ecdsa-sha2-nistp256
    • ecdsa-sha2-nistp384
    • ECDSA-SHA2-NISTP521
  • Impressão digital: MD5. Para obter mais informações, consulte Localizar a impressão digital MD5.

• Quando você fornecer sua chave privada SSH para sua conexão, não insira ou edite manualmente a chave, o que pode fazer com que a conexão falhe. Em vez disso, certifique-se de copiar a chave do arquivo de chave privada SSH e cole essa chave na caixa de informações de conexão.

  Para copiar e colar corretamente sua chave privada SSH, siga estas etapas.

  1. Abra seu arquivo de chave privada SSH em qualquer editor de texto. Estas etapas continuam usando o Bloco de Notas como exemplo.

  2. No Bloco de Notas, no menu Editar , selecione Selecionar tudo. (Pressione Ctrl + A)

  3. No menu Editar , selecione Copiar.

  4. Na caixa SFTP-SSH informações de conexão, cole a chave copiada completa na propriedade de chave privada SSH , que suporta várias linhas. Não insira ou edite manualmente a chave.

  5. Depois de concluir a inserção dos detalhes da conexão, selecione Criar.

Converter chave baseada em PuTTY para OpenSSH

O formato PuTTY e o formato OpenSSH usam diferentes extensões de nome de arquivo. O formato PuTTY usa a extensão de nome de arquivo .ppk, ou PuTTY Private Key. O formato OpenSSH usa a extensão de nome de arquivo .pem, ou Privacy Enhanced Mail. Se a sua chave privada estiver no formato PuTTY, e você tiver que usar o formato OpenSSH, primeiro converta a chave para o formato OpenSSH seguindo estas etapas:

• SO baseado em Unix

  1. Se você não tiver as ferramentas PuTTY instaladas em seu sistema, faça isso agora, por exemplo:

     sudo apt-get install -y putty

  2. Execute o seguinte comando, que cria um arquivo que você pode usar com o conector SFTP-SSH:

     puttygen <path-to-private-key-file-in-PuTTY-format> -O private-openssh -o <path-to-private-key-file-in-OpenSSH-format>

     Por exemplo

     puttygen /tmp/sftp/my-private-key-putty.ppk -O private-openssh -o /tmp/sftp/my-private-key-openssh.pem

• Sistema Operativo Windows

  1. Se você ainda não fez isso, baixe a ferramenta mais recente PuTTY Generator (puttygen.exe) e, em seguida, abra a ferramenta.

  2. Na ferramenta PuTTY Key Generator (puttygen.exe), em Ações, selecione Carregar.

  3. Navegue até o arquivo de chave privada no formato PuTTY e selecione Abrir.

  4. No menu Conversões , selecione Exportar chave OpenSSH.

  5. Salve o arquivo de chave privada com a extensão de nome de arquivo .pem .

Encontre a impressão digital MD5

O conector SFTP-SSH rejeita uma conexão se a impressão digital do servidor SFTP e a impressão digital esperada não corresponderem. Para obter a impressão digital MD5, que é uma sequência com 16 pares de dígitos hexadecimais delimitados por dois pontos, tente as seguintes opções.

Você tem a chave

A chave MD5 é uma cadeia de caracteres de 47 caracteres delimitada por dois pontos. Para obter a impressão digital MD5 quando você tem a chave, você pode usar ferramentas como ssh-keygen.

Por exemplo, em um prompt Bash, digite o seguinte comando:

ssh-keygen -l -f id_rsa.pub -E md5

Você não tem a chave

Para obter uma impressão digital MD5 quando você não tem uma chave, você pode usar a ferramenta mais recente Server and Protocol Information Dialog pelo WinSCP ou pode usar a ferramenta PuTTY Configuration em vez disso:

1. Na ferramenta Configuração PuTTY (putty.exe), na janela Categoria, expanda Chavesde hostSSH> de conexão>.

2. Em Preferência de algoritmo de chave de host, abra a lista Política de seleção de algoritmo e verifique se RSA aparece na parte superior.

3. Se o RSA não aparecer na parte superior, selecione RSA e, em seguida, selecione Até que o RSA passe para o topo.

4. Conecte-se ao seu servidor SFTP com PuTTY. Depois que a conexão for criada, quando o alerta de segurança PUTTY aparecer, selecione Mais informações.

   Observação

   Se o alerta de segurança não aparecer, tente limpar a entrada SshHostKeys . Abra o editor de registo do Windows e navegue até à seguinte entrada:

   Computer\HKEY_CURRENT_USER\Software\SimonTatham\PuTTY\SshHostKeys

5. Depois que a caixa PuTTY: informações sobre a chave de host do servidor for exibida, localize a propriedade de impressão digital MD5 e copie o valor da cadeia de caracteres de 47 caracteres, que se parece com o exemplo a seguir:

   **:**:**:**:**:**:**:**:**:**:**:**:**:**:**:**

Problemas conhecidos e limitações com gatilhos

• Os gatilhos do conector gerenciado SFTP podem apresentar resultados ausentes, incompletos ou atrasados.

  • Resultados em falta

    O SFTP aciona o trabalho pesquisando ou verificando o sistema de arquivos SFTP e procurando por todos os arquivos que foram alterados desde a última pesquisa. Os gatilhos do conector gerenciado SFTP comparam as versões do arquivo usando o carimbo de data/hora modificado da última modificação do arquivo.

    Se você criar, adicionar ou atualizar um arquivo com um carimbo de data/hora anterior ao carimbo de data/hora da última modificação rastreado no momento, o gatilho do conector gerenciado SFTP não detetará esse arquivo.

    Portanto, se você usar uma ferramenta ou cliente externo que cria, adiciona ou atualiza arquivos no servidor SFTP, certifique-se de desativar qualquer recurso na ferramenta ou cliente que preserve o carimbo de data/hora da última modificação de um arquivo.

    A tabela a seguir lista algumas ferramentas comumente usadas que preservam esse carimbo de data/hora e as etapas para desabilitar esse recurso:

    Cliente SFTP	Ação
    WinSCP	Vá para Opções>Preferências Transferir>>Editar>Preservar carimbo de data/hora>Desativar.
    FileZilla	Vá para Transferir>Preservar carimbos de data/hora de arquivos> transferidosDesativar.

  • Resultados incompletos ou atrasados

    Quando um gatilho SFTP verifica se há um arquivo recém-criado, adicionado ou atualizado, o gatilho também verifica se o arquivo está completo. Por exemplo, um arquivo pode ter alterações em andamento quando o gatilho verifica o servidor SFTP. Para evitar retornar um arquivo incompleto, o gatilho anota o carimbo de data/hora do arquivo, mas não retorna imediatamente o arquivo. Em vez disso, o gatilho retorna o arquivo somente quando o gatilho verifica o servidor novamente.

    Às vezes, esse comportamento pode causar um atraso que dura quase duas vezes o intervalo de sondagem do gatilho. Devido a esse comportamento, se você desabilitar a configuração Split On do gatilho SFTP, o gatilho SFTP pode não retornar todos os arquivos ao mesmo tempo.

Problemas e limitações gerais conhecidos

• O conector gerenciado SFTP-SSH atualmente não suporta os seguintes servidores SFTP:

  • Akamai NetStorage
  • FileMage Gateway
  • Globalscape
  • IBM DataPower
  • Caminho da Mensagem
  • OpenText Secure MFT
  • OpenText GXS
  • SFTP para Armazenamento de Blobs do Azure
  • VShell Secure File Transfer Server
  • AWS SFTP

• Use pastas SFTP separadas para processamento e upload de arquivos.

  Certifique-se de usar pastas separadas em seu servidor SFTP para o gatilho para monitorar arquivos para processamento e armazenamento de arquivos carregados. Caso contrário, o gatilho não disparará e se comportará de forma imprevisível. Por exemplo, o gatilho pode ignorar um número aleatório de arquivos que precisam de processamento.

  Essa limitação significa que você precisa de uma maneira de mover arquivos entre essas pastas. Se você encontrar esse problema, remova os arquivos da pasta monitorada e use uma pasta diferente para armazenar os arquivos carregados.

• Para gerenciar a carga em serviços de conector gerenciados multilocatários compartilhados, o conector de SFTP-SSH gerenciado pode criar várias conexões do mesmo endereço IP de origem, ou seja, o endereço IP do conector, para o destino, que é seu servidor SFTP. Algumas regiões de baixo tráfego podem usar apenas três instâncias de máquina virtual atrás do endereço IP do conector, o que significa que essas regiões podem criar no máximo três conexões. Outras regiões podem usar até 20 conexões porque têm o mesmo número de máquinas virtuais atrás do endereço IP do conector.

  Se o servidor SFTP limitar o número de conexões, o servidor pode não funcionar bem com o conector de SFTP-SSH gerenciado. No entanto, você pode criar um fluxo de trabalho de aplicativo lógico padrão que usa as operações SFTP internas. Você pode controlar os limites de expansão e, como resultado, o número de conexões.

• Se você encontrar problemas de interoperabilidade do conjunto de codificação entre o conector gerenciado SFTP-SSH e seu servidor SFTP, tente criar um fluxo de trabalho de aplicativo lógico padrão e use as operações internas do SFTP. As operações integradas do SFTP suportam uma gama mais ampla de pacotes de codificação.

• Esse conector pode enviar uma solicitação de no-op para o back-end.

Chunking

• Nos Aplicativos Lógicos do Azure e no Power Automate, as seguintes ações gerenciadas do conector de SFTP-SSH dão suporte à fragmentação em que uma ação pode habilitar a manipulação de arquivos grandes em partes menores. Para obter mais informações sobre fragmentação nos Aplicativos Lógicos do Azure, consulte [Manipular mensagens grandes usando fragmentação]](/azure/logic-apps/logic-apps-handle-large-messages).

  Ação	Suporte de fragmentação	Substituir o suporte ao tamanho do bloco
  Copiar ficheiro	Não	Não aplicável
  Criar ficheiro	Yes	Yes
  Criar pasta	Não aplicável	Não aplicável
  Eliminar ficheiro	Não aplicável	Não aplicável
  Extrair arquivo para pasta	Não aplicável	Não aplicável
  Obter conteúdo de arquivo	Yes	Yes
  Obter conteúdo de arquivo usando o caminho	Yes	Yes
  Obter metadados de arquivo	Não aplicável	Não aplicável
  Obter metadados de arquivo usando o caminho	Não aplicável	Não aplicável
  Listar arquivos na pasta	Não aplicável	Não aplicável
  Renomear arquivo	Não aplicável	Não aplicável
  Atualizar ficheiro	Não	Não aplicável

  SFTP-SSH ações que suportam fragmentação podem lidar com arquivos de até 1 GB, enquanto SFTP-SSH ações que não suportam fragmentação podem lidar com arquivos de até 50 MB. O tamanho padrão do bloco é 15 MB. No entanto, esse tamanho pode mudar dinamicamente, começando a partir de 5 MB e aumentando gradualmente até o máximo de 50 MB. O dimensionamento dinâmico é baseado em fatores como latência de rede, tempo de resposta do servidor e assim por diante.

  Você pode substituir esse comportamento adaptável ao especificar um tamanho de bloco constante para usar. Esse tamanho pode variar de 5 MB a 50 MB. Por exemplo, suponha que você tenha um arquivo de 45 MB e uma rede que possa suportar esse tamanho de arquivo sem latência. A fragmentação adaptativa resulta em várias chamadas, em vez de uma chamada. Para reduzir o número de chamadas, você pode tentar definir um tamanho de bloco de 50 MB. Em um cenário diferente, se o fluxo de trabalho do aplicativo lógico estiver com o tempo limite, por exemplo, ao usar blocos de 15 MB, você pode tentar reduzir o tamanho para 5 MB.

  O tamanho do bloco está associado a uma conexão. Esse atributo significa que você pode usar a mesma conexão para ações que suportam fragmentação e ações que não suportam fragmentação. Nesse caso, o tamanho do bloco para ações que suportam fragmentação varia de 5 MB a 50 MB.

  Para substituir o comportamento adaptativo padrão que a fragmentação usa em uma ação SFTP-SSH, você pode especificar um tamanho de bloco constante de 5 MB a 50 MB.

  1. No designer, no canto superior direito da ação SFTP-SSH, selecione o botão de reticências (...) e, em seguida, selecione Configurações.

  2. Em Transferência de Conteúdo, na propriedade Tamanho do bloco, insira um valor inteiro de 5 para .50

  3. Depois de terminar, selecione Concluído.

• SFTP-SSH gatilhos não suportam fragmentação de mensagens. Quando os gatilhos solicitam conteúdo de arquivo, eles selecionam apenas arquivos com 15 MB ou menos. Para obter ficheiros com mais de 15 MB, siga este padrão:

  1. Use um gatilho de SFTP-SSH que retorna apenas as propriedades do arquivo. Esses gatilhos têm nomes que incluem a descrição, (somente propriedades).

  2. Siga o gatilho com a ação SFTP-SSH Obter conteúdo de arquivo . Esta ação lê o arquivo completo e usa implicitamente o fragmento de mensagens.

Solução de problemas

Erro 401: "401 Não autorizado"

Esse erro pode acontecer porque você não tem as credenciais ou permissões corretas. Para obter mais informações, consulte Autenticação e permissões.

Erro 404: "Foi feita uma referência a um ficheiro ou pasta que não existe"

Esse erro pode acontecer quando você usa a ação Criar arquivo . Quando a ação cria um arquivo no seu servidor SFTP, a ação também envia automaticamente uma chamada para o seu servidor SFTP para obter os metadados do arquivo.

Se você mover imediatamente o arquivo recém-criado antes que a chamada possa obter os metadados, o arquivo não existe mais no local esperado e você receberá uma mensagem de erro 404, Uma referência foi feita a um arquivo ou pasta que não existe.

Se não for possível evitar ou atrasar a movimentação do arquivo, ignore a leitura dos metadados do arquivo após a criação do arquivo seguindo estas etapas:

1. Na ação Criar arquivo , abra a lista Adicionar novo parâmetro , selecione a propriedade Obter todos os metadados do arquivo e defina o valor como Não.

2. Se precisar desses metadados de arquivo mais tarde, você pode usar a ação Obter metadados de arquivo .

Erro 504: "Uma tentativa de conexão falhou porque a parte conectada não respondeu corretamente após um período de tempo, ou a conexão estabelecida falhou porque o host conectado não respondeu" ou "A solicitação ao servidor SFTP levou mais de '00:00:30' segundos"

Este erro pode acontecer quando você não consegue estabelecer com êxito uma conexão com o servidor SFTP. Pode haver diferentes razões para esse problema, portanto, tente estas opções de solução de problemas:

• O tempo limite de conexão é de 20 segundos. Verifique se o servidor SFTP tem um bom desempenho e se os dispositivos intermediários, como firewalls, não estão adicionando sobrecarga.

• Verifique se o seu servidor SFTP coloca um limite no número de conexões de cada endereço IP. Qualquer limite dificulta a comunicação entre o conector e o servidor SFTP. Certifique-se de remover esse limite.

• Se você tiver um firewall configurado, certifique-se de adicionar os endereços IP do conector gerenciado para sua região à lista aprovada.

• Se o erro ocorrer intermitentemente, altere a configuração de política Repetir na ação SFTP-SSH para uma contagem de tentativas maior do que as quatro tentativas padrão.

• Para reduzir o custo de estabelecimento da conexão, na configuração SSH para seu servidor SFTP, aumente a propriedade ClientAliveInterval para cerca de uma hora.

• Revise o log do servidor SFTP para verificar se as chamadas enviadas para o servidor SFTP chegam com êxito, Para obter mais informações sobre o problema de conectividade, você também pode executar um rastreamento de rede no firewall e no servidor SFTP.

Limites Gerais

Nome	Valor
Número máximo de megabytes sendo transferidos de/para o conector dentro de um intervalo de tempo de largura de banda (por conexão)	1000
Intervalo de tempo de largura de banda (em milissegundos)	60000

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição	Parâmetros para criar conexão.	Todas as regiões	Não compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome	Tipo	Description	Obrigatório
Endereço do servidor host	cadeia (de caracteres)	Endereço do servidor host	Verdade
Nome de utilizador	cadeia (de caracteres)	Nome de utilizador	Verdade
Palavra-passe	securestring	Palavra-passe
Chave privada SSH	securestring	Chave privada SSH (o conteúdo do arquivo deve ser fornecido inteiramente como está, no formato multilinha)
Senha de chave privada SSH	securestring	Senha de chave privada SSH (se a chave privada estiver protegida por uma senha)
Número da porta	int	Número da porta SFTP (exemplo: 22)
Desativar a validação da chave de host SSH	bool	Desativar a validação da chave de host SSH? (Verdadeiro/Falso)
Impressão digital da chave do host SSH	cadeia (de caracteres)	Impressão digital da chave do host SSH
Caminho da pasta raiz	cadeia (de caracteres)	Caminho da pasta raiz.

Limites de Limitação

Name	Chamadas	Período de Renovação
Chamadas de API por conexão	150	60 segundos

Ações

Atualizar ficheiro	Esta operação atualiza o conteúdo do arquivo.
Copiar ficheiro	Esta operação copia um arquivo.
Criar ficheiro	Esta operação carrega um arquivo.
Criar pasta	Esta operação cria uma nova pasta.
Eliminar ficheiro	Esta operação exclui um arquivo.
Extrair arquivo para pasta	Esta operação extrai um arquivo morto para uma pasta (exemplo: .zip).
Listar arquivos na pasta	Esta operação obtém arquivos contidos em uma pasta.
Listar arquivos na pasta raiz	Esta operação obtém os arquivos na pasta raiz.
Obter conteúdo de arquivo usando o caminho	Esta operação obtém o conteúdo do arquivo usando o caminho do arquivo.
Obter conteúdo de ficheiro	Esta operação obtém o conteúdo do arquivo usando a ID do arquivo.
Obter metadados de arquivo usando o caminho	Esta operação obtém metadados de arquivo usando o caminho do arquivo.
Obter metadados do ficheiro	Esta operação obtém metadados de arquivo usando a ID do arquivo.
Renomear arquivo	Esta operação renomeia um arquivo.

Atualizar ficheiro

Copiar ficheiro

Criar ficheiro

Criar pasta

Eliminar ficheiro

Extrair arquivo para pasta

Listar arquivos na pasta

Listar arquivos na pasta raiz

Obter conteúdo de arquivo usando o caminho

Obter conteúdo de ficheiro

Obter metadados de arquivo usando o caminho

Obter metadados do ficheiro

Renomear arquivo

Acionadores

Quando os ficheiros são adicionados ou modificados (apenas propriedades)

Esta operação dispara um fluxo quando um arquivo é adicionado ou modificado em uma pasta. Esse gatilho buscará apenas os metadados do arquivo. Para obter o conteúdo do arquivo, você pode usar a operação "Obter conteúdo do arquivo". O gatilho depende da hora da última modificação de um arquivo. Se um arquivo estiver sendo criado por um cliente de terceiros, a preservação da hora da última modificação deve ser desabilitada no cliente. O gatilho não é acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário acionar em subpastas, vários gatilhos devem ser criados.

Quando um ficheiro é adicionado ou modificado

Esta operação dispara um fluxo quando um arquivo é adicionado ou modificado em uma pasta. O gatilho buscará os metadados do arquivo, bem como o conteúdo do arquivo. O gatilho depende da hora da última modificação de um arquivo. Se um arquivo estiver sendo criado por um cliente de terceiros, a preservação da hora da última modificação deve ser desabilitada no cliente. Arquivos maiores que 50 megabytes são ignorados pelo gatilho. O gatilho não é acionado se um arquivo for adicionado/atualizado em uma subpasta. Se for necessário acionar em subpastas, vários gatilhos devem ser criados.

Quando os ficheiros são adicionados ou modificados (apenas propriedades)

Quando um ficheiro é adicionado ou modificado

Definições

BlobMetadata

BlobMetadataResponse

binário