CrowdSec Cyber Threat Intelligence

Article
09/04/2024

Important

Some information in this article relates to a prereleased product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

CrowdSec Threat Intelligence is an open-source, collaborative security stack that enables you to analyze behaviors, respond to attacks, and share signals across the community. CrowdSec Threat Intelligence provides information about IP addresses and verification or identification of potentially aggressive IP addresses. You can use the CrowdSec Cyber Threat Intelligence (CrowdSec CTI) plugin with Microsoft Copilot for Security.

Note

This article contains information about third-party plugins. This is provided to help complete integration scenarios. However, Microsoft does not provide troubleshooting support for third-party plugins. Contact the third-party vendor for support.

Know before you begin

Integration with Copilot for Security works with an API key. You'll need to take the following steps before using the plugin.

Note

Depending on which account you have, you might have a limit of up to 50 queries per day. It depends on your licensing for CrowdSec.

Get your CrowdSec API key. If you don't have one yet, follow these steps:
1. Go to the CrowdSec website and create your account.
2. In your personal account settings, go to API Keys and select + New key.
3. Next to your key, select the Copy icon.
Sign in to Microsoft Copilot for Security.
Access Manage Plugins by selecting the Plugin button from the prompt bar.
Next to CrowdSec Threat Intelligence, select Set up.
In the Value field, paste your API Key, and then select Save.

Sample CrowdSec CTI prompts

After the CrowdSec CTI plugin is configured, you can use it by taking one of the following steps:

Access the capability directly by typing LookupIpAddressSmokeDataset in the prompt bar; or
Prompt Copilot for Security to use the CrowdSec Threat Intelligence API on an IP address

The following table summarizes how this capability works.

Capability What it does

LookupIpAddressSmokeDataset

Required Input: IP Address Searches CrowdSec's dataset for an IP address to know more about:

- What it does in terms of observed behaviors, targeted protocols, and exploited vulnerabilities.

- In what categories it belongs, such as proxy/VPN, CDN exit node, and Legit security scanner.

- What it targets, in terms of countries or services.

- Existing cross-references, such as lists

- How virulent it is.

- For how long it's been reported by users.

- The confidence level of the information.

Capability	What it does
`LookupIpAddressSmokeDataset` Required Input: IP Address	Searches CrowdSec's dataset for an IP address to know more about: - What it does in terms of observed behaviors, targeted protocols, and exploited vulnerabilities. - In what categories it belongs, such as proxy/VPN, CDN exit node, and Legit security scanner. - What it targets, in terms of countries or services. - Existing cross-references, such as lists - How virulent it is. - For how long it's been reported by users. - The confidence level of the information.

Troubleshoot the CTI plugin

Errors occur

If you encounter errors, such as Couldn't complete your request, or An unknown error occurred, make sure the plugin is turned on. If the issue persists, sign out of Copilot for Security, and then sign back in.

Prompts aren't invoking the correct capabilities

If prompts aren't invoking the correct capabilities, or prompts are invoking some other capability set, you might have custom plugins or other plugins that have similar functionality as the capability set you want to use. To prioritize and target CrowdSec, try disabling other custom plugins. Or, you can either use the product name CrowdSec in your prompts, or type the name of a specific capability, like LookupIpAddressSmokeDataset instead.

Provide feedback

To provide feedback, contact CrowdSec.

Share via