HTTP Proxies in Alumio

Table Of Contents

  • Introduction
  • Creating and maintaining HTTP proxies
  • Using an HTTP proxy
  • Video guide

Introduction

HTTP Proxies enable external applications to request data from another system through Alumio in real-time. An HTTP proxy configuration enables an API endpoint for another application to connect to.

HTTP Proxies can be created and maintained by navigating to Connections → HTTP Proxies.

Creating and maintaining HTTP proxies

Possible configuration fields:

  • Name - A name describing the operation this configuration performs, i.e. ERP Order Simulation
  • Identifier - A unique identifier for this HTTP proxy (this field is automatically generated based on the name).
  • Description - Detailed description for the HTTP proxy.
  • Disabled - A flag that indicates whether the HTTP proxy configuration is disabled. Disabled HTTP proxy configurations do not process data.
  • Request URI - The URL of the system where the request needs to be forwarded. Depending on the selected HTTP client this may contain a full URL or an endpoint.
  • Request Method - The request method used for the forwarded request.
  • Forward Method - A flag that indicates whether the request method used by the consumer should be used instead of the value defined in the Request Method field.
  • HTTP Client - The HTTP client used to forward the request. Required when the external system requires additional authorization which is not provided by the consumer.
  • Body deserializer -
  • Matcher - The matcher may be used to validate the request is coming from a legitimate source. An example would be a custom header with a common secret, used by both parties to validate the legitimacy of a request.
  • Processors to apply on the request before forwarding it - These processors enable functionality to be run before the request is forwarded.
    • Headers - Remove - Remove any headers sent by the consumer.
    • Headers - Remove all except given - Remove all headers except the ones defined sent by the consumer.
    • Headers - Set - Set headers that need to be forwarded to the endpoint. You can also use placeholder “&{name}” in headers for this option.
    • Transform request data - Execute transformers on the incoming data. They may also be used to set fields required by the endpoint but not provided by the consumer.
  • Processors to apply on the response -
    • Headers - Remove - Remove any headers sent by the endpoint.
    • Headers - Remove all except given - Remove all headers except the ones defined sent by the endpoint.
    • Headers - Set - Set headers that need to be returned to the consumer.
    • Transform response data - Execute transformers on the outgoing data. They may also be used to set fields required by the consumer but not provided by the endpoint.

On the right side of the page, you can see the Configuration tester. It is intended for use when there is a need to test a configuration and see how it works first before saving HTTP Proxy and using it for other connections.

Configuration fields are divided into two tabs:

  • Input
    • “Make a real request checkmark” is used when you want to test a real request.
    • Request Method - selection of any of the existent request methods in the dropdown.
    • URI - link to where the system will be forwarded to request data.
    • Headers - headers and values that will be shown from the request.
    • Protocol - the HTTP protocol that is used.
  • Response
    • View logs - results shown once the test has been performed.

Besides, there are two buttons above the tabs, allowing you to start running the Configuration tester and save the example or/and results:

  • Run test - execution of the test settings.
  • Save test - saving test settings for the corresponding HTTP Proxy.

Note: Please be aware that the “Save test” and “Saved” buttons are not the same! The “Save test” button allows to save predefined settings in the Configuration tester. The “Saved” button allows to save only the HTTP Proxy part of the page. To save the HTTP Proxy settings and the Configuration tester details, use both buttons before setup finishing.

Using an HTTP proxy

To make use of an HTTP proxy you need to share your Alumio environment’s HTTP proxy base URL, as well as the relevant identifier. Depending on the settings of your HTTP proxy you may also need to share any request validators.

The HTTP proxy base URL can be found on the Info page under Settings → Info.

Note 2: A rate limitation for HTTP Proxies to avoid any server issues has been set to 1000 requests per 10 seconds for all domains that are proxied on Cloudflare.

Video guide