Cybereason EDR

The Cybereason Connector integrates endpoint detection and response data into Qualys Enterprise TruRisk Management by automating the ingestion of asset information through scheduled API calls.

Security teams gain visibility into their endpoints while the platform enriches findings with context and calculates risk scores to prioritize remediation efforts. This unidirectional integration eliminates manual data transfers and enables teams to correlate EDR detections with other security findings in a centralized risk management system.

By consolidating asset and threat data, organizations can make more informed decisions about which vulnerabilities and incidents pose the greatest risk to their environment.

Connector Details

Here is a comprehensive overview of what the Cybereason Connector supports.

Vendor

Cybereason

Product Name

Cybereason for EDR

Category

ENDPOINT SECURITY

Findings Support

Not Supported

Supported Assets

Host Assets (Compute)

Version

1.0.0

Integration Type

API Integration (REST)

Direction

Unidirectional

Delta Support

Not Supported

Import of Installed Software Not Supported
Import of Source Tags Not Supported
Filters/Filter Query Not Supported

Before you Login Before you Login 

User Roles and Permissions

Access credentials are issued to Cybereason subscribers and include:

  • Domain (subdomain for API calls)
  • Username
  • Password

These are provided directly by CyberReason to authorized customer accounts.

How to Get Domain, Username, and Password

  • Domain: Provided by Cybereason and used in the API base URL (e.g., https://your-domain.cybereason.net/)
  • Username/Password: Issued upon subscription or user provisioning.

Create a Profile & ConnectionCreate a Profile & Connection

This step establishes the connector's identity and authenticates it with Cybereason.

  1. Log in to Qualys ETM and navigate to Connectors > Integration.
  2. Locate the Cybereason Connector on the Connector Marketplace and click Add. This is a one-time task.

    If the connector is already added, navigate to My Connectors, search for the Cybereason connector, and click Manage Connections.

  3. Click Manage Connections from the connector tile.
  4. Click Create Connection. The Setup Guide opens, displaying the Before You Begin checklist alongside four reference tabs: Overview, Auth Setup, Permissions, and Troubleshooting. 
  5. Click Proceed to Setup.
  6. On the Profile & Connectivity page, complete the following fields:

    Connector Details

    Field Description
    Name (required) A unique display name for this connector.
    Description An optional description of the connection's purpose.

    Authentication Details

    Provide the following values to authenticate the connector with your Cybereason environment.

    Field Description
    Domain Enter the Domain Name. Example: qualys.cybereason.net 
    Username Enter your Username. 
    Password Enter the Password. 

  7. Click Test Connection. A modal will appear showing the status of five sequential checks:
    • Network Reachability — Verifies that the connector endpoint is reachable over HTTPS (port 443).
    • TLS Handshake — Confirms that a secure TLS connection can be established with the remote endpoint.
    • Authentication Credential Check — Validates the configured credentials against the source system's authentication endpoint.
    • Authorization Scope Check — Confirms that the provided credentials have the required permissions to access the configured data scope.
    • Data Fetch — Verifies that data can be successfully retrieved from the source system using the configured connection.

    All five checks must pass before you can proceed. If the Authentication Credential Check fails with an Unauthorized error, verify that the Client ID, Client Secret, and Token URL are correct, and that the service account has not been disabled.

  8. Click OK and then click Next.

Scope and ScheduleScope and Schedule

This step defines what data is ingested and when the connector runs.

  1. Data to Sync - The below option is selected by default.
    • Assets - Ingests asset records only, without findings.
  2. Advanced Settings (optional) — Turn on the Advanced Settings toggle to select the asset classes and finding types that you want to ingest into ETM.
  3. Schedule — Under the Schedule section, select an execution frequency from the Occurs dropdown (for example, Daily). The system will display the calculated start date, end date, and timezone for the scheduled run. The schedule configuration supports recurring synchronization, such as Daily.

The schedule timezone is determined by your Qualys account settings. The connector will run from the configured start date for a default period of 5 years.

  1. Click Next.

Advanced Settings

Clicking the Advanced Settings link opens a panel with two tabs: Filters and Transform Map.

Filters Tab

Filter Options Description
Create assets that don't exist in Qualys  - If enabled, the connector ingests all those assets that are not created /exist in Qualys

Transform Map 

The Transform Map tab displays the default field mappings from Cybereason source fields to Qualys ETM target fields for each asset class. Map the fields from Cyberreason to the corresponding fields in your target system. Transform Maps ensure that the data is transformed correctly during import or export.

The CyberReason Connector offers an out-of-box transform map for you to proceed without further configuration.

Review and ConfirmReview and Confirm

Review all configured settings before creating the connection and then click Create.


The new connection is displayed in the Connections list with a Registered state and an Active status.

How Does a Connection Work?

The CyberReason connector functions through configured profiles, determining what data gets synchronized and when.

A Connection usually involves creating a profile that defines which vulnerabilities to import based on detection data types and asset types. The connector then automatically executes according to the schedule (or on-demand), pulling asset data from CyberReason into Qualys ETM where it can be viewed alongside other security findings.

With the CyberReason API Connector successfully configured, you are almost ready to view all the assets and findings from CyberReason.

In the Connector screen, you can find your newly configured connector listed and marked in the Processed state.

Connector States

A successfully configured connector goes through 4 states.

  1. Registered - The connector is successfully created and registered to fetch data from the vendor.
  2. Scheduled - The connector is scheduled to execute a connection with the vendor.
  3. Processing - A connection is executed, and the connector is fetching the asset and finding data.
  4. Processed - The connector has successfully fetched the assets, it may still be under process of fetching the findings. Wait for some more time for the connector to fetch the findings completely.

The Processed state indicates that the Connector is successfully configured but it is under the process of importing all your assets and findings. This process (specifically for findings) may take some time.

This entire process may take up to 2 hours for completion. Once it is done, you can find the imported data in Enterprise TruRisk Management (ETM).

View Assets in ETM

Navigate to Enterprise TruRisk Management to start analysing your Connector's vulnerability findings.

You can view the assets imported from the CyberReason connection by navigating to the Inventory tab of ETM.

Go to Assets > Host to find all of your imported assets.

Use the token, tags.name: 'CyberReason' to view all the imported CyberReason assets.

Here, you can learn about your assets' criticality and Risk Scores. Click any asset to view more details.

API Reference

Name Endpoint Information
Auth API https://{domain}.cybereason.net/login.html Auth token valid for 6 hours; auto-refreshed after expiry.
Fetch Asset List https://{domain}.cybereason.net/rest/sensors/query

Batch size: 50; retrieves endpoint inventory

Data Model Mapping

Data Model MapData Model Map

Source Attribute Key

Target Attribute Label

uniqueSensorKey

externalAssetId (Required)

machineName

assetName

fqdn

fqdn

osType

operatingSystemName

osVersionType

operatingSystemVersion

externalIpAddress

ipAddress

deviceModel

model

serialNumber

serialNumber

Transformation Maps

The default transformation map configured for the Cybereason connector is fetched from the database and utilized during the execution of the connector profile to perform data transformation.

Asset Host Asset Cybereason Edr MapAsset Host Asset Cybereason Edr Map

Source Field Target Field
deviceModel biosInfo.model
fqdn fqdn
osType operatingSystem.version
machineName hostName
FUNCTION_PICKER operatingSystem.name
uniqueSensorKey externalAssetId
serialNumber biosInfo.serialNumber
externalIpAddress networkInterfaces[].ipAddress
disconnectionTime sourceLastUpdatedDate
firstSeenTime sourceCreatedDate
decommissionedSensors temp_q_customAttributes.customAttribute
status customConnectorAttributes.cybereasonSensorStatus
version customConnectorAttributes.cybereasonSensorVersion
department customConnectorAttributes.cybereasonDepartment
groupName customConnectorAttributes.cybereasonGroupName
policyName customConnectorAttributes.cybereasonPolicyName
siteName customConnectorAttributes.cybereasonSiteName