Todo lo que hace sgcSSH, repartido entre los tres componentes cliente, los dos componentes servidor y los algoritmos que negocian. Las mismas clases existen en Delphi y en .NET, y cada licencia incluye el código fuente completo.
Comandos, shells, reenvío y rekey
Transferencias rápidas, 16 peticiones en vuelo
Archivos y carpetas completas
Autenticación, exec, shell y subsistemas
Una jaula por usuario, modo de solo lectura
Intercambio de claves post-quantum primero
Delphi 7 a 13 y .NET
sgcSSH es autocontenido. Se entrega con el runtime sgcWebSockets Core incluido, y el add-on sgcCustomIndy sobre el que se construyen los componentes Delphi se incluye siempre en el pedido.
También dentro de sgcWebSockets. Los cinco componentes se entregan también dentro de sgcWebSockets Enterprise, y All-Access lo incluye todo. En .NET forman parte del paquete registrado, no de la edición gratuita Community. sgcSSH es el paquete independiente para los equipos que solo necesitan SSH y SFTP.
Tres clientes y dos servidores, registrados en la página de paleta SGC SSH.
| Componente | Clase | Función | Descripción |
|---|---|---|---|
| Cliente SSH | TsgcSSHClient | Ejecutar comandos | Comandos remotos, una shell interactiva con pty, reenvío de puertos local y remoto, y rekey de sesiones de larga duración. |
| Cliente SFTP | TsgcSFTPClient | Transferir archivos | Operaciones de gestor de archivos SFTP v3 con 16 peticiones en vuelo, de modo que una transferencia de 100 MB tarda cerca de un segundo en una red local. |
| Cliente SCP | TsgcSCPClient | Copiar archivos y carpetas | Sube y descarga archivos sueltos o árboles de carpetas completos con scp, conservando opcionalmente las fechas de los archivos. |
| Servidor SSH | TsgcSSHServer | Aceptar clientes SSH | Autenticación por contraseña y por clave pública, peticiones exec, shell y de subsistema, con claves de host Ed25519, ECDSA y RSA. |
| Servidor SFTP | TsgcSFTPServer | Servir una carpeta | SFTP v3 y SCP desde una carpeta raíz, con una jaula por usuario, un modo de solo lectura y un evento para permitir o denegar cada operación. |
TsgcSSHClient abre una conexión SSH autenticada y ejecuta en ella tantos canales como necesites.
| Capacidad | API | Notas |
|---|---|---|
| Conexión | Host, Port, Connect, Disconnect | Puerto 22 por defecto. |
| Autenticación por contraseña | Authentication.Username, Authentication.Password | Inicio de sesión simple con nombre de usuario y contraseña. |
| Autenticación por clave pública | Authentication.PrivateKeyFile, Authentication.Passphrase | Claves privadas Ed25519, ECDSA y RSA en archivos PEM o PKCS#8, y también en el formato OpenSSH en .NET. |
| Comprobación de la clave del host | OnSSHHostKey | Recibe el tipo de clave y su huella, para que los compares con tu almacén de hosts conocidos y rechaces una clave desconocida o cambiada. |
| Comando remoto | Execute | Abre un canal, ejecuta el comando y devuelve su salida como una cadena, con un tiempo límite. |
| Shell interactiva | OpenChannel, RequestPTY, RequestShell | Una sesión de terminal con el tipo y el tamaño de terminal que elijas. |
| Entrada y salida de la shell | SendChannelData, OnSSHChannelData | Envía lo que escribe el usuario, recibe lo que imprime el servidor. |
| Control del terminal | SendWindowChange, SendSignal, SendEOF | Cambia el tamaño del terminal, envía una señal o termina la entrada de un canal. |
| Canales exec y de subsistema | RequestExec, RequestSubsystem | Peticiones de canal de bajo nivel para protocolos propios sobre SSH. |
| Reenvío de puertos local | OpenDirectTCPIP | Abre un canal direct-tcpip a un host y puerto accesibles desde el servidor. |
| Reenvío de puertos remoto | RequestForwarding, CancelForwarding | Pide al servidor que escuche en un puerto y reenvíe sus conexiones de vuelta al cliente. |
| Rekey | Rekey | Renueva las claves de sesión de una conexión de larga duración. |
| Intercambio de claves post-quantum | PostQuantumKex | Activado por defecto: ofrece mlkem768x25519-sha256 en primer lugar. |
TsgcSFTPClient implementa SFTP v3 sobre el mismo transporte SSH, con las mismas opciones de autenticación e intercambio de claves que el cliente SSH.
| Capacidad | API | Notas |
|---|---|---|
| Carpeta de inicio | RealPath | Resuelve una ruta como . a la ruta absoluta en el servidor. |
| Listado de carpeta | ListDirectory | Nombre, tamaño, fecha de modificación e indicador de carpeta de cada entrada. |
| Subida y descarga | Put, Get | Una llamada por archivo, con 16 peticiones en vuelo. Una transferencia de 100 MB tarda cerca de un segundo en una red local. |
| Gestión de archivos | Rename, Delete, MakeDirectory, RemoveDirectory | Todo lo que necesita un gestor de archivos. |
| Progreso | OnSFTPProgress | Informa de los bytes transferidos, listo para una barra de progreso. |
TsgcSCPClient copia archivos por SSH a cualquier servidor que permita el comando scp.
| Capacidad | API | Notas |
|---|---|---|
| Archivos sueltos | Upload, Download | Copia un archivo hacia o desde la ruta remota. |
| Árboles de carpetas | UploadFolder, DownloadFolder | Copia una carpeta completa de forma recursiva. |
| Fechas de archivo | PreserveTimes | Conserva las fechas de modificación y de acceso en el otro lado. |
| Progreso | OnSCPProgress | Informa del nombre del archivo y de los bytes transferidos. |
TsgcSSHServer acepta cualquier cliente SSH estándar, incluidas las herramientas de línea de comandos estándar ssh, sftp y scp.
| Capacidad | API | Notas |
|---|---|---|
| Escucha | Port, Active | Inicia y detiene el servidor. |
| Claves de host | HostKeyFiles, GenerateHostKeyEd25519 | Claves de host Ed25519, ECDSA y RSA. El procedimiento de clase crea por ti un archivo de clave Ed25519. |
| Autenticación por contraseña | OnSSHAuthPassword | Comprueba el nombre de usuario y la contraseña con tu propio almacén de usuarios. |
| Autenticación por clave pública | OnSSHAuthPublicKey | Recibe el tipo de clave y su huella SHA256, para que aceptes solo las claves que conoces. |
| Comandos remotos | OnSSHExec, SendChannelData, SendExitStatus, CloseChannel | Responde a un comando, informa de su estado de salida y cierra el canal. |
| Shell interactiva | OnSSHShell, OnSSHChannelData | Atiende una sesión de terminal desde tu propio código. |
| Subsistemas | SFTPServer | Las peticiones de subsistema como sftp se dirigen a un TsgcSFTPServer enlazado. |
| Eventos de conexión | OnSSHConnect, OnSSHDisconnect | Registra cada conexión con la dirección del par. |
TsgcSFTPServer se enchufa en TsgcSSHServer y sirve archivos desde una carpeta de la que los clientes no pueden salir.
| Capacidad | API | Notas |
|---|---|---|
| Protocolos | SFTP, SCP | SFTP v3, más transferencias scp cuando está activado. |
| Carpeta raíz | RootFolder | La carpeta que ven los clientes. Se rechazan las rutas fuera de ella. |
| Una carpeta por usuario | OnSFTPUserRoot | Devuelve la raíz de cada usuario, de modo que cada uno ve solo sus propios archivos. |
| Modo de solo lectura | ReadOnly | Rechaza subidas, borrados y renombrados. |
| Control por operación | OnSFTPOperation | Se dispara en cada apertura para lectura o escritura, borrado, renombrado, creación y eliminación de carpetas, cambio de atributos y listado. Pon aAccept a False y el cliente recibe un error de permiso denegado. |
| Descargas grandes | Control de flujo | Las descargas usan memoria constante, sea cual sea el tamaño del archivo. |
Cliente y servidor ofrecen primero los algoritmos más fuertes y recurren a los clásicos solo cuando el otro lado los necesita.
| Área | Algoritmos | Notas |
|---|---|---|
| Intercambio de claves | mlkem768x25519-sha256 | ML-KEM-768 combinado con X25519, el valor por defecto de las últimas versiones de SSH. Lo ofrecen en primer lugar el cliente y el servidor. |
| Intercambio de claves clásico | curve25519, ECDH, Diffie-Hellman group14 y group16 | Se usa cuando el otro lado no admite el intercambio híbrido. |
| Cifrados | AES-GCM, AES-CTR | AES-GCM tiene aceleración por hardware en .NET 8 y posteriores. |
| Claves de host y de usuario | Ed25519, ECDSA, RSA | Firmas RSA con SHA-2, seleccionadas mediante server-sig-algs. |
| Archivos de clave | PEM, PKCS#8, OpenSSH (.NET) | Las claves privadas cifradas se abren con una frase de contraseña. |
| Intercambio de claves estricto | Mitigación de Terrapin | Cierra el ataque de truncamiento de prefijo contra el handshake SSH. |
Los mismos cinco componentes en Delphi y .NET.
| Área | Detalle |
|---|---|
| Delphi | Delphi 7 a 13, para VCL, FMX, aplicaciones de consola y servicios. |
| Destinos de Delphi | Windows Win32, Windows Win64 y Linux64. |
| .NET | .NET 8, .NET 9, .NET 10 y .NET Standard 2.0, en código totalmente gestionado y sin OpenSSL. |
| Demos | Demos\27.SSH: cliente SSH, cliente SFTP, cliente SCP, servidor SSH y servidor SFTP. |
| Ediciones | Los cinco componentes se entregan también dentro de sgcWebSockets Enterprise, y All-Access lo incluye todo. En .NET se entregan en el paquete registrado, no en la edición Community. |
| Licencias | Independiente. El runtime sgcWebSockets Core viene incluido, sgcCustomIndy se incluye en el pedido y el código fuente completo está incluido. |