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

# Stellar Cyber

Dropzone AI integrates with [Stellar Cyber](https://stellarcyber.ai/), an AI powered SecOps platform offering security solutions such as SIEM, Network Detection & Response (NDR), Identity Threat Detection & Response (ITDR), and User Behavior Entity Analytics (UEBA). Dropzone can perform analysis cases and alerts from the Stellar Cyber Connect API, and/or use Stellar Cyber data as part of investigation analysis.

## Integration Overview

To enable these integrations you will perform the following actions:

* Create an API token
* Install the credentials into your Dropzone tenant
* Select integration parameters, such as which indexes to search

## Create an API key

Stellar Cyber requires an Access Token or Refresh Token to enable. Access Tokens are only valid for a short length of time, so we recommend creating a Refresh Token (or API Key).

Stellar Cyber also requires a unique email address for all its users, which is associated with the Token. We recommend creating a dedicated email address for the user generating it, rather than using an existing company email.

Follow steps on Stellar Cyber's [documentation site](https://docs.stellarcyber.ai/7.0.xs/Using/API/API-Auth.htm) to create the Refresh Token.

## Enable Stellar Cyber

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

| Dropzone Field       | Source                                                                              |
| -------------------- | ----------------------------------------------------------------------------------- |
| Instance Domain      | Your Stellar Cyber server hostname (e.g. https\://<\<myserver.stellarcyber.cloud>>) |
| User Email Address   | The email address of the Stellar Cyber user you created/used earlier                |
| Access/Refresh Token | The Access Token or Refresh Token value you generated earlier                       |

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 Stellar Cyber, then click "Configure"

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

* Under the Data Source heading, input the instance domain, user email address, and access token

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2Fr7RuUPJDsel3a9DidN8E%2Fapp_system_integrations_available_stellarcyber_data_config_1.png?alt=media" alt=""><figcaption><p>The Stellar Cyber Data Source Configuration (pt 1)</p></figcaption></figure>

* Input an Index Prefix from Stellar Cyber's [ElasticSearch API](https://docs.stellarcyber.ai/6.5.xs/Using/API/API-ElasticSearch-Query.htm)
* Under "Advanced ElasticSearch Request Timeout," input the maximum amount of time you want Dropzone to wait for a response from Stellar Cyber's ElasticSearch API
* Under "Authentication Type," specify the Token you used — "Basic" for a Refresh Token, "JWT" for an Access Token

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FyFN9ElsGshTvCqSndY2S%2Fapp_system_integrations_available_stellarcyber_data_config_2.png?alt=media" alt=""><figcaption><p>The Stellar Cyber Data Source Configuration (pt 2)</p></figcaption></figure>

* Under "Enabled Stellar Cyber ElasticSearch Indexes," select the [indexes](https://docs.stellarcyber.ai/prod-docs/5.1.x/Common/Understanding-Indices.htm?Highlight=index) you want Dropzone to have access to

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FMrZZTn3jRBoR8yjGgfxQ%2Fapp_system_integrations_available_stellarcyber_data_config_3.png?alt=media" alt=""><figcaption><p>The Stellar Cyber 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%2FETcE4u0B2WgBnDoiXAVj%2Fapp_system_integrations_available_stellarcyber_data_config_4.png?alt=media" alt=""><figcaption></figcaption></figure>

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