connect
Se conecta a un servidor SSH con soporte SFTP. Puede usar objetos de conexión SFTP para otras funciones SFTP en pasos posteriores. Consulte también /system/sftp.
Puede que la función /system/sftp/connect devuelva una conexión SFTP sin conectar si el parámetro Anular en caso de error es false. También es posible que se pierda la conexión SFTP durante la ejecución de un trabajo. En ambos casos no se podrán ejecutar los pasos posteriores.
Parámetros
Nombre | Tipo | Descripción |
|---|---|---|
Host | string | Parámetro obligatorio. Dirección del servidor SFTP remoto, como URL o como IP. |
Puerto | number | Parámetro opcional. Número de puerto utilizado para conectarse al servidor SFTP. Valor predeterminado: 22. |
Credenciales de acceso. | credential | Parámetro opcional. Use el nombre de usuario y la contraseñan de su cuenta SFTP o seleccione un registro de credenciales con nombre de usuario y contraseña o con nombre de usuario y clave SSH. Para más información consulte el apartado Credenciales.
Omita este parámetro si no necesita credenciales para el servidor SFTP. |
Anular en caso de error | boolean | Parámetro opcional. Este parámetro determina el resultado de un trabajo si ocurre un error. Si el parámetro de Anular en caso de error es true, la ejecución del trabajo se anula. Si el parámetro es false, FlowForce Server ignora los errores y sigue ejecutando el trabajo. El valor predeterminado es true. |
Registro | string | Parámetro opcional. Este parámetro permite diagnosticar problemas SSH. Puede definir el parámetro Registro como predeterminado (información general), modo detallado o depurador. También puede dejar el parámetro vacío, en cuyo caso no se registra nada. Para más información siga leyendo. |
Métodos de intercambio de claves y algoritmos de clave de host
Los métodos de intercambio de claves se utilizan para intercambiar de forma segura claves criptográficas entre las partes a través de un canal de comunicación. Los métodos de intercambio de claves garantizan que, si se produce un fallo en el canal de comunicación, las claves intercambiadas no puedan descifrarse. Estos son los métodos de intercambio de claves admitidos por la función SFTP connect:
ecdh-sha2-nistp256, ecdh-sha2-nistp384, ecdh-sha2-nistp521, diffie-hellman-group-exchange-sha256, diffie-hellman-group16-sha512, diffie-hellman-group18-sha512, diffie-hellman-group14-sha256, diffie-hellman-group14-sha1, diffie-hellman-group1-sha1, diffie-hellman-group-exchange-sha1, ecdh-sha2-nistp256, ecdh-sha2-nistp384, ecdh-sha2-nistp521
Los algoritmos de clave de host se utilizan para establecer la autenticidad e integridad de las claves de host en protocolos de comunicación seguros (como SSH y TLS). A continuación puede ver una lista de los algoritmos de clave de host admitidos:
ecdsa-sha2-nistp256, ecdsa-sha2-nistp384, ecdsa-sha2-nistp521, ssh-ed25519, ssh-rsa,ssh-dss, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384, ecdsa-sha2-nistp521, ssh-ed25519
Registro SFTP
El parámetro Registro sirve para diagnosticar problemas SSH. Los niveles de registro pueden ser predeterminado (información general), modo detallado y depuración. Esta es la sintaxis del parámetro:
( settings “;” )? filename
El archivo debe crearse de forma que la cuenta del usuario tenga derechos de escritura sobre él. Si ya existe un archivo, se sobreescribirá. Puede usar, por ejemplo, {instance-id()} en el nombre del archivo para que este sea único. Si no se puede crear el archivo fallará el paso de la conexión.
Configuración del nivel de registro
A continuación se enumeran todas las opciones posibles.
•Sin registro: Si el parámetro Registro es una cadena vacía (campo de texto vacío) no se guarda ningún registro.
•Registro de nivel predeterminado: Si el parámetro es un nombre de archivo, el registro de nivel predeterminado se escribe en ese archivo. El nombre del archivo debe ser una ruta de acceso absoluta (p.ej., C:\temp\logfile.txt).
•Registro en modo detallado o en modo depuración Sólo necesitará usar punto y coma en la sintaxis si necesita una configuración más detallada. Por ejemplo, para que el nivel del registro sea depuración debe escribir este valor de parámetro en el campo de texto Registro:
debug;c:\temp\mylogfile.txt
Configuración global e individual
Puede configurar los niveles de registro de forma global para SFTP y SSH o de forma individual para cada uno de ellos. Para configurar SSH y SFTP por separado el nivel de registro debe llevar el prefijo ssh= o sftp=, según corresponda. Use punto y coma para separar las distintas opciones. A continuación puede ver un valor de parámetro de muestra que sirve para configurar el registro en modo depuración para SSH y en modo predeterminado para SFTP.
ssh=debug,sftp=default;c:\temp\mylogfile.txt
Registro de nivel predeterminado
Este es el aspecto del registro de un intento de conexión en modo predeterminado:
[SSH:info ] SSH Line 2.0 OpenSSH_7.9p1 Debian-10+deb10u2
[SFTP:info ] Connection established
[SFTP:info ] Closing SFTP connection
[SFTP:info ] SFTP read operation failed, status=broken pipe detail=0
Registro en modo detallado
Para configurar el nivel del registro como detallado debe escribir este valor de parámetro en el campo de texto Registro: A continuación puede ver un ejemplo de un registro en modo detallado:
[SSH:verbose] sending data
[SSH:verbose] Data received 112
[SSH:verbose] Received request result for channel 0
[SFTP:verbose] SFTP connection established
[SSH:verbose] sending data
[SSH:verbose] Data received 208
[SFTP:verbose] Received SFTP version 3 response
[SFTP:info ] Connection established
[SSH:verbose] sending data
[SFTP:info ] Closing SFTP connection
[SFTP:verbose] Closing SFTP channel
[SSH:verbose] sending data
[SSH:verbose] sending data
[SFTP:info ] SFTP read operation failed, status=broken pipe detail=0
[SSH:verbose] Connected closed
[SSH:verbose] Data received 0
El registro en modo depuración muestra más información detallada sobre todas las operaciones.