Tout ce que fait sgcSSH, réparti sur les trois composants clients, les deux composants serveurs et les algorithmes qu'ils négocient. Les mêmes classes existent en Delphi et en .NET, et chaque licence inclut le code source complet.
Commandes, shells, redirection et rekey
Transferts rapides, 16 requêtes en vol
Fichiers et dossiers entiers
Authentification, exec, shell et sous-systèmes
Une jail par utilisateur, mode lecture seule
Échange de clés post-quantique en premier
Delphi 7 à 13 et .NET
sgcSSH est autonome. Il est livré avec le runtime sgcWebSockets Core inclus, et le complément sgcCustomIndy sur lequel reposent les composants Delphi est toujours inclus dans la commande.
Aussi dans sgcWebSockets. Les cinq composants sont aussi livrés dans sgcWebSockets Enterprise, et All-Access inclut tout. En .NET, ils font partie du package enregistré, pas de l'édition Community gratuite. sgcSSH est le package autonome pour les équipes qui n'ont besoin que de SSH et SFTP.
Trois clients et deux serveurs, enregistrés sur la page de palette SGC SSH.
| Composant | Classe | Fonction | Description |
|---|---|---|---|
| Client SSH | TsgcSSHClient | Exécuter des commandes | Commandes distantes, un shell interactif avec pty, la redirection de ports locale et distante, et le rekey des sessions de longue durée. |
| Client SFTP | TsgcSFTPClient | Transférer des fichiers | Opérations de gestionnaire de fichiers SFTP v3 avec 16 requêtes en vol, si bien qu'un transfert de 100 Mo prend environ une seconde sur un réseau local. |
| Client SCP | TsgcSCPClient | Copier des fichiers et des dossiers | Envoie et télécharge des fichiers isolés ou des arborescences entières avec scp, en conservant si besoin les dates des fichiers. |
| Serveur SSH | TsgcSSHServer | Accepter des clients SSH | Authentification par mot de passe et par clé publique, requêtes exec, shell et de sous-système, avec des clés d'hôte Ed25519, ECDSA et RSA. |
| Serveur SFTP | TsgcSFTPServer | Servir un dossier | SFTP v3 et SCP depuis un dossier racine, avec une jail par utilisateur, un mode lecture seule et un événement pour autoriser ou refuser chaque opération. |
TsgcSSHClient ouvre une connexion SSH authentifiée et y exécute autant de canaux que tu en as besoin.
| Capacité | API | Notes |
|---|---|---|
| Connexion | Host, Port, Connect, Disconnect | Port 22 par défaut. |
| Authentification par mot de passe | Authentication.Username, Authentication.Password | Connexion simple avec nom d'utilisateur et mot de passe. |
| Authentification par clé publique | Authentication.PrivateKeyFile, Authentication.Passphrase | Clés privées Ed25519, ECDSA et RSA dans des fichiers PEM ou PKCS#8, et aussi au format OpenSSH en .NET. |
| Vérification de la clé d'hôte | OnSSHHostKey | Reçoit le type de clé et son empreinte, pour que tu les compares à ton magasin d'hôtes connus et refuses une clé inconnue ou modifiée. |
| Commande distante | Execute | Ouvre un canal, exécute la commande et renvoie sa sortie sous forme de chaîne, avec un délai d'expiration. |
| Shell interactif | OpenChannel, RequestPTY, RequestShell | Une session de terminal avec le type et la taille de terminal que tu choisis. |
| Entrée et sortie du shell | SendChannelData, OnSSHChannelData | Envoie ce que l'utilisateur tape, reçois ce que le serveur affiche. |
| Contrôle du terminal | SendWindowChange, SendSignal, SendEOF | Redimensionne le terminal, envoie un signal ou termine l'entrée d'un canal. |
| Canaux exec et de sous-système | RequestExec, RequestSubsystem | Requêtes de canal de bas niveau pour des protocoles personnalisés sur SSH. |
| Redirection de ports locale | OpenDirectTCPIP | Ouvre un canal direct-tcpip vers un hôte et un port joignables depuis le serveur. |
| Redirection de ports distante | RequestForwarding, CancelForwarding | Demande au serveur d'écouter sur un port et de rediriger ses connexions vers le client. |
| Rekey | Rekey | Renouvelle les clés de session d'une connexion de longue durée. |
| Échange de clés post-quantique | PostQuantumKex | Activé par défaut : propose mlkem768x25519-sha256 en premier. |
TsgcSFTPClient implémente SFTP v3 sur le même transport SSH, avec les mêmes options d'authentification et d'échange de clés que le client SSH.
| Capacité | API | Notes |
|---|---|---|
| Dossier personnel | RealPath | Résout un chemin tel que . en chemin absolu sur le serveur. |
| Liste d'un dossier | ListDirectory | Nom, taille, date de modification et indicateur de dossier de chaque entrée. |
| Envoi et téléchargement | Put, Get | Un appel par fichier, avec 16 requêtes en vol. Un transfert de 100 Mo prend environ une seconde sur un réseau local. |
| Gestion de fichiers | Rename, Delete, MakeDirectory, RemoveDirectory | Tout ce dont un gestionnaire de fichiers a besoin. |
| Progression | OnSFTPProgress | Indique les octets transférés, prêt pour une barre de progression. |
TsgcSCPClient copie des fichiers via SSH vers tout serveur qui autorise la commande scp.
| Capacité | API | Notes |
|---|---|---|
| Fichiers isolés | Upload, Download | Copie un fichier vers ou depuis le chemin distant. |
| Arborescences | UploadFolder, DownloadFolder | Copie un dossier entier de façon récursive. |
| Dates des fichiers | PreserveTimes | Conserve les dates de modification et d'accès de l'autre côté. |
| Progression | OnSCPProgress | Indique le nom du fichier et les octets transférés. |
TsgcSSHServer accepte tout client SSH standard, y compris les outils en ligne de commande standard ssh, sftp et scp.
| Capacité | API | Notes |
|---|---|---|
| Écoute | Port, Active | Démarre et arrête le serveur. |
| Clés d'hôte | HostKeyFiles, GenerateHostKeyEd25519 | Clés d'hôte Ed25519, ECDSA et RSA. La procédure de classe crée pour toi un fichier de clé Ed25519. |
| Authentification par mot de passe | OnSSHAuthPassword | Vérifie le nom d'utilisateur et le mot de passe auprès de ton propre magasin d'utilisateurs. |
| Authentification par clé publique | OnSSHAuthPublicKey | Reçoit le type de clé et son empreinte SHA256, pour que tu n'acceptes que les clés que tu connais. |
| Commandes distantes | OnSSHExec, SendChannelData, SendExitStatus, CloseChannel | Répond à une commande, indique son statut de sortie et ferme le canal. |
| Shell interactif | OnSSHShell, OnSSHChannelData | Sers une session de terminal depuis ton propre code. |
| Sous-systèmes | SFTPServer | Les demandes de sous-système telles que sftp sont routées vers un TsgcSFTPServer lié. |
| Événements de connexion | OnSSHConnect, OnSSHDisconnect | Journalise chaque connexion avec l'adresse du pair. |
TsgcSFTPServer se branche sur TsgcSSHServer et sert des fichiers depuis un dossier que les clients ne peuvent pas quitter.
| Capacité | API | Notes |
|---|---|---|
| Protocoles | SFTP, SCP | SFTP v3, plus les transferts scp lorsqu'ils sont activés. |
| Dossier racine | RootFolder | Le dossier que voient les clients. Les chemins en dehors sont refusés. |
| Un dossier par utilisateur | OnSFTPUserRoot | Renvoie la racine de chaque utilisateur, de sorte que chacun ne voit que ses propres fichiers. |
| Mode lecture seule | ReadOnly | Refuse les envois, les suppressions et les renommages. |
| Contrôle par opération | OnSFTPOperation | Se déclenche à chaque ouverture en lecture ou en écriture, suppression, renommage, création et suppression de dossier, changement d'attributs et listage. Mets aAccept à False et le client reçoit une erreur d'autorisation refusée. |
| Gros téléchargements | Contrôle de flux | Les téléchargements utilisent une mémoire constante, quelle que soit la taille du fichier. |
Le client et le serveur proposent d'abord les algorithmes les plus forts et ne se rabattent sur les classiques que lorsque l'autre côté en a besoin.
| Domaine | Algorithmes | Notes |
|---|---|---|
| Échange de clés | mlkem768x25519-sha256 | ML-KEM-768 combiné à X25519, le choix par défaut des dernières versions de SSH. Proposé en premier par le client et par le serveur. |
| Échange de clés classique | curve25519, ECDH, Diffie-Hellman group14 et group16 | Utilisé lorsque l'autre côté ne prend pas en charge l'échange hybride. |
| Chiffrements | AES-GCM, AES-CTR | AES-GCM est accéléré par le matériel à partir de .NET 8. |
| Clés d'hôte et d'utilisateur | Ed25519, ECDSA, RSA | Signatures RSA avec SHA-2, sélectionnées via server-sig-algs. |
| Fichiers de clé | PEM, PKCS#8, OpenSSH (.NET) | Les clés privées chiffrées s'ouvrent avec une phrase secrète. |
| Échange de clés strict | Parade à Terrapin | Ferme l'attaque de troncature de préfixe contre le handshake SSH. |
Les mêmes cinq composants en Delphi et .NET.
| Domaine | Détail |
|---|---|
| Delphi | Delphi 7 à 13, pour VCL, FMX, les applications console et les services. |
| Cibles Delphi | Windows Win32, Windows Win64 et Linux64. |
| .NET | .NET 8, .NET 9, .NET 10 et .NET Standard 2.0, en code entièrement managé et sans OpenSSL. |
| Démos | Demos\27.SSH : client SSH, client SFTP, client SCP, serveur SSH et serveur SFTP. |
| Éditions | Les cinq composants sont aussi livrés dans sgcWebSockets Enterprise, et All-Access inclut tout. En .NET, ils sont livrés dans le package enregistré, pas dans l'édition Community. |
| Licences | Autonome. Le runtime sgcWebSockets Core est inclus, sgcCustomIndy est inclus dans la commande et le code source complet est fourni. |