-
Notifications
You must be signed in to change notification settings - Fork 45
Get Crowdstrike API Credentials
Important
Requirements: Crowdstrike is a paid service, you must have an account to get API keys.
You will need an account with administrative permissions to create API credentials.
Falcon Insight XDR is required to access the API (Device Count).
Falcon Intelligence or Falcon Intelligence Premium is required to access the API (CTI Data).
Note
You can use Cyberbro with Falcon Insight XDR only but the CTI data won't be displayed,
you will just have Device Count (on how many devices the observable was seen).
To interact with the Crowdstrike API, you need to obtain the following credentials:
- Client ID (
"crowdstrike_client_id"
insecrets.json
orCROWDSTRIKE_CLIENT_ID
environment variable). - Client Secret (
"crowdstrike_client_secret"
insecrets.json
orCROWDSTRIKE_CLIENT_SECRET
environment variable).
Additionally, you need to assign the appropriate API permissions to your application to interact with Indicators of Compromise (IOC) and Intel.
- Go to the Crowdstrike Falcon Console.
- Log in with your credentials.
- In the left-hand menu, navigate to Support and resources > API Clients and Keys
- Click Create API client.
-
Enter a name and description for your API client.
-
Under Scope, select the following permissions:
- IOC Management - Read
- IOCs (Indicators of Compromise) - Read
- Indicators (Falcon Intelligence) - Read
- Actors (Falcon Intelligence) - Read
- Malware Families (Falcon Intelligence) - Read
- Reports (Falcon Intelligence) - Read
-
Click Create.
- After creating the API client, you will be shown the Client ID and Client Secret.
- Copy these values and store them securely.
Warning
Make sure to copy the Client Secret now as it will not be shown again.
You now have the Client ID and Client Secret required to authenticate with the Crowdstrike API.
Additionally, you have assigned the necessary permissions to interact with Indicators of Compromise (IOC) and Intel.
For more information, consult the official documentation: https://falcon.crowdstrike.com/documentation/page/a2a7fc0e/crowdstrike-oauth2-based-apis
Note
To configure the Falcon link (clickable in the GUI), users may utilize the optional "crowdstrike_falcon_base_url": "https://falcon.crowdstrike.com"
setting in secrets.json
or the CROWDSTRIKE_FALCON_BASE_URL
environment variable. By default, this variable is set to "https://falcon.crowdstrike.com". For instance, those operating within the US2 region should specify the prefix as "https://falcon.us-2.crowdstrike.com".
Any questions? Raise an issue or contact @cyberbro_cti on X / @cyberbro on Mastodon (infosec.exchange).