> For the complete documentation index, see [llms.txt](https://docs.onum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onum.com/listeners/listener-integrations/collect-data-from-zscaler.md).

# Collect data from Zscaler

{% hint style="info" %}
See the changelog of this Listener type [here](/listeners-changelog/zscaler-listener.md).
{% endhint %}

## Overview

Onum supports integration with [Zscaler](https://www.zscaler.com/).

Zscaler is a cloud-native security platform that sits between your users and the internet, SaaS applications, and internal systems.

{% hint style="warning" %}
Note that our **Zscaler** Listener is designed specifically for Zscaler Internet Access (ZIA) via Nanolog Streaming Service (NSS).
{% endhint %}

## Prerequisites

You must generate a JWT token in your Zscaler account, which will be needed on the Listener setup.

## Onum Setup

{% stepper %}
{% step %}
Log in to your Onum tenant and click **Listeners > New listener**.
{% endstep %}

{% step %}
Double-click the **Zscaler** Listener.
{% endstep %}

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

{% step %}
In the **Socket** section, enter the required **Port**.

{% hint style="warning" %}
Note that this section will not appear in Onum cloud deployments.
{% endhint %}
{% endstep %}

{% step %}
In the **Authentication** section, enter your Zscaler token. Open the **Select token** field and click **New secret** to create a new one:

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

{% hint style="info" %}
Learn more about secrets in Onum in [this article](/settings/organization-settings/secrets-management.md).
{% endhint %}

You can now select the secret you just created in the **Select token** field.
{% endstep %}

{% step %}
In the **Processing method** section, choose between **Delimiter** or **Stacked JSON**. If you choose **Delimiter**, enter the required characters in the **Custom delimiter** field that appears. The default value is `\n`.
{% endstep %}

{% step %}
In the **TLS configuration** section, enter the required certificates (**Certificate**, **Private key** and **CA chain**).

{% hint style="warning" %}
Note that this section will not appear in Onum cloud deployments.
{% endhint %}
{% endstep %}

{% step %}
Finally, click **Create labels**. Optionally, you can set labels to be used for internal Onum routing of data. By default, data will be set as **Unlabeled**.

{% hint style="info" %}
Learn more about labels in [this article](/listeners/labels.md).
{% endhint %}
{% endstep %}

{% step %}
Click **Create listener** when you're done.
{% endstep %}
{% endstepper %}

## Output Ports

The **Zscaler** Listener has two output ports:

* **Default port** - Events are sent through this port if no error occurs while processing them.
* **Error port** - Events are sent through this port if an error occurs while processing them.