Compartir vía

Configurar el adaptador de FTP

  • Artículo

Antes de empezar

  • El adaptador de FTP admite la lectura y escritura de datos de un servidor FTP seguro. El adaptador admite la transferencia de archivos desde un servidor FTP mediante Capa de sockets seguros (SSL)/Seguridad de nivel de transporte (TLS).
  • El adaptador FTP admite la descarga de archivos desde ubicaciones de archivos de solo lectura.
  • El adaptador FTP también admite la transferencia atómica de archivos para el modo ASCII.

Consulte Procedimientos recomendados y recomendaciones para el adaptador ftp.

Configuración de la ubicación de recepción

Puede establecer las propiedades del adaptador de ubicación de recepción de FTP en la consola de administración de BizTalk Server. Si las propiedades no se establecen en la ubicación de recepción, se usan los valores predeterminados del controlador de recepción en la consola de administración de BizTalk Server.

Nota

Antes de completar el procedimiento siguiente, debe haber agregado ya un puerto de recepción. Consulte Cómo crear un puerto de recepción.

  1. En la consola de administración de BizTalk Server, expanda BizTalk Server Administración, expanda Grupo de BizTalk, expanda Aplicaciones y, a continuación, expanda la aplicación en la que desea crear una ubicación de recepción.

  1. En el panel izquierdo, haga clic en el nodo Puertos de recepción . En el panel derecho, haga clic con el botón derecho en el puerto de recepción asociado a una ubicación de recepción existente o que quiera asociar a una nueva ubicación de recepción y, a continuación, haga clic en Propiedades.

  2. En el cuadro de diálogo Propiedades del puerto de recepción, en el panel izquierdo, seleccione Ubicaciones de recepción. En el panel derecho, haga doble clic en una ubicación de recepción existente o haga clic en Nuevo para crear una nueva ubicación de recepción.

  3. En el cuadro de diálogo Propiedades de ubicación de recepción, en la sección Transporte junto a Tipo, seleccione FTP en la lista desplegable y, a continuación, haga clic en Configurar.

  4. En Propiedades de transporte FTP, haga lo siguiente:

    Batch

    Use Para hacer esto
    Máximo de archivos Especificar el número máximo de archivos por lote de BizTalk Server.

    El cero (0) indica que no hay ningún límite.

    Valor predeterminado: 0
    Tamaño máximo Especificar el número máximo de bytes por lote de BizTalk Server.

    El cero (0) indica que no hay ningún límite.

    Valor predeterminado: 0

    Firewall

    Use Para hacer esto
    Dirección Especificar la dirección del servidor de seguridad, ya sea un nombre DNS o una dirección IP.
    Modo Especificar el modo en el que el adaptador establece la conexión con el servidor FTP.

    Valores válidos: Pasivo y activo

    En modo activo, el servidor FTP se conecta a un puerto abierto por el adaptador FTP. En modo pasivo, el adaptador FTP se conecta a un puerto abierto por el servidor FTP. Es posible que el modo activo no funcione si usa una dirección IP interna y se conecta a una dirección IP externa. En este caso, debe usar el modo pasivo o el modo Activo con una puerta de enlace de capa de aplicación (ALG) con compatibilidad con FTP.

    Valor predeterminado: Activo
    Contraseña Especificar la contraseña del servidor de seguridad.
    Puerto Especificar el puerto del servidor de seguridad.

    Valores válidos: de 1 a 65535 inclusive

    Valor predeterminado: 21
    Tipo Especificar el tipo de servidor de seguridad implementado.

    Valores válidos: Ninguno, Calcetines 4 y Calcetines 5

    Valor predeterminado: Ninguno
    User Especificar el nombre de usuario del servidor de seguridad.

    FTP

    Use Para hacer esto
    Cuenta Especificar el nombre de cuenta para el servidor FTP. Esta opción está en desuso y no se recomienda el uso de esta propiedad.
    Después de obtener Especifique los comandos FTP que se ejecutarán después del archivo GET. Separe los comandos con un punto y coma (;).
    Antes de obtener Especifique los comandos FTP que se ejecutarán antes del archivo GET. Separe los comandos con un punto y coma (;). Nota: No se admite el comando QUIT antes del archivo GET.
    Error de umbral Especifique el número de errores que BizTalk Server pueden encontrar antes de deshabilitar la ubicación.

    Valor predeterminado: 10
    Máscara de archivo Especificar el filtro de máscara de archivo que se utilizará al transmitir los archivos.
    Carpeta Especificar la ubicación de sondeo del servidor FTP.
    Tipo de servidor FTP Novedades a partir de BizTalk Server 2016.

    Utilice esta propiedad para elegir un servidor FTP que no requiera el comando SYST. Las opciones son None, AIX, Detect, GXS, MVS, OS400 y Other.

    Si se establece en Ninguno, se usa el comando SYST. Otro se usa cuando el tipo de sistema operativo no cabe en ninguna de las categorías especificadas.

    Valor predeterminado: Ninguno
    Log Especifique la ruta de acceso completa, incluido el nombre de archivo de registro al que se va a generar. Este archivo se utiliza para diagnosticar las condiciones de error que se producen al enviar o recibir archivos mediante FTP.
    Tamaño máximo de archivo Especificar el tamaño máximo de archivos descargables en megabytes (MB).

    Cero (0) indica que no hay límite de tamaño de archivo.

    Valor predeterminado: 100
    Contraseña Especificar la contraseña de usuario para iniciar la sesión en el servidor FTP.
    Puerto Especificar la dirección del puerto de este servidor FTP.

    Valor predeterminado: 21
    Representación Seleccionar el modo en el que el FTP recibe los datos.

    Valores válidos: binarios o ASCII

    Valor predeterminado: binario
    Servidor Especificar el nombre de servidor o la dirección IP del servidor FTP. Nota: El URI de un puerto de envío o una ubicación de recepción no puede superar los 256 caracteres.
    Afiliada de SSO Especificar la aplicación afiliada de inicio de sesión único empresarial.
    Usar lista de nombres (NLST) Especifique cómo el adaptador muestra una lista de archivos. Para ver los nombres de archivo en lugar de la lista de archivos definidos por el sistema, establezca este valor en Sí.

    Valor predeterminado: No
    Nombre de usuario Especificar el nombre de usuario para iniciar la sesión en el servidor FTP.

    Sondeo

    Use Para hacer esto
    Eliminar después de la descarga Especifique si el adaptador elimina un archivo del servidor FTP después de descargarlo.

    Valor predeterminado: Sí Nota:
    Habilitar la comparación en marca de tiempo Especifique si el adaptador vuelve a descargar un archivo en función de si la marca de tiempo se ha modificado. En aquellos casos en los que el adaptador no tena permisos de eliminación en el servidor de FTP, el comando MDTM (Hora de modificación) permite al adaptador saber si se ha modificado o no un archivo desde la última descarga. Según el valor de esta propiedad, el archivo se descarga de nuevo.

    Valor predeterminado: Sin nota: En caso de que el servidor FTP no admita MDTM, establezca la propiedad Redownload Interval . Nota: Esta propiedad solo es aplicable cuando Eliminar después de descargar se establece en No.
    Intervalo Especificar el número de intervalo de sondeo de esta ubicación. Para efectuar un sondeo continuo, establezca este valor en cero (0).

    Valor predeterminado: 60
    Intervalo para volver a descargar Especificar el intervalo después del cual el adaptador descarga archivos de nuevo. Esta propiedad solo se aplica cuando la opción Eliminar después de descargar y Habilitar la comparación de marca de tiempo se establece en No.

    Valor predeterminado: -1

    -1 indica que el adaptador no descargará los archivos de nuevo.

    0 indica que el adaptador descargará el archivo en cada ciclo de sondeo.
    Unidad Especifique el tipo de unidades para las propiedades Interval y Redownload Interval .

    Valores válidos: Segundos, minutos, horas y días

    Valor predeterminado: Segundos

    SSL

    Use Para hacer esto
    Hash de certificado de cliente Especifique el hash SHA1 del certificado de cliente que se debe usar en la negociación de la Capa de sockets seguros (SSL).

    En función de este hash, el certificado de cliente se toma del almacén personal de la cuenta de usuario bajo la que se ejecuta la instancia de host de BizTalk.
    Modo de conexión FTPS Especifique el modo de conexión SSL realizada al servidor FTPS.

    Valores válidos: Implícito o explícito

    Valor predeterminado: Explícito
    para usar la protección de datos Especifique Sí, si el adaptador debe usar el cifrado SSL cuando envía y recibe archivos de datos del servidor FTPS. Especifique No para que el adaptador envíe y reciba archivos de datos como texto sin formato. Nota: Esta propiedad solo se aplica si la propiedad Use SSL está establecida en Sí.

    Valores válidos: Sí o no

    Valor predeterminado: Sí
    Usar SSL Especifique si el adaptador FTP debe usar SSL para comunicarse con el servidor FTPS.

    Valores válidos: Sí o no

    Valor predeterminado: No

    Parámetros de optimización

    Use Para hacer esto
    Recibir datos de tiempo de espera Especifique el tiempo en milisegundos antes de que se anule la llamada de recepción. Esta propiedad se usa para evitar que un servidor lente haga que la ubicación de recepción deje de responder.

    Valor predeterminado: 90000
    Carpeta temporal Especificar la ubicación de una carpeta temporal. Se usa esta ubicación para garantizar la recuperación tras un error de transferencia.

  5. Haga clic en Aceptar para guardar la configuración.

  6. En el cuadro de diálogo Propiedades de ubicación de recepción, escriba los valores adecuados para completar la configuración de la ubicación de recepción y, a continuación, haga clic en Aceptar para guardar la configuración. Para información sobre el cuadro de diálogo Propiedades de ubicaciones de recepción , vea Cómo crear una ubicación de recepción.

Nota

No configure varias ubicaciones de recepción de FTP para sondear la misma dirección URL de FTP. Si varias ubicaciones de recepción de FTP sondean la misma dirección URL de forma simultánea, cada ubicación de recepción puede recibir una copia del archivo, lo que puede da lugar al duplicado de datos. Este comportamiento tiene lugar porque el protocolo FTP no tiene disposición para bloquear archivos al leerlos desde la dirección URL de destino.

Para proporcionar alta disponibilidad para el adaptador de recepción ftp, debe configurar el adaptador de recepción ftp para que se ejecute en una instancia de host de BizTalk en clúster. Consulte Consideraciones para ejecutar controladores de adaptador dentro de un host en clúster.

Configuración del puerto de envío

Puede establecer las propiedades del adaptador de puerto de envío ftp en la consola de administración de BizTalk Server. Si no se establecen propiedades para el puerto de envío, se usan los valores predeterminados del controlador de envío en la consola de administración de BizTalk Server.

  1. En la consola de administración de BizTalk Server, cree un puerto de envío o haga doble clic en un puerto de envío existente para modificarlo. Consulte Cómo crear un puerto de envío. Configure todas las opciones de puerto de envío y, en la sección Transporte de la página General , especifique FTP para la opción Tipo .

  2. En la página General , en la sección Transporte , haga clic en el botón Configurar situado junto a Tipo.

  3. En Propiedades de transporte FTP, haga lo siguiente:

    Firewall

    Use Para hacer esto
    Dirección Especificar la dirección del servidor de seguridad, ya sea un nombre DNS o una dirección IP.
    Modo Seleccionar el modo en el que el adaptador establece la conexión con el servidor FTP.

    Valores válidos: Pasivo y activo

    En modo activo, el servidor FTP se conecta a un puerto abierto por el adaptador FTP. En modo pasivo, el adaptador FTP se conecta a un puerto abierto por el servidor FTP. Es posible que el modo activo no funcione si usa una dirección IP interna y se conecta a una dirección IP externa. En este caso, debe usar el modo pasivo o el modo Activo con una puerta de enlace de capa de aplicación (ALG) con compatibilidad con FTP.

    Valor predeterminado: Activo
    Contraseña Especificar la contraseña del servidor de seguridad.
    Puerto Especificar el puerto del servidor de seguridad.

    Valores válidos: de 1 a 65535 de forma inclusiva

    Valor predeterminado: 21
    Tipo Seleccionar el tipo de servidor de seguridad implementado.

    Valores válidos: Calcetines 4, Calcetines 5, Ninguno

    Valor predeterminado: Ninguno
    User Especificar el nombre de usuario del servidor de seguridad.

    FTP

    Use Para hacer esto
    Cuenta Opcional. Especificar el nombre de cuenta para el servidor FTP. Esta opción se ha dejado de usar y se desaconseja el uso de esta propiedad.
    Después de Put Especificar los comandos FTP que se ejecutarán después del archivo PUT. Separe los comandos con un punto y coma (;).
    Asignar almacenamiento Especificar si se asigna espacio de almacenamiento para sistemas de hosts heredados. Esta opción se proporciona para la compatibilidad con versiones anteriores.

    Valores válidos: No y Sí

    Valor predeterminado: No
    Antes de colocar Especificar los comandos FTP que se ejecutarán antes del archivo PUT; por ejemplo, comandos para cambiar los valores predeterminados en el servidor FTP. Separe los comandos con un punto y coma (;). No se requiere ningún comando open. Nota: El comando QUIT no se admite antes del archivo PUT.
    Carpeta Especificar la ubicación a la que se moverán los archivos del servidor FTP.
    Tipo de servidor FTP Novedades a partir de BizTalk Server 2016.

    Utilice esta propiedad para elegir un servidor FTP que no requiera el comando SYST. Las opciones son None, AIX, Detect, GXS, MVS, OS400 y Other.

    Si se establece en Ninguno, se usa el comando SYST. Otro se usa cuando el tipo de sistema operativo no se ajusta a ninguna de las categorías especificadas.

    Valor predeterminado: Ninguno
    Log Especifique la ruta de acceso completa, incluido el nombre de archivo del archivo de registro en el que se va a generar la salida. Use este archivo para diagnosticar las condiciones de error que se producen al enviar o recibir archivos a través del adaptador de FTP.
    Contraseña Especifique la contraseña para iniciar sesión en el servidor de FTP.
    Puerto Especifique la dirección del puerto para el servidor FTP.

    Valor predeterminado: 21
    Representación Seleccione cómo envía los datos el adaptador de FTP, como binarios o como ASCII.

    Valores válidos: binario o ASCII

    Valor predeterminado: binario
    Servidor Especificar el nombre de servidor o la dirección IP del servidor FTP.
    Afiliada de SSO Especificar la aplicación afiliada de inicio de sesión único empresarial.
    Nombre de archivo de destino Especificar un nombre alternativo para el archivo. Conservar el nombre predeterminado garantiza nombres de mensaje únicos para cada mensaje enviado.

    Valor predeterminado: %MessageID%.xml
    Nombre de usuario Especificar el nombre de usuario para iniciar la sesión en el servidor FTP.

    SSL

    Use Para hacer esto
    Hash de certificado de cliente Especifique el hash SHA1 del certificado de cliente que se debe usar en la negociación de la Capa de sockets seguros (SSL).

    En función de este hash, el certificado de cliente se toma del almacén personal de la cuenta de usuario bajo la que se ejecuta la instancia de host de BizTalk.
    Modo de conexión FTPS Especifique el modo de conexión SSL realizada al servidor FTPS.

    Valores válidos: Implícito o explícito

    Valor predeterminado: Explícito
    para usar la protección de datos Especifique Sí, si el adaptador debe usar el cifrado SSL cuando envía y recibe archivos de datos del servidor FTPS. Especifique No para que el adaptador envíe y reciba archivos de datos como texto sin formato. Nota: Esta propiedad solo es aplicable si la propiedad Use SSL está establecida en Sí.

    Valores válidos: Sí o no

    Valor predeterminado: Sí
    Usar SSL Especifique si el adaptador FTP debe usar SSL para comunicarse con el servidor FTPS.

    Valores válidos: Sí o no

    Valor predeterminado: No

    Parámetros de optimización

    Use Para hacer esto
    Connection Limit (Límite de conexiones) Especificar el número máximo de conexiones FTP simultáneas que se pueden abrir con el servidor. El valor 0 significa que no hay ningún límite.

    Valor predeterminado: 0 Nota: Esta propiedad reemplaza la entrada del Registro que se usó en versiones anteriores de BizTalk Server para controlar el límite de conexión. BizTalk Server omite la entrada del Registro utilizada para controlar el límite de conexión.
    Carpeta temporal Especificar la ubicación para una carpeta temporal del servidor FTP. El archivo se carga primero aquí y, a continuación, se mueven a la carpeta de FTP de destino. En caso de error de transferencia, el adaptador reinicia la carga de archivos en modo ASCII de transferencia y reanuda en modo binario de transferencia. Nota: Si la transferencia de archivos es atómica entre la ubicación temporal y la ubicación pertinente en el servidor FTP, la carga de archivos también es atómica.

  4. Haga clic en Aceptar y en Aceptar de nuevo para guardar la configuración.

Comandos FTP requeridos por el adaptador de FTP

El adaptador de FTP está sujeto a las limitaciones del protocolo FTP y requiere que determinados comandos FTP estén disponibles en el servidor FTP de origen o de destino.

El adaptador FTP funciona como un cliente FTP y puede requerir que los siguientes comandos estén disponibles en el servidor FTP para funcionar correctamente:

Get-Help Requerido por Receive Requerido por Enviar
SYST ✔

Opcional a partir de BizTalk Server 2016		 ✔

Opcional a partir de BizTalk Server 2016
ALMACENAMIENTO ✔
RETR ✔
USER ✔ ✔
PASS ✔ ✔
CWD ✔ ✔
QUIT ✔ ✔
PUERTO ✔ ✔
PASV ✔ ✔
ABOR ✔ ✔
TYPE ✔ ✔
RNFR ✔ ✔
RNTO ✔ ✔
DELE ✔ ✔
PWD ✔ ✔
LISTA ✔ ✔
NLST ✔ ✔
NOOP ✔ ✔
APPE ✔
ALLO ✔ ✔
MDTM ✔
AUTH TLS ✔ ✔
PBSZ ✔ ✔
PROT ✔ ✔

Para obtener más información sobre estos comandos FTP, vea:

Configuración de un adaptador ftp para trabajar con hosts heredados

En estas secciones se aborda lo que necesita saber para facilitar la comunicación entre el adaptador ftp y un equipo central.

Nota

No se puede usar la función de carpeta temporal al enviar archivos a un host AS400 o MVS. La entrada en este campo no se admite y producirá errores.

Importante

La siguiente información se proporciona como guía y no se debería sustituir por la información que se encuentra en la documentación de IBM o AS400.

MVS

Para enviar archivos a un servidor FTP de un gran sistema (mainframe), éste debe admitir los grupos de datos de generaciones de IBM (GDG, del inglés Generation Data Group). En el campo de nombre, cada nombre de archivo anexará un (+1) al nombre de archivo de destino (una ruta completa entre comillas).

AS400

Existen tres métodos para dar nombre a los archivos y definir sus rutas cuando se transfieren archivos a un sistema AS400 y desde él:

  • Campo Nombre de archivo: al enviar un archivo a un servidor FTP, escriba el nombre de archivo en el campo Nombre de archivo . El nombre de archivo debe cumplir las convenciones de asignación de nombre de archivo del sistema AS400, pues el archivo se almacenará en el sistema de archivos de biblioteca.

  • Comando Quote: use el comando Quote para ejecutar un script en el equipo remoto. Escriba el comando Quote en los campos Before GET, Before PUT, After GET y After PUT en cualquiera de los puntos de conexión. Escriba el comando de comillas en el formato siguiente:

    QUOTE RCMD <command to be run on the remote system>.

  • Sistema de archivos integrado (IFS): IFS es un área del sistema AS400 que permite el almacenamiento de archivos basados en PC y, por tanto, las mismas convenciones de nomenclatura que un equipo. Para usar ifS en lugar del sistema de archivos de biblioteca predeterminado, el primer comando que se debe escribir es quote site namefmt 1. Este comando le indica al sistema AS400 que tiene que utilizar las convenciones de asignación de nombres de IFS.

Más cosas interesantes

Propiedades y esquema de propiedades del adaptador de FTP

Procedimientos recomendados y recomendaciones para el adaptador ftp

Adaptador de FTP