Integration Details

ThreatQuotient provides the following details for this integration:

Introduction

The SecurityScorecard CDF for ThreatQ enables analysts to automatically ingest scorecard summaries and events into ThreatQ.

The integration provides the following feeds:

• SecurityScorecard Summary Reports - pulls scorecard reports for registered domains, into ThreatQ.
• SecurityScorecard Events - pulls events for a given domain.

The integration ingests the following system objects:

• Assets
  • Asset Attributes
• Events
  • Event Attributes
• Indicators
  • Indicator Attributes

Prerequisites

The following is required to run the integration:

• A Security Scorecard license.
• A Security Scorecard API key.

Installation

Perform the following steps to install the integration:

The same steps can be used to upgrade the integration to a new version.

1. Log into https://marketplace.threatq.com/.
2. Locate and download the integration yaml file
3. Navigate to the integrations management page on your ThreatQ instance.
4. Click on the Add New Integration button.
5. Upload the yaml file using one of the following methods:
   • Drag and drop the file into the dialog box
   • Select Click to Browse to locate the integration file on your local machine

   ThreatQ will inform you if the feed already exists on the platform and will require user confirmation before proceeding. ThreatQ will also inform you if the new version of the feed contains changes to the user configuration. The new user configurations will overwrite the existing ones for the feed and will require user confirmation before proceeding.

6. Select the individual feeds to install, when prompted, and click Install. 

The feed will be added to the integrations page. You will still need to configure and then enable the feed.

Configuration

ThreatQuotient does not issue API keys for third-party vendors. Contact the specific vendor to obtain API keys and other integration-related credentials.

To configure the integration:

1. Navigate to your integrations management page in ThreatQ.
2. Select the Commercial option from the Category dropdown (optional).

   If you are installing the integration for the first time, it will be located under the Disabled tab.

3. Click on the integration entry to open its details page.
4. Enter the following parameters under the Configuration tab:

   SecurityScorecard Events Parameters

   Parameter	Description
   SecurityScorecard API Key	Your API Key for SecurityScorecard, found in your user-profile.
   Enable SSL Certificate Verification	Enable this parameter if the feed should validate the host-provided SSL certificate.
   Disable Proxies	Enable this parameter if the feed should not honor proxies set in the ThreatQ UI.
   Scorecard Domains	A comma-separated list of scorecard domains (sites) to fetch the scorecard summaries.
   Event Type Filter	Select the event types for events to ingest into ThreatQ.  Options include: Issue - indicates the arrival or departure of issues to this scorecard (default) Breach - a breach was associated to this company (default) Recalibration - indicates a recalibration event (default)
   Group Status Filter	Select the group status for events to ingest into ThreatQ.  Options include Active - new issues have been observed (default) Resolved - issues were refuted and resolution confirmed  Departed - issues are not observed anymore
   Severity Filter	Select the severity for events to ingest into ThreatQ.  Options include: Low (default) Medium (default) High (default) Positive Informational

   
   

   SecurityScorecard Summary Reports Parameters

   Parameter	Description
   SecurityScorecard API Key	Your API Key for SecurityScorecard, found in your user-profile.
   Enable SSL Certificate Verification	Enable this parameter if the feed should validate the host-provided SSL certificate.
   Disable Proxies	Enable this parameter if the feed should not honor proxies set in the ThreatQ UI.
   Scorecard Domains	A comma-separated list of scorecard domains (sites) to fetch the scorecard summaries.

   
   
5. Review any additional settings, make any changes if needed, and click on Save.
6. Click on the toggle switch, located above the Additional Information section, to enable it.

ThreatQ Mapping

{
    "name": "ThreatQuotient Inc",
    "description": "",
    "domain": "threatq.com",
    "grade_url": "https://s3.amazonaws.com/ssc-static/grades/factor_a.svg",
    "industry": "information_services",
    "size": "unknown",
    "score": 91,
    "grade": "A",
    "last30day_score_change": -5,
    "is_entity": false,
    "is_un_published": true,
    "created_at": "2018-01-04T20:19:31.077Z",
    "disputed": false
}

{
    "entries": [
        {
            "id": 1500171,
            "date": "2022-05-28T00:00:00.000Z",
            "event_type": "issues",
            "group_status": "departed",
            "issue_count": 1,
            "total_score_impact": 0,
            "issue_type": "service_vuln_host_info",
            "severity": "info",
            "factor": "patching_cadence",
            "detail_url": "https://api.securityscorecard.io/companies/threatq.com/history/events/2022-05-28/issues/service_vuln_host_info?group_status=departed"
        }
    ]
}

{
  "entries": [
        {
            "name": "application_security",
            "score": 71,
            "grade": "C",
            "grade_url": "https://s3.amazonaws.com/ssc-static/grades/factor_c.svg",
            "issue_summary": [
                {
                    "type": "csp_no_policy_v2",
                    "count": 1,
                    "severity": "medium",
                    "total_score_impact": 1.8012391326456623,
                    "detail_url": "https://api.securityscorecard.io/companies/threatq.com/issues/csp_no_policy_v2/"
                },
                {
                    "type": "csp_too_broad_v2",
                    "count": 4,
                    "severity": "low",
                    "total_score_impact": 2.2783649729965845,
                    "detail_url": "https://api.securityscorecard.io/companies/threatq.com/issues/csp_too_broad_v2/"
                }
      ]
    }
  ]
}

{
    "entries": [
        {
            "parent_domain": "threatq.com",
            "count": 1,
            "first_seen_time": "2022-05-25T02:43:02.000Z",
            "last_seen_time": "2022-05-25T02:43:02.000Z",
            "vulnerability_id": "CVE-2022-23943",
            "vulnerability_url": "https://nvd.nist.gov/vuln/detail/CVE-2022-23943",
            "vulnerability_description": "Product: Apache httpd\nSeverity: HIGH\nOut-of-bounds Write vulnerability in mod_sed of Apache HTTP Server allows an attacker to overwrite heap memory with possibly attacker provided data. This issue affects Apache HTTP Server 2.4 version 2.4.52 and prior versions.",
            "vulnerability_publish_date": "2022-03-14T00:00:00.000Z",
            "connection_attributes": {
                "protocol": "tcp",
                "dst_ip": "52.86.146.20",
                "dst_port": 443,
                "dst_host": "ec2-52-86-146-20.compute-1.amazonaws.com"
            },
            "effective_date": "2022-05-28T00:00:00.000Z",
            "group_status": "departed",
            "issue_id": "9651bf4c-6206-59ad-8c0f-9cba63ecf6b0"
        }
    ]
}

Average Feed Run

Object counts and Feed runtime are supplied as generalities only - objects returned by a provider can differ based on credential configurations and Feed runtime may vary based on system resources and load.

Summary Reports

Events

Change Log

• Version 1.0.1
  • Changed the Scorecard Domains (Sites) configuration parameter from a single line to a textarea field for both feeds. This allows you to enter multiple domains into the parameter field. This parameter was previously capped at a 255 character limit due to it being a single line field.    
  • Added the following configuration parameters for both feeds:
    • Enable SSL Certificate Verification - determine if the feed should validate the host-provided SSL certificate.
    • Disable Proxies - determine if the feed should honor proxies set in the ThreatQ UI.
  • Updated the minimum ThreatQ version to 5.12.0. 
• Version 1.0.0
  • Initial release