SFTP Activities

Versión: 1.0.0  ·  ID: zoan-packages-sftp  ·  Autor: Zoan Software

El paquete SFTP transfiere archivos de forma segura con un servidor remoto mediante el protocolo SFTP (SSH File Transfer Protocol). Es muy usado en integraciones entre empresas: subir archivos a un servidor (un lote de facturas para un proveedor), descargar archivos que dejan ahí (reportes de un banco), o gestionar carpetas remotas.

Concepto 1: la sesión

Todas las operaciones trabajan sobre una sesión que abres con SFTP Connect y compartes con las demás actividades:

• Con body: las actividades dentro heredan la sesión; al terminar la conexión se cierra sola.
• Sin body: guardas la sesión en una variable y la cierras con SFTP Close.

SFTP Connect   host = "sftp.proveedor.com"   username = "zoan"   password = = credential("sftp")
 └─ body:
      SFTP Upload   localPath = = rutaLocal   remotePath = "/entrada/factura.xml"

Concepto 2: autenticación

SFTP admite dos formas de autenticarse (elige una en SFTP Connect):

Método	Cómo
Contraseña	Parámetro password con una credencial — = credential("sftp").
Clave privada	Parámetro privateKeyPath con la ruta a tu clave (.pem / OpenSSH), y privateKeyPassphrase si está cifrada.

No escribas la contraseña en texto plano

Usa una credencial de Nexus para la contraseña o la frase de la clave. Ver Seguridad.

Rutas remotas

Las rutas del servidor usan barras / y suelen ser absolutas: /entrada/datos.csv, /salida/reportes/. No las confundas con las rutas locales (de tu máquina), que van en localPath.

Actividades

Sesión

Actividad	Tipo	Salida	Qué hace
SFTP Connect	sftp-connect	ZoanSftpSession	Conecta al servidor SFTP
SFTP Close	sftp-close	—	Cierra la conexión

Transferir

Actividad	Tipo	Salida	Qué hace
SFTP Upload	sftp-upload	—	Sube un archivo local al servidor
SFTP Download	sftp-download	string	Descarga un archivo del servidor

Gestionar archivos y carpetas

Actividad	Tipo	Salida	Qué hace
SFTP List Directory	sftp-list	List	Lista archivos y carpetas remotas
SFTP Exists	sftp-exists	boolean	¿Existe un archivo/carpeta?
SFTP Move / Rename	sftp-move	—	Mueve o renombra un archivo remoto
SFTP Delete	sftp-delete	—	Elimina un archivo remoto
SFTP Create Directory	sftp-mkdir	—	Crea una carpeta remota

Siguientes pasos

• SFTP Connect — conectarse al servidor.
• SFTP Download / SFTP Upload — transferir archivos.
• Files — gestionar los archivos locales.