Integrations
This article explains how to configure and manage integrations for customers in RedCarbon.
Overview
Integrations connect RedCarbon to external security vendors and tools, allowing automatic collection of alerts and cases. Each customer can have multiple integrations configured for different security products.
For detailed configuration instructions for each vendor, see the integration guides in the Integrations section.
Creating an Integration
To create a new integration:
- Navigate to
Organization Admin>Customers. - Click on the customer name to open the details.
- Click
Add integration. - Select the integration type from the available vendors.
- Follow the specific integration guide to configure the required fields (host, API key, etc.). See the Integrations section for vendor-specific guides.
- Click
Saveto create the integration. - Click the
Testbutton to verify the connection. - Once the health check passes (shows Active), click
Enablein the top right corner.
Integration Status
Integrations can have the following statuses:
| Status | Description |
|---|---|
| Active | Integration is running and collecting alerts |
| Paused | Integration is temporarily paused |
| Not active | Integration is disabled or has errors |
| Ingesting | Integration is actively collecting data |
API Query Chart
The chart at the top of the integration details shows the API query activity:
- new: Standard periodic queries for new alerts
- lost-found: Queries that search for missed alerts in the new APIs (fallback 1)
- fallback: Recovery queries to collect any missed alerts (fallback 2)
Logs Activity
The Logs Activity section at the bottom shows:
- Actions performed by users (enabled, disabled, configuration changes)
- Health check status updates
- Errors and warnings from the integration
Mirroring (Beta)
The Mirroring feature allows automatic synchronization from RedCarbon to the vendor. For more information, see the Case Mirroring page.
Best Practices
- Test Before Enabling: Always run the health check before enabling an integration.
- Monitor Logs: Regularly check the Logs Activity for errors or warnings.
- Review API Activity: Use the API query chart to ensure data is being collected correctly.