# Send data using TCP

{% hint style="info" %}
See the changelog of this Data sink type [here](https://app.gitbook.com/s/zgCDPkYt2378cQelEdK8/tcp-data-sink).
{% endhint %}

## Overview

Onum supports integration with [TCP](https://en.wikipedia.org/wiki/Transmission_Control_Protocol).

TCP (Transmission Control Protocol) is a core protocol of the Internet Protocol Suite. It ensures reliable, ordered, and error-checked data delivery between applications running on hosts in a network. 

## Onum Setup

{% stepper %}
{% step %}
Log in to your Onum tenant and click **Data Sinks> New Data sink**.
{% endstep %}

{% step %}
Double-click the **TCP** Sink.
{% endstep %}

{% step %}
Enter a **Name** for the new Data Sink. Optionally, add a **Description** and some **Tags** to identify the Sink.
{% endstep %}

{% step %}
Decide whether or not to include this Data sink info in the metrics and graphs of the [**Home**](https://docs.onum.com/the-workspace/home) area.

<figure><picture><source srcset="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2FnX1FnJmoz0haXBqzN4aG%2Ffadx.png?alt=media&#x26;token=acc9da4f-0ea5-415a-895d-13ee92e13a11" media="(prefers-color-scheme: dark)"><img src="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2Fo959yayUuruwU1Zh9LJZ%2Fimage.png?alt=media&#x26;token=99f3a353-5110-4e79-b20c-1ae504a9c6f5" alt=""></picture><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Enter the **Host**<mark style="color:red;">**\***</mark> IP address or hostname. Use `0.0.0.0` to indicate all and the IP **Port**<mark style="color:red;">**\***</mark> number.
{% endstep %}

{% step %}
Choose **Gzip** if you need to compress your events using this method or **None** to send them as they come.
{% endstep %}

{% step %}
Activate the **TLS configuration** toggle if you want to set a TLS connection. Configure the following parameters:

* **Minimum TLS version**<mark style="color:red;">**\***</mark> - Choose the minimum TLS version required for incoming connections.
* **Certificate**<mark style="color:red;">**\***</mark> - Select your CA certificate from the list of your tenant's [Secrets](https://docs.onum.com/administration/global-settings/organization-settings/secrets-management) or create a new one.
* **Private key**<mark style="color:red;">**\***</mark> - Select your private key from the list of your tenant's [Secrets](https://docs.onum.com/administration/global-settings/organization-settings/secrets-management) or create a new one.

By default, the **Skip TLS validations** toggle is activated. Deactivate it to configure the following:

* **CA chain**<mark style="color:red;">**\***</mark> - CA chain used by the Data sink to verify client certificates. Choose it from the list of your tenant's [Secrets](https://docs.onum.com/administration/global-settings/organization-settings/secrets-management) or create a new one.
* **Subject Alternative Name** - Optionally, enter a Subject Alternative Name (SAN) for your TLS connection.
  {% endstep %}

{% step %}
In the [Secrets](https://docs.onum.com/administration/global-settings/organization-settings/secrets-management) area, **New secret** to create a new one:

* Give the secret a **Name**.
* Turn off the **Expiration date** option.
* Click **Add new value** and paste the corresponding value.
* Click **Save**.

<figure><picture><source srcset="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2FlUo7CuVpPgIVm5VNjLw6%2Fnenenew.png?alt=media&#x26;token=eb7a7231-0ac2-4099-93f9-18f9ead5add1" media="(prefers-color-scheme: dark)"><img src="https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2FTSD53FxGQOjijA3W3DhE%2Fimage.png?alt=media&#x26;token=9941a3c0-100a-4759-b603-30079fbc90de" alt=""></picture><figcaption></figcaption></figure>

{% hint style="info" %}
Learn more about secrets in Onum in [this article](https://docs.onum.com/administration/global-settings/organization-settings/secrets-management).
{% endhint %}

You can now select the created secrets in the configuration.
{% endstep %}
{% endstepper %}

Click **Finish** when complete. Your new Data sink will appear in the **Data sinks** area list.

## Pipeline configuration <a href="#pipeline-configuration" id="pipeline-configuration"></a>

When it comes to using this Data sink in a [Pipeline](https://docs.onum.com/the-workspace/pipelines), you must configure the following output parameters. To do it, simply click the Data sink on the canvas and select **Configuration**.

### Output configuration <a href="#output-configuration" id="output-configuration"></a>

<table><thead><tr><th width="169.796875">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Event field</strong><mark style="color:red;"><strong>*</strong></mark></td><td>Select the incoming field containing the message to send on.</td></tr></tbody></table>

Click **Save** to save your configuration.