sgcSSH: Delphi & .NET 向け SSH & SFTP クライアントとサーバー

TsgcSSHClient はパスワードまたは秘密鍵で接続し、OnSSHHostKey がホスト鍵の種類とフィンガープリントを渡すので、known hosts の保存先と照合できます。Execute はコマンドを実行し、その出力を 1 回の呼び出しで返します。対話型セッションでは、OpenChannel、RequestPTY、RequestShell が端末を開き、SendChannelData が入力を送り、OnSSHChannelData がサーバーの出力を返します。端末プロトコルの残りは SendWindowChange と SendSignal が担当します。OpenDirectTCPIP はローカルの接続をサーバー経由で転送し、RequestForwarding はサーバー側のポートをこちらへ転送するよう依頼し、Rekey は長時間続く接続のセッション鍵を更新します。

TsgcSFTPClient は、同じ SSH 接続の上で SFTP v3 を話します。RealPath はホームフォルダーを解決し、ListDirectory は名前、サイズ、日付、フォルダーフラグを返し、Put と Get は 1 回の呼び出しでファイルをアップロード、ダウンロードします。Rename、Delete、MakeDirectory、RemoveDirectory でファイルマネージャーに必要な操作が揃い、OnSFTPProgress は転送済みバイト数をプログレスバー向けに通知します。転送では、ブロックごとに応答を待たずに 16 件のリクエストを同時に処理するため、100 MB のファイルがローカルネットワークで約 1 秒で転送されます。

TsgcSCPClient は、scp コマンドを許可している任意のサーバーへ、別途ファイル転送サービスを用意することなく SSH 経由でファイルをコピーします。Upload と Download は 1 つのファイルをコピーし、UploadFolder と DownloadFolder はフォルダーツリー全体を再帰的にコピーし、PreserveTimes は更新日時とアクセス日時を相手側にも保持します。OnSCPProgress はファイル名と転送済みバイト数を通知します。

TsgcSSHServer は指定したポートでリッスンし、HostKeyFiles から読み込んだ Ed25519、ECDSA、RSA のホスト鍵で自身の身元を証明します。GenerateHostKeyEd25519 を使えば鍵を自動で作成できます。OnSSHAuthPassword と OnSSHAuthPublicKey が誰を通すかを決め、後者には鍵の種類とその SHA256 フィンガープリントが渡されます。OnSSHExec はリモートコマンドに応答し、OnSSHShell は対話型セッションを提供し、サブシステム要求はお使いのハンドラーまたは TsgcSFTPServer に振り分けられます。標準の ssh、sftp、scp コマンドラインツールを含め、標準的な SSH クライアントであればどれでも接続できます。

TsgcSFTPServer は SFTPServer プロパティで SSH サーバーにリンクし、RootFolder から SFTP v3 を提供します。SCP を有効にすれば scp 転送も提供します。クライアントはそのフォルダーの外に出られません。OnSFTPUserRoot は各ユーザーに専用のフォルダーを割り当て、ReadOnly はアップロード、削除、名前変更を拒否し、OnSFTPOperation は open、remove、rename、フォルダー変更、属性変更、一覧取得のたびに発生するので、1 件ずつ許可または拒否し、ログに残せます。フロー制御により、ファイルサイズに関係なく、大きなダウンロードでもメモリ使用量は一定です。