> For the complete documentation index, see [llms.txt](https://docs.fusion.vectra.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fusion.vectra.ai/enrich-traffic-with-context/configure-context-integrations/crowdstrike-falcon-discover.md).

# CrowdStrike Falcon Discover

Configure CrowdStrike Falcon Discover for the Vectra context integration.

{% hint style="warning" %}
**The CrowdStrike Falcon Discover module is required for this integration.**
{% endhint %}

This document provides instructions for configuring CrowdStrike in order for the Vectra context integration to have the correct access to pull label contexts.

## Prerequisites <a href="#prerequisites" id="prerequisites"></a>

Before configuring the CrowdStrike Falcon Discover context integration in Vectra, you will need to have an API user created in CrowdStrike.

### Configure an API Client <a href="#configure-an-api-client" id="configure-an-api-client"></a>

* On the left hand menu expand the "Support and resources" submenu.
* Then click on API clients and keys.\
  ![](https://1075194167-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7upncbzIm3grJePXaOO9%2Fuploads%2Fgit-blob-999b7425c0433d3a6a4ff72e0501bc4e16139ca0%2Fad114b77739df678a71b6992e8f45269fd8964fa4b1644416a139270ec46a9e9.png?alt=media)
* Click on the "add new API client" button in the top right\
  ![](https://1075194167-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7upncbzIm3grJePXaOO9%2Fuploads%2Fgit-blob-fec44da5ccd7b4b03ece70c4aa4803b415952678%2F5f31adf4131ba1f1ac120e398dbf7c36ea458b1feb85f10ce688ee9969f970c8.png?alt=media)
* Fill out the client name.
* Give the key a description.
* In the API Scopes table select Read permission for "Hosts" and "Assets.
* Click Create at the bottom to create this api client.\
  ![](https://1075194167-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7upncbzIm3grJePXaOO9%2Fuploads%2Fgit-blob-5e81382e94371fac9817f0f2708be03184f2b92d%2F595d744da11ab50a6cc0d7fb36e576cc629eece4086f98a25ac5361ffe6ba275.png?alt=media)
* After clicking "Create" you will be presented with a screen that shows the credentials like below. Make note of the `CLIENT ID`, `SECRET` and subdomain from the `BASE URL`.
  * Note: The Subdomain of the base URL is what to select for Cloud abbreviation.

    <mark style="color:$info;">**📘 If the BASE URL is api.crowdstrike.com then your cloud is US-1.**</mark><br>

    ![](https://1075194167-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7upncbzIm3grJePXaOO9%2Fuploads%2Fgit-blob-4c841dc1081c7aa9cf2c312ea2cbebb850686d37%2F7e60037fe11887dee3c0529c150d985a9aba29419b6486d89950801846165f26.png?alt=media)

## Vectra portal steps <a href="#vectra-portal-steps" id="vectra-portal-steps"></a>

Navigate to Integrations (make sure you are on the Context tab) and click "Add Integration", then select `CrowdStrike Falcon Discover`

![](https://1075194167-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7upncbzIm3grJePXaOO9%2Fuploads%2Fgit-blob-e5cba244fc5248b5f881a37c0ac8686babcfdf45%2F21eb7fd3647f7d3aed55b3bf5908ff89f04d74b7d8f9e9091d3000fad84e1dfc.png?alt=media)

### Configuration <a href="#configuration" id="configuration"></a>

The following fields are specific to the CrowdStrike Falcon Discover integration.

| Field                | Required | Description                                                                      | Example                                                |
| -------------------- | -------- | -------------------------------------------------------------------------------- | ------------------------------------------------------ |
| `Cloud Abbreviation` | yes      | The falcon cloud to query. Found as the subdomain from the CrowdStrike`BASE URL` | US 2                                                   |
| `Filter`             |          | An optional FQL string to be used when filtering results.                        | entity\_type:'managed'+last\_seen\_timestamp:<'now-3d' |
| `Sort`               |          | An optional FQL sort string.                                                     | last\_seen\_timestamp.desc                             |

### Authentication <a href="#authentication" id="authentication"></a>

The following fields are necessary for the integration to authenticate with CrowdStrike.

| Field           | Required | Description                 |
| --------------- | -------- | --------------------------- |
| `Client ID`     | yes      | The CrowdStrike `CLIENT ID` |
| `Client Secret` | yes      | The CrowdStrike `SECRET`    |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.fusion.vectra.ai/enrich-traffic-with-context/configure-context-integrations/crowdstrike-falcon-discover.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
