Configure your integrations for Internal Security

In this article:

Internal Security is part of Internal Security Suite, which is in Early Access release for selected customers. To learn more, contact your Customer Success Manager.

SecurityScorecard's Internal Security (Beta) gathers security-related information behind your firewall by communicating with your own security tools such as:

• Endpoint detection and response (EDR) devices
• Multi-factor authentication (MFA) applications
• Firewalls

Use this guide to integrate Internal Security with any of the solutions that it currently supports.

Prepare for your integrations

Before configuring any integration do the following:

1. Install Internal Security from Integrate360°: Marketplace. See Internal Security integration for guidance on installation and deploying the integrations in the platform. 
2. Contact your internal Support or Engineering team if you do not know how to provide the information required for each integration.

Integrate with your solution

Select the product you want to integrate with:

Note: Internal Security currently supports three product integrations:

• Duo
• KnowBe4
• Qualys

We are developing support for will update this list as more integrations become available.

• Carbon Black
• CrowdStrike
• Duo
• Fortinet FortiGate
• Fortinet FortiNAC
• Fortinet FortiSOAR
• Fortinet FortiWeb
• KnowBe4
• Mcafee MVISION
• Qualys
• Tenable.io

Integration enables Internal Security to pull specific data from each installed product using a REST API GET method. It does not interact with your tools any other way.

Note: This list will expand as we add support for more integrations.

Carbon Black

See detailed integration instructions for CarbonBlack

Information that Internal Security extracts:

• List of unknown apps
• All recommendations
• Threat alerts
• Device list

Required configuration settings:

Documentation and resources:

• API guidance

• Installed library: carbon-black-cloud-sdk

CrowdStrike

See detailed integration instructions for CrowdStrike Falcon.

Information that Internal Security extracts:

• Event streams
• Hosts data
• Incident data
• Indicator of compromise (IOC) data
• Data about threat actors in the environment

Required configuration settings:

Documentation and resources:

• API guidance

• Installed library: Falconpy

• Partner development agreement

Duo

Information that Internal Security extracts:

• Authentication log details
• Administrative API endpoint details
• Administrative integration details
• Administrative phone details
• Administrative settings details
• Administrative usernames and activities details

Required configuration settings:

Documentation and resources:

• API integration library
• External packages installed: duo-client
• Terms and conditions of use

Fortinet FortiGate

See detailed integration instructions for Fortinet FortiGate.

Information that Internal Security extracts:

• System firmware data
• Anomalies in the system
• Rate-based intrusion prevention signals
• Intrusion prevention rules
• Intrusion prevention global settings
• Intrusion prevention sensor data
• FortiGate routing table entry
• FortiGate subnet data
• Antivirus profiles
• Control enforced on applications installed on systems behind FortiGate
• Antivirus settings
• Threat traffic
• FortiGate security rating data
• WAF Firewall profiles
• WAF Firewall signatures
• DNS filter settings and data

Required configuration settings:

Documentation and resources:

• API guidance
• No internal packages installed
• End-user license agreement

Fortinet FortiNAC

Note: This integration only works if the product is installed in your internal cloud environment, not in the FortiCloud.

Information that Internal Security extracts:

• Alarm information , such as OS update and admin service fail
• Control tasks information
• Device profile details
• All event details
• Devices in the network details
• User details

Required configuration settings:

Documentation and resources:

• API guidance
• No external packages installed
• Terms of use

Fortinet FortiSOAR

Note: This integration only works if the product is installed in your internal cloud environment, not in the FortiCloud.

Information that Internal Security extracts:

• Workflow history
• Incident alerts
• System templates
• Asset list
• Task list

Required configuration settings:

Documentation and resources:

• API guidance
• No external packages installed
• Terms of use

Fortinet FortiWeb

Note: This integration only works if the product is installed in your internal cloud environment, not in the FortiCloud.

Information that Internal Security extracts:

• Fortiweb operation status
• Fortiweb network interface configuration
• All local certificates
• tcpdump from Fortiweb
• HATopology configurations
• Open config network failure
• Topology config in manager mode
• FortiGuard configurations
• Network data source interface data
• Web application firewall signature policies
• Web application attack log data

Required configuration settings:

To  create the FortiWeb API key run the following command in your terminal, where the default value of vdom is root:

Note: "APIKEY" is the default value but still every installation is different. To learn the value for your installation see the FortiWeb API documentation, or ask Fortinet Customer Service  about creating API key in terminal using your credentials.

echo '{"username":"******","password":"********","vdom":"*****"}' | base64

Documentation and resources:

• API guidance
• No external packages installed
• Terms of use

KnowBe4

See detailed integration instructions for KnowBe4.

Information that Internal Security extracts:

• All campaign data
• All security test data
  

Required configuration settings:

Documentation and resources:

• API guidance
• No external packages installed
• Terms of use

Mcafee MVISION

Information that Internal Security extracts:

• Devices and their metadata
• Task schedules
• Installed products
• Tags

Required configuration settings:

Documentation and resources:

• API guidance
• No external packages installed

Qualys

Information that Internal Security extracts:

• Hosts
• Virtual hosts
• Web application IDs and details
• Web scan IDs and its configs, metadata
• Web scan results
• All Amazon Elastic Compute Cloud (Amazon EC2) scans
• EC2 scan results

Required configuration settings:

Note: Internal Security sends POST requests to create keys using the username and password and to get the list of hosts, web application IDs, and web application scan IDs from Qualys. Internal Security does not make any changes in your Qualys deployments.

Documentation and resources:

• API guidance
• No external packages installed

Tenable.io

See detailed integration instructions for Tenable.io.

Information that Internal Security extracts:

• Network details
• Asset details
• Agent group details
• Scan information

Required configuration settings:

Documentation and resources:

• API guidance
• Installed library: pytenable
• Technology interoperability program (TIP) agreement