---
title: "Generic HTTP"
url: "https://axoflow.com/docs/axoflow/data-sources/http/"
description: "Receive batches of log events that clients post over HTTP or HTTPS, and choose how AxoRouter splits the request body into messages."
last_modified: "2026-10-27T11:41:55+01:00"
---

> For the complete documentation index, see [llms.txt](https://axoflow.com/docs/axoflow/llms.txt).

# Generic HTTP

Receive batches of log events that clients post over HTTP or HTTPS, and choose how AxoRouter splits the request body into messages.

Generic HTTP connectors of AxoRouter can receive log events from any client that posts them over HTTP or HTTPS. Use this connector for senders that post logs over HTTP. If Axoflow has a vendor-specific solution to ingest data, for example the [Splunk HEC connector](https://axoflow.com/docs/axoflow/data-sources/splunk-hec/index.md), use that instead.

AxoRouter doesn’t parse the payload of the request: it splits the request body into messages according to the **Message mode** you select, and adds each message to the `log.body` field as a string. You can add parsing to the body using processing steps in [Flows](https://axoflow.com/docs/axoflow/data-management/index.md), for example, using [FilterX or Regex processing steps](https://axoflow.com/docs/axoflow/data-management/processing/index.md).

If every request of your clients carries a single JSON event, consider using a [Webhook](https://axoflow.com/docs/axoflow/data-sources/webhook/index.md) connector instead. Webhook connectors parse the JSON payload automatically, and can set message fields from the path of the request.

## Prerequisites

To receive data over HTTPS, you’ll need a key and a certificate that the connector shows to the clients.

If you want to enable TLS encryption for this connector to encrypt the communication with the sources, you’ll need to set appropriate keys and certificates.

**CAUTION:**

Copy the keys and certificates to AxoRouter before starting to configure the connector. Otherwise, you won’t be able to make configuration changes that require reloading the AxoRouter service, including starting log tapping or flow tapping.

Note the following points:

- Keys and certificates must be in PEM format.
- If the file contains a certificate chain, the file must begin with the certificate of the host, followed by the CA certificate that signed the certificate of the host, and any other signing CAs in order.
- If you manually copy these files to their place on the AxoRouter host, make the files readable by the `axorouter` service.
  - The recommended path for certificates is under `/etc/axorouter/user-config/` (for example, `/etc/axorouter/user-config/tls-key.pem`). (If you need to use a different path, you have to append an option like `-v /your/path:/your/path` to the `AXOROUTER_PODMAN_ARGS` variable of `/etc/axorouter/container.env`.)
  - When referring to the key or certificate when configuring the connector, use absolute paths (for example, `/etc/axorouter/user-config/tls-key.pem`).

## Add new Generic HTTP connector

To add a new connector to an AxoRouter host, complete the following steps:

1. Select **Routers > Connector Rules > Add Connector Rule**. (Alternatively, you can select **Add Connector > Add a connector rule** on the **Connectors** page of an AxoRouter host.)

   ![Connector rules list](https://axoflow.com/docs/axoflow/img/data-management/connector-rules/connector-rules-list_hu_6f335a0660dd40e6.webp)
2. Select **Generic HTTP**.
3. Configure the connector rule.

   1. Enter a name for the connector rule into the **Connector rule name** field.

      ![Generic connector rule parameters](https://axoflow.com/docs/axoflow/img/connector-rule-generic_hu_32a9c886e16162f3.webp)
   2. (Optional) Add labels to the connector rule. You will be able to use these labels in [Flow Processing steps](https://axoflow.com/docs/axoflow/data-management/processing/index.md), for example, in the **Query** field of **Select Messages** steps. For details about the message schema and the related connector-specific fields, see the [`meta.connector` object](https://axoflow.com/docs/axoflow/reference/message-schema/reference/index.md#meta.connector).
   3. Set the **Router selector** for the connector rule. The selector determines which AxoRouter instances will have a connector based on this connector rule.

      ![Router selectors](https://axoflow.com/docs/axoflow/img/data-management/connector-rules/connector-rules-router-selector_hu_4e7807cc9a0d1c54.webp)

      You can use any labels and metadata of the AxoRouter hosts in the Router selectors, for example, the hostname of the AxoRouter, or any [custom labels](https://axoflow.com/docs/axoflow/onboard-hosts/hosts/add-host-metadata/index.md).

      - If you leave the router selector empty, it matches every AxoRouter instance.
      - To select only a specific AxoRouter instance, set the `name` field to the name of the instance as selector. For example, `name = my-axorouter`.
      - If you set multiple fields in the selector, the selector will match only AxoRouter instances that match all elements of the selector. (There in an AND relationship between the fields.)
   4. (Optional) Enter a **Suffix** for the connector rule. AxoConsole uses the suffix in the name of the connector instances that it creates on the AxoRouter hosts. The name of the connector instance follows the `<name-of-AxoRouter>-<suffix>` schema. For example, if the name of a matching AxoRouter instance is `axorouter-1`, and the suffix of the rule is `custom`, the name of the connector on that AxoRouter is `axorouter-1-custom`.

      If the **Suffix** field is empty, AxoConsole uses the name of the connector rule instead. For example, if the name of the connector rule is `otlp-1`, the name of the connector is `axorouter-1-otlp-1`.
   5. (Optional) Enter a description for the rule.
   6. If needed, turn on the **Classify** and **Parse** steps in the **Preprocessing steps** section (they’re off by default), so AxoRouter automatically identifies and parses messages sent by [supported data sources](https://axoflow.com/docs/axoflow/data-sources/appliances/index.md). If your source is not listed, [contact us](https://axoflow.com/contact).

      Enabling these options processes all data received by the connectors created based on this connector rule. If you want to apply classification and parsing more selectively, you can use the **Classify** and **Parse** processing steps in your [**Flows**](https://axoflow.com/docs/axoflow/data-management/processing/index.md).

      Note that the **Parse** processing step requires **Classify** to be enabled. Parsing automatically parses the data from the content of the message, and replaces the message content (the `log.body` field in the internal message schema) with the structured information.
   7. (Optional) If needed, you can add other preprocessing steps to the connector rule. You can use the [same processing steps as in flows](https://axoflow.com/docs/axoflow/data-management/processing/index.md). These can be useful if you use a dedicated connector rule to fix or annotate data coming from some specific sources. To reuse the preprocessing steps in other connector rules or flows, select **Save as Custom Step**.
4. Set the **Port** number where the connector receives the requests, for example, `8080`.

   **CAUTION:**

   TCP and UDP port range 29500–29519 is reserved for AxoRouter’s internal listeners and cannot be used in connector rules.

   ![Connector-specific settings](https://axoflow.com/docs/axoflow/data-sources/http/connector-specific-settings_hu_d8b8c6c158e5cb88.webp)
5. (Optional) Enter an **Authorization token**. If you set it, the clients must send this token in the `Authorization` header of every request, and AxoRouter refuses the requests that don’t carry it. The token is compared verbatim against the whole Authorization header value, so for example if a client sends `Authorization: Bearer xyz`, the value of **Authorization token** must be `Bearer xyz`.
6. Select the **Message mode** that matches how your clients send the data. It determines how AxoRouter splits the body of a request into messages.

   - **Auto**: Detects a single JSON document, concatenated JSON objects, or line-separated records. This is the default value.
   - **JSON**: The body is a single JSON document, or a series of concatenated JSON objects.
   - **Line separated**: Every line of the body is a separate message.
   - **Single**: The whole body is a single message.
7. (Optional) To receive data over HTTPS, select **Enable TLS**, then set the certificate and the private key that AxoRouter shows to the clients.

   > **Note:**
   > These settings apply to every AxoRouter that matches the **Router selector** of the connector rule. If you paste values for the server certificate and server private key, every matching AxoRouter uses the same shared certificate, which is not recommended. Instead, use a separate certificate for each AxoRouter by setting the file path option, or create a separate connector rule for each AxoRouter.

   - **Server certificate**: The certificate that AxoRouter shows to the clients.

     - To provide the server certificate from the AxoConsole, select **Paste value** and paste the server certificate. AxoConsole will automatically deploy the server certificate to the related AxoRouters.
     - To provide the server certificate from a file, select **File path** and enter the path where the certificate file is located (for example, `/etc/axorouter/user-config/server-certificate.pem`). The path must be mounted into the container, `/etc/axorouter` is mounted by default. You must manually copy that file to its place on every affected AxoRouter, or you can use the configuration management system of your choice.
   - **Server private key**: The private key of the server certificate.

     - To provide the server private key from the AxoConsole, select **Paste value** and paste the server private key. AxoConsole will automatically deploy the server private key to the related AxoRouters.
     - To provide the server private key from a file, select **File path** and enter the path where the private key file is located (for example, `/etc/axorouter/user-config/server-private-key.pem`). The path must be mounted into the container, `/etc/axorouter` is mounted by default. You must manually copy that file to its place on every affected AxoRouter, or you can use the configuration management system of your choice.
8. (Optional) Select **More options** to change the [advanced options](https://axoflow.com/docs/axoflow/data-sources/http/index.md#advanced-options) of the connector.
9. Select **Add**.

   Axoflow automatically creates connectors on the AxoRouter hosts that match the **Router selector**.

   Make sure to enable the ports you’ve configured in the connector on the firewall of the AxoRouter host, and on other firewalls between the AxoRouter host and your data sources.
10. Send a test request to the connector.

    1. Open the **Overview** tab of the AxoRouter host where you’ve created the connector and check the IP address or FQDN of the host.
    2. Open a terminal on your computer and send a POST request to the port you’ve configured in the connector.

       ```shell
       curl -X POST -H 'Content-Type: application/json' --data '{"message": "sample generic http message"}' http://<router-IP-address>:<connector-port-number>/
       ```

       If you’ve set an **Authorization token**, send it in the `Authorization` header as well:

       ```shell
       curl -X POST -H 'Content-Type: application/json' -H 'Authorization: <your-token>' --data '{"message": "sample generic http message"}' http://<router-IP-address>:<connector-port-number>/
       ```

> **Note:**
> You can also use [Log tapping](https://axoflow.com/docs/axoflow/onboard-hosts/log-tapping/index.md) on the AxoRouter host to see the incoming messages.

## Advanced options

Select **More options** on the connector rule to set the following options.

- **Maximum connections**: The maximum number of connections that the connector accepts at the same time.
- **Maximum request size**: The maximum accepted size of a request body, in bytes. AxoRouter refuses the requests that are larger than this.

You can also adjust the flow-control related options.

- **Log window size**: The size (number of messages) of the initial window used in flow control. For details, see the [AxoSyslog documentation](https://axoflow.com/docs/axosyslog-core/chapter-sources/source-syslog/reference-source-syslog-chapter/#log-iw-size).

  If you change the value of **Log window size**, the change will affect only new connections, the **Log window size** of already established connections will not change. To apply the new **Log window size** value to every connection, [restart the `axorouter.service` service](https://axoflow.com/docs/axoflow/onboard-hosts/hosts/services/index.md#manage-service) on the **Services** page of the matching AxoRouters. A simple configuration reload is *NOT* sufficient.

  If the connector rule is receiving data using the UDP protocol, always [restart the `axorouter.service` service](https://axoflow.com/docs/axoflow/onboard-hosts/hosts/services/index.md#manage-service) on the **Services** page of the matching AxoRouters.

- **Log fetch limit**: The maximum number of messages fetched from a source during a single poll loop. For details, see the [AxoSyslog documentation](https://axoflow.com/docs/axosyslog-core/chapter-sources/source-syslog/reference-source-syslog-chapter/#log-fetch-limit).

## Metadata fields

The AxoRouter Generic HTTP connector adds the following fields to the `meta` variable:

| Analytics label | Message field | Value |
| --- | --- | --- |
| `connector.type` | [`meta.connector.type`](https://axoflow.com/docs/axoflow/reference/message-schema/reference/index.md#meta.connector.type) | `genericHttp` |
| `connector.name` | [`meta.connector.name`](https://axoflow.com/docs/axoflow/reference/message-schema/reference/index.md#meta.connector.name) | The **Name** of the connector |
| `connector.port` | [`meta.connector.port`](https://axoflow.com/docs/axoflow/reference/message-schema/reference/index.md#meta.connector.port) | The port number where the connector receives data |
| `connector.labels.product` | [`meta.connector.labels.product`](https://axoflow.com/docs/axoflow/reference/message-schema/reference/index.md#meta.connector.labels) | Default value: `generic-http` |
| `connector.labels.vendor` | [`meta.connector.labels.vendor`](https://axoflow.com/docs/axoflow/reference/message-schema/reference/index.md#meta.connector.labels) | Default value: `generic` |

You can use the labels as:

- labels in **Customize Graph** on the [Analytics page](https://axoflow.com/docs/axoflow/metrics/analytics/index.md),
- in the **Filter labels** field during [log tapping](https://axoflow.com/docs/axoflow/onboard-hosts/log-tapping/index.md).

You can use the message fields

- in [Flow Processing steps](https://axoflow.com/docs/axoflow/data-management/processing/index.md), for example, in the **Query** field of **Select Messages** steps,
- in AQL expressions in the search bars.