sgcSSH: postkwantowe SSH, SFTP i SCP dla Delphi i .NET

· Komponenty
sgcSSH: postkwantowe SSH, SFTP i SCP dla Delphi i .NET | Blog eSeGeCe
Nowy produkt · sgcSSH

SSH, SFTP i SCP dla Delphi i .NET.
Postkwantowe domyślnie.

Trzech klientów i dwa serwery, które wbudowują SSH w Twoje własne aplikacje. Hybrydowa wymiana kluczy mlkem768x25519-sha256 jest oferowana jako pierwsza po obu stronach, a kryptografia działa jako kod natywny.

  • ML-KEM-768 + X25519
  • SFTP v3
  • SCP
  • Ed25519
  • AES-GCM
Dema sgcSSH obok siebie: klient SSH wykonujący polecenie i interaktywną powłokę, klient SFTP przeglądający zdalny folder, serwer SFTP udostępniający folder główny oraz terminal pokazujący wymianę kluczy mlkem768x25519-sha256
5komponentów
16żądań SFTP w locie
~1 sna 100 MB w sieci LAN
0bibliotek DLL OpenSSL przy natywnej kryptografii

SSH to standardowy sposób zarządzania serwerami i bezpiecznej wymiany plików. sgcSSH wprowadza go do Twoich aplikacji Delphi, C++Builder i .NET jako zwykłe komponenty, zarówno po stronie klienta, jak i serwera.

Dzięki sgcSSH wykonasz polecenie na serwerze Linux i otrzymasz jego wynik jako ciąg znaków, otworzysz interaktywną powłokę, przekierujesz port, wyślesz folder przez SFTP lub SCP albo zamienisz własną aplikację w serwer SSH i SFTP z prywatnym folderem dla każdego użytkownika. Klient i serwer oferują jako pierwszą hybrydową postkwantową wymianę kluczy, tę samą, której domyślnie używają najnowsze wydania SSH.

sgcSSH w skrócie: klienci, serwery i postkwantowa wymiana kluczy. Także na YouTube.

Trzech klientów, dwa serwery

Każdy z nich jest komponentem niewizualnym na stronie palety SGC SSH. Upuszczasz go na formularzu lub tworzysz w kodzie, ustawiasz host i dane logowania, podłączasz zdarzenia, a następnie łączysz się lub zaczynasz nasłuchiwać. Klasy .NET mają takie same nazwy.

Klient SSHTsgcSSHClientPolecenia, interaktywne powłoki z pty, przekierowanie portów i zmiana kluczy sesji.
Klient SFTPTsgcSFTPClientTransfer plików SFTP v3 z 16 żądaniami w locie.
Klient SCPTsgcSCPClientPliki i całe foldery przez scp, z zachowaniem czasów plików.
Serwer SSHTsgcSSHServerLogowanie hasłem i kluczem publicznym, exec, powłoka i podsystemy.
Serwer SFTPTsgcSFTPServerSFTP v3 i SCP z folderu głównego, z osobnym jailem dla każdego użytkownika.

Postkwantowa wymiana kluczy, domyślnie włączona

Ruch zaszyfrowany dziś może zostać zaatakowany jutro. Atakujący nagrywa zaszyfrowaną sesję teraz i odszyfrowuje ją później, gdy powstanie dostatecznie duży komputer kwantowy. Nazywa się to harvest now, decrypt later (zbieraj teraz, odszyfruj później) i ma znaczenie dla wszystkiego, co musi pozostać prywatne przez lata: danych logowania, umów, plików klientów.

sgcSSH odpowiada na to hybrydową wymianą kluczy mlkem768x25519-sha256. Łączy ona ML-KEM-768 (FIPS 203), algorytm postkwantowy, z klasycznym X25519, dzięki czemu klucze sesji pozostają tajne, dopóki nie zostaną złamane oba algorytmy. To ustawienie domyślne najnowszych wydań SSH.

Oto standardowy klient wiersza poleceń ssh łączący się z demem serwera SSH. Hybrydowa wymiana jest negocjowana przy ustawieniach domyślnych po obu stronach:

ssh -v wobec 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

Natywna kryptografia, bez bibliotek DLL do wdrożenia

W Delphi właściwość CryptoLibrary wybiera, gdzie obliczane są algorytmy klasyczne (ECDH, Diffie-Hellman, AES, HMAC i podpisy kluczy hosta):

Hybrydowa wymiana ML-KEM-768 i X25519 jest w obu opcjach natywnym kodem biblioteki. Komponenty .NET to w pełni kod zarządzany, bez OpenSSL, a w .NET 8 i nowszych AES-GCM jest przyspieszany sprzętowo.

Wysłanie pliku przez SFTP z postkwantową wymianą kluczy i natywną kryptografią zajmuje kilka linii:

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;

Klient SSH: polecenia, powłoki i tunele

TsgcSSHClient loguje się hasłem lub kluczem prywatnym, a OnSSHHostKey przekazuje typ klucza hosta i jego odcisk, abyś mógł porównać go ze znanymi hostami i odrzucić nieznany lub zmieniony klucz.

Demo klienta SSH: połączenie z postkwantową wymianą kluczy i natywną biblioteką kryptograficzną, wynik zdalnego polecenia, interaktywna powłoka wyświetlająca folder oraz zaakceptowany klucz hosta Ed25519 w logu
Demo klienta SSH: zdalne polecenie, interaktywna powłoka i sprawdzenie klucza hosta.

Wykonanie polecenia konserwacyjnego z kluczem prywatnym i sprawdzeniem klucza hosta:

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 i SCP: szybki transfer plików

TsgcSFTPClient obsługuje SFTP v3 w tym samym połączeniu SSH, z jedną metodą na każde zadanie: RealPath rozwiązuje folder domowy, ListDirectory zwraca nazwy, rozmiary i daty, Put i Get wysyłają i pobierają plik, a Rename, Delete, MakeDirectory i RemoveDirectory pokrywają resztę funkcji menedżera plików. OnSFTPProgress raportuje liczbę przesłanych bajtów dla paska postępu.

Transfery są szybkie, ponieważ klient nie czeka na każdy blok. Utrzymuje 16 żądań w locie, więc plik 100 MB zajmuje około jednej sekundy w sieci lokalnej.

Demo klienta SFTP: zdalny folder wyświetlony z nazwami, rozmiarami, datami i znacznikami folderów oraz pasek postępu dużego pobierania
Demo klienta SFTP przeglądające zdalny folder podczas pobierania dużego pliku.

TsgcSCPClient kopiuje pliki przez SSH na dowolny serwer, który zezwala na polecenie scp, bez osobnej usługi transferu plików. Upload i Download kopiują jeden plik, UploadFolder i DownloadFolder kopiują całe drzewo folderów, a PreserveTimes zachowuje czasy modyfikacji i dostępu po drugiej stronie.

Demo klienta SCP z przyciskami wysyłania i pobierania pliku lub całego folderu, opcją zachowania czasów plików i postępem transferu
Demo klienta SCP: pojedyncze pliki lub całe foldery, z czasami plików lub bez nich.

Własny serwer SSH i SFTP

TsgcSSHServer nasłuchuje na wybranym porcie i potwierdza swoją tożsamość kluczami hosta Ed25519, ECDSA lub RSA wczytanymi z HostKeyFiles. GenerateHostKeyEd25519 tworzy taki klucz za Ciebie. OnSSHAuthPassword i OnSSHAuthPublicKey decydują, kto wejdzie, przy czym drugie otrzymuje typ klucza i jego odcisk SHA256. OnSSHExec odpowiada na zdalne polecenia, a OnSSHShell obsługuje sesję interaktywną. Łączy się z nim każdy standardowy klient SSH, w tym narzędzia wiersza poleceń ssh, sftp i scp.

Podłącz TsgcSFTPServer, a ten sam serwer stanie się serwerem plików:

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;

Tutaj standardowe narzędzie wiersza poleceń sftp pracuje z demem serwera SFTP:

sftp wobec 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

Po stronie serwera każda z tych operacji przeszła przez OnSFTPOperation, gdzie demo ją zapisuje w logu:

Demo serwera SFTP nasłuchujące z natywną biblioteką kryptograficzną, kluczem hosta Ed25519 i opcjami jednego podfolderu na użytkownika, trybu tylko do odczytu, SCP i odrzucanych usunięć; log pokazuje logowanie hasłem, listowania, otwarcie do zapisu, otwarcie do odczytu i nowy folder
Demo serwera SFTP zapisujące w logu powyższą sesję, jedna linia na operację.

Szczegóły bezpieczeństwa

Delphi, C++Builder i .NET

Te same pięć komponentów jest dostępnych na każdej platformie obsługiwanej przez sgcSSH:

Kod .NET wygląda tak samo jak kod 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();
}

Pięć dem w Demos\27.SSH pokazuje każdy komponent w działaniu: 01.SSH_Client, 02.SFTP_Client, 03.SCP_Client, 04.SSH_Server i 05.SFTP_Server. Zrzuty ekranu w tym artykule pochodzą z nich.

Edycje

sgcSSH jest zawarty w sgcWebSockets Enterprise i sgcWebSockets All-Access. W .NET komponenty są dostarczane w zarejestrowanym pakiecie sgcWebSockets, a nie w bezpłatnej edycji Community.

Jeśli potrzebujesz tylko SSH i SFTP, samodzielny pakiet sgcSSH jest kompletny: zawiera środowisko uruchomieniowe sgcWebSockets Core wraz z natywną kryptografią, na której działa wymiana kluczy, dodatek sgcCustomIndy, na którym opierają się komponenty Delphi, jest zawsze dołączany do zamówienia, a każda licencja zawiera pełny kod źródłowy.

Warto wiedzieć. Zanim kupisz, sprawdź, co już obejmuje Twoja edycja sgcWebSockets. Jeśli posiadasz Enterprise lub All-Access, masz już wszystkie pięć komponentów.

SSH w Twojej aplikacji, gotowe na to, co nadejdzie

Pobierz wersję próbną, uruchom demo serwera SSH i połącz się z nim dowolnym klientem SSH. Następnie upuść TsgcSFTPClient na własnym formularzu.

Pytania lub uwagi? Skontaktuj się z nami, odpowiedzą Ci osoby, które napisały ten kod.