Configure Team Cymru
Integrate Team Cymru as a feed source and start receiving threat intel in Intel Exchange. You can use the following sections for more information:
Configure Team Cymru as an API feed source to receive threat data feeds of botnet analysis and reports (BARS) and command and control (Controller) feeds.
Before you Start
You must have the View API Feed, View Feed Source, Create Feed Source, and Update Feed Source permissions in Intel Exchange.
You must have the base URL, client ID, and client secret to access Team Cymru provided by your Intel Exchange account manager or sales representative.
Steps
To configure Team Cymru as an API feed source in Intel Exchange, follow these steps:
Go to Administration > Integration Management. In Feed Sources, click APIs.
Click Add API Source.
Search and select Team Cymru.
Click Add Instance.
Instance Name: Enter a unique name to identify the instance name. For example, Team Cymru-Prod.
Base URL: The base URL is https://tc-feeds.cyware.com/ctixapi/ctix21/taxii2/.
Client ID: Enter the client ID to authenticate with the server.
Client Secret: Enter the client secret.
Note
The client ID and secret are provided by your Intel Exchange account manager or sales representative.
Select Verify SSL to verify the SSL certificate and secure the connection between the Intel Exchange and Team Cymru servers. By default, the verification is enabled.
Note
Enabling SSL verification is recommended. If you disable this option, it may result in the use of an expired SSL certificate while configuring the instance. This may not establish the connection properly and you will not be notified in case of a broken or improper connection.
Test the connectivity of the Team Cymru feed channels to ensure that the connection with the correct API endpoint is established and that you have permission to poll feeds.
Before you Start
Ensure that the Team Cymru integration is enabled.
Ensure that the feed channel for which you want to test connectivity is enabled.
Steps
To test the connectivity of a feed channel, follow these steps:
Go to Administration > Integration Management. In Feed Sources, click APIs.
Search and select the Team Cymru app.
On a feed channel, click the vertical ellipses and select View Details.
In the Working Status section, click Test Connectivity.
If the connection is established, then the working status shows Running. If the connectivity is broken, then the working status shows a Connection Error. Hover over the tooltip next to Connection Error to view the error code.
Note
When a feed channel loses connectivity, it is automatically disabled, and the system attempts to restore connectivity three times per hour. If the connectivity is successfully restored, the feed channel is automatically re-enabled.
Configure the feed channel to retrieve threat data feeds from Team Cymru and store the feeds in a collection.
Steps
To configure the feed channels, follow these steps:
Go to Administration > Integration Management. In Feed Sources, click APIs.
Search and select the Team Cymru app.
Click the vertical ellipsis, and select Manage.
Click Manage Feed Channels.
Select the preferred channel and turn on the toggle to activate it. Use the following information while configuring the channel:
Start Date and Time: Enter the date and time to start polling feeds. Select a date within 15 days from the current date.
Collection Name: Enter the name of the inboxing collection to group the feed data. For example, Team Cymru Controller Feeds. Intel Exchange creates the collection and stores all the feeds from the feed channel.
Polling Cron Schedule: Select from one of the following Polling Cron Schedule types to define when to poll the data:
Manual: Allows you to manually poll from the source collection.
Auto: Allows you to automatically poll for threat intel from sources at specific time intervals. The default polling cron schedule is Auto.
Note
The minimum and recommended polling time for Team Cymru feed channels is 24 hours (1440 minutes).
TLP: Set the TLP for the feeds that do not have a TLP already assigned. The default TLP is Amber. Alternatively, you can select None to ensure that no TLP is assigned to the feeds.
Default Source Confidence: Enter the confidence score for the feeds that do not have a confidence score already assigned. The default confidence score is 100.
Custom Scores: Select the Relevance and Severity Score for the channel.
Default Tags: Select any tags to identify and categorize the feeds.
Click Save.
The feed channel is configured and you can poll feeds from the channel. You can enable the other feed channels, and poll feeds, and view them.
