WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Servicio configurable FtpServer

Seleccione las propiedades y los valores que desea cambiar para un servicio configurable FtpServer existente o para crear un servicio nuevo.

Para cambiar estas propiedades, debe especificar el nombre del intermediario y -c FtpServer. También debe establecer ObjectName en el nombre del servicio configurable que ha creado anteriormente.

Consulte Mandato mqsichangeproperties para ver ejemplos de su uso.

En el caso de los servicios configurables FtpServer, debe detener e iniciar el grupo de ejecución para que un cambio efectuado en el valor de propiedad entre en vigor.

Servicios configurables proporcionados que se crean para cada intermediario Propiedades para cada servicio configurable que se define Descripción de propiedades
Ninguno

accountInfo

Algunos servidores FTP requieren un nombre de cuenta durante el procedimiento de inicio de sesión FTP. Si se especifica esta propiedad, su valor es el nombre de cuenta que se proporciona cuando se solicita durante el inicio de sesión de FTP. Si no se especifica esta propiedad y el servidor solicita un nombre de cuenta, fallará la transferencia FTP.

cipher

El cifrado que se utiliza para el cifrado. Esta propiedad toma la forma de uno o varios de los valores siguientes, separados por signos más (+):
  • blowfish-cbc
  • 3des-cbc
  • aes128-cbc
El cifrado que se utiliza para la acción de cifrado depende de la implementación SSH. Liste los valores en orden de preferencia.

Esta propiedad solamente es válida cuando se ha especificado SFTP como protocolo. Si se utiliza FTP, se ignorará esta propiedad.

Si no se especifica ningún valor, se utilizará el valor predeterminado siguiente: blowfish-cbc+3des-cbc+aes128-cbc

compression

El nivel de compresión que se debe utilizar. Los valores válidos son enteros en el rango de 0 a 9, donde 0 especifica sin compresión y 9 especifica la compresión máxima.

Esta propiedad solamente es válida cuando se ha especificado SFTP como protocolo. Si se utiliza FTP, se ignorará esta propiedad.

Si no se especifica ningún valor, se utiliza el valor predeterminado, que es 0.

connectionType

La conexión del socket de datos FTP. Los valores válidos son ACTIVE o PASSIVE.

Esta propiedad sólo es válida cuando se especifica FTP como protocolo. Si se especifica SFTP, se ignorará esta propiedad.

knownHostsFile

La ubicación del archivo de hosts conocidos. El valor debe ser la vía de acceso totalmente calificada a un archivo de hosts conocidos válido.

La información del host se almacena en un archivo known_hosts en el formato estándar OpenSSH.

Esta propiedad es obligatoria si se ha especificado la propiedad strictHostKeyChecking en Sí. Si se ha establecido la propiedad strictHostKeyChecking en No, se ignorará.

Esta propiedad solamente es válida cuando se ha especificado SFTP como protocolo. Si se utiliza FTP, se ignorará esta propiedad.

mac

El código de autenticación de mensaje. Esta propiedad toma la forma de uno o varios de los valores siguientes, separados por signos más (+):
  • hmac-md5
  • hmac-sha1
La información MAC que utilice dependerá de la implementación SSH. Liste los valores en orden de preferencia.

Esta propiedad solamente es válida cuando se ha especificado SFTP como protocolo. Si se utiliza FTP, se ignorará esta propiedad.

Si no se especifica ningún valor, se utiliza el valor predeterminado siguiente: hmac-md5+ hmac-sha1

preserveRemoteFileDate

Esta propiedad especifica si los archivos que el nodo FileInput recupera del servidor remoto retienen la última fecha de modificación en el servidor.

El valor predeterminado es No. Si seleccione Sí, el nodo FileInput completa el análisis para determinar la fecha de archivo remoto durante el proceso. El mandato MDTM se utiliza donde está soportado por el servidor remoto. Donde no está soportado el mandato MDTM, se utiliza el texto de lista.

Cuando se analiza a partir de un texto de lista, la precisión está limitada a la información que está disponible en el formato de lista específico utilizado por el servidor remoto. Si el formato de lista es ambiguo, el nodo FileInput basa en análisis en los valores locales del intermediario. Si la fecha no se puede determinar de forma fiable desde el servidor remoto, se emite una excepción y el mensaje no se procesa.

protocol

El protocolo de transferencia remota que se debe utilizar. Los valores válidos son FTP o SFTP. Si no se especifica ningún protocolo en el servicio configurable, se utilizará el valor especificado en el nodo.

remoteDirectory

El nombre del directorio relativo o absoluto en el servidor FTP remoto. Si se establece, esta propiedad altera temporalmente la propiedad Directorio de servidor en el separador FTP del nodo FileInput o FileOutput que utiliza este servicio.

scanDelay

El tiempo, en segundos, que se debe esperar después de una exploración del directorio en la que no se ha identificado ningún archivo para procesarlo. El valor predeterminado es de 60 segundos. Si se establece, esta propiedad altera temporalmente la propiedad Retardo de exploración en el separador FTP del nodo FileInput que utiliza este servicio.

securityIdentity

El nombre de una identidad de seguridad que se define utilizando el mandato mqsisetdbparms. Si se establece, esta propiedad altera temporalmente la propiedad Identidad de seguridad en el separador FTP del nodo FileInput o FileOutput que utiliza este servicio. Si el valor de esta propiedad es secId, utilice el mandato siguiente para definir la identidad de seguridad:
  • Si está utilizando FTP:
    mqsisetdbparms NombreIntermediario
    -n ftp::secId -u nombreUsuario 
    -p contraseña
  • Si está utilizando SFTP:
    mqsisetdbparms NombreIntermediario
    -n sftp::secId -u nombreUsuario 
    -p contraseña 
    o
    mqsisetdbparms NombreIntermediario
    -n sftp::secId -u nombreUsuario 
    -i ArchivoIdentidadSSH 
    -r Passphrase

serverName

La dirección IP y, de forma opcional, el número de puerto del servidor FTP remoto. La sintaxis para la propiedad es idéntica a la sintaxis permitida para la propiedad Servidor y puerto FTP de los nodos FileInput y FileOutput (excepto que no puede ser el nombre de un servicio configurable FtpServer).

strictHostKeyChecking

Esta propiedad especifica cómo se comprueban las claves de host durante la conexión y la fase de autenticación. Los valores válidos son:
No
Especifica que se lleva a cabo la siguiente acción:
  • Si la conexión se realiza a un host nuevo, conectar y aceptar la clave del host y almacenarla.
  • Si la conexión se realiza a un host al que se ha conectado anteriormente, y la clave del host ha cambiado, emitir una excepción (en el nodo FileOutput).
Si selecciona No, se utiliza un archivo de host conocido de forma predeterminada (que gestiona el intermediario).
Conecte solamente aquellos hosts con claves válidas; de lo contrario, emita una excepción.

Si selecciona Sí, tendrá que especificar su propio archivo de hosts conocidos utilizando la propiedad knownHostsFile.

El valor predeterminado es No.

La información de host se almacena en un archivo known_hosts en el formato estándar OpenSSH.

Esta propiedad solamente es válida cuando se ha especificado SFTP como protocolo. Si se utiliza FTP, se ignorará esta propiedad.

timeoutSec

El valor de tiempo de espera, en segundos, para establecer una conexión con el servidor FTP o SFTP. Puede establecer cualquier enter válido como valor de propiedad timeoutSec. Un tiempo de espera excedido de 0 se interpreta como un tiempo de espera excedido infinito. Si utiliza FTP, el valor predeterminado es 5 segundos. Si utiliza SFTP, el valor predeterminado son 20 segundos.

transferMode

La modalidad de transferencia de la conexión FTP. Los valores válidos son BINARY (el predeterminado) o ASCII. Si se establece, esta propiedad altera temporalmente la propiedad Modalidad de transferencia en el separador FTP del nodo FileInput o FileOutput que utiliza este servicio.

Esta propiedad solamente es válida cuando se especifica FTP como protocolo. Si se especifica SFTP, se ignorará esta propiedad.

Si define un servicio configurable FtpServer utilizando el mandato mqsicreateconfigurableservice, puede especificar el nombre de este servicio configurable en la propiedad Servidor y puerto FTP remoto del separador FTP de los nodos FileInput y FileOutput.

Para crear un servicio configurable FtpServer, el mandato tiene la siguiente sintaxis:
Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-mqsicreateconfigurableservice--NombreIntermediario----------->

>-- -c  FtpServer-- -o--NombreObjeto---------------------------->

>--+------------------------------+----------------------------->
   |      .-,-------------------. |   
   |      V                     | |   
   '- -n----+-----------------+-+-'   
            '-NombrePropiedad-'       

>--+-----------------------------+-----------------------------><
   |      .-,------------------. |   
   |      V                    | |   
   '- -v----+----------------+-+-'   
            '-ValorPropiedad-'       

donde NombreObjeto es el nombre del servicio configurable y NombrePropiedad es una o más de las propiedades descritas en este tema.
Si define un servicio configurable FtpServer, debe especificar un valor para su propiedad NombreServidor. Las demás propiedades son opcionales.
serverName
La dirección IP y, de forma opcional, el número de puerto del servidor FTP o SFTP remoto. La sintaxis de la propiedad es idéntica a la sintaxis permitida para la propiedadServidor remoto y puerto de los nodos FileInput y FileOutput (excepto en que no puede ser el nombre de un servicio configurable FtpServer).

accountInfo
Algunos servidores FTP requieren un nombre de cuenta durante el procedimiento de inicio de sesión FTP. Si se especifica esta propiedad, su valor es el nombre de cuenta proporcionado cuando se le ha solicitado durante el inicio de sesión FTP. Si no se especifica esta propiedad y el servidor solicita un nombre de cuenta, fallará la transferencia FTP.

cipher
El cifrado utilizado para la acción de cifrado. Esta propiedad toma la forma de una lista de uno o más de los valores siguientes, separados por signos más (+):
  • blowfish-cbc
  • 3des-cbc
  • aes128-cbc
El cifrado que se utiliza para la acción de cifrado depende de la implementación SSH. Liste los valores en orden de preferencia.

Esta propiedad solamente es válida cuando se ha especificado SFTP como protocolo. Si se utiliza FTP, se ignorará esta propiedad.

Si no se especifica ningún valor, se utilizarán los siguientes valores predeterminados: blowfish-cbc+3des-cbc+aes128-cbc

compression
Especifica el nivel de compresión que se ha de utilizar. Los valores válidos son enteros en el rango de 0 a 9, donde 0 especifica sin compresión y 9 especifica la compresión máxima.

Esta propiedad solamente es válida cuando se ha especificado SFTP como protocolo. Si se utiliza FTP, se ignorará esta propiedad.

Si no se ha especificado ningún valor, se utiliza el valor predeterminado.

connectionType
La conexión del socket de datos FTP. Puede ser ACTIVE o PASSIVE.

Esta propiedad solamente es válida cuando se especifica FTP como protocolo. Si se especifica SFTP, se ignorará esta propiedad.

knownHostsFile
La ubicación del archivo de hosts conocidos. El valor debe ser la vía de acceso completa a un archivo de hosts conocidos válido.

La información de host se almacena en un archivo known_hosts en el formato estándar OpenSSH.

Esta propiedad es obligatoria si se ha especificado la propiedad strictHostKeyChecking en Sí. Si se ha establecido la propiedad strictHostKeyChecking en No, se ignorará.

Esta propiedad solamente es válida cuando se ha especificado SFTP como protocolo. Si se utiliza FTP, se ignorará esta propiedad.

mac
Código de autenticación de mensajes. Esta propiedad toma la forma de una lista de uno o más de los valores siguientes, separados por signos más (+):
  • hmac-md5
  • hmac-sha1
La información MAC que utilice dependerá de la implementación SSH. Liste los valores en orden de preferencia.

Esta propiedad solamente es válida cuando se ha especificado SFTP como protocolo. Si se utiliza FTP, se ignorará esta propiedad.

Si no se especifica ningún valor, se utilizarán los siguientes valores predeterminados: hmac-md5+hmac-sha1

preserveRemoteFileDate
Esta propiedad especifica si los archivos que el nodo FileInput recupera del servidor remoto retienen la última fecha de modificación en el servidor.

El valor predeterminado es No. Si seleccione Sí, el nodo FileInput completa el análisis para determinar la fecha de archivo remoto durante el proceso. El mandato MDTM se utiliza donde está soportado por el servidor remoto. Donde no está soportado el mandato MDTM, se utiliza el texto de lista.

Cuando se analiza a partir de un texto de lista, la precisión está limitada a la información que está disponible en el formato de lista específico utilizado por el servidor remoto. Si el formato de lista es ambiguo, el nodo FileInput basa en análisis en los valores locales del intermediario. Si la fecha no se puede determinar de forma fiable desde el servidor remoto, se emite una excepción y el mensaje no se procesa.

protocol
El protocolo de transferencia remota que se debe utilizar. Los valores válidos son FTP o SFTP. Si no se especifica ningún protocolo en el servicio configurable, se utilizará el valor especificado en el nodo.

remoteDirectory
El nombre del directorio relativo o absoluto en el servidor FTP remoto. Si se establece, esta propiedad altera temporalmente el Directorio de servidor del separador FTP del nodo FileInput o FileOutput que utiliza este servicio.

scanDelay
El intervalo de tiempo, en segundos, que se ha de esperar tras una exploración del directorio en la que no se ha identificado ningún archivo para su proceso. El valor predeterminado es 60 segundos. Si se establece, esta propiedad altera temporalmente el Retardo de exploración en el separador FTP del nodo FileInput que utiliza este servicio.

securityIdentity
El nombre de una identidad de seguridad que se define utilizando el mandato mqsisetdbparms. Si se establece, esta propiedad altera temporalmente la Identidad de seguridad del separador FTP del nodo FileInput o FileOutput que utiliza este servicio. Si el valor de esta propiedad es secId, defina la identidad de seguridad utilizando el mandato siguiente:
  • Si está utilizando FTP:
    mqsisetdbparms MB8BROKER -n ftp::secId -u nombreUsuario -p contraseña
  • Si está utilizando SFTP:
    mqsisetdbparms MB8BROKER -n sftp::secId -u nombreUsuario -p contraseña
    o
    mqsisetdbparms MB8BROKER -n sftp::secId -u nombreUsuario -i ArchivoIdentidadSSH
    -r Passphrase
strictHostKeyChecking
Especifica cómo se comprueban las claves de host durante la conexión y la fase de autenticación. Los valores válidos son:
No
Especifica que se lleva a cabo la siguiente acción:
  • Si la conexión se debe efectuar en un host nuevo, conecte y acepte la clave de host y guárdela.
  • Si la conexión se debe efectuar en un host al que ya se ha conectado previamente y se ha cambiado la clave de host, emita una excepción (nodo FileOutput).
Si selecciona No, se utiliza un archivo de host conocido de forma predeterminada (que gestiona el intermediario).
Conectarse sólo a hosts conocidos con claves válidas; de lo contrario, emitir una excepción.

Si selecciona Sí, tendrá que especificar su propio archivo de hosts conocidos utilizando la propiedad knownHostsFile.

El valor predeterminado es No.

La información de host se almacena en un archivo known_hosts en el formato estándar OpenSSH.

Esta propiedad solamente es válida cuando se ha especificado SFTP como protocolo. Si se utiliza FTP, se ignorará esta propiedad.

timeoutSec
El valor de tiempo de espera en segundos para establecer una conexión con el servidor FTP o SFTP remoto. Puede establecer cualquier entero válido como el valor de la propiedad timeoutSec. Un tiempo de espera de 0 se interpreta como un tiempo de espera infinito. Si está utilizando FTP, el valor predeterminado es 5 segundos. Si está utilizando SFTP, el valor predeterminado es 20 segundos.
transferMode
La modalidad de transferencia de la conexión FTP. Este valor es BINARY o ASCII. El valor predeterminado es BINARY. Si se establece, esta propiedad altera temporalmente Modalidad de transferencia del separador FTP del nodo FileInput o FileOutput que utiliza este servicio.

Esta propiedad solamente es válida cuando se especifica FTP como protocolo. Si se especifica SFTP, se ignorará esta propiedad.

De forma predeterminada, no se establece ninguna de estas propiedades en la definición del servicio configurable FtpServer. La única propiedad obligatoria cuando se define un servicio configurable FtpServer es el nombre del servidor.
El ejemplo siguiente de un mandato mqsicreateconfigurableservice muestra cómo crear un servicio configurable FtpServer:
mqsicreateconfigurableservice MB8BROKERR -c FtpServer -o Server01 
-n serverName,scanDelay,transferMode,connectionType,securityIdentity 
-v one.hursley.abc.com:123,20,BINARY,ACTIVE,secId

Los valores establecidos en las propiedades en la definición de servicio configurable FtpServer alteran temporalmente los valores establecidos en las correspondientes propiedades de los nodos FileInput y FileOutput.

Si establece la propiedad de información de cuenta, ésta se utilizará durante el protocolo de inicio de sesión cuando se realice la conexión con el servicio configurable FtpServer después de facilitar el identificador y la contraseña del usuario. A veces, esta información la requieren los servidores FTP y se solicita como parte del protocolo de inicio de sesión. Este valor permite a los nodos FileInput y FileOutput responder de forma adecuada durante el inicio de sesión.

Si establece la propiedad de tipo de conexión, ésta alterará el tipo de socket de datos que se utiliza para transferir archivos a o desde el servidor FTP. Si establece esta propiedad en ACTIVE, ésta hará referencia a un socket establecida por el servidor remoto para el cliente (el flujo de mensajes del intermediario). Si establece esta propiedad en PASSIVE, ésta hará referencia a un socket establecido por el cliente para el servidor remoto (así como el inicio de sesión o el socket de control). El valor predeterminado es PASSIVE, que tiene más probabilidades de ser tolerado por la mayoría de los tipos de protección por cortafuegos que permiten al cliente iniciar la sesión. Puede establecer esta propiedad en ACTIVE si el servidor FTP no tiene soporte para conexiones PASSIVE o si existen disposiciones especiales con las que tenga que cumplir la configuración.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 16:58:33


Tema de referenciaTema de referencia | Versión 8.0.0.5 | ac25670_