Skip to main content

Detectify

Visualize Detectify scan reports and monitor changes through queries and alerts.

Installation​

The integration connects directly to the Detectify REST API to obtain application scan assets, reports, and findings. By default, it only ingests findings from the past 30 days. If you have an Enterprise Plan with Detectify, the configuration can be changed to ingest findings from the latest scan reports.

Configuration in Detectify​

note

You will need a Detectify API key to allow the integration to make REST API calls. The API-keys tab is only visible to team Admins, so you must have admin permissions for the team to create the key.

  1. In Detectify, open the user menu and go to Team settings, then select the API-keys tab.

  2. Click Generate API key and, if desired, give the key a name or description in the modal.

  3. On professional and enterprise plans, you can optionally configure Setting Permissions for the key or require a message signature (secret key). These controls are not required for the integration.

  4. The key is shown only once. Copy it and store it in a safe place — you will paste it into JupiterOne. API keys can be reviewed and managed later from the API keys page.

For more detail, see Detectify's guide to setting up the API.

Configuration in JupiterOne​

To install the Detectify integration in JupiterOne, navigate to the Integrations tab in JupiterOne and select Detectify. Click New Instance to begin configuring your integration.

Creating an instance requires the following:

  • The Account Name used to identify the Detectify account in JupiterOne. Ingested entities will have this value stored in tag.AccountName when the AccountName toggle is enabled.

  • A Description to assist in identifying the integration instance, if desired.

  • A Polling Interval that you feel is sufficient for your monitoring needs. You may leave this as DISABLED and manually execute the integration.

  • Your Detectify API Key, configured for read access, generated in the steps above.

Click Create once all values are provided to finalize the integration.

Data Volume Configuration​

The Detectify integration provides configuration options to control the volume of data ingested into JupiterOne:

FieldDescriptionDefaultOptions
Get findings from the latest scansWhen enabled, the integration pulls findings only from the latest scan reports. When disabled, the integration pulls all findings from the last 30 days. Requires an Enterprise Plan from Detectify.Disabled (pulls findings from the last 30 days)Enable to pull only the latest scan findings (requires Enterprise Plan)

Data Model​

The JupiterOne vulnerability management and scanner integration is built on this high level data model:


Vendor - HOSTS -> Account
Account - PROVIDES -> Service (*)
Service - SCANS or TESTS -> <Entity> (*)
<Entity> - HAS -> Finding

(*) Examples:

  • Service (E.g., SAST, DAST, IAST, MAST, PenTest, etc.)
  • <Entity> (E.g., Application, Host, or Device)

Optionally, the following is added when each scan/assessment/report is also tracked by the integration:


Service - PERFORMS -> Assessment
Assessment - IDENTIFIED -> Finding

Next steps​

Now that your integration instance has been configured, it will begin running on the polling interval you provided, populating data within JupiterOne. Continue on to our Instance management guide to learn more about working with and editing integration instances.