Tutto quello che fa sgcSSH, mappato sui tre componenti client, sui due componenti server e sugli algoritmi che negoziano. Le stesse classi esistono in Delphi e .NET, e ogni licenza include il codice sorgente completo.
Comandi, shell, forwarding e rekey
Trasferimenti veloci, 16 richieste in parallelo
File e intere cartelle
Autenticazione, exec, shell e subsystem
Una jail per utente, modalità sola lettura
Prima lo scambio di chiavi post-quantum
Da Delphi 7 a 13 e .NET
sgcSSH è autosufficiente. Include il runtime sgcWebSockets Core, e il componente aggiuntivo sgcCustomIndy su cui si basano i componenti Delphi è sempre incluso nell'ordine.
Anche dentro sgcWebSockets. Tutti e cinque i componenti sono inclusi anche in sgcWebSockets Enterprise, e All-Access comprende tutto. Su .NET fanno parte del pacchetto registrato, non dell'edizione Community gratuita. sgcSSH è il pacchetto autonomo per i team che hanno bisogno solo di SSH e SFTP.
Tre client e due server, registrati nella pagina SGC SSH della palette.
| Componente | Classe | Compito | Descrizione |
|---|---|---|---|
| Client SSH | TsgcSSHClient | Eseguire comandi | Comandi remoti, una shell interattiva con pty, port forwarding locale e remoto e rekey delle sessioni di lunga durata. |
| Client SFTP | TsgcSFTPClient | Trasferire file | Operazioni da file manager SFTP v3 con 16 richieste in parallelo, così un trasferimento da 100 MB richiede circa un secondo su una rete locale. |
| Client SCP | TsgcSCPClient | Copiare file e cartelle | Carica e scarica singoli file o interi alberi di cartelle con scp, mantenendo se vuoi le date dei file. |
| Server SSH | TsgcSSHServer | Accettare client SSH | Autenticazione con password e chiave pubblica, richieste exec, shell e subsystem, con chiavi host Ed25519, ECDSA e RSA. |
| Server SFTP | TsgcSFTPServer | Servire una cartella | SFTP v3 e SCP a partire da una cartella radice, con una jail per utente, una modalità sola lettura e un evento per consentire o negare ogni operazione. |
TsgcSSHClient apre una connessione SSH autenticata e vi esegue tutti i canali che ti servono.
| Funzionalità | API | Note |
|---|---|---|
| Connessione | Host, Port, Connect, Disconnect | Porta 22 per impostazione predefinita. |
| Autenticazione con password | Authentication.Username, Authentication.Password | Accesso semplice con nome utente e password. |
| Autenticazione con chiave pubblica | Authentication.PrivateKeyFile, Authentication.Passphrase | Chiavi private Ed25519, ECDSA e RSA in file PEM o PKCS#8, e anche nel formato OpenSSH su .NET. |
| Controllo della chiave host | OnSSHHostKey | Riceve il tipo di chiave e la sua impronta, così li confronti con il tuo archivio degli host noti e rifiuti una chiave sconosciuta o cambiata. |
| Comando remoto | Execute | Apre un canale, esegue il comando e restituisce il suo output come stringa, con un timeout. |
| Shell interattiva | OpenChannel, RequestPTY, RequestShell | Una sessione di terminale con il tipo e la dimensione di terminale che scegli. |
| Input e output della shell | SendChannelData, OnSSHChannelData | Invia ciò che l'utente digita, ricevi ciò che il server stampa. |
| Controllo del terminale | SendWindowChange, SendSignal, SendEOF | Ridimensiona il terminale, invia un segnale o chiudi l'input di un canale. |
| Canali exec e subsystem | RequestExec, RequestSubsystem | Richieste di canale a basso livello per protocolli personalizzati su SSH. |
| Port forwarding locale | OpenDirectTCPIP | Apre un canale direct-tcpip verso un host e una porta raggiungibili dal server. |
| Port forwarding remoto | RequestForwarding, CancelForwarding | Chiede al server di mettersi in ascolto su una porta e di inoltrare le sue connessioni al client. |
| Rekey | Rekey | Rinnova le chiavi di sessione di una connessione di lunga durata. |
| Scambio di chiavi post-quantum | PostQuantumKex | Attivo per impostazione predefinita: propone per primo mlkem768x25519-sha256. |
TsgcSFTPClient implementa SFTP v3 sullo stesso trasporto SSH, con le stesse opzioni di autenticazione e di scambio di chiavi del client SSH.
| Funzionalità | API | Note |
|---|---|---|
| Cartella home | RealPath | Risolve un percorso come . nel percorso assoluto sul server. |
| Elenco di una cartella | ListDirectory | Nome, dimensione, data di modifica e flag di cartella di ogni voce. |
| Upload e download | Put, Get | Una chiamata per file, con 16 richieste in parallelo. Un trasferimento da 100 MB richiede circa un secondo su una rete locale. |
| Gestione dei file | Rename, Delete, MakeDirectory, RemoveDirectory | Tutto ciò che serve a un file manager. |
| Avanzamento | OnSFTPProgress | Riporta i byte trasferiti, pronti per una barra di avanzamento. |
TsgcSCPClient copia file via SSH su qualsiasi server che consenta il comando scp.
| Funzionalità | API | Note |
|---|---|---|
| File singoli | Upload, Download | Copia un file verso o dal percorso remoto. |
| Alberi di cartelle | UploadFolder, DownloadFolder | Copia ricorsivamente un'intera cartella. |
| Date dei file | PreserveTimes | Mantiene le date di modifica e di accesso dall'altra parte. |
| Avanzamento | OnSCPProgress | Riporta il nome del file e i byte trasferiti. |
TsgcSSHServer accetta qualsiasi client SSH standard, compresi gli strumenti a riga di comando standard ssh, sftp e scp.
| Funzionalità | API | Note |
|---|---|---|
| Ascolto | Port, Active | Avvia e ferma il server. |
| Chiavi host | HostKeyFiles, GenerateHostKeyEd25519 | Chiavi host Ed25519, ECDSA e RSA. La class procedure crea per te un file di chiave Ed25519. |
| Autenticazione con password | OnSSHAuthPassword | Verifica nome utente e password nel tuo archivio utenti. |
| Autenticazione con chiave pubblica | OnSSHAuthPublicKey | Riceve il tipo di chiave e la sua impronta SHA256, così accetti solo le chiavi che conosci. |
| Comandi remoti | OnSSHExec, SendChannelData, SendExitStatus, CloseChannel | Rispondi a un comando, riporta il suo exit status e chiudi il canale. |
| Shell interattiva | OnSSHShell, OnSSHChannelData | Servi una sessione di terminale dal tuo codice. |
| Subsystem | SFTPServer | Le richieste di subsystem come sftp vengono instradate a un TsgcSFTPServer collegato. |
| Eventi di connessione | OnSSHConnect, OnSSHDisconnect | Registra ogni connessione con l'indirizzo del peer. |
TsgcSFTPServer si innesta in TsgcSSHServer e serve file da una cartella che i client non possono lasciare.
| Funzionalità | API | Note |
|---|---|---|
| Protocolli | SFTP, SCP | SFTP v3, più trasferimenti scp quando abilitato. |
| Cartella radice | RootFolder | La cartella mostrata ai client. I percorsi al di fuori sono rifiutati. |
| Una cartella per utente | OnSFTPUserRoot | Restituisci la radice di ogni utente, così ognuno vede solo i propri file. |
| Modalità sola lettura | ReadOnly | Rifiuta upload, eliminazioni e rinomine. |
| Controllo per operazione | OnSFTPOperation | Scatta per ogni apertura in lettura o scrittura, rimozione, rinomina, creazione e rimozione di cartelle, cambio di attributi ed elenco. Imposta aAccept a False e il client riceve un errore di permesso negato. |
| Download di grandi dimensioni | Controllo di flusso | I download usano una quantità costante di memoria, qualunque sia la dimensione del file. |
Client e server propongono per primi gli algoritmi più forti e ripiegano su quelli classici solo quando l'altra parte ne ha bisogno.
| Area | Algoritmi | Note |
|---|---|---|
| Scambio di chiavi | mlkem768x25519-sha256 | ML-KEM-768 combinato con X25519, il predefinito delle ultime versioni di SSH. Proposto per primo sia dal client sia dal server. |
| Scambio di chiavi classico | curve25519, ECDH, Diffie-Hellman group14 e group16 | Usati quando l'altra parte non supporta lo scambio ibrido. |
| Cifrari | AES-GCM, AES-CTR | AES-GCM è accelerato in hardware da .NET 8 in poi. |
| Chiavi host e utente | Ed25519, ECDSA, RSA | Firme RSA con SHA-2, selezionate tramite server-sig-algs. |
| File di chiavi | PEM, PKCS#8, OpenSSH (.NET) | Le chiavi private cifrate si aprono con una passphrase. |
| Strict key exchange | Mitigazione di Terrapin | Chiude l'attacco di troncamento del prefisso sull'handshake SSH. |
Gli stessi cinque componenti su Delphi e .NET.
| Area | Dettaglio |
|---|---|
| Delphi | Da Delphi 7 a 13, per VCL, FMX, applicazioni console e servizi. |
| Target Delphi | Windows Win32, Windows Win64 e Linux64. |
| .NET | .NET 8, .NET 9, .NET 10 e .NET Standard 2.0, in codice completamente gestito e senza OpenSSL. |
| Demo | Demos\27.SSH: client SSH, client SFTP, client SCP, server SSH e server SFTP. |
| Edizioni | Tutti e cinque i componenti sono inclusi anche in sgcWebSockets Enterprise, e All-Access comprende tutto. Su .NET sono nel pacchetto registrato, non nell'edizione Community. |
| Licenze | Autonomo. Il runtime sgcWebSockets Core è incluso, sgcCustomIndy è compreso nell'ordine e il codice sorgente completo è incluso. |