Skip to main content

Sonatype IQ Server 197 Release Notes

Released November 5, 2025

The IQ 197 release includes multiple changes to our IQ-powered solutions. View the details in each solution’s section below.

Sonatype_Logo_Favicon.png Changes Impacting Multiple Solutions

This release includes the following changes impacting multiple IQ-powered solutions:

Improved Advanced Search User Experience

We have redesigned IQ’s Advanced Search to make searching across your data easier and more flexible. This update introduces a new Query Builder alongside the existing Add Search Terms option, providing both guided and manual methods for constructing complex searches.

1705345087.png

Key enhancements include the following:

  • A new tile-based layout improves visual consistency across the platform.

  • Query Builder allows users to create structured queries by selecting fields, match types (partial or exact), and logical operators (AND, OR). Each rule includes real-time examples to guide input formatting.

  • The existing Add Search Terms option remains available for users who prefer direct control over query syntax.

  • Inline guidance, including an expandable tip labeled Craft your search terms for the best results, offers real-world examples to improve search effectiveness.

Note

While both Query Builder and manual entry are supported, mixing the two within the same search may result in inconsistent behavior. For best results, use one method per query.

For full details, see the Advanced Search help documentation.

Lifecycle Sonatype Lifecycle

This release includes the following changes for Sonatype Lifecycle:

Create Bulk Waivers Through the User Interface

You can now create bulk waivers (simultaneous waivers for multiple policy violations) directly through the Sonatype Lifecycle user interface.

4.png

This enhancement builds on the bulk waiver API capability introduced in version 196 and adds a user-friendly interface in version 197. The new UI option streamlines waiver management, improves consistency, and reduces the time required to handle multiple policy violations.

Bulk waivers can be created from both the Application Report and Component Details pages by users with the WAIVE_POLICY_VIOLATIONS permission.

For detailed instructions, see the Bulk Waivers help documentation.

Enforce Minimum Integration Versions

With this release, a new integrationsSupportedVersionCount system property allows organizations to enforce a minimum version range for Sonatype integrations that include scanning functionality. When configured, only a defined number of the most recent integration versions are permitted to initiate policy evaluations.

This enhancement helps ensure consistent access to the latest features (e.g., AI-powered model identification) and promotes alignment across teams using scanning integrations.

If not configured, all integration versions remain supported by default. Evaluations initiated from the Lifecycle UI or during re-evaluations are not subject to this version check.

For full configuration details, see the Configuration REST API help documentation.

Waiver Status Included in PDF Reports

Sonatype Lifecycle now includes waiver status information in the Policy Violations table of the PDF version of the Application Composition Report. A new Waived column indicates whether each policy violation has been waived (Yes / No), giving users clear visibility into all policy decisions. This enhancement supports better auditing and historical tracking of component evaluations.

For details on generating PDF reports and what they contain, see the PDF Report help documentation.

Improved User Experience When Modifying Waiver Configuration

Waiver configurations now automatically reset when the selection criteria are modified. Previously, waiver settings were retained even after changing the selection filters, which could result in unintended policy exceptions. With this update, modifying selected violations on the previous step clears the waiver configuration, ensuring it accurately reflects the current evaluation scope.

Support for Preserving Original Package URLs in CycloneDX SBOMs

This release includes support for a sonatype:original_purl property in exported CycloneDX SBOMs. This Sonatype-specific metadata, added under the Sonatype namespace, preserves the original package URL (purl) from ingested SBOMs. Including this property helps maintain consistent component identity and improves interoperability when tracking components across different tools in your software supply chain.

For full details, see our CycloneDX Application Analysis documentation.

sonatype-developer-icon.png Sonatype Developer

This release includes the following changes for Sonatype Developer:

Support for GPG-Based Commit Signing

Sonatype Lifecycle now supports GPG-based commit signing for both native Git and jGit. This enhancement allows teams to include commit signature verification in their policy evaluation workflows, strengthening software supply chain integrity and helping ensure that only trusted commits are used in builds and scans.

SBOM Manager Sonatype SBOM Manager

This release does not include any notable SBOM Manager-specific changes.

Sonatype Repository Firewall Sonatype Repository Firewall

This release includes the following changes for Sonatype Repository Firewall:

Firewall for Docker Scanning Now Uses Nexus Repository Network Settings

Starting with Nexus Repository version 3.86.0 and IQ Server version 197, Firewall for Docker Scanning now uses the network connection settings configured in Nexus Repository when accessing Docker registries.

This enhancement ensures that Docker scans respect custom networking configurations, allowing seamless image downloads and more consistent scanning behavior across different environments.

With this update, Firewall scans automatically apply the following Nexus Repository settings when available:

  • User-Agent customization

  • Connection and socket timeouts

  • Connection retry attempts

  • HTTP and HTTPS proxy settings, including host, port, authentication, NTLM domain, and hostname

If you use Nexus Repository 3.86.0 with an earlier version of IQ Server, Firewall for Docker will fall back to the older IQ CLI scanning method, which does not apply the Nexus Repository HTTP configuration.

Expanded Support for OCI-Based Docker Images

Firewall for Docker now supports analyzing and quarantining a broader range of OCI-compliant images requested through Docker proxy repositories. This includes multi-architecture manifest lists, single-manifest images without layers, and uncompressed image layers. These updates improve compatibility with modern image formats by adding support for less common Docker layer constructs.

Bug Fixes

This release includes the following notable bug fixes:

Issue ID

Description

NEXUS-48987

InnerSource repository connections to Sonatype Nexus Repository cloud tenants now succeed without requiring the Server response header, enabling compatibility with Nexus Repository Cloud in IQ Server.

NEXUS-47655

Starting with Nexus Repository version 3.86.0 and IQ Server version 197, Firewall for Docker Scanning now uses the network connection settings configured in Nexus Repository when accessing Docker registries.

NEXUS-45459

The Vulnerability Lookup page is now available again for customers with a Repository Firewall-only license, and the login page link correctly directs to it.

CLM-37095

SBOM Manager now uses both component identifiers and hashes to accurately deduplicate components during SBOM import, improving performance for SBOMs containing large embedded license data.

CLM-37027

SBOM ingestion in both Sonatype Lifecycle and SBOM Manager now correctly imports all components when multiple entries share the same coordinates but have different SHA1 hashes.

CLM-35845

The IQ Operator Helm chart now supports specifying CPU limits for pods, enabling deployment in environments with enforced resource quotas.

CLM-35775

Support zip generation now enforces a cluster-wide lock to prevent concurrent requests, avoiding collisions and file access errors during zip creation.

CLM-35279

IQ Server no longer requires the Server response header to validate Nexus Repository connections in InnerSource Repository configuration, allowing support for environments that restrict HTTP header exposure through reverse proxies.

Coming Soon

We’re excited to share that the following enhancements will be coming soon:

New Product Launch Coming Soon

Sonatype will soon introduce a new product that helps your AI coding assistant make smarter dependency choices. A preview of the first component, our Model Context Protocol (MCP) server, is available now for early exploration. Sonatype’s MCP server guides AI to select secure, reliable, and license-compliant versions using Sonatype’s trusted open source intelligence.