Saltar al contenido

Conexión HTTP

Introducción

Una conexión HTTP, creada mediante el conector HTTP, establece acceso a través del protocolo HTTP o HTTPS a un servicio como una API REST, una API GraphQL o un formulario web. Una vez configurada una conexión, puede crear instancias de actividades HTTP asociadas con esa conexión para usarlas como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Nota

Este conector admite la política de la organización Habilitar reautenticación en caso de cambio. Si está habilitado, un cambio en la URL base o el Nombre de usuario en esta conexión requiere que los usuarios vuelvan a ingresar la Contraseña para la conexión.

Importante

Con el lanzamiento del conector HTTP v2, recomendamos convertir las conexiones y actividades HTTP existentes a HTTP v2. Obtenga más información sobre los beneficios del conector HTTP v2 en nuestra publicación del blog sobre HTTP v2 o consulte una comparación de las características del conector HTTP y HTTP v2.

La intención a largo plazo de Jitterbit es descontinuar el conector HTTP, lo que se anunciará de acuerdo con la Política de fin de vida útil de Jitterbit. En la actualidad, no hay un cronograma para la descontinuación y el conector HTTP sigue siendo totalmente compatible. Le recomendamos que convierta las conexiones y actividades HTTP existentes a HTTP v2 cuando sea posible.

Crear o editar una conexión HTTP

Se crea una nueva conexión HTTP utilizando el conector HTTP desde una de estas ubicaciones:

Se puede editar una conexión HTTP existente desde estas ubicaciones:

Configurar una conexión HTTP

A continuación se describe cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión HTTP.

Configuración de la conexión HTTP

Sugerencia

Campos con un ícono de variable Ícono de variable admite el uso de variables globales, variables del proyecto y variables Jitterbit. Comience escribiendo un corchete abierto [ en el campo o haciendo clic en el icono de la variable para mostrar una lista de las variables existentes entre las que elegir.

  • Nombre de la conexión: Ingrese un nombre para identificar la conexión. El nombre debe ser único para cada conexión HTTP y no debe contener barras diagonales (/) o dos puntos (:) Este nombre también se utiliza para identificar el extremo HTTP, que hace referencia tanto a una conexión específica como a sus actividades.

  • URL base: Ingrese una URL base válida para la conexión. Para usar el cifrado SSL, simplemente use https:// en la URL. No incluya ningún parámetro de consultar ni ruta a menos que se vayan a utilizar para todas las actividades asociadas (podrá especificar rutas y parámetros únicos durante la configuración de la actividad). La URL final se concatenará a partir de la URL base proporcionada aquí junto con cualquier ruta especificada durante la configuración de la actividad.

  • Nombre de usuario y Contraseña: Si corresponde, ingrese un nombre de usuario y una contraseña que le permitirán acceder al servidor HTTP. Puede dejar estos campos en blanco para la autenticación anónima si no se requiere un nombre de usuario o una contraseña.

  • Certificado: Utilice el menú para seleccionar un certificado disponible para autenticarse con el servidor HTTP. Puede administrar los certificados SSL del lado del cliente desde la Management Console en Personalizaciones > Certificados de cliente.

  • Retry: Funcional solo cuando se usa un ambiente asociado con un grupo de agentes privados, esta configuración se usa para reintentar una solicitud cuando un extremo HTTP devuelve uno de estos códigos de estado: 500, 502, 503, o 504.

    Esta configuración entra en vigencia cuando se utiliza con agentes privados versión 10.22 o posterior.

    Nota

    Para los agentes privados de la versión 10.30 a la 10.33, RecoverableStatusCode La configuración y la lista de códigos de error se deben agregar manualmente al archivo de configuración del agente privado.

    Seleccione la casilla de verificación Reintentar para expandir opciones de configuración adicionales:

    Reintento de conexión HTTP

    • Intervalo de reintento (segundos): Ingrese la cantidad de segundos (máximo de 5 segundos) a esperar antes de volver a enviar una solicitud al extremo HTTP.

    • Máximo de reintentos: Ingrese la cantidad máxima de veces (se recomienda no más de 5 veces) que se debe volver a intentar enviar una solicitud al extremo HTTP. Si la solicitud aún falla después de la cantidad máxima de reintentos, se devolverá una excepción con un mensaje de error en el registro de operación. Además, el agente privado registrará cada reintento en el jitterbit.log archivo de registro.

      Cada reintento se trata como parte de la misma ejecución de la operación, donde solo aparece un único registro en el registro de operación. Cualquier acción de operación configurados para ejecutar operaciones abajo en la cadena se activan según el estado final de la operación después de volver a intentarlo hasta el número máximo de reintentos.

  • Configuración opcional: Haga clic para expandir configuraciones opcionales adicionales:

    Configuración opcional de conexión HTTP

    • Opción de seguridad: Si corresponde, seleccione Usar autenticación HTTP básica para autenticarse con el alojar mediante autenticación HTTP básica sin cifrado SSL. Tenga en cuenta que si se utiliza esta opción, la contraseña proporcionada se envía en texto sin formato. (A menos que sea necesario, esto no se recomienda).

      Si no se utiliza esta opción, Harmony negocia de forma predeterminada con el extremo para determinar qué métodos de autenticación son compatibles y utiliza las credenciales proporcionadas en uno de los protocolos. Además de HTTP Basic, Harmony admite estas opciones de autenticación HTTP:

      • Resumen HTTP

      • Resumen HTTP con autenticación con una versión de IE

    • Ignorar líneas: Si hay encabezados y/o pies de página en los datos de origen que desea que se ignoren, ingrese la cantidad de líneas a ignorar en los campos Primero y Último.

      Nota

      Esta configuración no tiene efecto cuando se hace referencia a actividades HTTP desde un secuencia de comandos que utiliza ReadFile o WriteFile funciones.

    • Configuración de proxy: Si desea especificar un proxy personalizado, use el menú desplegable para seleccionar una de estas opciones:

      • Predeterminado: La configuración de proxy está habilitada, usando la configuración de proxy de agente privado si existe. Si no se especifican los ajustes de proxy en la configuración del agente, el ajuste Predeterminado tiene el mismo resultado que el ajuste Deshabilitar.

      • Deshabilitar: Los ajustes de proxy están deshabilitados para esta conexión específica, sin pasar por la configuración de proxy de agente privado si existe.

      • Personalizado: La configuración de proxy se habilita para esta conexión específica utilizando la información personalizada proporcionada aquí. Esta opción omite la configuración de proxy de agente privado si existe uno y, en su lugar, utiliza información de proxy personalizada. Cuando se selecciona Personalizado, se encuentran disponibles campos adicionales para que los configure. Para obtener detalles sobre estos campos, consulte Habilitación de proxy para agentes privados.

        Nota

        Campos adicionales con un ícono de variable Ícono de variable admite variables con agentes 10.66 y posteriores.

    • Propiedades HTTP avanzadas: Si corresponde, configure estas opciones avanzadas:

      • Content-Type: Ingrese el tipo de contenido de la estructura de solicitud que espera la API en particular. Si el método que se utiliza no acepta datos estructurados o si la API no requiere que se especifique el tipo de contenido, puede dejar este campo en blanco. Algunos ejemplos de tipos de contenido incluyen text/plain, application/json, application/x-www-form-urlencoded, etc.

      • Habilitar codificación de contenido: Si se selecciona, el encabezado Accept-Encoding se envía con la codificación compatible con Harmony. Actualmente, se admite Gzip.

      • Habilitar codificación de transferencia fragmentada: Si se selecciona, se envía el encabezado Transfer-Encoding: chunked. Utilice esta opción si está transfiriendo grandes conjuntos de datos.

      • Enviar Expect 100-continue: Si se selecciona, se envía el encabezado Expect: 100-continue. Con esta opción, no se envían datos hasta que el servidor HTTP haya validado los encabezados. Utilice esta opción si va a enviar grandes cantidades de datos pero no desea utilizar la codificación de transferencia fragmentada.

      • Permitir cifrados débiles: Seleccione esta casilla de verificación para comunicarse con servidores HTTP que utilizan cifrados débiles (DES/3DES y RC4).

      • HTTP Accept Encoding Gzip: Seleccionada de forma predeterminada, esta opción le indica al servidor HTTP que Harmony puede aceptar una respuesta comprimida con Gzip. A cambio, Harmony sigue el estándar RFC 1952 y descomprime automáticamente las respuestas HTTP con Gzip. Si el servidor no usa Gzip, Harmony ve que la respuesta no está comprimida y la maneja como de costumbre.

        Nota

        Esta configuración no está relacionada con el conector Gzip.

      • Solo aplicable cuando se utiliza HTTPS: Use el menú desplegable para seleccionar una versión de SSL específica si el servidor HTTP lo requiere. El valor predeterminado es Negociar.

      • Encabezados de solicitud (una línea por encabezado): Cualquier texto ingresado en este cuadro se envía como un encabezado HTTP. Especifique cada encabezado en una línea a menos que el encabezado esté envuelto de acuerdo con el estándar HTTP. Este campo también admite el uso de variables globales, variables del proyecto y variables Jitterbit reemplazando las variables entre corchetes [ ]con sus valores.

  • Prueba: Haz clic para verificar la conexión enviando una solicitud HTTP GET sin autorización.

  • Guardar cambios: Haz clic para guardar y cerrar la configuración de la conexión.

  • Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haz clic para cerrar la configuración sin guardar. Un mensaje te pide que confirmes que quieres descartar los cambios.

  • Eliminar: Después de abrir una configuración de conexión existente, haz clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulta Dependencias de componentes, eliminación y remoción). Un mensaje te pedirá que confirmes que deseas eliminar la conexión.

Próximos pasos

Después de crear una conexión HTTP, coloque un tipo de actividad en el tela de diseño para crear instancias de actividad que se utilizarán como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Se puede acceder a las acciones del menú de una conexión y sus tipos de actividad desde el panel de proyecto y la paleta de componentes de diseño. Para obtener más información, consulte Menús de acciones en Conceptos básicos del conector.

  • CONSEGUIR: Recupera información sobre un recurso en un servicio accesible a través del protocolo HTTP o HTTPS y puede usarse como origen o destino en una operación.

  • PONER: Reemplaza un recurso existente en un servicio accesible a través del protocolo HTTP o HTTPS y puede usarse como origen o destino en una operación.

  • CORREO: Crea un nuevo recurso en un servicio accesible a través del protocolo HTTP o HTTPS y puede usarse como origen o destino en una operación.

  • BORRAR: Elimina un recurso en un servicio accesible a través del protocolo HTTP o HTTPS y puede usarse como origen o destino en una operación.

  • Costumbre: Ejecuta un método HTTP especificado en un servicio accesible a través del protocolo HTTP o HTTPS y puede usarse como origen o destino en una operación.