Conexión HTTP V2¶

Introducción¶

Una conexión HTTP v2, creada utilizando el conector HTTP v2, 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 v2 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).

Crear o Editar una Conexión HTTP V2¶

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

• La pestaña Conexiones de la paleta de componentes de diseño (consulte Paleta de Componentes de Diseño).
• La página Conexiones globales (vea Crear una conexión global en Conexiones globales).

Una conexión HTTP v2 existente se puede editar desde estas ubicaciones:

• La pestaña Conexiones de la paleta de componentes de diseño (consulte Paleta de Componentes de Diseño).
• La pestaña Componentes del panel del proyecto (consulte Menú de acciones de componentes en Pestaña Componentes del panel de proyecto).
• La página Conexiones globales (vea Editar una conexión global en Conexiones globales).

Configurar una Conexión HTTP V2¶

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

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

• URL base: Ingrese la URL base. La URL base se utiliza para probar la conexión. El uso de este campo en tiempo de ejecución depende de si el campo URL de actividad HTTP de una actividad HTTP v2 está completo:

  • Si se proporciona una URL parcial o ninguna URL en el campo URL de actividad HTTP, la URL utilizada en tiempo de ejecución se concatena desde la URL base y la URL de actividad HTTP.

  • Si se proporciona una URL completa en el campo URL de actividad HTTP, entonces la URL base no se utiliza en tiempo de ejecución.

• Autorización: Utilice el menú para seleccionar el tipo de autorización, que se resume a continuación. La configuración de cada tipo de autorización se describe en Tipos de autorización de conexión HTTP v2.

  • Clave API: Especifique un par clave-valor de API para enviar encabezados o parámetros de consultar.

  • Firma de AWS: Especifique un ID de clave de acceso de AWS, una clave de acceso secreta, una región, un servicio y un token de sesión para enviar mediante la firma de Amazon Web Services (AWS) versión 2 en encabezados o parámetros de consultar.

  • Autenticación básica: Especifique un nombre de usuario y contraseña para enviar los encabezados.

  • Ficha al portador: Especifique un token de portador para enviar encabezados.

  • Autenticación resumida: Especifique un nombre de usuario, contraseña, dominio, nonce, algoritmo, QOP, recuento de nonce, nonce de cliente y opaco para enviar los encabezados.

  • Autenticación de Halcón: Especifique un ID de autenticación de Hawk, una clave de autenticación, información específica de la aplicación, un ID de aplicación y DLG para enviar los encabezados.

  • Sin autenticación: Seleccione para acceder al servicio de forma anónima y sin autorización.

  • OAuth 2.0: Especifique el tipo de concesión y proporcione el extremo del token de OAuth, el ID del cliente, el secreto del cliente y el alcance para enviar los encabezados o el cuerpo de la solicitud.

• Reintentar: Funciona 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 v2 devuelve uno de estos códigos de estado: 500, 502, 503, o 504.

  Esta configuración entra en vigor cuando se usa con Agentes Privados versión 10.34 o posterior.

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

  

  • Intervalo de reintento (segundos): Ingrese la cantidad de segundos (máximo de 5 segundos) que se deben esperar entre el reenvío de una solicitud al extremo HTTP v2.

  • Reintentos máximos: Ingrese el número máximo de reintentos (máximo de 5 reintentos) que una solicitud se reenviará al extremo HTTP v2. Si la solicitud aún falla después del número máximo 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 operación, donde solo aparece un registro en el registro de operación. Cualquier acción operación configurada para ejecutar operaciones abajo en la cadena se activa según el estado final de la operación después de reintentar hasta el número máximo de reintentos.

• Configuraciones opcionales: Haga clic para expandir configuraciones opcionales adicionales:

  

  • Configuración de proxy: Utilice el menú para seleccionar la configuración de proxy, una de estas opciones:

    • Personalizado: La configuración de proxy se habilita utilizando las entradas especificadas en los campos adicionales que están disponibles cuando se selecciona esta opción. Esta opción omite la configuración del proxy del Agente Privado si existe.

      

      • Host: Introduzca el nombre de alojar del servidor proxy HTTP.
      • Puerto: Introduzca el puerto del servidor proxy HTTP.
      • Usuario: Introduzca el nombre de usuario para la autenticación del servidor proxy HTTP.
      • Contraseña: Introduzca la contraseña para la autenticación del servidor proxy HTTP.
      • Dominio NTLM: Ingrese el dominio NTLM para la autenticación del servidor proxy HTTP.
      • Permitir certificados no verificados utilizados por proxy: Seleccione para permitir que el servidor proxy HTTP utilice certificados no verificados.

    • Predeterminado: La configuración del proxy está habilitada mediante la Configuración del proxy del Agente Privado si existe. Si la configuración del proxy no se especifica en la configuración del agente, entonces la configuración Predeterminada tiene el mismo resultado que la configuración Desactivar.

    • Desactivar: La configuración del proxy está desactivada, sin pasar por la configuración del proxy del Agente Privado si existe.

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

    • Tipo de contenido: Ingrese el tipo de contenido de la estructura de solicitud que espera la API en particular. Por ejemplo, text/plain, application/json, application/x-www-form-urlencoded, etc. Si el método que se utiliza no acepta datos estructurados, o si la API no requiere que se especifique el tipo de contenido, deje este campo en blanco. Este campo no se ve afectado por la configuración Enviar encabezados de solicitud en ejecución de actividad.

      Alternativamente, el tipo de contenido se puede especificar en otros campos de configuración de la interfaz de usuario o proporcionarse en la transformación de la solicitud. Si el tipo de contenido se especifica en varios lugares, se sigue este orden de prioridad:

      1. Un Content-Type El encabezado proporcionado en la tabla Configuraciones adicionales de una actividad HTTP v2 anula todos los campos siguientes.
      2. El bodyContentType El campo especificado en una transformación de solicitud anula los campos restantes a continuación.
      3. Un Content-Type encabezado proporcionado en la transformación de la solicitud headers El nodo anula los campos restantes a continuación.
      4. Un Content-Type El encabezado proporcionado en el campo Encabezados de solicitud de una actividad HTTP v2 anula el campo restante a continuación.
      5. Un Content-Type El encabezado proporcionado en el campo Encabezados de solicitud de una conexión HTTP v2, si Enviar encabezados de solicitud en ejecución de actividad está habilitado, tiene la menor prioridad.

      Nota

      Si un encabezado se define en varias ubicaciones, cada instancia del encabezado se agregará a la solicitud de una actividad siguiendo el orden de precedencia anterior. Este orden se basa en cómo los servicios suelen manejar los encabezados duplicados en una solicitud.

    • Habilitar codificación de contenido: Seleccione para enviar el Accept-Encoding encabezado con codificación Gzip. Este campo no se ve afectado por la configuración Enviar encabezados de solicitud en ejecución de actividad.

      Alternativamente, este encabezado se puede definir en otros campos de configuración de la interfaz de usuario o proporcionarse en la transformación de la solicitud. Si este encabezado se especifica en varios lugares, se sigue este orden de prioridad:

      1. Un Accept-Encoding encabezado proporcionado en la transformación de la solicitud headers El nodo anula todos los campos siguientes.
      2. Un Accept-Encoding El encabezado proporcionado en el campo Encabezados de solicitud de una actividad HTTP v2 anula el campo restante a continuación.
      3. Un Accept-Encoding El encabezado proporcionado en el campo Encabezados de solicitud de una conexión HTTP v2, si Enviar encabezados de solicitud en ejecución de actividad está habilitado, tiene la menor prioridad.

      Nota

      Si un encabezado se define en varias ubicaciones, cada instancia del encabezado se agregará a la solicitud de una actividad siguiendo el orden de precedencia anterior. Este orden se basa en cómo los servicios suelen manejar los encabezados duplicados en una solicitud.

    • Habilitar codificación de transferencia fragmentada: Seleccione para enviar el Transfer-Encoding: chunked encabezado. Utilice esta opción si está transfiriendo grandes conjuntos de datos. Este campo no se ve afectado por la configuración Enviar encabezados de solicitud en ejecución de actividad.

      Alternativamente, este encabezado se puede definir en otros campos de configuración de la interfaz de usuario o proporcionarse en la transformación de la solicitud. Si este encabezado se especifica en varios lugares, se sigue este orden de prioridad:

      1. Un Transfer-Encoding encabezado proporcionado en la transformación de la solicitud headers El nodo anula todos los campos siguientes.
      2. Un Transfer-Encoding El encabezado proporcionado en el campo Encabezados de solicitud de una actividad HTTP v2 anula el campo restante a continuación.
      3. Un Transfer-Encoding El encabezado proporcionado en el campo Encabezados de solicitud de una conexión HTTP v2, si Enviar encabezados de solicitud en ejecución de actividad está habilitado, tiene la menor prioridad.

      Nota

      Si un encabezado se define en varias ubicaciones, cada instancia del encabezado se agregará a la solicitud de una actividad siguiendo el orden de precedencia anterior. Este orden se basa en cómo los servicios suelen manejar los encabezados duplicados en una solicitud.

    • Permitir cifrados débiles: Esta opción no funciona actualmente.

    • Keep Alive: Seleccione para permitir que una única conexión TCP permanezca abierta para múltiples solicitudes y respuestas HTTP.

    • Solo aplicable cuando se usa HTTPS: Use el menú para cambiar la selección de Negociar (predeterminado) a una versión TLS específica si el servicio lo requiere, seleccionando entre TLS 1.0, TLS 1.1, TLS 1.2 o TLS 1.3.

    • Encabezados de solicitud: Defina encabezados HTTP para la conexión. Haga clic en el ícono Agregar para agregar un encabezado a la siguiente tabla e ingresar un par clave-valor para cada parámetro de solicitud.

      Para guardar la fila, haga clic en el icono de enviar en la columna de la derecha.

      Para editar o eliminar una sola fila, coloque el cursor sobre la columna de la derecha y use el ícono de edición o eliminar icono .

      Para eliminar todas las filas, haga clic en Borrar todo.

      Alternativamente, los encabezados se pueden definir en otros campos de configuración de la interfaz de usuario o proporcionarse en la transformación de la solicitud. Los encabezados que no comparten una clave se envían de forma acumulativa, independientemente de dónde se especifiquen.

      Si se especifica la misma clave de encabezado en varios lugares, se sigue este orden de precedencia:

      1. Un encabezado proporcionado en la transformación de la solicitud headers El nodo anula todos los campos siguientes.
      2. Un encabezado proporcionado en el campo Encabezados de solicitud de una actividad HTTP v2 anula el campo restante a continuación.
      3. Un encabezado proporcionado en el campo Encabezados de solicitud de una conexión HTTP v2 (este campo), si Enviar encabezados de solicitud en ejecución de actividad está habilitado, tiene la menor precedencia.

      Nota

      Si un encabezado se define en varias ubicaciones, cada instancia del encabezado se agregará a la solicitud de una actividad siguiendo el orden de precedencia anterior. Este orden se basa en cómo los servicios suelen manejar los encabezados duplicados en una solicitud.

      Importante

      Los campos de la tabla Encabezados de solicitud muestran el icono de variable sólo en modo de edición. Para que los valores de las variables de estos campos se completen en tiempo de ejecución, la versión del agente debe ser al menos 10.75 / 11.13.

    • Enviar encabezados de solicitud en ejecución de actividad: Seleccione para pasar los encabezados definidos en Encabezados de solicitud a actividades HTTP v2. Consulte los órdenes de precedencia anteriores para determinar cómo interactúan los encabezados definidos en una conexión HTTP v2 con los encabezados definidos en otras ubicaciones.

• Prueba: Haga clic para verificar la conexión enviando una solicitud HTTP GET utilizando la autorización configurada. Una prueba se considera exitosa si se devuelve cualquier código de estado HTTP 2xx. A 405 Method Not Allowed La respuesta también se considera exitosa. Cuando se prueba la conexión, los agentes del grupo de agentes asociado con el ambiente actual descargan la última versión del conector. Este conector admite la suspensión de la descarga de la última versión del conector mediante Desactivar actualización automática del conector política de la organización.

• Guardar cambios: Haga clic para guardar y cerrar la configuración de 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 eliminación). Un mensaje le pide que confirme que desea eliminar la conexión.

Próximos Pasos¶

Después de crear una conexión HTTP v2, coloca 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 de menú para una conexión y sus tipos de actividad desde el panel del 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.

Estos tipos de actividades están disponibles:

• PARCHE: Aplica modificaciones parciales a 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.

• CABEZA: Recupera la línea de estado y la sección de encabezado de un recurso en un servicio accesible a través del protocolo HTTP o HTTPS y se puede utilizar 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.

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

• OPCIONES: Recupera información sobre las opciones de comunicación para un recurso en un servicio accesible a través del protocolo HTTP o HTTPS y se puede utilizar 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.

• 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.