> 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/vectra-ai_data.md).

# Vectra AI

Dropzone AI integrates with [Vectra AI](https://www.vectra.ai/platform), an AI-driven NDR platform for automated threat detection and response across hybrid networks, including public clouds, SaaS, identity systems, and data centers. Dropzone supports both Cloud and On-premise deployments of Vectra AI.

Vectra AI has multiple versions of API documentation available for different deployments and features. If this documentation looks incorrect, use <https://support.vectra.ai/s/> for more information more relevant to your organization.

## Create an API Token (On-premise)

If you have an On-premise deployment, Vectra AI requires an API Token to enable.

To obtain an API Token, do the following:

* Open your Vectra AI instance
* Navigate to Profile > View/Generate API Token
* Record your API token for use later in the Dropzone UI

## Create an API Client (Cloud Deployment)

If you have a Cloud deployment, Vectra AI requires an API Client and Secret Key to enable.

To obtain these, do the following:

* Log in to your Vectra AI console
* In the left sidebar, navigate to Manage > API Clients
* Click "Add API Client"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2F2FZHAjeRjWfEjDLoBLUq%2Fvectra-ai-1.png?alt=media" alt=""><figcaption><p>Add API Client</p></figcaption></figure>

* Name the client something memorable, such as "Dropzone AI"
* Assign the client the Read-Only role
* Click "Generate Credentials"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2Fkeg6qgWOxlLS2AY3njgo%2Fvectra-ai-2.png?alt=media" alt=""><figcaption><p>Generate the API Client</p></figcaption></figure>

* Copy the Client ID and Secret Key generated for use later in the Dropzone UI, where they are called "OAuth2 Client ID" and "OAuth2 Client Secret," respectively

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2F1ahb4qxNfEnCLMP95UvC%2Fvectra-ai-3.png?alt=media" alt=""><figcaption><p>Save the credentials</p></figcaption></figure>

## Create an API Token (On-Premise Deployment)

* Log in to your Vectra AI console
* In the left sidebar, navigate to My Profile

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FvveciIlnaKx7ByueRRwD%2Fvectra-ai-4.png?alt=media" alt=""><figcaption><p>Click "My Profile"</p></figcaption></figure>

* Click "View API Token"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FuKLJEWKAcC6FCUdQrwVc%2Fvectra-ai-5.png?alt=media" alt=""><figcaption></figcaption></figure>

* Input your password, then click "Continue"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FLNPCxqyrnAa4tMJchz7b%2Fvectra-ai-6.png?alt=media" alt=""><figcaption><p>Input your credentials</p></figcaption></figure>

* Copy the API token shown for use later in the Dropzone UI, where it is called "API Token"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2Fm6c9tRg2JsNix66JbSQp%2Fvectra-ai-7.png?alt=media" alt=""><figcaption><p>Copy the API Token</p></figcaption></figure>

* Click "Close"

## Enable Vectra AI

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

| Dropzone Field       | Source                                                                                    |
| -------------------- | ----------------------------------------------------------------------------------------- |
| Deployment Type      | Your Vectra AI deployment type, e.g. Cloud or On-Premise                                  |
| Vectra AI URL        | The base URL of your Vectra instance, e.g. <https://api.vectra.ai> or <https://10.20.1.5> |
| OAuth2 Client ID     | The Client ID value you copied earlier. Only necessary for Cloud deployments              |
| OAuth2 Client Secret | The Secret Key value you copied earlier. Only necessary for Cloud deployments             |
| API Token            | The API Token value you created earlier. Only necessary for On-Premise deployments        |

To enable the Data Source integration, do the following:

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

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FQKQGU2YK0KqsewZWvh0i%2Fui-integrations-dropdown.png?alt=media" 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="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2Fx4O3FuRG5IqPwx5sFuHr%2Fapp_system_integrations_library.png?alt=media" alt=""><figcaption><p>Click Library</p></figcaption></figure>

* In the Search bar, search Vectra AI, then click "Configure"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FhprtZdbcV3C3IDjSwlPg%2Fapp_system_integrations_available_vectra-ai.png?alt=media" alt=""><figcaption><p>The Vectra AI Tile</p></figcaption></figure>

* Under the Data Source header, if your Vectra AI integration is behind an [On-premise Dropzone Connector](https://docs.dropzone.ai/platform/settings/connector), select your connector from the dropdown
* Input your Deployment Type and Vectra AI URL

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FtbLx9sI2tVC75e1n5qIB%2Fapp_system_integrations_available_vectra-ai_data_config_1.png?alt=media" alt=""><figcaption><p>The Vectra AI Data Source configuration (pt 1)</p></figcaption></figure>

* If you have a Cloud deployment, input the OAuth2 Client ID and Secret

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2Fiog6rDMjElTd5MwXEsQP%2Fapp_system_integrations_available_vectra-ai_data_config_2.png?alt=media" alt=""><figcaption><p>The Vectra AI Data Source configuration (pt 2)</p></figcaption></figure>

* If you have an On-premise deployment, input the Vectra AI Server, Port, and API Token

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FHYdnuRbpKwkwL4krVUEj%2Fapp_system_integrations_available_vectra-ai_data_config_3.png?alt=media" alt=""><figcaption><p>The Vectra AI Data Source configuration (pt 3)</p></figcaption></figure>

* Click "Test & Save" to finish

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FzlXvpTSeEcWS1gYQgTan%2Fui-test-and-save.png?alt=media" alt=""><figcaption><p>The Vectra AI Data Source configuration (pt 4)</p></figcaption></figure>

If you have any errors or questions, contact our Customer Success team.
