sgcSSH: Delphi와 .NET을 위한 포스트 퀀텀 SSH, SFTP, SCP

· 컴포넌트
sgcSSH: Delphi와 .NET을 위한 포스트 퀀텀 SSH, SFTP, SCP | eSeGeCe 블로그
신제품 · sgcSSH

Delphi와 .NET을 위한 SSH, SFTP, SCP.
기본값부터 포스트 퀀텀.

SSH를 여러분의 애플리케이션 안에 넣어 주는 클라이언트 3종과 서버 2종입니다. 하이브리드 키 교환 mlkem768x25519-sha256을 양쪽 모두에서 가장 먼저 제안하며, 암호화는 네이티브 코드로 실행됩니다.

  • ML-KEM-768 + X25519
  • SFTP v3
  • SCP
  • Ed25519
  • AES-GCM
나란히 배치한 sgcSSH 데모: 명령과 대화형 셸을 실행하는 SSH 클라이언트, 원격 폴더를 탐색하는 SFTP 클라이언트, 루트 폴더를 제공하는 SFTP 서버, 그리고 키 교환 mlkem768x25519-sha256을 보여 주는 터미널
5컴포넌트
16동시 처리 SFTP 요청
~1 sLAN에서 100 MB당
0네이티브 암호화 사용 시 OpenSSL DLL

SSH는 서버를 관리하고 파일을 안전하게 주고받는 표준 방식입니다. sgcSSH는 이를 Delphi, C++Builder, .NET 애플리케이션에 클라이언트 측과 서버 측 모두 일반 컴포넌트로 제공합니다.

sgcSSH를 사용하면 Linux 서버에서 명령을 실행하고 그 출력을 문자열로 받거나, 대화형 셸을 열거나, 포트를 포워딩하거나, SFTP 또는 SCP로 폴더를 업로드할 수 있습니다. 또한 자체 애플리케이션을 사용자별 전용 폴더를 갖춘 SSH 및 SFTP 서버로 만들 수도 있습니다. 클라이언트와 서버 모두 최신 SSH 릴리스가 기본으로 사용하는 하이브리드 포스트 퀀텀 키 교환을 가장 먼저 제안합니다.

sgcSSH 한눈에 보기: 클라이언트, 서버, 그리고 포스트 퀀텀 키 교환. YouTube에서도 볼 수 있습니다.

클라이언트 3종, 서버 2종

각 컴포넌트는 SGC SSH 팔레트 페이지에 있는 비주얼이 아닌 컴포넌트입니다. 폼에 올려놓거나 코드에서 생성한 뒤, 호스트와 자격 증명을 설정하고 이벤트를 연결한 다음 연결하거나 수신 대기를 시작하면 됩니다. .NET 클래스도 이름이 같습니다.

SSH 클라이언트TsgcSSHClient명령, pty를 갖춘 대화형 셸, 포트 포워딩, 재키 교환.
SFTP 클라이언트TsgcSFTPClient16개 요청을 동시에 처리하는 SFTP v3 파일 전송.
SCP 클라이언트TsgcSCPClientscp로 파일과 폴더 전체를 파일 시간까지 보존하며 전송.
SSH 서버TsgcSSHServer비밀번호 및 공개 키 로그인, exec, 셸, 서브시스템.
SFTP 서버TsgcSFTPServer루트 폴더에서 SFTP v3와 SCP를 제공하며 사용자별 jail 지원.

포스트 퀀텀 키 교환, 기본값으로 켜짐

오늘 암호화한 트래픽이 내일 공격받을 수 있습니다. 공격자는 지금 암호화된 세션을 기록해 두었다가, 충분히 강력한 양자 컴퓨터가 등장하면 그때 복호화합니다. 이를 harvest now, decrypt later(지금 수집하고 나중에 복호화)라고 하며, 자격 증명, 계약서, 고객 파일처럼 수년간 기밀로 유지해야 하는 모든 데이터에 중요한 문제입니다.

sgcSSH는 하이브리드 키 교환 mlkem768x25519-sha256으로 이에 대응합니다. 포스트 퀀텀 알고리즘인 ML-KEM-768(FIPS 203)과 기존의 X25519를 결합하므로, 둘 중 하나가 깨지지 않는 한 세션 키는 안전하게 유지됩니다. 최신 SSH 릴리스의 기본값이기도 합니다.

다음은 표준 ssh 명령줄 클라이언트가 SSH 서버 데모에 접속하는 모습입니다. 양쪽 모두 기본 설정만으로 하이브리드 교환이 협상됩니다.

TsgcSSHServer에 대한 ssh -v
$ 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

네이티브 암호화, 배포할 DLL 없음

Delphi에서는 CryptoLibrary 속성으로 기존 알고리즘(ECDH, Diffie-Hellman, AES, HMAC, 호스트 키 서명)을 어디에서 계산할지 선택합니다.

ML-KEM-768과 X25519 하이브리드 교환은 두 옵션 모두에서 라이브러리의 네이티브 코드로 실행됩니다. .NET 컴포넌트는 OpenSSL 없이 완전한 관리 코드로 구성되며, .NET 8 이상에서는 AES-GCM이 하드웨어 가속됩니다.

포스트 퀀텀 교환과 네이티브 암호화로 SFTP 파일을 업로드하는 데 필요한 코드는 몇 줄뿐입니다.

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;

SSH 클라이언트: 명령, 셸, 터널

TsgcSSHClient는 비밀번호 또는 개인 키로 로그인하며, OnSSHHostKey는 호스트 키 유형과 지문을 전달해 주므로 known hosts와 대조하여 알 수 없거나 변경된 키를 거부할 수 있습니다.

SSH 클라이언트 데모: 포스트 퀀텀 키 교환과 네이티브 암호화 라이브러리로 연결된 상태, 원격 명령의 출력, 폴더를 나열하는 대화형 셸, 로그에 표시된 수락된 Ed25519 호스트 키
SSH 클라이언트 데모: 원격 명령, 대화형 셸, 호스트 키 확인.

개인 키와 호스트 키 확인을 사용해 유지보수 명령을 실행하는 예입니다.

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와 SCP: 빠른 파일 전송

TsgcSFTPClient는 동일한 SSH 연결 위에서 SFTP v3를 사용하며, 작업마다 메서드가 하나씩 있습니다. RealPath는 홈 폴더를 확인하고, ListDirectory는 이름, 크기, 날짜를 반환하며, Put과 Get은 파일을 업로드하고 다운로드합니다. Rename, Delete, MakeDirectory, RemoveDirectory는 파일 관리자에 필요한 나머지를 담당합니다. OnSFTPProgress는 진행률 표시줄에 쓸 수 있도록 전송된 바이트 수를 알려 줍니다.

클라이언트가 블록마다 응답을 기다리지 않기 때문에 전송이 빠릅니다. 16개 요청을 동시에 처리하므로 100 MB 파일이 로컬 네트워크에서 약 1초면 전송됩니다.

SFTP 클라이언트 데모: 이름, 크기, 날짜, 폴더 표시와 함께 나열된 원격 폴더, 그리고 대용량 다운로드의 진행률 표시줄
대용량 파일을 다운로드하는 동안 원격 폴더를 탐색하는 SFTP 클라이언트 데모.

TsgcSCPClient는 scp 명령을 허용하는 모든 서버에 SSH로 파일을 복사하며, 별도의 파일 전송 서비스가 필요 없습니다. Upload와 Download는 파일 하나를 복사하고, UploadFolder와 DownloadFolder는 폴더 트리 전체를 복사하며, PreserveTimes는 상대편에서도 수정 시간과 접근 시간을 유지합니다.

파일 또는 폴더 전체를 업로드하고 다운로드하는 버튼, 파일 시간 보존 옵션, 전송 진행 상황이 있는 SCP 클라이언트 데모
SCP 클라이언트 데모: 파일 하나 또는 폴더 전체를 파일 시간 포함 여부와 관계없이 전송.

나만의 SSH 및 SFTP 서버

TsgcSSHServer는 지정한 포트에서 수신 대기하며, HostKeyFiles에서 불러온 Ed25519, ECDSA 또는 RSA 호스트 키로 자신의 신원을 증명합니다. GenerateHostKeyEd25519가 키를 대신 만들어 줍니다. OnSSHAuthPassword와 OnSSHAuthPublicKey가 접근 허용 여부를 결정하며, 후자는 키 유형과 SHA256 지문을 함께 받습니다. OnSSHExec는 원격 명령에 응답하고 OnSSHShell은 대화형 세션을 제공합니다. ssh, sftp, scp 명령줄 도구를 포함해 표준 SSH 클라이언트라면 무엇이든 접속할 수 있습니다.

TsgcSFTPServer를 연결하면 같은 서버가 파일 서버가 됩니다.

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;

다음은 표준 sftp 명령줄 도구가 SFTP 서버 데모와 함께 동작하는 모습입니다.

TsgcSFTPServer에 대한 sftp
$ 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

서버 측에서는 이 모든 작업이 OnSFTPOperation을 거쳤고, 데모는 여기에서 이를 기록합니다.

네이티브 암호화 라이브러리와 Ed25519 호스트 키로 수신 대기 중인 SFTP 서버 데모. 사용자별 하위 폴더, 읽기 전용, SCP, 삭제 거부 옵션이 있으며, 로그에는 비밀번호 로그인, 목록 조회, 쓰기용 열기, 읽기용 열기, 새 폴더가 표시됩니다
위 세션을 작업당 한 줄씩 기록하는 SFTP 서버 데모.

보안 세부 사항

Delphi, C++Builder, .NET

sgcSSH가 지원하는 모든 플랫폼에서 동일한 컴포넌트 5종을 사용할 수 있습니다.

.NET 코드도 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();
}

Demos\27.SSH에 있는 데모 5개가 각 컴포넌트의 동작을 보여 줍니다. 01.SSH_Client, 02.SFTP_Client, 03.SCP_Client, 04.SSH_Server, 05.SFTP_Server입니다. 이 글의 스크린샷은 모두 이 데모에서 가져왔습니다.

에디션

sgcSSH는 sgcWebSockets Enterprise와 sgcWebSockets All-Access에 포함됩니다. .NET에서는 컴포넌트가 무료 Community 에디션이 아닌 정식 sgcWebSockets 패키지에 포함되어 제공됩니다.

SSH와 SFTP만 필요하다면 독립형 sgcSSH 팩이 그 자체로 완결됩니다. sgcWebSockets Core 런타임과 키 교환이 사용하는 네이티브 암호화를 함께 제공하고, Delphi 컴포넌트의 기반이 되는 sgcCustomIndy 애드온은 주문에 항상 포함되며, 모든 라이선스에 전체 소스 코드가 포함됩니다.

알아 두세요. 구매하기 전에 보유하신 sgcWebSockets 에디션이 이미 무엇을 포함하는지 확인하세요. Enterprise 또는 All-Access를 보유하고 있다면 컴포넌트 5종을 모두 이미 갖고 계신 것입니다.

애플리케이션 안의 SSH, 다가올 미래에 대한 준비 완료

체험판을 다운로드하고 SSH 서버 데모를 실행한 뒤 아무 SSH 클라이언트로 접속해 보세요. 그런 다음 여러분의 폼에 TsgcSFTPClient를 올려놓으세요.

질문이나 의견이 있으신가요? 문의해 주세요. 코드를 직접 작성한 사람들이 답변해 드립니다.