> For the complete documentation index, see [llms.txt](https://docs.dropzone.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dropzone.ai/integrations/data/zscaler_data.md).

# ZScaler (Beta)

{% hint style="warning" %}
This is integration is currently in Beta. At this point in its development, any attempts to integrate with it will return a success, regardless of whether the information entered is accurate or not. For more information about our beta integrations, engage your Dropzone support representative.
{% endhint %}

The Dropzone platform integrates with [ZScaler](https://www.zscaler.com/company/about-zscaler), a cloud-based security platform offering services such as cloud firewalls, data loss prevention, zero trust network access (ZTNA), and automated threat inspections.

## Create an API Client

ZScaler requires API credentials to enable.

To obtain API credentials, do the following:

* Navigate to Administration > API Configuration > OneAPI > API Clients
* Click "Add API Client"

<figure><img src="/files/27c0Ev61pjcHNN7lJLOA" alt=""><figcaption><p>The API Clients page</p></figcaption></figure>

* Name the key something memorable, such as "Dropzone AI"
* Click the box under "Status" to enable the API Client
* Select an expiration period for the access token

<figure><img src="/files/YDoot9YmUz0ez8YDrKhD" alt=""><figcaption><p>Assign the client details</p></figcaption></figure>

* Under the Client Authentication header, select the "Secret" validation type
* Click "Add"
* Assign the secret an expiration date

{% hint style="info" %}
To reduce the number of times you need to perform this integration, we recommend selecting the maximum duration of 365 days.
{% endhint %}

* Copy the secret shown for use later in the Dropzone UI, where it is called "Client Secret"

<figure><img src="/files/RLMGiSCHCzWWWDwyUloj" alt=""><figcaption><p>Copy the API Key details</p></figcaption></figure>

* Click "Save"
* In the API Clients page, copy the Client ID of your new token for use later in the Dropzone UI, where it is called "Client ID"

<figure><img src="/files/FpToTqcNi5Tqhmhop6w1" alt=""><figcaption><p>The API Clients page</p></figcaption></figure>

Once your API Client has been generated, you must also authenticate your API Client in ZScaler's OneAPI, to verify your client's identity. To do so, enter the following code into your request payload:

```
POST /oauth2/v1/token HTTP/1.1
Host: <vanity-domain>.zslogin.net
Content-Type: application/x-www-form-urlencoded

{
  "grant_type": "client_credentials",
  "client_id": "<Client ID>",
  "client_secret": "<Client Secret>",
  "audience": "https://api.zscaler.com"
}
```

See ZScaler's [authentication](https://automate.zscaler.com/docs/getting-started/getting-started#authenticating) documentation for more information.

## Enable ZScaler

To enable the Data Source integration, you will need the following information:

| Dropzone Field | Source                                                                          |
| -------------- | ------------------------------------------------------------------------------- |
| Client ID      | The Client ID value you generated earlier                                       |
| Client Secret  | The Client Secret value you generated earlier                                   |
| Vanity Domain  | The domain name of your organization, e.g. https\://\<your\_domain>.zslogin.net |
| Cloud          | Your Cloud environment, e.g. zscalerone, zscloud, etc                           |

* Navigate to your Dropzone AI tenant home page e.g. https\://*mycompany*.dropzone.app
* In the bottom left hand corner, navigate to Settings > Integrations

<figure><img src="/files/zN02u3HObDaemUY8E1kD" alt=""><figcaption><p>Integrations Dropdown</p></figcaption></figure>

* Click "Library"

{% hint style="info" %}
If you have previously integrated this application, click "Configured"
{% endhint %}

<figure><img src="/files/QySQeLXXUC5SLjaXyamH" alt=""><figcaption><p>Click Library</p></figcaption></figure>

* In the Search bar, search ZScaler, then click "Configure"

<figure><img src="/files/5ulthQQQPxd3QiCvAmjY" alt=""><figcaption><p>The ZScaler Tile</p></figcaption></figure>

* Under the Data Source header, input the Client ID, Client Secret, and Vanity Domain
* Select your cloud environment from the dropdown

<figure><img src="/files/SZE6M8NjYnTa4VqxjUN2" alt=""><figcaption><p>The ZScaler Data Source Configuration</p></figcaption></figure>

* Click "Test & Save" to finish

If you have any errors engage your Dropzone AI support representative.