# Zscaler Private Access

## Connection Requirements

{% stepper %}
{% step %}

### Domain

The Domain of the Zscaler Private Access.

{% hint style="info" %}
🔵 Default: `config.private.zscaler.com`\
The ZPA API Portal URL on the API Keys page (Configuration & Control > Public API) differs depending on your organization's assigned cloud. If an organization logs in to `admin.private.zscaler.com`, then the ZPA API Portal for that organization's cloud name is `config.private.zscaler.com`. If an organization logs in to `zpatwo.net`, then the ZPA API Portal for that organization's cloud name is `config.zpatwo.net`.
{% endhint %}
{% endstep %}

{% step %}

### Client ID

Client ID that is generated during API Key creation.
{% endstep %}

{% step %}

### Client Secret

Client Secret that is obtained during API Key creation.

To create an API Key and obtain Client ID & Secret:

* Go to Configuration & Control > Public API > API Keys.
* Click Add. In the Add API Key window enter a name for the key and enable the status.
* Give read access to Servers. If you want to fetch app connectors and service edges, you should also give read access to App Connector Management and Private Service Edges.
* Save the API key.
* After saving please copy your client id & secret.
  {% endstep %}

{% step %}

### Customer ID

ZPA tenant id of the user.
{% endstep %}

{% step %}

### Is Secure?

Use SSL for connection (default: Encrypted).
{% endstep %}

{% step %}

### Fetch Private Service Edges

Fetch private service edges as additional assets. (optional, default: False).
{% endstep %}

{% step %}

### Fetch App Connectors

Fetch app connectors as additional assets. (optional, default: False).
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
⚠️ Attention\
Please perform a **connection test** to ensure there is a valid connection to the host.\
When the discovery operation is finalized, you will be able to see the details on the **Assets** page.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.octoxlabs.com/adapters/adapters/zscaler-private-access.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.