Taegis XDR came to Sophos with the Secureworks acquisition. This article follows the Taegis TAXII 2.1 integration guide. TAXII access is not part of the standard Q-Feeds packages. It runs on a separate Enterprise license that we set up on request, so contact us before you start. We then send you your TAXII username, password and collection UUID.
Prerequisites
- Taegis XDR: a role that can add integrations under Integrations > Cloud APIs
- Q-Feeds: TAXII access set up by us (ask via the contact page), your TAXII username and password, and the UUID of the collection you want to use
- Network: nothing to open on your side. Taegis polls
taxii.qfeeds.comon port 443 from its own cloud.
Q-Feeds values
| Taegis field | Value |
|---|---|
| Integration Name | Any name, for example Q-Feeds |
| Severity | The severity every detection from this integration gets. Pick what fits your triage. |
| TAXII 2.1 Root URL | https://taxii.qfeeds.com/default/ |
| TAXII 2.1 Collection ID | Collection UUID we send you with your credentials |
| TAXII 2.1 Username | Your Q-Feeds TAXII username |
| TAXII 2.1 Password | Your Q-Feeds TAXII password, not your API key |
The Root URL is the API root. Do not paste the discovery URL https://taxii.qfeeds.com/taxii2/ here.
Add the TAXII integration
- In the Taegis menu, open Integrations > Cloud APIs.
- Select Add an Integration at the top of the page.
- On the Optimized tab, choose TAXII.
- Fill in the fields from the table above.
- Select Done. The integration now shows on the Cloud APIs page, where you can follow its status.
Stay under the 15,000 indicator limit
Taegis keeps at most 15,000 active indicators per tenant. When a new indicator would go over that, it deletes the oldest one. The limit is shared by every BYOTI source in the tenant, so a TAXII integration from another vendor counts against it too.
- Point Taegis at one collection, not several.
- A full Premium collection holds far more than 15,000 indicators, so Taegis would keep rotating it. Secureworks itself recommends loading only recent, high-confidence indicators.
- Need a collection sized for Taegis, with the most recently seen high-score indicators? Ask support@qfeeds.com.
Taegis uses IP addresses, domains, URLs and MD5, SHA1 and SHA256 hashes from the collection.
Check that detections come in
Run this in Advanced Search to list BYOTI detections from the last 24 hours:
from detection metadata.creator.detector.detector_id='app:detect:byoti' and EARLIEST=-24h
An empty result does not mean the integration is broken. It may simply be that none of the indicators has shown up in your telemetry yet. Check the integration status on the Cloud APIs page first.
Troubleshooting
- Authentication fails (401): the API key was entered as the password. The TAXII server only accepts your TAXII username and password over Basic authentication.
- Collection not found (404): the Root URL is the discovery URL, or the Collection ID has a typo. Use
https://taxii.qfeeds.com/default/and copy the UUID exactly as we sent it. - 403: the account has no access to that collection, or the credentials are not Enterprise.
- Older indicators disappear: the tenant reached 15,000 active indicators. See the limit above.
- Support: support@qfeeds.com or the support page.