Conexión a archivos en servidores SFTP a través de Secure Shell (SSH) desde flujos de trabajo en Azure Logic Apps

Se aplica a: Azure Logic Apps (consumo + estándar)

Cuando el flujo de trabajo necesita realizar una administración de archivos automatizada y segura en servidores que usan el Protocolo de transferencia de archivos (SFTP) de Secure Shell (SSH), use las operaciones del conector SFTP-SSH o SFTP en los flujos de trabajo que cree con Azure Logic Apps.

SFTP es un protocolo de red que proporciona acceso a archivos, transferencia de archivos y administración de archivos a través de cualquier flujo de datos confiable. Después, puede supervisar, transferir y administrar archivos en el servidor SFTP sin escribir código personalizado ni administrar la infraestructura. De lo contrario, intentar administrar manualmente estas operaciones de archivo puede ser lenta, propensa a errores y difícil de escalar.

Por ejemplo, el flujo de trabajo puede completar las siguientes tareas:

Supervisar y procesar archivos de datos entrantes.
Crear y administrar carpetas y archivos.
Obtener contenido de archivos y metadatos Extraer archivos.
Distribuir informes.
Sincronice el contenido entre entornos.

En esta guía se muestra cómo acceder al servidor SFTP desde un flujo de trabajo en Azure Logic Apps.

Para obtener más información, consulte:

Referencia técnica del conector

El conector SFTP-SSH tiene versiones diferentes, basadas en el tipo de aplicación lógica y el entorno de host.

Los flujos de trabajo de consumo y estándar pueden utilizar el conector SFTP-SSHadministrado, que comparte recursos de proceso con otros recursos en Azure multitenant. Los flujos de trabajo estándar también pueden usar el conector SFTP nativo en tiempo de ejecución o integrado. Ambas versiones del conector usan el protocolo SSH.

Tipo de aplicación lógica (plan)	Entorno	Versión del conector
Consumo	Azure Logic Apps multiinquilino	Conector gestionado, que aparece en la galería bajo el filtro Compartido. Para más información, consulte la referencia del conector gestionado SFTP-SSH.
Estándar	Azure Logic Apps de un solo inquilino, App Service Environment v3 (solo plan Windows) e híbrido	- Conector administrado, que aparece en la galería de conectores en el filtro Compartido . - Conector integrado, que aparece en la galería de conectores bajo el filtro Integrado y está basado en un proveedor de servicios. El conector integrado puede conectarse directamente a un servidor SFTP y acceder a redes virtuales de Azure mediante una cadena de conexión sin una puerta de enlace de datos local. Para obtener más información, consulte: - Referencia del conector administrado SFTP-SSH - Referencia del conector integrado de SFTP

Las distintas versiones del conector SFTP ofrecen diferentes operaciones precompiladas. Puede iniciar un flujo de trabajo en blanco con un desencadenador específico de SFTP o elegir otro desencadenador en función de su escenario. Por ejemplo, puede iniciar el flujo de trabajo con un desencadenador SFTP que supervisa y responde a eventos en el servidor SFTP. El desencadenador proporciona salidas para usarlas con acciones posteriores en el flujo de trabajo. Varias acciones de SFTP realizan diferentes tareas, como obtener, crear y administrar archivos en el servidor SFTP.

Requisitos previos

Una cuenta y una suscripción de Azure. Obtenga una cuenta gratuita de Azure.
Información sobre la conexión y autenticación del servidor SFTP:
- Dirección del servidor
- Credenciales de cuenta
- Acceso a una clave privada SSH
- Contraseña de clave privada SSH
Importante

Al crear la conexión y escribir la clave privada SSH en el parámetro clave privada SSH , asegúrese de seguir los pasos para proporcionar el valor de parámetro completo y correcto. De lo contrario, una clave no válida hace que se produzca un error en la conexión.

Para obtener más información, consulte Referencia del conector administrado SFTP-SSH: autenticación y permisos.
Flujo de trabajo en el que desea acceder al servidor SFTP.

Para iniciar el flujo de trabajo con un desencadenador SFTP, necesita un flujo de trabajo en blanco. Para usar una acción SFTP, use cualquier desencadenador que funcione mejor para su escenario. En el ejemplo de esta guía se usa el desencadenador Recurrencia.

Limitaciones generales

Antes de usar el conector administrado SFTP-SSH, consulte la referencia del conector administrado SFTP-SSH: problemas y limitaciones conocidos.
Antes de usar el conector integrado SFTP, consulte la referencia del conector administrado SFTP-SSH: problemas y limitaciones conocidos.

Problemas conocidos

De forma predeterminada, los desencadenadores que aceptan y devuelven matrices suelen tener un valor Split on que ya está habilitado. El desencadenador desagrupa automáticamente una matriz mediante la creación interna de una instancia de flujo de trabajo independiente para procesar cada elemento de matriz. Todas las instancias de flujo de trabajo se ejecutan en paralelo para que los elementos de matriz se procesen al mismo tiempo.

Con la opción Dividir en habilitada, los desencadenadores del conector administrado devuelven las salidas de todos los elementos de la matriz como listas. Las acciones posteriores que hagan referencia a estas salidas deben controlar primero estas salidas como listas. Para controlar cada elemento de matriz individualmente, puede agregar acciones adicionales. Por ejemplo, para recorrer en iteración estos elementos de matriz, puede usar un bucle For each. En el caso de los desencadenadores que devuelven solo metadatos o propiedades, use una acción que obtenga primero los metadatos del elemento de matriz y, a continuación, use una acción para obtener el contenido de los elementos.

Debe aplicar este enfoque solo para los desencadenadores de conector administrados, y no para los desencadenadores de conector integrados que devuelven salidas de un elemento de matriz a la vez cuando la opción Dividir en elementos está habilitada.

Por ejemplo, supongamos que tiene un desencadenador de conector administrado denominado Cuando se agrega o modifica un archivo (solo propiedades) que devuelve los metadatos o propiedades de los archivos nuevos o actualizados como matrices. Para obtener los metadatos por separado para cada archivo, puede usar un bucle For each que recorre en iteración la matriz. En este bucle, use las siguientes acciones del conector administrado en el orden especificado:

Obtenga metadatos de archivo para obtener los metadatos de cada archivo.
Obtenga la acción de contenido del archivo para obtener el contenido de cada archivo.

Fragmentación

La fragmentación permite que una operación controle archivos grandes que superen los límites de tamaño predeterminados. Para obtener más información sobre el conector administrado SFTP-SSH y la compatibilidad con la fragmentación, consulte SFTP-SSH referencia del conector administrado: Fragmentación.

Adición de un desencadenador de SFTP

Para agregar un desencadenador SFTP al flujo de trabajo en blanco, siga los pasos correspondientes:

Añadir un activador de SFTP-SSH administrado (Consumo, Estándar)

Para agregar y configurar un desencadenador de conector SFTP-SSH administrado o compartido, siga estos pasos:

En Azure Portal, abra el recurso de aplicación lógica. En el diseñador, abra el flujo de trabajo en blanco.
En el diseñador, siga los pasos generales para agregar el desencadenador compartidoSFTP-SSH que desee.

Por ejemplo, el desencadenador de SFTP-SSH denominado Cuando se agrega o modifica un archivo inicia el flujo de trabajo cuando se agrega o cambia un archivo en el servidor SFTP. Puede agregar una acción de condición que compruebe si el contenido del archivo cumple los criterios especificados. Si el contenido cumple los criterios, use la acción SFTP denominada Obtener contenido del archivo y, a continuación, use otra acción para guardar el contenido en una carpeta SFTP diferente.
Si se le solicita, proporcione la información de conexión necesaria. Cuando termine, seleccione Crear nueva.
En el diseñador, seleccione el desencadenador, si no está seleccionado. En el panel de información del desencadenador, proporcione los detalles necesarios.

Para obtener más información, consulte Referencia de desencadenadores del conector administrado SFTP-SSH.
Cuando termine, guarde el flujo de trabajo. En la barra de herramientas del diseñador, seleccione Save (Guardar).
Siga compilando el flujo de trabajo agregando acciones.

Agregar un desencadenador SFTP integrado (solo estándar)

Para agregar y configurar un desencadenador de conector SFTP integrado, siga estos pasos:

En Azure Portal, abra el recurso de aplicación lógica. En el diseñador, abra el flujo de trabajo en blanco.
En el diseñador, siga los pasos generales para agregar el desencadenador integradoSFTP que desee.

Por ejemplo, el desencadenador SFTP denominado Cuando se agrega o modifica un archivo inicia el flujo de trabajo cuando se agrega o cambia un archivo en el servidor SFTP. Puede agregar una acción de condición que compruebe si el contenido del archivo cumple los criterios especificados. Si el contenido cumple los criterios, use la acción SFTP denominada Obtener contenido del archivo y, a continuación, use otra acción para guardar el contenido en una carpeta SFTP diferente.
Si se le solicita, proporcione la información de conexión necesaria. Cuando termine, seleccione Crear nueva.
En el diseñador, seleccione el desencadenador, si no está seleccionado. En el panel de información del desencadenador, proporcione los detalles necesarios.

Para obtener más información, consulte Referencia del desencadenador del conector integrado SFTP.
Cuando termine, guarde el flujo de trabajo. En la barra de herramientas del diseñador, seleccione Save (Guardar).
Siga compilando el flujo de trabajo agregando acciones.

Adición de una acción SFTP

Antes de agregar una acción SFTP, el flujo de trabajo requiere un desencadenador, que puede ser lo que mejor funcione para su escenario.

En este ejemplo se usa el desencadenador integrado Periodicidad genérico, que ejecuta el flujo de trabajo en función de una programación especificada. Puede agregar un SFTP.

Agregar una acción de SFTP-SSH administrada (Consumo, Estándar)

Para agregar y configurar una acción de conector SFTP-SSH administrado, siga estos pasos:

En el portal de Azure, abra su recurso de aplicación lógica. En el diseñador, abra el flujo de trabajo.
En el diseñador, siga los pasos generales para agregar la acción de SFTP-SSH compartida que desee.

Por ejemplo, la acción SFTP-SSH denominada Obtener contenido del archivo mediante la ruta de acceso obtiene contenido de archivo de un servidor SFTP especificando la ruta de acceso del archivo. Puede usar el desencadenador SFTP-SSH para buscar archivos nuevos o actualizados y una acción de condición que especifique los criterios que debe cumplir el contenido. Si el contenido cumple los criterios, use la acción Obtener contenido del archivo mediante la ruta y una acción posterior para guardar el contenido en una carpeta SFTP diferente.
Si se le solicita, proporcione la información de conexión necesaria. Cuando termine, seleccione Crear nueva.
En el diseñador, seleccione la acción si no está seleccionada. En el panel de información de acciones, proporcione los detalles necesarios.

Para obtener más información, consulte Referencia de acciones del conector administrado SFTP-SSH.
Cuando termine, guarde el flujo de trabajo. En la barra de herramientas del diseñador, seleccione Save (Guardar).

Agregar una acción SFTP integrada (solo estándar)

Para agregar y configurar una acción SFTP integrada, siga estos pasos:

En el portal de Azure, abra su recurso de aplicación lógica. En el diseñador, abra el flujo de trabajo.
En el diseñador, siga los pasos generales para agregar la acción integrada SFTP-SSH que desee.

Por ejemplo, la acción SFTP denominada Obtener contenido del archivo obtiene el contenido del archivo en un servidor SFTP. Puede usar el desencadenador SFTP que comprueba si hay archivos nuevos o actualizados y una acción de condición que especifica los criterios que debe cumplir el contenido del archivo. Si el contenido cumple los criterios, use la acción Obtener contenido del archivo y una acción posterior para guardar el contenido en una carpeta SFTP diferente.
Si se le solicita, proporcione la información de conexión necesaria. Cuando termine, seleccione Crear nueva.
En el diseñador, seleccione la acción si no está seleccionada. En el panel de información de acciones, proporcione los detalles necesarios.

Para obtener más información, consulte Referencia de acciones del conector integrado SFTP.
Cuando termine, guarde el flujo de trabajo. En la barra de herramientas del diseñador, seleccione Save (Guardar).

Solucionar problemas