Limitações e problemas conhecidos com o suporte para protocolo SFTP SSH no Armazenamento de Blobs do Azure

Artigo
03/19/2024

Este artigo descreve as limitações e problemas conhecidos do suporte ao SFTP no Armazenamento de Blobs do Azure.

Importante

Como você precisa habilitar o namespace hierárquico da sua conta para usar o SFTP, todos os problemas conhecidos descritos no artigo Problemas conhecidos com o Azure Data Lake Storage Gen2 também se aplicam à sua conta.

Clientes conhecidos sem suporte

Os clientes a seguir são conhecidos por serem incompatíveis com o SFTP para Armazenamento de Blobs do Azure. Consulte algoritmos com suporte para obter mais informações.

Five9
Kemp
Mule
paramiko 1.16.0
SSH.NET 2016.1.0

A lista de clientes sem suporte acima não está completa e pode ser alterada ao longo do tempo.

Configurações de cliente

Para transferir arquivos de ou para o Armazenamento de Blobs do Azure por meio de clientes SFTP, confira as configurações recomendadas a seguir.

WinSCP
- No diálogo Preferências, em Transferência - Resistência, selecione Desabilitar para desabilitar a opção Habilitar retomada/transferência de transferência para nome de arquivo temporário.

Cuidado

Deixar essa opção habilitada pode causar falhas ou desempenho degradado durante uploads de arquivos grandes.

Operações sem suporte

Categoria	Operações sem suporte
Gravações aleatórias	Operações que incluem sinalizadores READ e WRITE. Por exemplo: SSH.NET criar API
Links	`symlink` - criando links simbólicos `ln` - criando links rígidos Não há suporte para a leitura de links
Informações de capacidade	`df` - informações de uso para o sistema de arquivos
Extensões	As extensões sem suporte incluem, mas não se limitam a: fsync@openssh.com, limits@openssh.com, lsetstat@openssh.com, statvfs@openssh.com
Comandos SSH	O SFTP é o único subsistema com suporte. As solicitações do Shell após a conclusão da troca de chaves falharão.
Gravações de vários protocolos	Gravações aleatórias e acréscimos (`PutBlock`,`PutBlockList`, `GetBlockList`, `AppendBlock`, `AppendFile`) não são permitidos de outros protocolos (NFS, REST de Blob, REST do Data Lake Storage Gen2) em blobs criados usando SFTP. Substituições completas são permitidas.
Operações de renomeação	As operações de renomeação quando o nome do arquivo de destino já existe são uma violação de protocolo. A tentativa de tal operação retornará um erro. Confira Remover e renomear arquivos para obter mais informações.
Operações entre contêineres	Não há suporte para a passagem entre contêineres ou a execução de operações em vários contêineres da mesma conexão.

Autenticação e autorização

Os usuários locais são a única forma de gerenciamento de identidade com suporte no momento para o ponto de extremidade SFTP.
Não há suporte para o Microsoft Entra ID no ponto de extremidade SFTP.

Para obter mais informações, confira Modelo de permissão SFTP e Controle de acesso no Azure Data Lake Storage Gen2.

Rede

Para acessar a conta de armazenamento usando o SFTP, sua rede deve permitir o tráfego na porta 22.
Não há suporte para endereços IP estáticos em contas de armazenamento. Essa não é uma limitação específica do SFTP.
Não há suporte para o roteamento da Internet. Use o roteamento de Rede da Microsoft.
Há um tempo limite de dois minutos para conexões ociosas ou inativas. O OpenSSH parecerá ter deixado de responder e, em seguida, se desconectará. Alguns clientes se reconectam automaticamente.

Outro

Para problemas de desempenho e considerações, consulte Considerações de desempenho do SFTP (Protocolo de Transferência de Arquivo SSH) no Armazenamento de Blobs do Azure.
As operações de retomada e acréscimo exigem a ativação do recurso de visualização SFTP Resumable Uploads em sua assinatura. Para obter mais informações sobre como ativar funcionalidades de pré-visualização, veja Configurar funcionalidades de pré-visualização na subscrição do Azure.
Por padrão, a propriedade Content-MD5 dos blobs carregados usando o SFTP é definida como nula. Portanto, se você quiser que a propriedade Content-MD5 desses blobs contenha um hash MD5, seu cliente deverá calcular esse valor e, em seguida, definir a propriedade Content-MD5 do blob antes de fazer o upload do blob.
O tamanho máximo de upload de arquivo por meio do ponto de extremidade SFTP é de 100 GB.
Para alterar as configurações de redundância/replicação da conta de armazenamento ou iniciar o failover da conta, o SFTP deve ser desabilitado. O SFTP pode ser habilitado novamente depois que a conversão for concluída.
Os contêineres especiais, como $logs, $blobchangefeed, $root e $web, não são acessíveis por meio do ponto de extremidade SFTP.
Não há suporte para links simbólicos.
Não há suporte para comandos SSH e SCP que não são SFTP.
Não há suporte para FTPS e FTP.
TLS e SSL não estão relacionados ao SFTP.
Há suporte apenas para a versão 2 do SSH.

Recursos de Armazenamento de Blobs

Quando você habilitar o suporte ao SFTP, alguns recursos do Armazenamento de Blobs terão suporte total, mas alguns recursos podem ter suporte apenas no nível de visualização ou ainda não têm suporte.

Para ver como cada recurso de Armazenamento de Blobs tem suporte em contas que têm suporte de SFTP habilitado, consulte o suporte a recursos de Armazenamento de Blobs para contas de Armazenamento do Azure.

Solução de problemas

Para resolver o erro Failed to update SFTP settings for account 'accountname'. Error: The value 'True' isn't allowed for property isSftpEnabled., verifique se os seguintes pré-requisitos são atendidos no nível da conta de armazenamento:
- A conta precisa ser do tipo de uso geral V2 e de blob de blocos premium.
- A conta precisa ter o namespace hierárquico habilitado.
Para resolver o erro Home Directory not accessible error., verifique se:
- O usuário recebeu permissões apropriadas para o contêiner.
- O nome do contêiner está especificado na cadeia de conexão para os usuários locais que não têm um diretório base.
- O nome do contêiner está especificado na cadeia de conexão para os usuários locais que têm um diretório base que não existe.
Para resolver Received disconnect from XX.XXX.XX.XXX port 22:11: ao conectar, verifique se:
- O acesso à rede pública é Enabled from all networks ou Enabled from selected virtual networks and IP addresses.
- O endereço IP do cliente é permitido pelo firewall.
- O Roteamento de Rede está definido como Microsoft network routing.