Skip to main content

Cyware Threat Intelligence eXchange

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:

  1. Go to Administration > Integration Management > FEED SOURCES > APIs.

  2. Click Add API source.

  3. Search and select the PolySwarm app.

  4. Click Add Instance.

  5. Enter a unique name to identify the instance name. For example, PolySwarm-Prod.

  6. Enter the base URL of your PolySwarm instance. The default base URL is https://api.polyswarm.network/v3/stix.

  7. 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.

  8. 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.

  9. 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:

  1. Go to Administration > Integration Management > FEED SOURCES > APIs.

  2. Search and select the PolySwarm app.

  3. Click the ellipsis on the top right corner and select Manage.

  4. Click Manage Feed Channels.

  5. Select a feed channel and enable the toggle.

  6. Enter the date and time to start polling feeds. Select a date within 15 days from the current date.

  7. 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.

  8. 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.

  9. 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.

  10. Select any tags to identify and categorize the feeds.

  11. 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:

  1. Go to Administration > Integration Management > FEED SOURCES > APIs.

  2. Search and select the PolySwarm app.

  3. On a feed channel, click the vertical ellipses and select View Details.

  4. 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

{{base-url}}ransomware 

Fetch Guest Researcher Feeds

{{base-url}}trustgroup 

Fetch Freemium Feeds

{{base-url}}freemium