2 Warning |
---|
October 2022 - Known Issue Warning: Following changes in the K8 APIs, installing or upgrading ThreadFix on Kubernetes versions 1.25 or newer will fail. This issue will be addressed in the next ThreadFix release. | 32September 2022 Note |
---|
Users interested in migrating to 3.2 from 2.X must upgrade to 2.8.7 first, then contact the Coalfire Support Portal to continue with the 2.X to 3.X Migration process. Users upgrading from 3.1.2 please view the expandable note below before upgrading. |
In ThreadFix 3.2, Minio requires the Minio secret data to contain the keys “rootUser” and “rootPassword” instead of “secretKey” and “accessKey”. When attempting an upgrade, some users may encounter the following error: Code Block |
---|
Error: UPGRADE FAILED: template: threadfix/charts/minio/templates/secrets.yaml:14:15: executing "threadfix/charts/minio/templates/secrets.yaml" at <include "minio.root.username" .>: error calling include: template: threadfix/charts/minio/templates/_helpers.tpl:208:8: executing "minio.root.username" at <include "minio.getValueFromSecret" (dict "Namespace" .Release.Namespace "Name" (include "minio.fullname" .) "Length" 20 "Key" "rootUser")>: error calling include: template: threadfix/charts/minio/templates/_helpers.tpl:198:28: executing "minio.getValueFromSecret" at <b64dec>: invalid value; expected string |
This error can be resolved by manually editing the Minio secret to change the data values to what is expected. Code Block |
---|
kubectl edit secret tf-minio |
Change the following: Code Block |
---|
apiVersion: v1
data:
secretkey: <secret-key-value>
accesskey: <access-key-value> |
To: Code Block |
---|
apiVersion: v1
data:
secretkey: <secret-key-value>
accesskey: <access-key-value>
rootUser: <access-key-value>
rootPassword: <secret-key-value> |
Once complete, perform the upgrade procedure once again. Helm Key Updates / Version Feature ChangesNew versions of ThreadFix may deprecate, remove, and/or reintroduce features. To view a list of feature changes please see below: Azure Dev Ops 2.X Feature Parity (3.X only) Integration Enhancements The following remote providers now ingest and store CVSS values: Acunetix 360, Black Duck, Netsparker, NowSecure, and WhiteHat Sentinel Source Checkmarx can now ingest additional scanner detail and scanner recommendations for findings Contrast date management enhancements to provide greater accuracy on finding discovery dates Improved SonarQube severity mappings The maximum number of Defect Profiles that can be associated with a single defect tracker has been increased to 1024 Improvement to Fortify SCC findings filtering
To view a complete list including prior releases, please view the 3.X Version Feature Changes list. Addressed Reported Issues and Security Updates Upgraded dependencies and images including Debian, Kafka, and ActiveMQ Fixed intermittent import errors with Acunetix 360/Netsparker WhiteHat API updates to support new requirements from WhiteHat Improvement to UI messaging indicating when all remote providers have been mapped Improvement to UI messaging indicating when an invalid scanId was used The ThreadFix UI Help button has been adjusted to now direct to the Coalfire Support Portal
Issue | Resolution |
---|
Importing scan data from AsoC fails, displaying the following error message: “RestIOException: Invalid response from ASoC while fetching last scan date.” | Resolved ASoC integration errors on import | A user without read-access could view all policy data for an application | The Policies tab in ThreadFix has been updated to address the information disclosure | A vulnerability’s open and close dates will no longer shift with new scan uploads unless a reopen or close event occurs | Resolved scan delete error if it includes findings that belong to vulnerabilities that have been closed and reopened multiple times | When trying to update Jira Defect Tracker integration credentials, a 403 error is received with the following message: “Failure. Message was : The defect tracker URL is not valid." | Resolved JIRA connection issue | "You don't have permission for this team." error is received when attempting to move an application to another team using the Update Application API even with an Administrator Global role | The Update Application API has been updated to address the permissions error, allowing the application to be successfully moved | User unable to save an LDAP-linked SAML configuration, receiving a “Display Name Config Not Found” error | This issue has been addressed in 3.2 | Threadfix files incorrectly export with a filename of null instead of the associated application’s name | A fix has been provided to ensure the Threadfix files correctly export with associated application’s name | Occasionally Qualys WAS Finding Scan Details and Scan Recommendation sections do not import | Version 3.2 corrects the reported issue with the scanner details and recommendations properly displaying | Error importing Contrast cloud scans | Resolved imports failing for certain Ruby applications |
3.1.2May 2022 Note |
---|
To upgrade to 3.1.2 please see the Upgrade & Migration guides. Users interested in migrating from 2.8.6 to 3.1.2 must follow the 2.X to 3.X Migration process. Note: Migration from 2.8.5.1 to 3.1.2 is currently not supported. |
Helm Key Update Version Feature Changes New versions of ThreadFix may deprecate, remove, and/or reintroduce features. To view a list of feature changes please see below: To view a complete list including prior releases, please view the 3.X Version Feature Changes list. 3.1.1April 2022 Warning |
---|
The National Vulnerability Database has identified a high risk exploit, Spring4Shell, which affects applications running Tomcat as a WAR deployment. For more information refer to CVE-2022-22965. In response Coalfire has tested ThreadFix to assess risk and mitigation options and recommends users update to ThreadFix version 3.1.1 to mitigate risk of exposure and provide security enhancements. |
Note |
---|
Migration from 2.8.5.1 to 3.1.1 is currently not supported. Users interested in migrating to 3.1.1 must upgrade to 2.8.6 first then continue with the 2.X to 3.X Migration process. |
Key Updates New/Updated API New versionName and versionNativeId API calls for Black Duck Remote Provider, allowing users to import scans from multiple versions of a project at once New Fetch Applications and Get Scans API calls for Contrast Remote Provider The Get Application by Name and Get Application in a Team by Unique ID calls have been merged into Get Application by Name or Unique ID The Create Application and Update Application REST calls have been updated to include additional fields
General Improvements Remote providers can now also be instantly managed via drop-down menu from the Remote Provider list page CVSS scores now available as part of Finding Details General UI improvements General bug fixes and improvements
Feature ChangesNote the following changes to features with the introduction of ThreadFix 3.1.1: Reintroduced Deprecated and Removed For other REST API updates, refer to the Change Log The Black Duck call "/remediating" has been deprecated by Black Duck in version 2021.10.0 and has been replaced by "/upgrade" The SSVL Converter Tool deprecated in 3.1 has been removed (since SSVL scan uploads are no longer supported)
3.1October 2021 Note |
---|
Migration from 2.8.5.1 to 3.1 is currently not supported. Users interested in migrating to 3.1 should upgrade to 2.8.4 first then continue with the 2.X to 3.X Migration process. |
Key Updates Fundamental and holistic rebuild of the ThreadFix architecture and deployment environment (please see the new environment requirements). To install a helm chart offline see the manual helm download. Full rewrite of our scan ingestion and processing logic to provide over 60x reduction in raw scan data processing speed Introduction of Remote Provider UI display cards and associated API Remote provider import and scan ingestion statuses display on the Scan Queue page Updates to the Scan Import Queue’s UI tooltips Update to add a new Queue Management permissions level
New/Updated API New GET ThreadFix application assets by import request ID API New GET Remote Provider Import Requests API New Pending Scan Status API New Scan Queue Management report view API Update to Remote Provider Import Request API
General Improvements Improvements to user login session management Leveraged new architecture to implement self-recovery for scan ingestion Improvements to Manual Vulnerability Actions Security improvements Bug fixes
Feature ChangesNote the following changes to features with the introduction of ThreadFix 3.1: Deprecated and Removed Support has been ended for the SSVL Converter and SSVL scan uploads Bi-directional capability for Checkmarx and AppSpider has been removed Service Delivery/Service Request feature set is no longer supported Removed the Import All Vulnerabilities remote provider option Saved scan files on the file system will not be migrated to 3.1 (NOTE: this only impacts the raw scan files. All vulnerability data is fully retained and migrated) SonarQube Plugin removed from the Tools section. Remote Provider integration still behaves as before. Support for the following integrations has been removed:
Limitations, Scheduled for Enhancement Post 3.1 Limit of 3000 vulnerabilities when exporting Vulnerability Search data to a .csv file. Remediation filters do not update automatically in 3.1, they will update with a defect status call sync. This feature is planned to be reintroduced. (NOTE: this may impact created policies based on these filters)
Absent, Scheduled for Re-introduction Post 3.1 The Disable Vulnerability Merging option when creating a new application has been removed, this feature is planned to be reintroduced Scan File Retention feature has been removed, this feature is planned to be reintroduced The Vulnerability Close Settings option, allowing users to close vulnerabilities only when all scanners report them closed, has been removed, but is planned to be reintroduced The Scan Agent tool API endpoints have not been migrated, this feature is planned to be reintroduced The ability to cancel queued scans has been removed, this feature is planned to be reintroduced in the future Time to Remediate Date policy override has been disabled, this feature will be reinstated Dashboard and Analytics page report caching time configuration has been disabled with plans to be re-enabled The Global FPR Filter Set API REST calls have been removed, with plans to be reintroduced Support for the following integrations has been removed, with plans for reintroduction: Acunetix File Importer Brakeman Coverity Dependency Check Sonatype
3.0.8March 2021 Note |
---|
Do Not Upgrade Without Reading This First!The following only applies to users upgrading from an older version of v3 to 3.0.8. When upgrading from v2 to v3, you must first be on latest, 2.8.3. Upgrade instructions can be found here. Adjusted vulnerability Open/Close Time to be Scan Date instead of Updated Date. To preserve historic reporting, no existing data will be retroactively changed. If you would like to have your historic data migrated to match the new date ingestion logic, please open a support ticket to request a migration script. Logic changes have been made to enforce vulnerability status uniqueness. Any vulnerabilities with multiple statuses will have their statuses updated in the migration to 2.8.2 from an earlier version of 2.X or updating from version 3.0.6. For additional information please review the Vulnerability Status Migration Logic.
|
Security Updates Key Updates Issue fix for Qualys scan imports Docker Logging improvement Fix for Netsparker upload issue Bug fix for SonarQube Improved import ingestion and configuration options for InsightVM Support added for JAVA_OPTIONS modifications Issue resolution for QualysWAS findings scan profiles and findings merging error Comprehensive Time zone management updates in ThreadFix Fortify on Demand no longer imports Fixed or Suppressed findings Introduced support for Acunetix 360 Remote Provider and Acunetix Premium exports Improvement to the Jenkins plugin Added CVSS Score and Vulnerability IDs as dynamic Defect Tracker profile values Checkmarx Remote Provider microservice mapping performance improvement Vulnerability statuses are now mutually exclusive WhiteHat mobile data support Checkmarx enhanced finding tracking Portfolio page now reflects ThreadFix Pen Tests as Assessments WebInspect findings details expanded Portfolio Application View pagination Most Vulnerable Applications report grouping Significant performance improvements to the Team delete function Time to Remediate Policies now allow for per-vulnerability exceptions Veracode Remote Provider import includes SCA data NowSecure Remote Provider integration
General Improvements Improvements to UI-Page navigation Adjustment for improving scan data imports Improvement to Veracode Remote Provider scan updates API performance improvements Vulnerability Trending report improvements Portfolio UI improvements for large-scale deployments UI performance enhancements Bug fix for graphs displayed on PDF exports Filter on mobile vulnerability data Improved error messaging WhiteHat integration respects the Out of Scope status LDAP login supports additional user attributes Netsparker Enterprise enhancements Time to Remediate notification improvements File attachment usability improvements Updated 3rd party dependencies and other security improvements Other enhancements and bug fixes General performance improvements
Installation and Upgrade Guides:3.0.7October 2020 General Improvements Expanded SAML support to cover additional use cases. As of 3.0.7 SAML is fully configurable in the UI from the Settings page. Resolved issues in Checkmarx and SonarQube integrations Performance improvements Other enhancements and bug fixes
3.0.7 also contains the following AppSec updates. Key Updates Vulnerability statuses are now mutually exclusive WhiteHat mobile data support Checkmarx enhanced finding tracking Portfolio page now reflects ThreadFix Pen Tests as Assessments WebInspect findings details expanded Portfolio Application View pagination Most Vulnerable Applications report grouping Significant performance improvements to the Team delete function Time to Remediate Policies now allow for per-vulnerability exceptions Veracode Remote Provider import includes SCA data NowSecure Remote Provider integration
General Improvements Filter on mobile vulnerability data Improved error messaging WhiteHat integration respects the Out of Scope status LDAP login supports additional user attributes Netsparker Enterprise enhancements Time to Remediate notification improvements File attachment usability improvements Updated 3rd party dependencies and other security improvements Added OAuth support for Jira Defect Tracker integration Improved parsing of scan data from AppScan Enterprise and Fortify SSC
|