Polyswarm
Connector Category: API Feed Source
About Integration
CTIX integrates with PolySwarm to retrieve various types of threat data feeds. This integration adds contextual information to seemingly isolated threat data, provides you the visibility into attacks, and makes threat investigations easier.
Use Cases
Early detection of new and emerging threats using specialized feeds offered by PolySwarm
Access to STIX and TAXII ransomware feeds with unique and first-seen samples
Benefits
Faster detection and response to emerging threats.
Configure PolySwarm as API Feed Source
Configure PolySwarm as an API feed source to receive threat data feeds.
Before you Start
You must have the View API Feed, View Feed Source, Create Feed Source, and Update Feed Source permissions in CTIX.
You must have the base URL, email ID, and API key of your PolySwarm account.
Note
Ensure that your PolySwarm account plan includes integration support. If you do not have permission to retrieve a threat data feed, then the respective feed channel is disabled automatically and displays a connection error.
Steps
To configure PolySwarm as an API feed source in CTIX, do the following:
Go to Administration > Integration Management > FEED SOURCES > APIs.
Click Add API source.
Search and select the PolySwarm app.
Click Add Instance.
Enter a unique name to identify the instance name. For example, PolySwarm-Prod.
Enter the base URL of your PolySwarm instance. The default base URL is
https://api.polyswarm.network/v3/stix
.Enter the following credentials to authenticate communication between the CTIX and PolySwarm servers:
Enter the email ID of your PolySwarm account in Username.
Enter the Personal Account API key of your PolySwarm account in Password.
Select Verify SSL to verify the SSL certificate and secure the connection between the CTIX and PolySwarm servers. By default, Verify SSL is selected.
Note
Cyware recommends you select Verify SSL. If you disable this option, CTIX may configure an instance for an expired SSL certificate. This may not establish the connection properly and CTIX will not be able to notify you in case of a broken or improper connection.
Click Save.
The PolySwarm instance is configured and you can view the PolySwarm feed channels. You can configure multiple instances by clicking Manage > Add More.
Configure PolySwarm Feed Channels
Configure the feed channels to retrieve threat data feeds from PolySwarm and store the feeds in a collection.
Steps
To configure a PolySwarm channel, do the following:
Go to Administration > Integration Management > FEED SOURCES > APIs.
Search and select the PolySwarm app.
Click the ellipsis on the top right corner and select Manage.
Click Manage Feed Channels.
Select a feed channel and enable the toggle.
Enter the date and time to start polling feeds. Select a date within 15 days from the current date.
Enter the name of the collection to group the feed data. For example, PolySwarm Feeds. CTIX creates the collection and stores all the feeds from the feed channel.
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.
Enter a frequency in minutes between 60 and 10080 minutes in Polling Time. The default polling time is 240 minutes.
Set a default TLP and confidence score to assign to the feeds that do not have a TLP and confidence score already assigned. By default, the default TLP and confidence score are set to Amber and 100 respectively.
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, poll feeds, and view the feeds. For more information, see API Integrations.
Test PolySwarm Feed Channel Connectivity
Test the connectivity of the PolySwarm API feed channels to ensure that the connection with the correct API endpoint is established and you have permission to poll feeds.
Before you Start
Ensure that the PolySwarm API 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, do the following:
Go to Administration > Integration Management > FEED SOURCES > APIs.
Search and select the PolySwarm 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 Connection Error. Hover over the tooltip next to Connection Error to view the error code.
Note
When the connectivity of a feed channel breaks, CTIX disables the channel and re-attempts to restore the connectivity three times every hour. After a successful re-attempt to restore the connectivity, CTIX enables the feed channel automatically.
To understand the error code and troubleshoot broken connectivity, see Troubleshoot Integrations.
PolySwarm Feed Channels
CTIX provides various channels to poll feeds from PolySwarm. The following table lists the feed channels and the API endpoints used to retrieve feeds:
Feed Channel | API Endpoint |
---|---|
Fetch Emerging Ransomware Feeds |
|
Fetch Guest Researcher Feeds |
|
Fetch Freemium Feeds |
|