Skip to main content

Cyware Threat Intelligence eXchange

Vilocify

Connector Category: API Feed Source

Notice

This integration is available in Intel Exchange starting v3.7.5.2 (LA).

About Integration

Vilocify delivers vulnerability intelligence in the form of structured security notifications. These notifications provide details on affected components, related vulnerabilities, severity, and recommended actions, helping organizations strengthen their vulnerability management and response processes.

Intel Exchange integrates with Vilocify to retrieve vulnerability notifications as threat intel feeds about the following threat objects:

  • Vulnerability

  • Reports

  • Tools

Use Cases 

  • Monitor vulnerability notifications to stay updated on new or changed risks affecting your components.

  • Correlate notifications with your environment to prioritize remediation.

  • Track end-of-life (EOL) information to plan for component upgrades.

Configure Vilocify 

Integrate Vilocify as a feed source and start receiving threat intel in Intel Exchange. You can use the following sections for more information:

Configure Vilocify as a Feed Source

Configure Vilocify as an API feed source in Intel Exchange to retrieve vulnerability notifications, reports, and tools from Vilocify.

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 and API key of your Vilocify account.

Steps 

To configure Vilocify as an API feed source in Intel Exchange, follow these steps:

  1. Go to Administration > Integration Management. In Feed Sources, click APIs.

  2. Click Add API Source.

  3. Search and select Vilocify.

  4. Click Add Instance.

    1. Instance Name: Enter a unique name to identify the instance name. For example, Vilocify-Prod.

    2. Base URL: Enter the base URL of your Vilocify instance. The default base URL is https://portal.vilocify.com/.

    3. API Token: Enter the API token to authenticate with Vilocify.

    4. Select Verify SSL to verify the SSL certificate and secure the connection between the Intel Exchange and Vilocify 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.

The Vilocify instance is configured, and you can view the feed channels. You can configure multiple instances by clicking Manage > Add More.

Configure Vilocify Feed Channels

Configure the feed channel to retrieve threat data feeds from Vilocify and store the feeds in a collection.

Steps 

To configure the feed channels, follow these steps:

  1. Go to Administration > Integration Management. In Feed Sources, click APIs.

  2. Search and select Vilocify.

  3. Click the vertical ellipsis, and select Manage.

  4. Click Manage Feed Channels.

  5. Select the Fetch Notifications Data channel and turn on the toggle. Use the following information while configuring the channel:

    • Collection Name: Enter the name of the collection to group the feed data. For example, Vilocify Feeds. Intel Exchange creates the collection and stores all the feeds from the feed channel.

    • Start Date and Time: Enter the date and time to start polling feeds. Select a date within 15 days from the current date.

    • Filter Notifications by Monitoring Lists: Select one or more monitoring lists to receive filtered notifications. If no monitoring list is selected, Intel Exchange polls all notifications from Vilocify, including those not tagged to any monitoring list.

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

        • Enter a frequency in minutes between 60 and 10080 in Polling Time. The default polling time is 240 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.

  6. 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 the feeds.

Test Feed Channel Connectivity

Test the connectivity of the Vilocify API 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 Vilocify 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, follow these steps:

  1. Go to Administration > Integration Management. In Feed Sources, click APIs.

  2. Search and select the Vilocify app.

  3. On a feed channel, click the vertical ellipsis 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 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.

To understand the error code and troubleshoot broken connectivity, see Troubleshoot Integrations.

Vilocify Feed Channels

The following table lists the feed channel and the API endpoint used to retrieve feeds from Vilocify:

Feed Channel

API Endpoint

Fetch Notifications Data

{base_url}/api/v2/notifications