SFTP: SSH

Este conector está disponible en los siguientes productos y regiones:

Service	Class	Regions
Copilot Studio	Estándar	Todas las regiones de Power Automate excepto las siguientes:      - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas	Estándar	Todas las regiones de Logic Apps
Power Apps	Estándar	Todas las regiones de Power Apps excepto las siguientes:      - Departamento de Defensa de EE. UU. (DoD)
Power Automate	Estándar	Todas las regiones de Power Automate excepto las siguientes:      - Departamento de Defensa de EE. UU. (DoD)

Contacto
Nombre	Microsoft
URL	Compatibilidad con Microsoft LogicApps Soporte técnico de Microsoft Power Automate Soporte técnico de Microsoft Power Apps

Metadatos del conector
Publicador	Microsoft

Guía paso a paso del conector

En este artículo se describen las operaciones del conector administrado SFTP-SSH, que está disponible para Azure Logic Apps, Power Automate y Power Apps. El conector integrado SFTP solo está disponible para flujos de trabajo de aplicaciones lógicas estándar en Azure Logic Apps. Para más información, consulte Conexión a un servidor SFTP mediante SSH en Azure Logic Apps y referencia del conector integrado SFTP para Azure Logic Apps.

Diferencias con respecto al conector administrado SFTP en desuso

En comparación con el conector administrado SFTP en desuso, el conector administrado SFTP-SSH proporciona las siguientes funcionalidades clave:

• Usa la biblioteca de SSH.NET, que es una biblioteca de Secure Shell (SSH) de código abierto que admite .NET.

• Proporciona la acción Crear carpeta , que crea una carpeta en la ruta de acceso especificada en el servidor SFTP.

• Proporciona la acción Cambiar nombre de archivo , que cambia el nombre de un archivo en el servidor SFTP.

• Almacena en caché la conexión al servidor SFTP durante un máximo de 1 hora. Esta funcionalidad mejora el rendimiento y reduce la frecuencia con la que el conector intenta conectarse al servidor. Para establecer la duración de este comportamiento de almacenamiento en caché, edite la propiedad ClientAliveInterval en la configuración de SSH en el servidor SFTP.

Autenticación y permisos

• Al crear una conexión con el servidor SFTP, debe proporcionar la dirección del servidor SFTP, las credenciales de la cuenta, una clave privada SSH y la contraseña de la clave privada SSH. Si la plataforma admite la carga de archivos grandes mediante fragmentación, también necesita acceso de lectura y escritura para la carpeta raíz en el servidor SFTP.

• El conector de SFTP-SSH admite la autenticación de clave privada y la autenticación de contraseñas. Sin embargo, el conector de SFTP-SSH solo admite los siguientes formatos de clave privada, algoritmos de intercambio de claves, algoritmos de cifrado y huellas digitales:

  • Formatos de clave privada: claves RSA (Rivest Shamir Adleman) y DSA (algoritmo de firma digital) en formatos OpenSSH y ssh.com. Si la clave privada está en formato de archivo PuTTY (.ppk), convierta primero la clave al formato de archivo OpenSSH (.pem).
  • Algoritmos de intercambio de claves:
    • curve25519-sha256
    • curve25519-sha256@libssh.org
    • ecdh-sha2-nistp256
    • ecdh-sha2-nistp384
    • ecdh-sha2-nistp521
    • diffie-hellman-group-exchange-sha256
    • diffie-hellman-group-exchange-sha1
    • diffie-hellman-group16-sha512
    • diffie-hellman-group14-sha256
    • diffie-hellman-group14-sha1
    • diffie-hellman-group1-sha1
  • Algoritmos de cifrado:
    • aes256-ctr
    • 3des-cbc
    • aes128-cbc
    • aes192-cbc
    • aes256-cbc
    • blowfish-cbc
    • twofish-cbc
    • twofish192-cbc
    • twofish128-cbc
    • twofish256-cbc
    • arcfour
    • arcfour128
    • arcfour256
    • cast128-cbc
    • aes128-ctr
    • aes192-ctr
  • Algoritmos de clave de host:
    • ssh-rsa
    • ssh-dss
    • ssh-ed25519
    • ecdsa-sha2-nistp256
    • ecdsa-sha2-nistp384
    • ecdsa-sha2-nistp521
  • Huella digital: MD5. Para obtener más información, vea Buscar la huella digital MD5.

• Al proporcionar la clave privada SSH para la conexión, no escriba ni edite manualmente la clave, lo que podría provocar un error en la conexión. En su lugar, asegúrese de copiar la clave del archivo de clave privada SSH y pegue esa clave en el cuadro de información de conexión.

  Para copiar y pegar correctamente la clave privada SSH, siga estos pasos.

  1. Abra el archivo de clave privada SSH en cualquier editor de texto. Estos pasos siguen usando el Bloc de notas como ejemplo.

  2. En el Bloc de notas, en el menú Editar , seleccione Seleccionar todo. (Presione Ctrl + A)

  3. En el menú Editar , seleccione Copiar.

  4. En el cuadro SFTP-SSH información de conexión, pegue la clave copiada completa en la propiedad clave privada SSH , que admite varias líneas. No escriba ni edite manualmente la clave.

  5. Después de terminar de escribir los detalles de conexión, seleccione Crear.

Conversión de la clave basada en PuTTY en OpenSSH

El formato PuTTY y el formato OpenSSH usan diferentes extensiones de nombre de archivo. El formato PuTTY usa la extensión de nombre de archivo .ppk o PuTTY Private Key. El formato OpenSSH usa el .pem, o la extensión de nombre de archivo de correo mejorado de privacidad. Si la clave privada está en formato PuTTY y tiene que usar el formato OpenSSH, primero convierta la clave al formato OpenSSH siguiendo estos pasos:

• Sistema operativo basado en Unix

  1. Si no tiene instaladas las herramientas de PuTTY en el sistema, hála ahora, por ejemplo:

     sudo apt-get install -y putty

  2. Ejecute el comando siguiente, que crea un archivo que puede usar con el conector SFTP-SSH:

     puttygen <path-to-private-key-file-in-PuTTY-format> -O private-openssh -o <path-to-private-key-file-in-OpenSSH-format>

     Por ejemplo

     puttygen /tmp/sftp/my-private-key-putty.ppk -O private-openssh -o /tmp/sftp/my-private-key-openssh.pem

• SO Windows

  1. Si aún no lo ha hecho, descargue la herramienta PuTTY Generator (puttygen.exe) más reciente y, a continuación, abra la herramienta.

  2. En la herramienta Generador de claves PuTTY (puttygen.exe), en Acciones, seleccione Cargar.

  3. Vaya al archivo de clave privada en formato PuTTY y seleccione Abrir.

  4. En el menú Conversiones , seleccione Exportar clave OpenSSH.

  5. Guarde el archivo de clave privada con la extensión de nombre de archivo .pem .

Buscar la huella digital MD5

El conector de SFTP-SSH rechaza una conexión si la huella digital del servidor SFTP y la huella digital esperada no coinciden. Para obtener la huella digital MD5, que es una secuencia con 16 pares de dígitos hexadecimales delimitados por dos puntos, pruebe las siguientes opciones.

Tiene la clave

La tecla MD5 es una cadena de 47 caracteres delimitada por dos puntos. Para obtener la huella digital MD5 cuando tenga la clave, puede usar herramientas como ssh-keygen.

Por ejemplo, desde un símbolo del sistema de Bash, escriba el siguiente comando:

ssh-keygen -l -f id_rsa.pub -E md5

No tiene la clave

Para obtener una huella digital MD5 cuando no tenga una clave, puede usar la herramienta de diálogo de información del servidor y el protocolo más reciente de WinSCP, o puede usar la herramienta de configuración de PuTTY en su lugar:

1. En la herramienta de configuración de PuTTY (putty.exe), en la ventana Categoría, expandaClaves de hostSSH>de conexión>.

2. En Preferencia de algoritmo de clave de host, abra la lista Directiva de selección de algoritmos y compruebe que RSA aparece en la parte superior.

3. Si RSA no aparece en la parte superior, seleccione RSA y, a continuación, seleccione Up until RSA move to the top ( Arriba hasta que RSA se mueva a la parte superior).

4. Conéctese al servidor SFTP con PuTTY. Una vez creada la conexión, cuando aparezca la alerta de seguridad PUTTY, seleccione Más información.

   Nota:

   Si la alerta de seguridad no aparece, intente borrar la entrada SshHostKeys . Abra el editor del Registro de Windows y vaya a la entrada siguiente:

   Computer\HKEY_CURRENT_USER\Software\SimonTatham\PuTTY\SshHostKeys

5. Después de que aparezca el cuadro de clave host del servidor: información sobre el cuadro de clave host del servidor , busque la propiedad de huella digital MD5 y copie el valor de cadena de 47 caracteres, que tiene el siguiente aspecto:

   **:**:**:**:**:**:**:**:**:**:**:**:**:**:**:**

Problemas conocidos y limitaciones con desencadenadores

• Es posible que los desencadenadores del conector administrado sfTP experimenten resultados que faltan, están incompletos o retrasados.

  • Faltan resultados

    Los desencadenadores SFTP funcionan sondeando, o comprobando, el sistema de archivos SFTP y buscando los archivos que cambiaron desde el último sondeo. Los desencadenadores del conector administrado sfTP comparan las versiones de archivo con la marca de tiempo de la última modificación del archivo.

    Si crea, agrega o actualiza un archivo con una marca de tiempo anterior a la marca de tiempo de la última marca de tiempo modificada actualmente, el desencadenador del conector administrado SFTP no detectará este archivo.

    Por lo tanto, si usa una herramienta externa o un cliente que crea, agrega o actualiza archivos en el servidor SFTP, asegúrese de deshabilitar cualquier característica de la herramienta o cliente que conserve la marca de tiempo de última modificación de un archivo.

    En la tabla siguiente se enumeran algunas herramientas usadas habitualmente que conservan esta marca de tiempo y los pasos para deshabilitar esta característica:

    Cliente SFTP	Acción
    WinSCP	Vaya a Opciones>Preferencias>Transferir>editar editar>conservar marca> de tiempoDeshabilitar.
    FileZilla	Vaya a Transferir>marcas de tiempo Conservar marcas de tiempo de los archivos> transferidosDeshabilitar.

  • Resultados incompletos o retrasados

    Cuando un desencadenador SFTP comprueba si hay un archivo recién creado, agregado o actualizado, el desencadenador también comprueba si el archivo está completo. Por ejemplo, un archivo podría tener cambios en curso cuando el desencadenador comprueba el servidor SFTP. Para evitar devolver un archivo incompleto, el desencadenador anota la marca de tiempo del archivo, pero no devuelve inmediatamente el archivo. En su lugar, el desencadenador devuelve el archivo solo cuando el desencadenador vuelve a comprobar el servidor.

    A veces, este comportamiento puede provocar un retraso que dure tanto como casi dos veces el intervalo de sondeo del desencadenador. Debido a este comportamiento, si deshabilita la configuración Split On del desencadenador SFTP, es posible que el desencadenador SFTP no devuelva todos los archivos al mismo tiempo.

Problemas y limitaciones conocidos generales

• Actualmente, el conector administrado SFTP-SSH no admite los siguientes servidores SFTP:

  • Akamai NetStorage
  • Puerta de enlace de FileMage
  • Globalscape
  • IBM DataPower
  • MessageWay
  • OpenText Secure MFT
  • OpenText GXS
  • SFTP para Azure Blob Storage
  • Servidor de transferencia de archivos seguro de VShell
  • AWS SFTP

• Use carpetas SFTP independientes para el procesamiento y la carga de archivos.

  Asegúrese de usar carpetas independientes en el servidor SFTP para el desencadenador para supervisar los archivos para su procesamiento y para almacenar archivos cargados. De lo contrario, el desencadenador no se activará y se comportará de forma impredecible. Por ejemplo, el desencadenador podría omitir un número aleatorio de archivos que necesitan procesamiento.

  Esta limitación significa que necesita una manera de mover archivos entre esas carpetas. Si encuentra este problema, quite los archivos de la carpeta supervisada y use otra carpeta para almacenar los archivos cargados.

• Para administrar la carga en los servicios de conector administrados multiinquilino compartidos, el conector de SFTP-SSH administrado puede crear varias conexiones desde la misma dirección IP de origen, es decir, la dirección IP del conector, al destino, que es el servidor SFTP. Algunas regiones de tráfico bajo solo pueden usar tres instancias de máquina virtual detrás de la dirección IP del conector, lo que significa que esas regiones pueden crear un máximo de tres conexiones. Otras regiones pueden usar hasta 20 conexiones porque tienen el mismo número de máquinas virtuales detrás de la dirección IP del conector.

  Si el servidor SFTP limita el número de conexiones, es posible que el servidor no funcione bien con el conector de SFTP-SSH administrado. Sin embargo, puede crear un flujo de trabajo de aplicación lógica estándar que use las operaciones SFTP integradas en su lugar. Puede controlar los límites de escalado horizontal y, como resultado, el número de conexiones.

• Si encuentra problemas de interoperabilidad del conjunto de cifrado entre el conector administrado SFTP-SSH y el servidor SFTP, intente crear un flujo de trabajo de aplicación lógica estándar y use en su lugar las operaciones integradas de SFTP. Las operaciones integradas de SFTP admiten una gama más amplia de conjuntos de cifrado.

• Este conector puede enviar una solicitud de no-op al back-end.

Chunking

• En Azure Logic Apps y Power Automate, las siguientes acciones del conector de SFTP-SSH administradas admiten la fragmentación, donde una acción puede habilitar el control de archivos grandes en partes más pequeñas. Para más información sobre la fragmentación en Azure Logic Apps, consulte [Control de mensajes grandes mediante fragmentación]](/azure/logic-apps/logic-apps-handle-large-messages).

  Acción	Compatibilidad con la fragmentación	Invalidar la compatibilidad con el tamaño del fragmento
  Copiar archivo	No	No aplicable
  Crear archivo	Sí	Sí
  Crear carpeta	No aplicable	No aplicable
  Eliminar archivo	No aplicable	No aplicable
  Extracción del archivo en la carpeta	No aplicable	No aplicable
  Obtener contenido de archivo	Sí	Sí
  Obtención del contenido del archivo mediante la ruta de acceso	Sí	Sí
  Obtención de metadatos de archivo	No aplicable	No aplicable
  Obtención de metadatos de archivo mediante la ruta de acceso	No aplicable	No aplicable
  Enumerar archivos en la carpeta	No aplicable	No aplicable
  Cambiar nombre de archivo	No aplicable	No aplicable
  Actualizar archivo	No	No aplicable

  SFTP-SSH acciones que admiten fragmentación pueden controlar archivos de hasta 1 GB, mientras que SFTP-SSH acciones que no admiten fragmentación pueden controlar archivos de hasta 50 MB. El tamaño de fragmento predeterminado es de 15 MB. Sin embargo, este tamaño puede cambiar dinámicamente, a partir de 5 MB y aumentando gradualmente al máximo de 50 MB. El ajuste de tamaño dinámico se basa en factores como la latencia de red, el tiempo de respuesta del servidor, etc.

  Puede invalidar este comportamiento adaptable al especificar un tamaño de fragmento constante que se usará en su lugar. Este tamaño puede oscilar entre 5 MB y 50 MB. Por ejemplo, supongamos que tiene un archivo de 45 MB y una red que puede admitir ese tamaño de archivo sin latencia. La fragmentación adaptable da como resultado varias llamadas, en lugar de esa llamada. Para reducir el número de llamadas, puede intentar establecer un tamaño de fragmento de 50 MB. En un escenario diferente, si el flujo de trabajo de la aplicación lógica está agotando el tiempo de espera, por ejemplo, al usar fragmentos de 15 MB, puede intentar reducir el tamaño a 5 MB.

  El tamaño del fragmento está asociado a una conexión. Este atributo significa que puede usar la misma conexión para ambas acciones que admiten fragmentación y acciones que no admiten la fragmentación. En este caso, el tamaño del fragmento de las acciones que admiten la fragmentación oscila entre 5 MB y 50 MB.

  Para invalidar el comportamiento adaptable predeterminado que usa la fragmentación en una acción de SFTP-SSH, puede especificar un tamaño de fragmento constante de 5 MB a 50 MB.

  1. En el diseñador, en la esquina superior derecha de la acción SFTP-SSH, seleccione el botón de puntos suspensivos (...) y, a continuación, seleccione Configuración.

  2. En Transferencia de contenido, en la propiedad Tamaño de fragmento , escriba un valor entero de 5 a 50.

  3. Después de finalizar, seleccione Listo.

• SFTP-SSH desencadenadores no admiten la fragmentación de mensajes. Cuando desencadena el contenido del archivo de solicitud, seleccionan solo los archivos de 15 MB o más pequeños. Para obtener archivos de más de 15 MB, siga este patrón en su lugar:

  1. Use un desencadenador SFTP-SSH que devuelva solo las propiedades del archivo. Estos desencadenadores tienen nombres que incluyen la descripción (solo propiedades).

  2. Siga el desencadenador con la acción Obtener contenido del archivo SFTP-SSH. Esta acción lee el archivo completo y usa implícitamente la fragmentación de mensajes.

Solución de problemas

Error 401: "401 No autorizado"

Este error puede producirse porque no tiene las credenciales o permisos correctos. Para obtener más información, consulte Autenticación y permisos.

Error 404: "Se realizó una referencia a un archivo o carpeta que no existe"

Este error puede producirse al usar la acción Crear archivo . Cuando la acción crea un archivo en el servidor SFTP, la acción también envía automáticamente una llamada al servidor SFTP para obtener los metadatos del archivo.

Si mueve inmediatamente el archivo recién creado antes de que la llamada pueda obtener los metadatos, el archivo ya no existe en la ubicación esperada y recibe un mensaje de error 404, se realizó una referencia a un archivo o carpeta que no existe.

Si no puede evitar ni retrasar el movimiento del archivo, puede omitir la lectura de los metadatos del archivo después de la creación del archivo siguiendo estos pasos:

1. En la acción Crear archivo , abra la lista Agregar nuevo parámetro , seleccione la propiedad Obtener todos los metadatos del archivo y establezca el valor en No.

2. Si necesita estos metadatos de archivo más adelante, puede usar la acción Obtener metadatos de archivo .

Error 504: "Error en un intento de conexión porque la entidad conectada no respondió correctamente después de un período de tiempo o error de conexión establecida porque el host conectado no ha respondido" o "La solicitud al servidor SFTP ha tardado más de '00:00:30' segundos"

Este error puede producirse cuando no se puede establecer correctamente una conexión con el servidor SFTP. Puede haber diferentes motivos para este problema, por lo que pruebe estas opciones de solución de problemas:

• El tiempo de espera de conexión es de 20 segundos. Compruebe que el servidor SFTP tiene un buen rendimiento y dispositivos intermedios, como firewalls, no agregan sobrecarga.

• Compruebe si el servidor SFTP pone un límite en el número de conexiones de cada dirección IP. Cualquier límite de este tipo dificulta la comunicación entre el conector y el servidor SFTP. Asegúrese de quitar este límite.

• Si tiene un firewall configurado, asegúrese de agregar las direcciones IP del conector administrado para su región a la lista aprobada.

• Si el error se produce de forma intermitente, cambie la configuración de directiva de reintento en la acción SFTP-SSH a un recuento de reintentos superior al predeterminado de cuatro reintentos.

• Para reducir el costo del establecimiento de conexiones, en la configuración ssh del servidor SFTP, aumente la propiedad ClientAliveInterval a aproximadamente una hora.

• Revise el registro del servidor SFTP para comprobar si las llamadas enviadas al servidor SFTP llegan correctamente, para obtener más información sobre el problema de conectividad, también puede ejecutar un seguimiento de red en el firewall y en el servidor SFTP.

Límites generales

Nombre	Importancia
Número máximo de megabytes que se transfieren hacia o desde el conector dentro de un intervalo de tiempo de ancho de banda (por conexión)	1 000
Intervalo de tiempo de ancho de banda (en milisegundos)	60000

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado	Parámetros para crear una conexión.	Todas las regiones	No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre	Tipo	Description	Obligatorio
Dirección del servidor host	cuerda / cadena	Dirección del servidor host	Cierto
Nombre de usuario	cuerda / cadena	Nombre de usuario	Cierto
Contraseña	securestring	Contraseña
Clave privada SSH	securestring	Clave privada SSH (el contenido del archivo debe proporcionarse completamente tal cual, en formato multilínea)
Frase de contraseña de clave privada SSH	securestring	Frase de contraseña de clave privada SSH (si la clave privada está protegida por una frase de contraseña)
Número de puerto	int	Número de puerto SFTP (ejemplo: 22)
Deshabilitación de la validación de claves de host SSH	bool	¿Deshabilita la validación de claves de host SSH? (True/False)
Impresión con dedo de clave de host SSH	cuerda / cadena	Impresión con dedo de clave de host SSH
Ruta de acceso de carpeta raíz	cuerda / cadena	Ruta de acceso de la carpeta raíz.

Limitaciones

Nombre	Llamadas	Período de renovación
Llamadas API por conexión	150	60 segundos

Acciones

Actualizar archivo	Esta operación actualiza el contenido del archivo.
Cambiar nombre de archivo	Esta operación cambia el nombre de un archivo.
Copiar archivo	Esta operación copia un archivo.
Crear archivo	Esta operación carga un archivo.
Crear carpeta	Esta operación crea una nueva carpeta.
Eliminar archivo	Esta operación elimina un archivo.
Enumerar archivos en la carpeta	Esta operación obtiene los archivos contenidos en una carpeta.
Enumerar archivos en la carpeta raíz	Esta operación obtiene los archivos de la carpeta raíz.
Extracción del archivo en la carpeta	Esta operación extrae un archivo de archivo en una carpeta (ejemplo: .zip).
Obtención de metadatos de archivo	Esta operación obtiene metadatos de archivo mediante el identificador de archivo.
Obtención de metadatos de archivo mediante la ruta de acceso	Esta operación obtiene metadatos de archivo mediante la ruta de acceso del archivo.
Obtención del contenido del archivo mediante la ruta de acceso	Esta operación obtiene el contenido del archivo mediante la ruta de acceso del archivo.
Obtener contenido de archivo	Esta operación obtiene el contenido del archivo mediante el identificador de archivo.

Actualizar archivo

Cambiar nombre de archivo

Copiar archivo

Crear archivo

Crear carpeta

Eliminar archivo

Enumerar archivos en la carpeta

Enumerar archivos en la carpeta raíz

Extracción del archivo en la carpeta

Obtención de metadatos de archivo

Obtención de metadatos de archivo mediante la ruta de acceso

Obtención del contenido del archivo mediante la ruta de acceso

Obtener contenido de archivo

Desencadenadores

Cuando se agrega o modifica un archivo

Esta operación desencadena un flujo cuando se agrega o modifica un archivo en una carpeta. El desencadenador capturará los metadatos del archivo, así como el contenido del archivo. El desencadenador se basa en la hora de última modificación de un archivo. Si un cliente de terceros crea un archivo, la conservación de la hora de la última modificación debe deshabilitarse en el cliente. El desencadenador omite los archivos de más de 50 megabytes. El desencadenador no se activa si se agrega o actualiza un archivo en una subcarpeta. Si es necesario desencadenar en subcarpetas, se deben crear varios desencadenadores.

Cuando se agregan o modifican archivos (solo propiedades)

Esta operación desencadena un flujo cuando se agrega o modifica un archivo en una carpeta. Este desencadenador solo capturará los metadatos del archivo. Para obtener el contenido del archivo, puede usar la operación "Obtener contenido de archivo". El desencadenador se basa en la hora de última modificación de un archivo. Si un cliente de terceros crea un archivo, la conservación de la hora de la última modificación debe deshabilitarse en el cliente. El desencadenador no se activa si se agrega o actualiza un archivo en una subcarpeta. Si es necesario desencadenar en subcarpetas, se deben crear varios desencadenadores.

Cuando se agrega o modifica un archivo

Cuando se agregan o modifican archivos (solo propiedades)

Definiciones

BlobMetadata

BlobMetadataResponse

binary