AboutCode Integrations

DejaCode relies on three services of the AboutCode stack to collect package data:

  • ScanCode.io: scan packages to detect their licenses, copyrights, and other metadata.

  • PurlDB: browse a database of packages mined and scanned from public sources.

  • VulnerableCode: get the known vulnerabilities affecting your packages.

Each service is enabled per Dataspace. Its URL and API key are taken from the Dataspace configuration when defined, otherwise from the application settings (see AboutCode integrations).

Configure a service in your Dataspace

  1. Select Admin Dashboard from the dropdown under your user name.

  2. Navigate to the Dataspaces section and select your Dataspace name.

  3. In the Application Process Settings section, check the option of the service.

  4. In the Configuration panel at the bottom of the form, set the URL and API key of the service.

  5. Click the Save button.

Service

Option

URL field

API key field

ScanCode.io

Enable package scanning

ScanCode.io URL

ScanCode.io API key

PurlDB

Enable PurlDB access

PurlDB URL

PurlDB API key

VulnerableCode

Enable VulnerableCodeDB access

VulnerableCode URL

VulnerableCode API key

Tip

To validate the setup, select Integrations Status from the dropdown under your user name.

ScanCode.io

With ScanCode.io, you can:

  • Provide a Download URL to create a Package, collect its data, and scan it.

  • Scan an existing Package from its Scan tab.

  • Review the scan results on the Scan tab and apply them to the Package definition.

  • Download the scan results as JSON to use them in other analysis and reporting tools.

Scans are listed from Scans in the Integrations section of the side menu.

See also

ScanCode.io and DejaCode Compliance Workflow for the complete workflow with ScanCode.io.

Install your own ScanCode.io server

Follow the instructions at https://scancodeio.readthedocs.io/en/latest/installation.html

For production use, the minimum system requirements for ScanCode.io are:

Item

Minimum

Processor

Modern X86 64 bit Multi Core, with at least 8 physical cores

Memory

64GB or more (ECC preferred)

Disk

2x500GB SDD in RAID mirror setup (enterprise disk preferred).

Warning

If you run ScanCode.io on the same server (virtual or physical) as DejaCode:

Secure ScanCode.io with authentication

For an enterprise deployment, enable authentication on ScanCode.io and give DejaCode an API key:

  1. Enable the ScanCode.io authentication system, see ScanCode.io Application Settings.

  2. Restart the ScanCode.io services:

    docker compose restart web worker
    
  3. Generate an API key for DejaCode, see CLI Create User.

  4. Set this key in the ScanCode.io API key field of your Dataspace configuration.

PurlDB

With PurlDB, you can:

  • Browse and search over 21 million Packages from PurlDB in the Integrations section of the side menu.

  • Create local Packages from PurlDB entries.

  • Get extra information on your local Packages from their PurlDB tab.

  • Extend the Global search results with Packages from the PurlDB.

  • Check for new Package versions in your Products inventory.

A public instance is available at https://public.purldb.io/api/packages/. To run your own instance, see https://purldb.readthedocs.io/.

VulnerableCode

DejaCode uses the Package URL (purl) of each Package to get its known vulnerabilities from VulnerableCode. With VulnerableCode, you can:

  • See a vulnerability icon next to affected Packages, in the Package list and in Product inventories.

  • Explore the vulnerabilities of a Package on its Vulnerabilities tab, with links to public reports (e.g. CVE, GHSA, DSA).

  • Analyze the vulnerabilities affecting your Products, see How To 4 - Product Vulnerability Analysis.

A public instance is available at https://public.vulnerablecode.io/api/. To run your own instance, see https://vulnerablecode.readthedocs.io/.

See also

Vulnerability Management for how vulnerability data is collected and used.