Alles, was sgcSSH kann, aufgeschlüsselt nach den drei Client-Komponenten, den zwei Server-Komponenten und den Algorithmen, die sie aushandeln. Dieselben Klassen gibt es in Delphi und .NET, und jede Lizenz enthält den vollen Quellcode.
Befehle, Shells, Weiterleitung und Rekey
Schnelle Übertragungen, 16 Anfragen gleichzeitig
Dateien und ganze Ordner
Authentifizierung, exec, Shell und Subsysteme
Ein Jail pro Benutzer, Nur-Lese-Modus
Post-Quanten-Schlüsselaustausch zuerst
Delphi 7 bis 13 und .NET
sgcSSH ist in sich geschlossen. Es bringt die sgcWebSockets Core Runtime mit, und das Add-on sgcCustomIndy, auf dem die Delphi-Komponenten aufbauen, ist in der Bestellung immer enthalten.
Auch in sgcWebSockets enthalten. Alle fünf Komponenten sind außerdem in sgcWebSockets Enterprise enthalten, und All-Access enthält alles. Unter .NET gehören sie zum registrierten Paket, nicht zur kostenlosen Community-Edition. sgcSSH ist das eigenständige Paket für Teams, die nur SSH und SFTP brauchen.
Drei Clients und zwei Server, registriert auf der Palettenseite SGC SSH.
| Komponente | Klasse | Aufgabe | Beschreibung |
|---|---|---|---|
| SSH-Client | TsgcSSHClient | Befehle ausführen | Remote-Befehle, eine interaktive Shell mit pty, lokale und entfernte Portweiterleitung und Rekey lange laufender Sitzungen. |
| SFTP-Client | TsgcSFTPClient | Dateien übertragen | Dateimanager-Operationen über SFTP v3 mit 16 gleichzeitigen Anfragen, sodass eine 100-MB-Übertragung in einem lokalen Netzwerk etwa eine Sekunde dauert. |
| SCP-Client | TsgcSCPClient | Dateien und Ordner kopieren | Lädt einzelne Dateien oder ganze Ordnerbäume mit scp hoch und herunter, auf Wunsch unter Beibehaltung der Dateizeiten. |
| SSH-Server | TsgcSSHServer | SSH-Clients annehmen | Authentifizierung per Passwort und öffentlichem Schlüssel, exec-, Shell- und Subsystem-Anfragen, mit Ed25519-, ECDSA- und RSA-Host-Schlüsseln. |
| SFTP-Server | TsgcSFTPServer | Einen Ordner bereitstellen | SFTP v3 und SCP aus einem Stammordner, mit einem Jail pro Benutzer, einem Nur-Lese-Modus und einem Ereignis, um jede Operation zu erlauben oder zu verweigern. |
TsgcSSHClient öffnet eine authentifizierte SSH-Verbindung und führt darauf so viele Kanäle aus, wie du brauchst.
| Funktion | API | Hinweise |
|---|---|---|
| Verbindung | Host, Port, Connect, Disconnect | Standardmäßig Port 22. |
| Passwort-Authentifizierung | Authentication.Username, Authentication.Password | Einfache Anmeldung mit Benutzername und Passwort. |
| Authentifizierung per öffentlichem Schlüssel | Authentication.PrivateKeyFile, Authentication.Passphrase | Private Schlüssel Ed25519, ECDSA und RSA in PEM- oder PKCS#8-Dateien, unter .NET auch im OpenSSH-Format. |
| Host-Schlüssel-Prüfung | OnSSHHostKey | Erhält den Schlüsseltyp und seinen Fingerabdruck, damit du beides mit deinem Known-Hosts-Speicher abgleichst und einen unbekannten oder geänderten Schlüssel ablehnst. |
| Remote-Befehl | Execute | Öffnet einen Kanal, führt den Befehl aus und gibt seine Ausgabe als Zeichenkette zurück, mit Timeout. |
| Interaktive Shell | OpenChannel, RequestPTY, RequestShell | Eine Terminalsitzung mit dem von dir gewählten Terminaltyp und der gewählten Größe. |
| Ein- und Ausgabe der Shell | SendChannelData, OnSSHChannelData | Sende, was der Benutzer eingibt, und empfange, was der Server ausgibt. |
| Terminalsteuerung | SendWindowChange, SendSignal, SendEOF | Ändere die Terminalgröße, sende ein Signal oder beende die Eingabe eines Kanals. |
| Exec- und Subsystem-Kanäle | RequestExec, RequestSubsystem | Kanalanfragen auf niedriger Ebene für eigene Protokolle über SSH. |
| Lokale Portweiterleitung | OpenDirectTCPIP | Öffnet einen direct-tcpip-Kanal zu einem Host und Port, die vom Server aus erreichbar sind. |
| Entfernte Portweiterleitung | RequestForwarding, CancelForwarding | Bittet den Server, auf einem Port zu lauschen und dessen Verbindungen an den Client zurückzuleiten. |
| Rekey | Rekey | Erneuert die Sitzungsschlüssel einer lange laufenden Verbindung. |
| Post-Quanten-Schlüsselaustausch | PostQuantumKex | Standardmäßig aktiv: bietet mlkem768x25519-sha256 zuerst an. |
TsgcSFTPClient implementiert SFTP v3 über denselben SSH-Transport, mit denselben Optionen für Authentifizierung und Schlüsselaustausch wie der SSH-Client.
| Funktion | API | Hinweise |
|---|---|---|
| Home-Ordner | RealPath | Löst einen Pfad wie . zum absoluten Pfad auf dem Server auf. |
| Ordnerauflistung | ListDirectory | Name, Größe, Änderungsdatum und Ordner-Kennzeichen jedes Eintrags. |
| Hoch- und Herunterladen | Put, Get | Ein Aufruf pro Datei, mit 16 gleichzeitigen Anfragen. Eine 100-MB-Übertragung dauert in einem lokalen Netzwerk etwa eine Sekunde. |
| Dateiverwaltung | Rename, Delete, MakeDirectory, RemoveDirectory | Alles, was ein Dateimanager braucht. |
| Fortschritt | OnSFTPProgress | Meldet die übertragenen Bytes, bereit für einen Fortschrittsbalken. |
TsgcSCPClient kopiert Dateien über SSH auf jeden Server, der den Befehl scp erlaubt.
| Funktion | API | Hinweise |
|---|---|---|
| Einzelne Dateien | Upload, Download | Kopiert eine Datei zum oder vom entfernten Pfad. |
| Ordnerbäume | UploadFolder, DownloadFolder | Kopiert einen ganzen Ordner rekursiv. |
| Dateizeiten | PreserveTimes | Behält die Änderungs- und Zugriffszeiten auf der Gegenseite bei. |
| Fortschritt | OnSCPProgress | Meldet den Dateinamen und die übertragenen Bytes. |
TsgcSSHServer akzeptiert jeden Standard-SSH-Client, auch die Standard-Kommandozeilenwerkzeuge ssh, sftp und scp.
| Funktion | API | Hinweise |
|---|---|---|
| Lauschen | Port, Active | Startet und stoppt den Server. |
| Host-Schlüssel | HostKeyFiles, GenerateHostKeyEd25519 | Host-Schlüssel Ed25519, ECDSA und RSA. Die Klassenprozedur erzeugt für dich eine Ed25519-Schlüsseldatei. |
| Passwort-Authentifizierung | OnSSHAuthPassword | Prüfe Benutzername und Passwort gegen deinen eigenen Benutzerspeicher. |
| Authentifizierung per öffentlichem Schlüssel | OnSSHAuthPublicKey | Erhält den Schlüsseltyp und seinen SHA256-Fingerabdruck, damit du nur die Schlüssel akzeptierst, die du kennst. |
| Remote-Befehle | OnSSHExec, SendChannelData, SendExitStatus, CloseChannel | Beantwortet einen Befehl, meldet seinen Exit-Status und schließt den Kanal. |
| Interaktive Shell | OnSSHShell, OnSSHChannelData | Bediene eine Terminalsitzung aus deinem eigenen Code. |
| Subsysteme | SFTPServer | Subsystem-Anfragen wie sftp werden an einen verknüpften TsgcSFTPServer geleitet. |
| Verbindungsereignisse | OnSSHConnect, OnSSHDisconnect | Protokolliere jede Verbindung mit der Adresse der Gegenstelle. |
TsgcSFTPServer wird in TsgcSSHServer eingesteckt und liefert Dateien aus einem Ordner, den Clients nicht verlassen können.
| Funktion | API | Hinweise |
|---|---|---|
| Protokolle | SFTP, SCP | SFTP v3, dazu scp-Übertragungen, wenn aktiviert. |
| Stammordner | RootFolder | Der Ordner, den die Clients sehen. Pfade außerhalb davon werden abgelehnt. |
| Ein Ordner pro Benutzer | OnSFTPUserRoot | Gib die Wurzel jedes Benutzers zurück, sodass jeder nur seine eigenen Dateien sieht. |
| Nur-Lese-Modus | ReadOnly | Lehnt Uploads, Löschungen und Umbenennungen ab. |
| Kontrolle pro Operation | OnSFTPOperation | Wird bei jedem Öffnen zum Lesen oder Schreiben, Entfernen, Umbenennen, Anlegen und Entfernen von Ordnern, Ändern von Attributen und Auflisten ausgelöst. Setze aAccept auf False, und der Client erhält den Fehler "Zugriff verweigert". |
| Große Downloads | Flusskontrolle | Downloads verbrauchen konstant viel Speicher, egal wie groß die Datei ist. |
Client und Server bieten zuerst die stärksten Algorithmen an und greifen nur dann auf die klassischen zurück, wenn die Gegenseite sie braucht.
| Bereich | Algorithmen | Hinweise |
|---|---|---|
| Schlüsselaustausch | mlkem768x25519-sha256 | ML-KEM-768 kombiniert mit X25519, der Standard der neuesten SSH-Versionen. Wird von Client und Server zuerst angeboten. |
| Klassischer Schlüsselaustausch | curve25519, ECDH, Diffie-Hellman group14 und group16 | Wird verwendet, wenn die Gegenseite den hybriden Austausch nicht unterstützt. |
| Verschlüsselungen | AES-GCM, AES-CTR | AES-GCM ist ab .NET 8 hardwarebeschleunigt. |
| Host- und Benutzerschlüssel | Ed25519, ECDSA, RSA | RSA-Signaturen mit SHA-2, ausgewählt über server-sig-algs. |
| Schlüsseldateien | PEM, PKCS#8, OpenSSH (.NET) | Verschlüsselte private Schlüssel werden mit einer Passphrase geöffnet. |
| Strikter Schlüsselaustausch | Terrapin-Abwehr | Schließt den Präfix-Abschneideangriff auf den SSH-Handshake. |
Dieselben fünf Komponenten in Delphi und .NET.
| Bereich | Detail |
|---|---|
| Delphi | Delphi 7 bis 13, für VCL, FMX, Konsolenanwendungen und Dienste. |
| Delphi-Zielplattformen | Windows Win32, Windows Win64 und Linux64. |
| .NET | .NET 8, .NET 9, .NET 10 und .NET Standard 2.0, in vollständig verwaltetem Code ohne OpenSSL. |
| Demos | Demos\27.SSH: SSH-Client, SFTP-Client, SCP-Client, SSH-Server und SFTP-Server. |
| Editionen | Alle fünf Komponenten sind außerdem in sgcWebSockets Enterprise enthalten, und All-Access enthält alles. Unter .NET gehören sie zum registrierten Paket, nicht zur Community-Edition. |
| Lizenzierung | Eigenständig. Die sgcWebSockets Core Runtime ist enthalten, sgcCustomIndy gehört zur Bestellung und der volle Quellcode ist inklusive. |