sgcSSH: SSH, SFTP e SCP pós-quânticos para Delphi e .NET

· Componentes
sgcSSH: SSH, SFTP e SCP pós-quânticos para Delphi e .NET | Blog eSeGeCe
Novo produto · sgcSSH

SSH, SFTP e SCP para Delphi e .NET.
Pós-quântico por padrão.

Três clientes e dois servidores que colocam o SSH dentro das suas próprias aplicações. A troca de chaves híbrida mlkem768x25519-sha256 é oferecida primeiro nos dois lados, e a criptografia roda como código nativo.

  • ML-KEM-768 + X25519
  • SFTP v3
  • SCP
  • Ed25519
  • AES-GCM
As demos do sgcSSH lado a lado: o cliente SSH executando um comando e um shell interativo, o cliente SFTP navegando por uma pasta remota, o servidor SFTP servindo uma pasta raiz e um terminal mostrando a troca de chaves mlkem768x25519-sha256
5componentes
16requisições SFTP em andamento
~1 spor 100 MB em uma LAN
0DLLs do OpenSSL com criptografia nativa

O SSH é a forma padrão de administrar servidores e de trocar arquivos com segurança. O sgcSSH o leva às suas aplicações Delphi, C++Builder e .NET como componentes comuns, tanto no lado do cliente quanto no lado do servidor.

Com o sgcSSH você executa um comando em um servidor Linux e recebe a saída como uma string, abre um shell interativo, redireciona uma porta, envia uma pasta por SFTP ou SCP, ou transforma a sua própria aplicação em um servidor SSH e SFTP com uma pasta privada para cada usuário. Cliente e servidor oferecem primeiro a troca de chaves híbrida pós-quântica, a mesma que as versões mais recentes do SSH usam por padrão.

O sgcSSH em resumo: os clientes, os servidores e a troca de chaves pós-quântica. Também no YouTube.

Três clientes, dois servidores

Cada um é um componente não visual na página da paleta SGC SSH. Você o solta em um formulário ou o cria em código, define o host e as credenciais, liga os eventos e então conecta ou começa a escutar. As classes .NET têm os mesmos nomes.

Cliente SSHTsgcSSHClientComandos, shells interativos com pty, redirecionamento de portas e rekey.
Cliente SFTPTsgcSFTPClientTransferências de arquivos SFTP v3 com 16 requisições em andamento.
Cliente SCPTsgcSCPClientArquivos e pastas inteiras com scp, preservando as datas dos arquivos.
Servidor SSHTsgcSSHServerLogin por senha e por chave pública, exec, shell e subsistemas.
Servidor SFTPTsgcSFTPServerSFTP v3 e SCP a partir de uma pasta raiz, com uma jaula por usuário.

Troca de chaves pós-quântica, ativada por padrão

O tráfego criptografado hoje pode ser atacado amanhã. Um atacante grava agora a sessão criptografada e a decifra mais tarde, quando existir um computador quântico grande o suficiente. Isso se chama harvest now, decrypt later (colete agora, decifre depois) e importa para tudo o que precisa continuar privado por anos: credenciais, contratos, arquivos de clientes.

O sgcSSH responde a isso com a troca de chaves híbrida mlkem768x25519-sha256. Ela combina o ML-KEM-768 (FIPS 203), um algoritmo pós-quântico, com o clássico X25519, de modo que as chaves de sessão permanecem secretas enquanto um dos dois não for quebrado. É o padrão das versões mais recentes do SSH.

Este é um cliente SSH de linha de comando padrão conectando-se à demo do servidor SSH. A troca híbrida é negociada com as configurações padrão nos dois lados:

ssh -v contra o TsgcSSHServer
$ ssh -v -p 2290 deploy@127.0.0.1 "echo hello"
debug1: Remote protocol version 2.0, remote software version sgcSSH
debug1: kex: algorithm: mlkem768x25519-sha256
debug1: kex: host key algorithm: ssh-ed25519
debug1: kex: client->server cipher: aes128-ctr MAC: hmac-sha2-256 compression: none
Authenticated to 127.0.0.1 ([127.0.0.1]:2290) using "password".
hello

Criptografia nativa, sem DLL para distribuir

No Delphi, a propriedade CryptoLibrary escolhe onde os algoritmos clássicos (ECDH, Diffie-Hellman, AES, HMAC e as assinaturas das chaves de host) são calculados:

A troca híbrida ML-KEM-768 e X25519 é código nativo da biblioteca com as duas opções. Os componentes .NET são código totalmente gerenciado, sem nenhum OpenSSL, e no .NET 8 e posteriores o AES-GCM tem aceleração por hardware.

Enviar um arquivo por SFTP com a troca pós-quântica e a criptografia nativa leva apenas algumas linhas:

uses
  sgcSSH_Crypto, sgcSSH_Client;

procedure TForm1.UploadInvoices;
var
  SFTP: TsgcSFTPClient;
begin
  SFTP := TsgcSFTPClient.Create(nil);
  try
    SFTP.Host := 'files.example.com';
    SFTP.Authentication.Username := 'partner';
    SFTP.Authentication.Password := 'secret';
    SFTP.PostQuantumKex := True;      // the default: mlkem768x25519-sha256 first
    SFTP.CryptoLibrary := sshcNative; // sgcCrypto units, no OpenSSL DLL
    SFTP.Connect;
    SFTP.Put('C:\export\invoices.zip', '/upload/invoices.zip');
    Memo1.Lines.Add('Uploaded ' +
      IntToStr(SFTP.FileSize('/upload/invoices.zip')) + ' bytes');
    SFTP.Disconnect;
  finally
    SFTP.Free;
  end;
end;

O cliente SSH: comandos, shells e túneis

O TsgcSSHClient faz login com senha ou com uma chave privada, e o OnSSHHostKey entrega o tipo da chave de host e a sua impressão digital para que você a confira com os seus hosts conhecidos e rejeite uma chave desconhecida ou alterada.

A demo do cliente SSH: conectada com a troca de chaves pós-quântica e a biblioteca de criptografia nativa, a saída de um comando remoto, um shell interativo listando uma pasta e a chave de host Ed25519 aceita no log
A demo do cliente SSH: um comando remoto, um shell interativo e a verificação da chave de host.

Executando um comando de manutenção com uma chave privada e verificação da chave de host:

procedure TForm1.CheckDisk;
var
  SSH: TsgcSSHClient;
begin
  SSH := TsgcSSHClient.Create(nil);
  try
    SSH.Host := 'build01.example.com';
    SSH.Authentication.Username := 'deploy';
    SSH.Authentication.PrivateKeyFile := 'C:\keys\id_ed25519.pem';
    SSH.OnSSHHostKey := DoHostKey;
    SSH.Connect;
    Memo1.Text := SSH.Execute('df -h /var');
    SSH.Disconnect;
  finally
    SSH.Free;
  end;
end;

procedure TForm1.DoHostKey(Sender: TObject; const aHostKeyType,
  aFingerprint: string; var aAction: TIdSSHHostKeyVerification);
begin
  if aFingerprint <> FKnownFingerprint then
    aAction := sshHostKeyReject;
end;

SFTP e SCP: transferências rápidas de arquivos

O TsgcSFTPClient fala SFTP v3 sobre a mesma conexão SSH, com um método para cada tarefa: RealPath resolve a pasta pessoal, ListDirectory devolve nomes, tamanhos e datas, Put e Get enviam e baixam um arquivo, e Rename, Delete, MakeDirectory e RemoveDirectory cobrem o resto de um gerenciador de arquivos. O OnSFTPProgress informa os bytes transferidos para uma barra de progresso.

As transferências são rápidas porque o cliente não espera por cada bloco. Ele mantém 16 requisições em andamento, de modo que um arquivo de 100 MB leva cerca de um segundo em uma rede local.

A demo do cliente SFTP: uma pasta remota listada com nomes, tamanhos, datas e indicadores de pasta, e a barra de progresso de um download grande
A demo do cliente SFTP navegando por uma pasta remota enquanto um arquivo grande é baixado.

O TsgcSCPClient copia arquivos por SSH para qualquer servidor que permita o comando scp, sem um serviço de transferência de arquivos separado. Upload e Download copiam um arquivo, UploadFolder e DownloadFolder copiam uma árvore de pastas inteira, e PreserveTimes mantém as datas de modificação e de acesso do outro lado.

A demo do cliente SCP com botões para enviar e baixar um arquivo ou uma pasta inteira, a opção de preservar as datas dos arquivos e o progresso de uma transferência
A demo do cliente SCP: arquivos individuais ou pastas inteiras, com ou sem as datas dos arquivos.

O seu próprio servidor SSH e SFTP

O TsgcSSHServer escuta na porta que você escolher e prova a sua identidade com chaves de host Ed25519, ECDSA ou RSA carregadas de HostKeyFiles. O GenerateHostKeyEd25519 cria uma para você. OnSSHAuthPassword e OnSSHAuthPublicKey decidem quem entra, o segundo com o tipo da chave e a sua impressão digital SHA256. OnSSHExec responde a comandos remotos e OnSSHShell atende uma sessão interativa. Qualquer cliente SSH padrão se conecta a ele, inclusive as ferramentas de linha de comando ssh, sftp e scp.

Vincule um TsgcSFTPServer e o mesmo servidor passa a ser um servidor de arquivos:

uses
  sgcSSH_Crypto, sgcSSH_Server, sgcSSH_SFTP_Server;

procedure TForm1.StartServer;
begin
  if not FileExists('hostkey_ed25519.pem') then
    TsgcSSHServer.GenerateHostKeyEd25519('hostkey_ed25519.pem');

  SFTP := TsgcSFTPServer.Create(Self);
  SFTP.RootFolder := 'D:\sftp';
  SFTP.OnSFTPUserRoot := DoUserRoot;
  SFTP.OnSFTPOperation := DoOperation;

  SSH := TsgcSSHServer.Create(Self);
  SSH.Port := 22;
  SSH.HostKeyFiles.Text := 'hostkey_ed25519.pem';
  SSH.CryptoLibrary := sshcNative;
  SSH.SFTPServer := SFTP;
  SSH.OnSSHAuthPassword := DoAuthPassword;
  SSH.Active := True;
end;

procedure TForm1.DoAuthPassword(Sender: TObject;
  aConnection: TsgcSSHServerConnection; const aUsername, aPassword: string;
  var aAccept: Boolean);
begin
  aAccept := CheckUser(aUsername, aPassword); // your own user store
end;

procedure TForm1.DoUserRoot(Sender: TObject; const aUsername: string;
  var aRootFolder: string);
begin
  aRootFolder := 'D:\sftp\' + aUsername; // every user in its own folder
  ForceDirectories(aRootFolder);
end;

procedure TForm1.DoOperation(Sender: TObject; const aUsername: string;
  aOperation: TsgcSFTPOperation; const aPath, aNewPath: string;
  var aAccept: Boolean);
begin
  if aOperation = sfoRemove then
    aAccept := False; // the client gets permission denied
end;

Aqui, a ferramenta de linha de comando sftp padrão trabalha com a demo do servidor SFTP:

sftp contra o TsgcSFTPServer
$ sftp -P 2291 -b batch.txt deploy@127.0.0.1
sftp> cd reports
sftp> put Q4-summary-2026.xlsx
sftp> ls -l
-rw-r--r--   1 deploy   deploy     150000 Nov 13 10:28 Q3-summary-2026.xlsx
-rw-r--r--   1 deploy   deploy     204800 Nov 13 10:28 Q4-summary-2026.xlsx
sftp> cd ..
sftp> get catalog-2026.pdf
sftp> mkdir archive-2026

No lado do servidor, cada uma dessas operações passou pelo OnSFTPOperation, onde a demo a registra no log:

A demo do servidor SFTP escutando com a biblioteca de criptografia nativa, uma chave de host Ed25519 e opções de uma subpasta por usuário, somente leitura, SCP e exclusões negadas; o log mostra o login por senha, as listagens, uma abertura para escrita, uma abertura para leitura e uma nova pasta
A demo do servidor SFTP registrando a sessão acima, uma linha por operação.

Detalhes de segurança

Delphi, C++Builder e .NET

Os mesmos cinco componentes estão disponíveis em todas as plataformas que o sgcSSH suporta:

O código .NET se lê da mesma forma que o código Delphi:

using esegece.sgcWebSockets;

using (var sftp = new TsgcSFTPClient())
{
    sftp.Host = "files.example.com";
    sftp.Authentication.Username = "partner";
    sftp.Authentication.Password = "secret";
    sftp.Connect();
    sftp.Put(@"C:\export\invoices.zip", "/upload/invoices.zip");
    foreach (var item in sftp.ListDirectory("/upload"))
        Console.WriteLine($"{item.FileName}  {item.Size}");
    sftp.Disconnect();
}

Cinco demos em Demos\27.SSH mostram cada componente em ação: 01.SSH_Client, 02.SFTP_Client, 03.SCP_Client, 04.SSH_Server e 05.SFTP_Server. As capturas de tela deste artigo vêm delas.

Edições

O sgcSSH está incluído no sgcWebSockets Enterprise e no sgcWebSockets All-Access. No .NET, os componentes são distribuídos no pacote registrado do sgcWebSockets, não na edição Community gratuita.

Se você precisa apenas de SSH e SFTP, o pacote independente sgcSSH é autônomo: ele inclui o runtime sgcWebSockets Core junto com a criptografia nativa sobre a qual a troca de chaves roda, o complemento sgcCustomIndy, no qual os componentes Delphi se baseiam, está sempre incluído no pedido, e toda licença vem com o código-fonte completo.

Bom saber. Confira o que a sua edição do sgcWebSockets já cobre antes de comprar. Se você tem o Enterprise ou o All-Access, você já tem os cinco componentes.

SSH dentro da sua aplicação, pronto para o que vem a seguir

Baixe a versão de avaliação, execute a demo do servidor SSH e conecte-se a ela com qualquer cliente SSH. Depois, solte um TsgcSFTPClient no seu próprio formulário.

Dúvidas ou comentários? Entre em contato, você receberá a resposta das pessoas que escreveram o código.