Changes for page Dependency-Track
Last modified by Milad Afshar-Jahanshahi on 2025/09/03 14:31
From version 32.1
edited by Milad Afshar-Jahanshahi
on 2025/09/03 12:53
on 2025/09/03 12:53
Change comment:
There is no comment for this version
To version 57.1
edited by Milad Afshar-Jahanshahi
on 2025/09/03 14:28
on 2025/09/03 14:28
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 1 added, 0 removed)
-
Objects (0 modified, 0 added, 1 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,5 +3,3 @@ 1 -STILL UNDER CONSTRUCTION 2 - 3 3 [[image:logo-dependency-track.YzQAjtqS_Z2pMQkR.webp||alt="Grafana Icon Logo PNG vector in SVG, PDF, AI, CDR format" data-xwiki-image-style-alignment="end" height="52" width="190"]] 4 4 5 5 {{toc/}} ... ... @@ -6,46 +6,31 @@ 6 6 7 7 = Introduction = 8 8 9 -Dependency-Track is an open-source Software Composition Analysis (SCA) tool that helps organizations manage and secure their software supply chain. It automatically generates and maintains a Software Bill of Materials (SBOM) for projects ,continuously monitoringdependencies for known vulnerabilities. In addition, it tracks license compliance of open-source components, giving teams greater visibility and control. By integrating seamlessly into DevOps and CI/CD pipelines, Dependency-Track makes it easier to embed security throughout the development lifecycle.7 +Dependency-Track is an open-source Software Composition Analysis (SCA) tool that helps organizations manage and secure their software supply chain. It automatically generates and maintains a Software Bill of Materials (SBOM) for projects and the continuously monitors dependencies for known vulnerabilities. In addition, it tracks license compliance of open-source components, giving teams greater visibility and control. By integrating seamlessly into DevOps and CI/CD pipelines, Dependency-Track makes it easier to embed security throughout the development lifecycle. 10 10 11 11 [[Vendor Page>>https://dependencytrack.org/]] 12 12 13 -There are several useful resources available to get started with Dep track:11 +There are several useful resources available to get started with Dependency-Track: 14 14 15 15 [[Dependency-Track Documentation>>https://docs.dependencytrack.org/]] 16 16 17 -[[Impact Analysis>>https://docs.dependencytrack.org/usage/impact-analysis/]] 18 - 19 -[[Collection-projects>>https://docs.dependencytrack.org/usage/collection-projects/]] 20 - 21 21 = Accessing Dependency-Track = 22 22 17 +Dependency-Track is integrated into the DevOps-as-a-Service tool chain, but for now it is only available to pilot customers. To get started, a few prerequisites need to be in place. 23 23 24 -Dependency-Track is integrated into the DOSSS toolchain, but for now it’s only offered in the Pilotkunden Preview. To get started, a few prerequisites need to be in place. 25 - 26 - 27 27 == Preconditions in DevOps portal to access Dependency-Track == 28 28 29 -1. A Dep endency-Track license must be assigned to the user30 -1. Dep endency-Track must be added to the tool list of the project21 +1. A DepTrack license must be assigned to the user by a Portal Admin. 22 +1. DepTrack must be added to the tool list of the project by a Project Admin or Portal Admin. 31 31 32 32 (% class="box warningmessage" %) 33 33 ((( 34 34 ⚠ **Note** 35 - Im Gegensatzzu anderenToolsist ein Loginnurdannmöglich,wennderUsereineLizenzhat und inmindestenseinemDepTrackProjekteine Rolle hat27 +Unlike other tools, login is only possible if the user has a valid license and is assigned a role in at least one Dependency-Track project. 36 36 ))) 37 37 30 +After completing the preconditions, a project in Dependency-Track, which is part of the DevOps-as-a-Service tool chain, can be accessed via the DevOps Portal or directly through the Depdency-Track URL. 38 38 39 - 40 - 41 - 42 - 43 - 44 - 45 - 46 - 47 -After completing the preconditions, a project in Dependency-Track, which is part of the DevOps-as-a-Service toolchain, can be accessed via the DevOps Portal or directly through a URL. 48 - 49 49 == Via DevOps Portal == 50 50 51 51 Go to the DevOps Portal Homepage and click on the link //Project// in the Project Vulnerabilities tile: ... ... @@ -55,8 +55,9 @@ 55 55 (% class="box warningmessage" %) 56 56 ((( 57 57 ⚠ **Note** 58 -If you are still unable to access your project in Dependency-Track, it may be because you are logged in with an old session that still uses outdated permissions or To resolve this issue, please log out and then log in again: 59 -\\[[image:login1.png||alt="Untitled2.png" height="250" width="600"]] 41 +If you are still unable to access your project in Dependency-Track, it may be because you are logged in with an old session that still uses outdated permissions. To resolve this issue, please log out and then log in again. 42 +For some reason, you may need to click more than one time on the OpenID button or go to the login page ([[https:~~/~~/deptrack-<customer~>.devops.t-systems.net/>>https://<customer>.devops.t-systems.net/xwiki/wiki/<pkey>/view]]login) to access the new session. 43 +\\[[image:login1.png||alt="Untitled2.png" data-xwiki-image-style-border="true" height="297" width="650"]] 60 60 ))) 61 61 62 62 == Via Direct URL == ... ... @@ -64,67 +64,63 @@ 64 64 You can also access Dependency-Track directly using the following link format: 65 65 [[https:~~/~~/deptrack-<customer~>.devops.t-systems.net/projects>>https://<customer>.devops.t-systems.net/xwiki/wiki/<pkey>/view]] where <customer> is the id of your DevOps-as-a-Service instance. 66 66 67 -If you are not already logged in to another tool in the toolchain or the DevOps portal, then you have to login using your configured SSO credentials. 51 +If you are not already logged in to another tool in the tool chain or the DevOps portal, then you have to log in using your configured SSO credentials. 68 68 69 69 54 += Projects = 70 70 71 - ==Dependency-TrackJenkinsInteraction==56 +After creating a DevOps project in the portal, a Dependency-Track project is automatically created. The type of the new project is** Collection Project**. Subprojects which keep the real SBOM scan results are later created as children of this collection project. This makes it easier to see aggregated metrics, such as vulnerabilities and license compliance, without having to open each subproject individually. 72 72 73 - NursdcPipeline()wirdunterstützt,nurmaven(bisher),allesautomatisch58 +For more details, see the [[Collection Projects>>https://docs.dependencytrack.org/usage/collection-projects/]] section in the Dependency-Track documentation. 74 74 60 +== Integration with Jenkins == 75 75 76 - ==CollectionProjectundUnterprojekte==62 +The [[Jenkins Shared Library>>url:https://prd.sdc.t-systems.net/xwiki/wiki/devopsaas/view/Jenkins/Jenkins%20Shared%20Library/]] will automatically create SBOM (Software Bill of Materials) files for maven projects and upload them to Dependency-Track. 77 77 78 - TODO64 +[[image:1756907509490-678.png]] 79 79 80 - =Users,Projects andRoles=66 +A new Dependency-Track sub project is automatically created on the fly. 81 81 82 - * Projects,users and theirroles inprojects are managed in the DevOps Portal, thecorresponding functionsinDependency-Trackare disabled(UIandAPI)68 +Currently, this option is only available for Maven projects. 83 83 84 -⚠ **Note** 85 -Projects in the DevOps portal are mapped to the corresponding subwikis in Dependency-Track. 86 86 87 -* When Dependency-Track is added as a tool to an existing or new project, a corresponding subwiki is automatically created. Users assigned to the project in the DevOps Portal are then added to the subwiki with the roles defined in the configuration : 88 -** Role mapping: ((( 89 -|=Project Role in DevOps Portal|=Permissions in XWiki 90 -|Admin| POLICY_VIOLATION_ANALYSIS,''VIEW_POLICY_VIOLATION,''VIEW_PORTFOLIO,'VIEW_VULNERABILITY,''VULNERABILITY_ANALYSIS' 91 -|Master|(% colspan="1" %)Can view, comment, and edit pages, but cannot delete content 92 -|Developer|(% colspan="1" %)Similar to Master 93 -|Viewer|Read-only access. Can only view content, no edits or comments allowed 71 += Users and Roles = 94 94 95 -A detailed description of the XWiki role model can be found [[here>>https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/Access%20Rights/Permission%20types/]] 73 +* Projects, users and their roles in projects are managed in the DevOps Portal, the corresponding functions in Dependency-Track are disabled (UI and API). 74 + 75 +* Users assigned to a project in the DevOps Portal are automatically added to the matching Dependency-Track projects with the roles as shown below:((( 76 +|=Project Role in DevOps Portal|=Permissions in Dependency-Track 77 +|Admin|POLICY_VIOLATION_ANALYSIS, VIEW_POLICY_VIOLATION, VIEW_PORTFOLIO, VIEW_VULNERABILITY, VULNERABILITY_ANALYSIS 78 +|Master|(% colspan="1" %)POLICY_VIOLATION_ANALYSIS, VIEW_POLICY_VIOLATION, VIEW_PORTFOLIO, VIEW_VULNERABILITY, VULNERABILITY_ANALYSIS 79 +|Developer|(% colspan="1" %)POLICY_VIOLATION_ANALYSIS, VIEW_POLICY_VIOLATION, VIEW_PORTFOLIO, VIEW_VULNERABILITY, VULNERABILITY_ANALYSIS 80 +|Viewer|VIEW_POLICY_VIOLATION, VIEW_PORTFOLIO, VIEW_VULNERABILITY 96 96 ))) 97 97 98 98 = Main Features = 99 99 100 - InsideDevOps-as-a-Service, deptrack is mainlyusedfor writing specificationsand documentations. See below for a list of the main features of XWiki.85 +== Auditing Basics == 101 101 102 -== Collaborative Content Editing == 87 +(% class="wikigeneratedid" %) 88 +Dependency-Track offers a robust auditing workflow: you can triage findings on individual projects, add comments, and record analysis decisions. The platform logs a complete audit trail for each action. Users with the VULNERABILITY_ANALYSIS permission can perform these audits, and audit histories are visible to anyone with the VIEW_VULNERABILITY permission. 103 103 104 -* WYSIWYG and wiki syntax editors 105 -* Version control and history tracking 106 -* Inline and structured content editing 107 -* Commenting and annotations 90 +(% class="wikigeneratedid" %) 91 +You can explore the [[Auditing Basics>>https://docs.dependencytrack.org/triage/auditing-basics/]] section in the Dependency-Track documentation for deeper insights. 108 108 109 -== Advanced Page & DocumentManagement==93 +== Impact Analysis == 110 110 111 -* Hierarchical page structure (nested pages) 112 -* Templates for creating structured documents 113 -* Tags, categories, and metadata support 114 -* File attachments and preview 95 +(% class="wikigeneratedid" %) 96 +Dependency-Track enables organizations to assess how a vulnerability affects their environment. If a vulnerability is published in a supported datasource (e.g., NVD, GitHub Advisories, OSS Index, VulnDB), the platform dynamically identifies all affected projects. This allows you to answer: "What is affected?" and "Where am I affected?" at a glance. 115 115 116 -== Powerful Search and Navigation == 98 +(% class="wikigeneratedid" %) 99 +You can explore the [[Impact Analysis >>https://docs.dependencytrack.org/usage/impact-analysis/]]section in the Dependency-Track documentation for deeper insights. 117 117 118 -* Full-text search (Solr-based) 119 -* Faceted search filters 120 -* Page index, breadcrumbs, and navigation panels 101 +== Analysis States == 121 121 122 -== Macros and Widgets == 103 +(% class="wikigeneratedid" %) 104 +Dependency-Track tracks the status of findings through their lifecycle via "analysis states". These help teams understand whether findings are new, under review, suppressed, or resolved. You can reference the Analysis States section in the documentation for full details on available statuses and workflows. 123 123 124 -* Built-in and custom macros (charts, galleries, diagrams) 125 -* Embedding of rich media (videos, iframes, etc.) 126 -* Markdown and LaTeX support 106 +(% class="wikigeneratedid" %) 107 +You can explore the [[Analysis States>>https://docs.dependencytrack.org/triage/analysis-states/]] section in the Dependency-Track documentation for deeper insights. 127 127 128 128 129 - 130 130
- 1756907509490-678.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +xwiki:XWiki.borisfolgmannt-systemscom - Size
-
... ... @@ -1,0 +1,1 @@ 1 +5.4 KB - Content
- XWiki.XWikiComments[0]
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -xwiki:XWiki.miladafshar-jahanshahit-systemscom - Comment
-
... ... @@ -1,13 +1,0 @@ 1 -[[https:~~/~~/docs.dependencytrack.org/>>url:https://docs.dependencytrack.org/]] 2 - 3 -Optionales Tool: aktivieren als Project Admin für das Projekt, zuweisen von Lizenzen als Portal Admin an die entsprechenden User 4 - 5 -Im Gegensatz zu anderen Tools ist ein Login nur dann möglich, wenn der User eine Lizenz hat und in mindestens einem DepTrack Projekt eine Rolle hat ~-~-> Done 6 - 7 -Dashboard -> DepTrack Login Seite ~-~-> DOne 8 - 9 -Pilotkunden Preview ist 10 - 11 -Nur sdcPipeline() wird unterstützt, nur maven (bisher), alles automatisch 12 - 13 -Collection Project und Unterprojekte - Date
-
... ... @@ -1,1 +1,0 @@ 1 -2025-09-03 08:45:10.589