Wiki source code of Dependency Track
Version 37.1 by Milad Afshar-Jahanshahi on 2025/09/03 13:05
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | STILL UNDER CONSTRUCTION | ||
| 2 | |||
| 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 | |||
| 5 | {{toc/}} | ||
| 6 | |||
| 7 | = Introduction = | ||
| 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 monitoring 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 | |||
| 11 | [[Vendor Page>>https://dependencytrack.org/]] | ||
| 12 | |||
| 13 | There are several useful resources available to get started with Deptrack: | ||
| 14 | |||
| 15 | [[Dependency-Track Documentation>>https://docs.dependencytrack.org/]] | ||
| 16 | |||
| 17 | [[Impact Analysis>>https://docs.dependencytrack.org/usage/impact-analysis/]] | ||
| 18 | |||
| 19 | = Accessing Dependency-Track = | ||
| 20 | |||
| 21 | Dependency-Track is integrated into the DevOps-as-a-Service toolchain, but for now it’s only offered in the Pilotkunden Preview. To get started, a few prerequisites need to be in place. | ||
| 22 | |||
| 23 | == Preconditions in DevOps portal to access Dependency-Track == | ||
| 24 | |||
| 25 | 1. A Dependency-Track license must be assigned to the user | ||
| 26 | 1. Dependency-Track must be added to the tool list of the project | ||
| 27 | |||
| 28 | (% class="box warningmessage" %) | ||
| 29 | ((( | ||
| 30 | ⚠ **Note** | ||
| 31 | 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. | ||
| 32 | ))) | ||
| 33 | |||
| 34 | 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. | ||
| 35 | |||
| 36 | == Via DevOps Portal == | ||
| 37 | |||
| 38 | Go to the DevOps Portal Homepage and click on the link //Project// in the Project Vulnerabilities tile: | ||
| 39 | |||
| 40 | [[image:deptrack.png||alt="Deptrack -Tile" data-xwiki-image-style-border="true" height="211" width="459"]] | ||
| 41 | |||
| 42 | (% class="box warningmessage" %) | ||
| 43 | ((( | ||
| 44 | ⚠ **Note** | ||
| 45 | 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: | ||
| 46 | \\[[image:login1.png||alt="Untitled2.png" height="250" width="600"]] | ||
| 47 | ))) | ||
| 48 | |||
| 49 | == Via Direct URL == | ||
| 50 | |||
| 51 | You can also access Dependency-Track directly using the following link format: | ||
| 52 | [[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. | ||
| 53 | |||
| 54 | 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. | ||
| 55 | |||
| 56 | |||
| 57 | = Projects = | ||
| 58 | |||
| 59 | == Dependency-Track Jenkins Integration == | ||
| 60 | |||
| 61 | When using sdcPipeline(), Maven projects automatically generate a Software Bill of Materials (SBOM) and are pushed to Dependency-Track. This process is fully automated through the provided pipeline library. Currently, this option is only available for Maven projects. | ||
| 62 | |||
| 63 | |||
| 64 | == Collection Project == | ||
| 65 | |||
| 66 | In Dependency-Track, these Maven builds are organized under a **Collection Project**. Subprojects (for example, individual modules of a Maven project) are created as children of the collection. This makes it easier to see aggregated metrics, such as vulnerabilities and license compliance, without having to open each subproject individually. | ||
| 67 | For more details, see the [[Collection Projects>>https://docs.dependencytrack.org/usage/collection-projects/]] section in the Dependency-Track documentation. | ||
| 68 | |||
| 69 | = Users and Roles = | ||
| 70 | |||
| 71 | * Projects, users and their roles in projects are managed in the DevOps Portal, the corresponding functions in Dependency-Track are disabled (UI and API) | ||
| 72 | |||
| 73 | ⚠ **Note** | ||
| 74 | Projects in the DevOps portal are mapped to the corresponding subwikis in Dependency-Track. | ||
| 75 | |||
| 76 | * 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 : | ||
| 77 | ** Role mapping: ((( | ||
| 78 | |=Project Role in DevOps Portal|=Permissions in XWiki | ||
| 79 | |Admin| POLICY_VIOLATION_ANALYSIS,''VIEW_POLICY_VIOLATION,''VIEW_PORTFOLIO,'VIEW_VULNERABILITY,''VULNERABILITY_ANALYSIS' | ||
| 80 | |Master|(% colspan="1" %)Can view, comment, and edit pages, but cannot delete content | ||
| 81 | |Developer|(% colspan="1" %)Similar to Master | ||
| 82 | |Viewer|Read-only access. Can only view content, no edits or comments allowed | ||
| 83 | |||
| 84 | 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/]] | ||
| 85 | ))) | ||
| 86 | |||
| 87 | = Main Features = | ||
| 88 | |||
| 89 | Inside DevOps-as-a-Service, deptrack is mainly used for writing specifications and documentations. See below for a list of the main features of XWiki. | ||
| 90 | |||
| 91 | == Collaborative Content Editing == | ||
| 92 | |||
| 93 | * WYSIWYG and wiki syntax editors | ||
| 94 | * Version control and history tracking | ||
| 95 | * Inline and structured content editing | ||
| 96 | * Commenting and annotations | ||
| 97 | |||
| 98 | == Advanced Page & Document Management == | ||
| 99 | |||
| 100 | * Hierarchical page structure (nested pages) | ||
| 101 | * Templates for creating structured documents | ||
| 102 | * Tags, categories, and metadata support | ||
| 103 | * File attachments and preview | ||
| 104 | |||
| 105 | == Powerful Search and Navigation == | ||
| 106 | |||
| 107 | * Full-text search (Solr-based) | ||
| 108 | * Faceted search filters | ||
| 109 | * Page index, breadcrumbs, and navigation panels | ||
| 110 | |||
| 111 | == Macros and Widgets == | ||
| 112 | |||
| 113 | * Built-in and custom macros (charts, galleries, diagrams) | ||
| 114 | * Embedding of rich media (videos, iframes, etc.) | ||
| 115 | * Markdown and LaTeX support | ||
| 116 | |||
| 117 | |||
| 118 | |||
| 119 |