> 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/alert/stellarcyber_alert.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 on 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 alert types to sync

## 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 Alert 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 Alert 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 Alert Source heading, input the instance domain, user email address, and token
* 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%2FgDTnb6q5xaLwbTAYJYqL%2Fapp_system_integrations_available_stellarcyber_alert_config_1.png?alt=media" alt=""><figcaption><p>The Stellar Cyber Alert Source Configuration (pt 1)</p></figcaption></figure>

* In the StellarCyber Alerts section, you may input an array of Python regex patterns to include or exclude specific [alerts](https://docs.stellarcyber.ai/prod-docs/5.1.x/Using/Alerts/Alert-Main.htm?tocpath=SECURITY%20MONITORING%7CWorking%20with%20Alerts%7C_____1) by name. To do so, select whether to exlude or include the listed threat names, then click "Add Item" and input the array. Continue adding arrays until done.

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

* To enable Dropzone to poll for alerts, check the box labeled "Enable polling for alerts"
* Input the [Alert Index prefix](https://docs.stellarcyber.ai/prod-docs/5.1.x/Using/ML/Machine-Learning-by-index.htm?tocpath=REFERENCE%7CDetection%20and%20Correlation%20Overview%7CAlert%20Type%20Model%20Summary%7C_____3) and minimum desired [event score](https://docs.stellarcyber.ai/prod-docs/5.1.x/Using/Alerts/Alert-Scoring.htm?tocpath=SECURITY%20MONITORING%7CWorking%20with%20Alerts%7C_____6) of the alerts you want Dropzone to investigate

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

* To enable Dropzone to poll for [cases](https://docs.stellarcyber.ai/prod-docs/5.1.x/Using/Cases/Cases-Main.htm?Highlight=case), check the box labeled "Enable polling for cases"
* Input your minimum desired [score](https://docs.stellarcyber.ai/prod-docs/5.1.x/Using/Cases/Cases-Understanding.htm?tocpath=SECURITY%20MONITORING%7CWorking%20with%20Cases%7C_____2#:~:text=AWS%20GuardDuty-,How%20Case%20Scores%20Are%20Calculated,-Stellar%20Cyber%20assigns), then check the boxes for each [severity level](https://docs.stellarcyber.ai/prod-docs/5.1.x/Using/Cases/Cases-Detail.htm?tocpath=SECURITY%20MONITORING%7CWorking%20with%20Cases%7C_____3#:~:text=were%20seen%20where.-,Severity,-%E2%80%93%20The%20severity%20of) you want Dropzone to investigate

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

* In the "Custom Filtering" section, you may input an array of Python regex patterns to include or exclude specific cases by name. To do so, check the box labeled "Enable Custom Filtering," select whether to exlude or include the listed threat names, then click "Add Item" and input the array. Continue adding arrays until done.

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

* To limit Dropzone's access to specific [tenants](https://docs.stellarcyber.ai/prod-docs/5.1.x/Common/Using-Tenants.htm?Highlight=tenant%20id) within Stellar Cyber, check the box labeled "Manually Specify Tenant IDs," then click "Add Item." Input the Tenant [ID](https://docs.stellarcyber.ai/prod-docs/5.1.x/Configure/People/Tenants-Managing.htm?tocpath=CONFIGURING%7CManaging%20Access%7CManaging%20Tenants%7C_____2) you want Dropzone to investigate alerts for. Continue adding Tenant IDs until done.

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

* Input your desired poll interval and lookback

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

* If you wish to further filter alerts using the Python [CEL](https://python-common-expression-language.readthedocs.io/en/stable/tutorials/cel-language-basics/) package, check the box labeled "Use advanced filtering"
* Input your CEL expression, then select whether to include or exclude alerts matching that filter. Add each filter individually using the "Add Item" button
* Contact our Customer Success team for more information about this feature

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

* Click "Test & Save" to finish

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