|
| 1 | +--- |
| 2 | +title: SFTP |
| 3 | +description: Transferir archivos a través de SFTP (Protocolo de transferencia de |
| 4 | + archivos SSH) |
| 5 | +--- |
| 6 | + |
| 7 | +import { BlockInfoCard } from "@/components/ui/block-info-card" |
| 8 | + |
| 9 | +<BlockInfoCard |
| 10 | + type="sftp" |
| 11 | + color="#2D3748" |
| 12 | +/> |
| 13 | + |
| 14 | +{/* MANUAL-CONTENT-START:intro */} |
| 15 | +[SFTP (Protocolo de transferencia de archivos SSH)](https://en.wikipedia.org/wiki/SSH_File_Transfer_Protocol) es un protocolo de red seguro que te permite subir, descargar y gestionar archivos en servidores remotos. SFTP opera sobre SSH, lo que lo hace ideal para transferencias de archivos automatizadas y cifradas, así como para la gestión remota de archivos dentro de flujos de trabajo modernos. |
| 16 | + |
| 17 | +Con las herramientas SFTP integradas en Sim, puedes automatizar fácilmente el movimiento de archivos entre tus agentes de IA y sistemas o servidores externos. Esto permite a tus agentes gestionar intercambios críticos de datos, copias de seguridad, generación de documentos y orquestación de sistemas remotos, todo con una seguridad robusta. |
| 18 | + |
| 19 | +**Funcionalidades clave disponibles a través de las herramientas SFTP:** |
| 20 | + |
| 21 | +- **Subir archivos:** Transfiere sin problemas archivos de cualquier tipo desde tu flujo de trabajo a un servidor remoto, con soporte tanto para autenticación por contraseña como por clave privada SSH. |
| 22 | +- **Descargar archivos:** Recupera archivos de servidores SFTP remotos directamente para su procesamiento, archivo o automatización adicional. |
| 23 | +- **Listar y gestionar archivos:** Enumera directorios, elimina o crea archivos y carpetas, y gestiona permisos del sistema de archivos de forma remota. |
| 24 | +- **Autenticación flexible:** Conéctate usando contraseñas tradicionales o claves SSH, con soporte para frases de contraseña y control de permisos. |
| 25 | +- **Soporte para archivos grandes:** Gestiona programáticamente cargas y descargas de archivos grandes, con límites de tamaño incorporados para mayor seguridad. |
| 26 | + |
| 27 | +Al integrar SFTP en Sim, puedes automatizar operaciones seguras de archivos como parte de cualquier flujo de trabajo, ya sea recopilación de datos, informes, mantenimiento de sistemas remotos o intercambio dinámico de contenido entre plataformas. |
| 28 | + |
| 29 | +Las secciones a continuación describen las principales herramientas SFTP disponibles: |
| 30 | + |
| 31 | +- **sftp_upload:** Sube uno o más archivos a un servidor remoto. |
| 32 | +- **sftp_download:** Descarga archivos desde un servidor remoto a tu flujo de trabajo. |
| 33 | +- **sftp_list:** Lista el contenido de directorios en un servidor SFTP remoto. |
| 34 | +- **sftp_delete:** Elimina archivos o directorios de un servidor remoto. |
| 35 | +- **sftp_create:** Crea nuevos archivos en un servidor SFTP remoto. |
| 36 | +- **sftp_mkdir:** Crea nuevos directorios de forma remota. |
| 37 | + |
| 38 | +Consulta la documentación de la herramienta a continuación para conocer los parámetros detallados de entrada y salida para cada operación. |
| 39 | +{/* MANUAL-CONTENT-END */} |
| 40 | + |
| 41 | +## Instrucciones de uso |
| 42 | + |
| 43 | +Sube, descarga, lista y gestiona archivos en servidores remotos a través de SFTP. Compatible con autenticación por contraseña y clave privada para transferencias seguras de archivos. |
| 44 | + |
| 45 | +## Herramientas |
| 46 | + |
| 47 | +### `sftp_upload` |
| 48 | + |
| 49 | +Subir archivos a un servidor SFTP remoto |
| 50 | + |
| 51 | +#### Entrada |
| 52 | + |
| 53 | +| Parámetro | Tipo | Obligatorio | Descripción | |
| 54 | +| --------- | ---- | ----------- | ----------- | |
| 55 | +| `host` | string | Sí | Nombre de host o dirección IP del servidor SFTP | |
| 56 | +| `port` | number | Sí | Puerto del servidor SFTP \(predeterminado: 22\) | |
| 57 | +| `username` | string | Sí | Nombre de usuario SFTP | |
| 58 | +| `password` | string | No | Contraseña para autenticación \(si no se usa clave privada\) | |
| 59 | +| `privateKey` | string | No | Clave privada para autenticación \(formato OpenSSH\) | |
| 60 | +| `passphrase` | string | No | Frase de contraseña para clave privada cifrada | |
| 61 | +| `remotePath` | string | Sí | Directorio de destino en el servidor remoto | |
| 62 | +| `files` | file[] | No | Archivos para subir | |
| 63 | +| `fileContent` | string | No | Contenido directo del archivo para subir \(para archivos de texto\) | |
| 64 | +| `fileName` | string | No | Nombre del archivo cuando se usa contenido directo | |
| 65 | +| `overwrite` | boolean | No | Si se deben sobrescribir archivos existentes \(predeterminado: true\) | |
| 66 | +| `permissions` | string | No | Permisos del archivo \(p. ej., 0644\) | |
| 67 | + |
| 68 | +#### Salida |
| 69 | + |
| 70 | +| Parámetro | Tipo | Descripción | |
| 71 | +| --------- | ---- | ----------- | |
| 72 | +| `success` | boolean | Si la subida fue exitosa | |
| 73 | +| `uploadedFiles` | json | Array de detalles de archivos subidos \(nombre, rutaRemota, tamaño\) | |
| 74 | +| `message` | string | Mensaje de estado de la operación | |
| 75 | + |
| 76 | +### `sftp_download` |
| 77 | + |
| 78 | +Descargar un archivo desde un servidor SFTP remoto |
| 79 | + |
| 80 | +#### Entrada |
| 81 | + |
| 82 | +| Parámetro | Tipo | Obligatorio | Descripción | |
| 83 | +| --------- | ---- | -------- | ----------- | |
| 84 | +| `host` | string | Sí | Nombre de host o dirección IP del servidor SFTP | |
| 85 | +| `port` | number | Sí | Puerto del servidor SFTP \(predeterminado: 22\) | |
| 86 | +| `username` | string | Sí | Nombre de usuario SFTP | |
| 87 | +| `password` | string | No | Contraseña para autenticación \(si no se usa clave privada\) | |
| 88 | +| `privateKey` | string | No | Clave privada para autenticación \(formato OpenSSH\) | |
| 89 | +| `passphrase` | string | No | Frase de contraseña para clave privada cifrada | |
| 90 | +| `remotePath` | string | Sí | Ruta al archivo en el servidor remoto | |
| 91 | +| `encoding` | string | No | Codificación de salida: utf-8 para texto, base64 para binario \(predeterminado: utf-8\) | |
| 92 | + |
| 93 | +#### Salida |
| 94 | + |
| 95 | +| Parámetro | Tipo | Descripción | |
| 96 | +| --------- | ---- | ----------- | |
| 97 | +| `success` | boolean | Si la descarga fue exitosa | |
| 98 | +| `fileName` | string | Nombre del archivo descargado | |
| 99 | +| `content` | string | Contenido del archivo \(texto o codificado en base64\) | |
| 100 | +| `size` | number | Tamaño del archivo en bytes | |
| 101 | +| `encoding` | string | Codificación del contenido \(utf-8 o base64\) | |
| 102 | +| `message` | string | Mensaje de estado de la operación | |
| 103 | + |
| 104 | +### `sftp_list` |
| 105 | + |
| 106 | +Listar archivos y directorios en un servidor SFTP remoto |
| 107 | + |
| 108 | +#### Entrada |
| 109 | + |
| 110 | +| Parámetro | Tipo | Obligatorio | Descripción | |
| 111 | +| --------- | ---- | -------- | ----------- | |
| 112 | +| `host` | string | Sí | Nombre de host o dirección IP del servidor SFTP | |
| 113 | +| `port` | number | Sí | Puerto del servidor SFTP \(predeterminado: 22\) | |
| 114 | +| `username` | string | Sí | Nombre de usuario SFTP | |
| 115 | +| `password` | string | No | Contraseña para autenticación \(si no se usa clave privada\) | |
| 116 | +| `privateKey` | string | No | Clave privada para autenticación \(formato OpenSSH\) | |
| 117 | +| `passphrase` | string | No | Frase de contraseña para clave privada cifrada | |
| 118 | +| `remotePath` | string | Sí | Ruta del directorio en el servidor remoto | |
| 119 | +| `detailed` | boolean | No | Incluir información detallada de archivos \(tamaño, permisos, fecha de modificación\) | |
| 120 | + |
| 121 | +#### Salida |
| 122 | + |
| 123 | +| Parámetro | Tipo | Descripción | |
| 124 | +| --------- | ---- | ----------- | |
| 125 | +| `success` | boolean | Si la operación fue exitosa | |
| 126 | +| `path` | string | Ruta del directorio que fue listado | |
| 127 | +| `entries` | json | Array de entradas del directorio con nombre, tipo, tamaño, permisos, modifiedAt | |
| 128 | +| `count` | number | Número de entradas en el directorio | |
| 129 | +| `message` | string | Mensaje de estado de la operación | |
| 130 | + |
| 131 | +### `sftp_delete` |
| 132 | + |
| 133 | +Eliminar un archivo o directorio en un servidor SFTP remoto |
| 134 | + |
| 135 | +#### Entrada |
| 136 | + |
| 137 | +| Parámetro | Tipo | Requerido | Descripción | |
| 138 | +| --------- | ---- | -------- | ----------- | |
| 139 | +| `host` | string | Sí | Nombre de host o dirección IP del servidor SFTP | |
| 140 | +| `port` | number | Sí | Puerto del servidor SFTP \(predeterminado: 22\) | |
| 141 | +| `username` | string | Sí | Nombre de usuario SFTP | |
| 142 | +| `password` | string | No | Contraseña para autenticación \(si no se usa clave privada\) | |
| 143 | +| `privateKey` | string | No | Clave privada para autenticación \(formato OpenSSH\) | |
| 144 | +| `passphrase` | string | No | Frase de contraseña para clave privada cifrada | |
| 145 | +| `remotePath` | string | Sí | Ruta al archivo o directorio a eliminar | |
| 146 | +| `recursive` | boolean | No | Eliminar directorios recursivamente | |
| 147 | + |
| 148 | +#### Salida |
| 149 | + |
| 150 | +| Parámetro | Tipo | Descripción | |
| 151 | +| --------- | ---- | ----------- | |
| 152 | +| `success` | boolean | Si la eliminación fue exitosa | |
| 153 | +| `deletedPath` | string | Ruta que fue eliminada | |
| 154 | +| `message` | string | Mensaje de estado de la operación | |
| 155 | + |
| 156 | +### `sftp_mkdir` |
| 157 | + |
| 158 | +Crear un directorio en un servidor SFTP remoto |
| 159 | + |
| 160 | +#### Entrada |
| 161 | + |
| 162 | +| Parámetro | Tipo | Obligatorio | Descripción | |
| 163 | +| --------- | ---- | ----------- | ----------- | |
| 164 | +| `host` | string | Sí | Nombre de host o dirección IP del servidor SFTP | |
| 165 | +| `port` | number | Sí | Puerto del servidor SFTP \(predeterminado: 22\) | |
| 166 | +| `username` | string | Sí | Nombre de usuario SFTP | |
| 167 | +| `password` | string | No | Contraseña para autenticación \(si no se usa clave privada\) | |
| 168 | +| `privateKey` | string | No | Clave privada para autenticación \(formato OpenSSH\) | |
| 169 | +| `passphrase` | string | No | Frase de contraseña para clave privada cifrada | |
| 170 | +| `remotePath` | string | Sí | Ruta para el nuevo directorio | |
| 171 | +| `recursive` | boolean | No | Crear directorios principales si no existen | |
| 172 | + |
| 173 | +#### Salida |
| 174 | + |
| 175 | +| Parámetro | Tipo | Descripción | |
| 176 | +| --------- | ---- | ----------- | |
| 177 | +| `success` | boolean | Si el directorio se creó correctamente | |
| 178 | +| `createdPath` | string | Ruta del directorio creado | |
| 179 | +| `message` | string | Mensaje de estado de la operación | |
| 180 | + |
| 181 | +## Notas |
| 182 | + |
| 183 | +- Categoría: `tools` |
| 184 | +- Tipo: `sftp` |
0 commit comments