Gestión de configuraciones de pasarela

Las pasarelas gestionan la información de transporte que se utiliza para direccionar los documentos a su destino correcto en la comunidad de concentrador. El protocolo de transporte saliente determina qué información se utiliza durante la configuración de la pasarela. Si desea obtener información sobre la creación de pasarelas, consulte la Guía de configuración de concentrador.

Información necesaria para la configuración de la pasarela

El tipo de transporte determina la información de parámetros necesaria para la configuración de la pasarela. En la Tabla 3, los recuadros marcados con una X necesitan información de configuración y los recuadros marcados con la letra O son opcionales. Consulte la Tabla 4 para ver descripciones de los atributos de la pasarela.

Nota:
La posibilidad de editar determinados valores de configuración de la pasarela varía según el nivel de permiso del usuario.
Tabla 3. Información de transporte necesaria
Información de transporte necesaria Transporte HTTP Transporte HTTPS Transporte FTP Transporte FTPS Transporte FTP Scripting Transporte de Directorio de archivos Transporte JMS Transporte SMTP

Autent.
obligatoria

O

O

Cola automática

O

O

O

O

O

O

Tiempo de espera
de conexión

X

X

X

X

X

Modalidad FTPS

O

Nombre de
fábrica JMS

X

Nombre de
fábrica
JMS JNDI

X

Clase de
mensaje JMS

X

Tipo de mensaje
JMS

O

Nombre de
cola JMS

X

Bloquear usuario

O

Número de
hebras

X

X

X

X

X

X

Contraseña

O

O

O

O

O

O

O

O

Paquete de URL
del proveedor

O

Recuento de reintentos

X

X

X

X

X

X

X

X

Intervalo de reintentos

X

X

X

X

X

X

X

X

IP de servidor

X

URI de destino

X

X

X

X

X

X

X

ID de usuario

O

Nombre de usuario

O

O

O

O

O

O

O

Validar
IP de cliente

O

O

O

O

Validar
certificado SSL
de cliente

O

Notas:
  1. Cuando la opción Autenticación obligatoria de una pasarela está activada y se proporcionan el Nombre de usuario y la Contraseña, la pasarela pasará el nombre de usuario y la contraseña al sistema externo con el que se conecta para la entrega del documento. La pasarela no fuerza la autenticación, sino que pasa simplemente estas credenciales de autenticación al sistema con el que se está intentando conectar. Para una pasarela JMS, se utilizan el Nombre de usuario y la Contraseña como credenciales para la búsqueda JNDI de la fábrica de conexiones de cola JMS. Tenga en cuenta que JMS en Websphere MQ no fuerza la autenticación de JNDI cuando se utiliza el JNDI basado en archivo para conectarse con una cola JMS.
  2. El nombre de usuario y la contraseña son necesarios para la autenticación FTPS a menos que el servidor FTPS con el que está negociando esté correlacionado con el usuario, de acuerdo con un certificado de cliente presentado. Póngase en contacto con el administrador del servidor FTPS para obtener los detalles de la implementación.

Visualización y edición de pasarelas

Para ver y editar pasarelas, siga estos pasos:

  1. Pulse Administración de cuentas > Perfiles > Pasarelas.
  2. Para cambiar el acceso a una pasarela, pulse En línea o Fuera de línea en la columna Acceso.
  3. Para cambiar el estado de una pasarela, pulse Habilitado o Inhabilitado en la columna Estado.
  4. Pulse el icono Ver detalles para ver los detalles de la pasarela.
  5. Pulse el icono Editar.
  6. En la ventana Detalle de pasarela, edite los parámetros de pasarela que se describen en Tabla 4.
  7. Pulse Guardar.

    También puede suprimir la pasarela pulsando Suprimir.

    Tabla 4. Descripciones de parámetros de la pasarela
    Parámetro Descripción

    Autenticación obligatoria

    Si está habilitado este parámetro, se proporcionan el nombre de usuario y la contraseña con mensajes JMS o SMTP.

    Cola automática

    Si está habilitado este parámetro, los documentos se colocan en un depósito temporal si la pasarela se deja fuera de línea. Si está inhabilitado y la pasarela se deja fuera de línea, el documento no se puede direccionar y se produce un error.

    Planificación basada en calendario

    Si se selecciona esta opción, los documentos asociados con esta pasarela se procesan de acuerdo con la planificación seleccionada.

    Manejadores de puntos de configuración

    Se utiliza para especificar los manejadores que se deben utilizar para el preproceso y el postproceso.

    Tiempo de espera de conexión

    Número de segundos que permanecerá abierto un socket sin tráfico. El valor predeterminado es 120 (2 minutos).

    Descripción

    Descripción opcional de la pasarela.

    Modalidad FTPS

    Seleccione Sí o No para controlar si se utiliza una conexión segura.

    Nombre de pasarela

    El nombre que se utiliza para identificar la pasarela.

    Nota: Nombre de pasarela es un campo de formato libre definido por el usuario. Aunque no es necesario que sea exclusivo, se recomienda a los usuarios utilizar nombres diferentes para cada pasarela para evitar posibles confusiones.

    Planificación basada en intervalos

    Si se selecciona esta opción, la pasarela procesa el documento con el intervalo de tiempo especificado.

    Nombre de fábrica JMS

    Nombre de la clase Java (TM) que utilizará el proveedor JMS para generar la conexión con la cola JMS.

    Nombre de fábrica JMS JNDI

    Nombre de fábrica que se utiliza para conectarse con el servicio de nombres.

    Clase de mensaje JMS

    Clase del mensaje.

    Tipo de mensaje JMS

    Tipo del mensaje JMS.

    Nombre de cola JMS

    Nombre de la cola donde se almacenan los mensajes JMS.

    Intervalo de reintento de bloqueo (segundos)

    Cantidad de tiempo que el componente FTP Script esperará entre reintentos de bloqueo.

    Recuento de reintento de bloqueo

    Número de veces que el componente FTP Script intentará obtener el bloqueo.

    Bloquear usuario

    Seleccione Sí o No para controlar si se permiten o no las conexiones simultáneas.

    Tiempo máximo de bloqueo (segundos)

    Cantidad de tiempo máximo que el componente FTP Script conservará el bloqueo. Después del tiempo máximo, el bloqueo se devuelve a la base de datos.

    Cola máxima de bloqueo (segundos)

    Cantidad de tiempo máximo que el componente FTP Script permanecerá en la cola de solicitud de bloqueo. Se coloca en la cola de bloqueo de solicitud cuando una solicitud de bloqueo se deniega.

    Número de hebras

    El número de hebras asignadas para direccionar un documento. El valor predeterminado es 3. Este parámetro sólo está disponible para los usuarios de administración de concentrador.

    En línea / Fuera de línea

    Indica si la pasarela está en línea o fuera de línea. Si está fuera de línea, los documentos se ponen en cola hasta que vuelva a estar en línea.

    Contraseña

    La contraseña del acceso seguro a través del cortafuegos del participante.

    Paquete de URL del proveedor

    Nombre de las clases o del archivo JAR que utiliza Java para entender el URL de contexto JMS.

    Recuento de reintentos

    El número máximo de veces que el sistema intenta enviar un documento antes de fallar. El valor predeterminado es 3.

    Intervalo de reintentos

    Cantidad de tiempo que la pasarela debe esperar entre reintentos. El valor predeterminado es 300 (5 minutos).

    Archivo de script

    Script de FTP que contiene los mandatos de FTP.

    IP de servidor

    Dirección IP del servidor

    Estado

    Indica si la pasarela está habilitada o inhabilitada. Si está inhabilitada, los documentos que pasen a través de la pasarela no se podrán procesar.

    URI de destino

    El identificador de recursos uniformes (URI) del participante.

    Número de hebras

    Número de documentos que se deben procesar simultáneamente.

    Transporte

    Protocolo para direccionar los documentos (consulte la sección Información necesaria para la configuración de la pasarela).

    Utilizar nombre de archivo exclusivo

    Crea un nombre de archivo exclusivo cuando el documento se recibe en la ubicación de destino. El nombre del archivo original se almacena en la base de datos.

    Atributos definidos por el usuario

    Para los archivos de FTP Scripting, los usuario pueden añadir sus propios atributos, que se pueden definir en la consola. Estos atributos se leen en la pasarela y se sustituyen en el archivo de script.

    ID de usuario

    Necesario para acceder al servidor FTP.

    Nombre de usuario

    El nombre de usuario del acceso seguro a través del cortafuegos del participante.

    Validar IP de cliente

    Valida la dirección IP del socio remitente antes de procesar el documento. Se utiliza con la pasarela que se selecciona como pasarela de origen para una conexión.

    Validar certificado SSL de cliente

    Valida el certificado digital del participante remitente comparándolo con el ID de empresa asociado con el documento antes de procesarlo. Se utiliza con la pasarela que se selecciona como pasarela de origen para una conexión.

Visualización y edición de pasarelas predeterminadas

Siga estos pasos para ver las pasarelas predeterminadas configuradas para el sistema y editarlas:

  1. Pulse Administración de cuentas > Perfiles > Pasarelas.
  2. Pulse Ver pasarelas predeterminadas en la esquina superior derecha de la ventana. La consola muestra una lista de todos los tipos de pasarela con la pasarela asociada.
  3. Para ver la información asociada con una pasarela predeterminada, pulse el icono Ver detalles junto a la pasarela.
  4. Edite la información que desee y pulse Guardar.

Supresión de configuraciones de pasarela

Si ya no necesita una configuración de pasarela, utilice el siguiente procedimiento para suprimirla. No aparece ningún mensaje de precaución antes de suprimir la configuración de pasarela. Por lo tanto, asegúrese de que no necesita la configuración de pasarela antes de suprimirla.

  1. Pulse Administración de cuentas > Perfiles > Pasarelas.
  2. Pulse el icono Ver detalles junto a la pasarela que desea suprimir.
  3. Pulse el icono Editar.
  4. Pulse Suprimir.

Subida de transportes

Utilice el siguiente procedimiento para subir un transporte.

  1. Pulse Administración de cuentas > Perfiles > Pasarelas.
  2. Seleccione Gestionar tipos de transporte.
  3. Pulse Examinar y seleccione el transporte.
  4. Seleccione si se debe confirmar o no el nuevo transporte con la base de datos.
  5. Seleccione si se deben sobreescribir o no la fecha existente.
  6. Pulse Subir.

Supresión de transportes

Si ya no necesita un transporte, utilice el siguiente procedimiento para suprimirlo.

  1. Pulse Administración de cuentas > Perfiles > Pasarelas.
  2. Seleccione Gestionar tipos de transporte.
  3. Pulse el icono Suprimir junto al transporte listado.

Reintentos de transporte y pasarela

Cuando no se puede entregar un documento a una pasarela de participante, WebSphere Partner Gateway intenta volver a entregarlo. Cada intento se denomina reintento. La funcionalidad de reintentos existe en dos niveles en WebSphere Partner Gateway: transporte y pasarela.

Reintentos de transporte

Los reintentos de transporte son reintentos de bajo nivel incorporados que se aplican siempre, independientemente de la especificación de la pasarela. La motivación de los reintentos de bajo nivel es que las anomalías transitorias son inherentes de las redes en las que se intenta la entrega, en concreto de Internet. Por lo tanto, el sistema de entrega está diseñado para ejecutar reintentos automáticos, sin necesidad de que el usuario defina explícitamente los parámetros de reintento. El número de reintentos de transporte (bcg.delivery.gwTransportMaxRetries) y el intervalo de tiempo entre los reintentos (bcg.delivery.gwTransportRetryInterval) se definen en el archivo bcg.properties del gestor de documentos y se aplican a todas las pasarelas. Los valores predeterminados son tres reintentos a intervalos de tres segundos.

Reintentos de pasarela (también denominados reintentos de documento)

El usuario configura los parámetros de reintento de pasarela (el número de reintentos permitidos y el intervalo entre reintentos) en las propiedades de la pasarela. Normalmente, el intervalo de reintentos de la pasarela es más largo que el de los reintentos de transporte incorporados. El objetivo es permitir que haya tiempo suficiente para que el usuario corrija el problema que impide la entrega. Por ejemplo, puede que el servidor web de destino esté apagado, o que el URL de destino no sea el correcto. Para el establecimiento de los valores del parámetro es necesario que el usuario asigne valores para cada pasarela.

Para cada reintento de pasarela (definido por el usuario), WebSphere Partner Gateway realizará automáticamente los reintentos de transporte. Por ejemplo, si se han especificado tres reintentos de pasarela, el patrón de reintentos del sistema será:

Todo intento de entrega fallido genera un suceso de aviso visible en la Consola de comunidad.

Soporte de proxy de avance

En los transportes HTTP y HTTPS, puede configurar el soporte de proxy de avance de modo que los documentos se envíen a través de un servidor proxy configurado. Con WebSphere Partner Gateway, puede configurar los siguientes tipos de soporte:

Después de configurar un proxy de avance, puede hacer que sea global para el transporte convirtiéndolo en la pasarela de proxy de avance predeterminada (por ejemplo, que todas las pasarelas HTTP hagan uso del proxy de avance). Para cada pasarela individual puede elegir que no utilice el servidor proxy de avance predeterminado o puede seleccionar que utilice otro servidor proxy de avance. Consulte la Guía de configuración del concentrador para obtener más información sobre el soporte de proxy de avance.

Copyright IBM Corp. 2003, 2005