2019 Release Notes

The organization REST API now supports retrieving information for a single organization by its identifier or name.

The component label REST API can now manage component labels for an entire organization.

Starting with version 2.15.0-01, the clm-maven-plugin requires Java 8.

The Third-Party Scan REST API and CycloneDX Application Analysis have been extended to support the following features.

Visual refresh of IQ Server main header.

This release fixes a regression that prevented IQ Server 79 from starting if configured with an HTTPS connector that employed a server certificate making use of SNI.

Added policy waiver scope to the Component Waivers REST API.

The Nexus IQ for SCM Configuration UI allows for configuration of the integration between Nexus IQ Server and an external Source Control Management provider.

Automated Pull Requests allow for the automatic creation of pull requests for policy violations on components that have an available version that remediates those violations.

The report-related REST API has been extended to include the new property latestReportHtmlUrl in its response, providing a stable link to view the most recent report for a given application and stage.

Components in Quarantine REST API allows you to list repository components that are quarantined.

Release Component from Quarantine REST API allows you to release a quarantined repository component by waiving the policy violations causing the component to be quarantined.

CycloneDX Application Analysis is now extended to support submitting component vulnerabilities.

IQ Server integration with Clair provides you the ability to identify and apply IQ policies against Clair scanner results.

IQ Server can now be used to evaluate policies against a software component list supplied in CycloneDX SBOM (software bill-of-material) format. This can be used in the following ways.

Component Waivers REST API allows you to retrieve components with waivers for applications and repositories.

User Tokens REST API allows IQ users to create and delete user tokens. It also allows IQ Server administrators to purge obsolete tokens.

You can now look up a vulnerability without logging in.

Vulnerability Details REST API allows you to retrieve vulnerability details in the form of JSON.

IQ Server can now be configured to enable single sign-on via SAML during login, which can be done by a system administrator via the UI or via the SAML REST API.

The application and component evaluation have been updated to support Java 13 bytecode.

All previous releases of IQ Server suffer from a security vulnerability that allows authenticated users with the Edit System Configuration and Users permission to execute arbitrary code. We advise you to update your IQ Server at the earliest opportunity to this new release which contains the required fix. Details have been published on October 17: CVE-2019-16530 .

The support for anonymous access used by very old IQ clients and plugins was removed from the IQ Server. This doesn't affect you unless you are still using very old IQ clients or plugins. If present, the optional anonymousClientAccessAllowed setting should be removed from the config yml file used to configure the IQ Server.

The policy violation ID has been added to the REST API to facilitate Requesting a Waiver

During policy evaluation, the commit hash and repository URL are automatically deduced allowing our scanners (CLI, Jenkins, GitLab, etc) to pick up which commit and repository they are evaluating against. This will allow Nexus IQ for Git to push policy evaluation report summaries to Git commits and pull requests with minimal configuration.

You can now Request a Waiver when your workflow for waivers is handled outside of the IQ Server.

Policy evaluation report summaries and a link to the report can now be viewed on GitLab commits and pull requests.

Several additions to the public REST API of IQ Server were made to help automate the management of users and their roles:

We support the generation of SBOM using industry-standard CycloneDX specifications. The new CycloneDX REST API returns an SBOM containing coordinates and licenses for components in a scan report.

You can now use package URLs when configuring constraints in policy management.

IQ Server clients now poll for application evaluation results rather than waiting on the socket. Clients affected by this change are CLI, Jenkins, Bamboo, and Maven plugins.

Recent versions of IQ have had a bug where user interface resources could be cached within the browser across IQ version upgrades. This could cause a mismatch between the IQ frontend and backend code, or even a mismatch between different parts of the frontend code. This would result in UI breakages, such as an oversized IQ logo rendering the page unusable in Release 67. IQ 68 differs from IQ 67 only in that it fixes this issue.

Policy evaluation report summaries and a link to the report can now be viewed on GitHub commits and pull requests.

The following APIs are extended to support package URLs in requests and responses:

The Application Composition report now includes the option to easily see a list of the vulnerabilities that triggered policy violations associated with a given application.

You can now search for and view information about specific vulnerabilities directly from the top navigation bar in IQ Server.

As of Release 67 IQ no longer provides support for Internet Explorer 9 & 10.

A new command was added to reestablish the default admin account in a shutdown IQ Server including its default password and roles.

We are rolling out package URL-based component information access as an alternative to the coordinate-based component information retrieval in REST APIs. The following API is extended to support package URLs.

The webhook description is displayed in the UI where webhooks can be selected such as the webhook list or the policy editor.

Component Remediation Suggestions have been added to the Component Information Panel. For components that have policy violations, it will show the next available version that does not violate any policies for the given application, if such a version exists. This will be shown in the Application Composition Report and the IDE plugins.

The policy-centric Application Composition Report is no longer in preview mode and has now replaced the previous version of the report. The previous version is still accessible through the link provided in the new UI.

A new endpoint was added in order to provide policy violation data for a given report. See "Policy Violations by Report REST API (v2)" in Report-related REST APIs.

Added a new remediation type for the next closest component version which does not fail any policy violations.

Existing Application Composition Reports are not updated anymore when changes are made in the Component Information Panel. These changes become visible only when the application is re-analyzed (via the re-evaluation button or a new evaluation being triggered from CI, CLI, policy monitoring, etc). This ensures that the reports reflect the state of the application and policy evaluation results at the time the application was analyzed.

This release completes the data retention and purging feature introduced in release 63 by extending the IQ Server UI with the elements needed to inspect and edit the data retention for Success Metrics.

In order to facilitate automation and customization of component remediation, IQ Server now supports a Component Remediation API. The first release of the API provides similar data from the component intelligence panel version graph in a machine-readable format. The result of the request provides component remediation suggestions for policy violations on a per-component basis.

To reduce the disk space consumption of the IQ Server, you can now specify data retention policies for application reports and Success Metrics. Reports, that according to these retention policies are deemed obsolete, are automatically purged from sonatype-work/clm-server/report. Likewise, policy violation history that is no longer relevant for Success Metrics is purged from sonatype-work/clm-server/data. But note that automatic purging needs to be manually enabled after IQ Server is upgraded to the new version.

Users can now specify Python (PyPI) component coordinates when configuring constraints in policy management.

The application and component evaluation have been updated to support Java 12 bytecode.

Firewall now supports Artifactory repositories.

To reclaim disk space, this release includes a background task that deletes obsolete files from the sonatype-work/clm-server/scan directory. This task is only run once and scheduled automatically for 11 pm local time after the IQ Server is upgraded. Depending on the number of obsolete scan files in your installation, you might see elevated IO activity during that time when the files are removed.

Fixed a bug that resulted in Component IQ not being displayed in Nexus Repository Manager.

A new policy violation logging feature, which must be explicitly enabled, is now available. It logs its data to a dedicated log file in JSON format. This allows for easy line-by-line parsing for inspection, analysis, and extraction of desired data. It can be enabled/customized in your IQ Server configuration.

Python wheel packages are now recognized by the Sonatype IQ Server, CLI, Jenkins, Bamboo, and Maven plugins as well as the Vulnerability Scanner .

For added security protection against cross-site scripting and other attack vectors, the IQ server now sets the Content-Security-Policy and X-XSS-Protection HTTP headers.

The application and component evaluation have been updated to support Java 10/11 bytecode.

Audit loggingfunctionality has been extended to include

Python coordinate detection via the requirements.txt file has been extended from just theSonatype IQ Server and CLI to also include the Jenkins, Bamboo, and Maven plugins as well as the Vulnerability Scanner.

Audit logging functionality has been extended to include

The Component Information Panel has been updated to display the component category identified by Sonatype.

A new look of the Application Report is being added to IQ which will allow the user to interpret the report in a more policy-centric manner. We call this the Policy Centric App Report and a preview of this new look is now available alongside the existing reports.