Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Document differences between Dependency-Track 4.x and Hyades / DT 5.x #927

Closed
Tracked by #860
nscuro opened this issue Nov 23, 2023 · 1 comment · Fixed by #1354
Closed
Tracked by #860

Document differences between Dependency-Track 4.x and Hyades / DT 5.x #927

nscuro opened this issue Nov 23, 2023 · 1 comment · Fixed by #1354
Labels
documentation Improvements or additions to documentation help wanted Extra attention is needed p2 Non-critical bugs, and features that help organizations to identify and reduce risk

Comments

@nscuro
Copy link
Member

nscuro commented Nov 23, 2023

While we are mostly compatible with DT 4.x, we made a few changes that users should know about when considering an upgrade.

For example:

  • How configuration is done
  • What RDBMSes are supported / or not supported
  • New notifications that were added
  • New features (e.g. workflow state tracking)
  • ...
@nscuro nscuro added documentation Improvements or additions to documentation p2 Non-critical bugs, and features that help organizations to identify and reduce risk labels Nov 23, 2023
@nscuro nscuro mentioned this issue Nov 23, 2023
Open
34 tasks
@nscuro
Copy link
Member Author

nscuro commented Feb 9, 2024 •
edited
Loading

Breaking Change: Some Notification Values Changed

  • Generally, subject objects passed to notification templates are Protobuf objects now, as defined in https://github.com/DependencyTrack/hyades/blob/main/proto/src/main/proto/org/dependencytrack/notification/v1/notification.proto
    • Shouldn't break anything by itself, but some fields may be named differently
    • List fields now have a List suffix (i.e. vulnerabilities -> vulnerabilitiesList)
  • Level values are now prefixed with LEVEL_
    • Before: INFORMATIONAL
    • Now: LEVEL_INFORMATIONAL
  • Scope values are now prefixed with SCOPE_
    • Before: SYSTEM
    • Now: SCOPE_SYSTEM
  • Group values are now prefixed with GROUP_
    • Before: NEW_VULNERABILITY
    • Now: GROUP_NEW_VULNERABILITY
  • The timestamp value passed to notification templates is now consistently formatted with three fractional digits (Ensure consistent formatting of notification timestamps #795)
    • Before: 1970-01-01T00:11:06Z, or 1970-01-01T00:11:06.000Z, or 1970-01-01T00:11:06.000000Z, or 1970-01-01T00:11:06.000000000Z
    • Now: 1970-01-01T00:11:06.000Z

nscuro added a commit that referenced this issue Feb 12, 2024
@nscuro
Port notification publisher fixes and tests
b79c557 
Ports the following PRs:

* DependencyTrack/dependency-track#3198

Closes #1071

Further fixes:

* Wrong base URL being set for `JiraPublisher`
* Bearer token authentication with Jira not working (DependencyTrack/dependency-track#2642 was not ported for some reason)
* Notification template using values that no longer exist
  * Observed differences between Hyades and DT v4.x have been documented here: #927 (comment)

Signed-off-by: nscuro <nscuro@protonmail.com>
@nscuro nscuro mentioned this issue Feb 12, 2024
Merged
@VinodAnandan VinodAnandan added the help wanted Extra attention is needed label Jun 30, 2024
@nscuro nscuro mentioned this issue Jul 1, 2024
Merged
1 task
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
documentation Improvements or additions to documentation help wanted Extra attention is needed p2 Non-critical bugs, and features that help organizations to identify and reduce risk
Projects
None yet
Milestone
No milestone
Development

Successfully merging a pull request may close this issue.

Clean up and extend documentation DependencyTrack/hyades
2 participants
@nscuro @VinodAnandan