Saltar al contenido

Conexión HTTP

Introducción

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

Nota

Este conector soporta la Política de Re-autenticación al Cambiar política de organización. Si está habilitada, un cambio en la URL Base o 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. Aprende más sobre los beneficios del conector HTTP v2 en nuestro artículo de blog sobre HTTP v2 o consulta una comparación de las características de los conectores HTTP y HTTP v2.

La intención a largo plazo de Jitterbit es descontinuar el conector HTTP, lo cual se anunciará de acuerdo con la política de fin de vida de Jitterbit. En la actualidad, no hay un cronograma para la descontinuación y el conector HTTP sigue siendo totalmente soportado. Recomendamos que conviertas 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:

Una conexión HTTP existente se puede editar desde las siguientes ubicaciones:

Configurar una conexión HTTP

Cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión HTTP se describe a continuación.

Consejo

Los campos con un ícono de variable admiten el uso de variables globales, variables del proyecto y variables de Jitterbit. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú que enumera las variables existentes de 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 (/) ni dos puntos (:). Este nombre también se utiliza para identificar el punto final HTTP, que se refiere 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 cifrado SSL, simplemente use https:// en la URL. No incluya ningún parámetro de consulta o rutas a menos que se utilicen 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 es aplicable, ingrese un nombre de usuario y una contraseña que permitirán el acceso al servidor HTTP. Puede dejar estos campos en blanco para la autenticación anónima si no se requiere un nombre de usuario o contraseña.

  • Certificado: Utilice el menú para seleccionar un certificado disponible para autenticarse con el servidor HTTP. Puede gestionar los certificados SSL del lado del cliente desde la Consola de Administración en Personalizaciones > Certificados de Cliente.

  • Reintentar: Funcional solo cuando se utiliza un entorno asociado con un grupo de agentes privados, esta configuración se utiliza para reintentar una solicitud cuando un punto final HTTP devuelve uno de estos códigos de estado: 500, 502, 503 o 504.

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

    Nota

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

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

    • Intervalo de Reintentos (Segundos): Ingrese el número de segundos (máximo de 5 segundos) que se debe esperar antes de reenviar una solicitud al punto final HTTP.

    • Máx. Reintentos: Ingrese el número máximo de veces (se recomienda no más de 5 veces) para reintentar enviar una solicitud al punto final HTTP. Si la solicitud sigue fallando después del número máximo de reintentos, se devolverá una excepción con un mensaje de error en el registro de operaciones. Además, el agente privado registrará cada reintento en el archivo de registro jitterbit.log.

      Cada reintento se considera parte de la misma ejecución de operación, donde solo aparece un único registro en el registro de operaciones. Cualquier acción de operación configurada para ejecutar operaciones posteriores se activa en función del estado final de la operación después de reintentar hasta el número máximo de reintentos.

  • Configuraciones Opcionales: Haz clic para expandir configuraciones opcionales adicionales.

    • Opción de Seguridad: Si es aplicable, selecciona Usar Autenticación HTTP Básica para autenticarte con el host utilizando autenticación HTTP básica sin cifrado SSL. Ten en cuenta que si se utiliza esta opción, la contraseña proporcionada se envía en texto claro. (A menos que sea necesario, no se recomienda esto.)

      Si no se utiliza esta opción, por defecto Harmony negocia con el endpoint para determinar qué métodos de autenticación son compatibles y utiliza las credenciales proporcionadas contra uno de los protocolos. Además de HTTP Básico, Harmony admite estas opciones de autenticación HTTP:

      • Digest HTTP

      • Digest HTTP con autenticación con un sabor de IE

    • Ignorar Líneas: Si hay encabezados y/o pies de página en los datos de origen que deseas ignorar, ingresa el número de líneas a ignorar en los campos Primero y Último.

      Nota

      Esta configuración no tiene efecto cuando las actividades HTTP son referenciadas desde un script utilizando las funciones ReadFile o WriteFile.

    • Configuraciones de Proxy: Si deseas especificar un proxy personalizado, utiliza el menú desplegable para seleccionar una de estas opciones:

      • Predeterminado: Las configuraciones de proxy están habilitadas, utilizando la configuración de proxy del agente privado si existe. Si las configuraciones de proxy no están especificadas en la configuración del agente, entonces la configuración Predeterminado tiene el mismo resultado que la configuración Deshabilitar.

      • Deshabilitar: Las configuraciones de proxy están deshabilitadas para esta conexión específica, eludiendo la configuración de proxy del agente privado si existe.

      • Personalizado: Las configuraciones de proxy están habilitadas para esta conexión específica utilizando la información personalizada proporcionada aquí. Esta opción elude la configuración de proxy del agente privado si existe, y en su lugar utiliza información de proxy personalizada. Cuando se selecciona Personalizado, se vuelven disponibles campos adicionales para que los configures. Para detalles sobre estos campos, consulta Habilitar proxy para agentes privados.

        Nota

        Los campos adicionales con un ícono de variable admiten variables con 10.66 agentes y versiones posteriores.

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

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

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

      • Habilitar Codificación de Transferencia en Fragmentos: 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 está enviando grandes cantidades de datos pero no desea utilizar la codificación de transferencia en fragmentos.

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

      • Codificación de Aceptación HTTP Gzip: Seleccionado por defecto, esta opción indica al servidor HTTP que Harmony puede aceptar una respuesta comprimida en Gzip. A cambio, Harmony sigue el estándar RFC 1952 y descomprime automáticamente las respuestas HTTP en Gzip. Si el servidor no utiliza Gzip, Harmony observa que la respuesta no está comprimida y la maneja como de costumbre.

      • Solo Aplicable Cuando se Utiliza HTTPS: Utilice el menú para cambiar la selección de Negociar (predeterminado) a una versión específica de SSL o TLS si es necesario, seleccionando entre SSLv3, TLSv1.0, TLSv1.1, TLSv1.2 o TLSv1.X. Seleccione TLSv1.X si se requiere TLS 1.3.

  • 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 de proyecto y variables de Jitterbit reemplazando las variables entre corchetes [ ] con sus valores.

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

  • Guardar Cambios: Haga 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, haga clic para cerrar la configuración sin guardar. Un mensaje le pide que confirme que desea descartar los cambios.

  • Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte Dependencias de componentes, eliminación y remoción). Un mensaje le pide que confirme que desea eliminar la conexión.

Próximos pasos

Después de que se ha creado una conexión HTTP, se coloca un tipo de actividad en el lienzo 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).

Las acciones del menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulte Menús de acciones en Conceptos básicos del conector.

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

  • PUT: Reemplaza un recurso existente en un servicio accesible a través del protocolo HTTP o HTTPS y puede ser utilizado como fuente o destino en una operación.

  • POST: Crea un nuevo recurso en un servicio accesible a través del protocolo HTTP o HTTPS y puede ser utilizado como fuente o destino en una operación.

  • DELETE: Elimina un recurso en un servicio accesible a través del protocolo HTTP o HTTPS y puede ser utilizado como fuente o destino en una operación.

  • Custom: Realiza un método HTTP especificado en un servicio accesible a través del protocolo HTTP o HTTPS y puede ser utilizado como fuente o destino en una operación.