<?xml version="1.0" encoding="utf-8"?>
<?xml-stylesheet href="https://blog.kali-team.cn/feed_style.xsl" type="text/xsl"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
    <tabi:metadata xmlns:tabi="https://github.com/welpo/tabi">
        <tabi:base_url>https://blog.kali-team.cn</tabi:base_url>
        <tabi:separator>
            •
        </tabi:separator>
        <tabi:about_feeds>
            这是Web Feed，又称为Atom Feed，把现在的网址复制到新闻阅读器即可订阅本站文章。造访「About Feeds」来了解更多资讯。
        </tabi:about_feeds>
        <tabi:visit_the_site>
            造访网站
        </tabi:visit_the_site>
        <tabi:recent_posts>
            近期文章
        </tabi:recent_posts>
        <tabi:last_updated_on>
            更新于 $DATE
        </tabi:last_updated_on>
        <tabi:default_theme></tabi:default_theme>
        <tabi:post_listing_date>date</tabi:post_listing_date>
        <tabi:current_section>sca</tabi:current_section>
    </tabi:metadata><link rel="extra-stylesheet" href="https://blog.kali-team.cn/skins/arch.css?h=8b651815fde702215b07" /><title>Kali-Team - sca</title>
        <subtitle>三米前有蕉皮的博客</subtitle>
    <link href="https://blog.kali-team.cn/tags/sca/atom.xml" rel="self" type="application/atom+xml"/>
    <link href="https://blog.kali-team.cn/tags/sca/" rel="alternate" type="text/html"/>
    <generator uri="https://www.getzola.org/">Zola</generator><updated>2026-09-03T00:00:00+00:00</updated><id>https://blog.kali-team.cn/tags/sca/atom.xml</id><entry xml:lang="en">
        <title>安全开发-DependencyTrack</title>
        <published>2026-09-03T00:00:00+00:00</published>
        <updated>2026-09-03T00:00:00+00:00</updated>
        <author>
            <name>三米前有蕉皮</name>
        </author>
        <link rel="alternate" href="https://blog.kali-team.cn/blog/2026/09/安全开发-DependencyTrack/" type="text/html"/>
        <id>https://blog.kali-team.cn/blog/2026/09/安全开发-DependencyTrack/</id>
        
            <content type="html">&lt;h2 id=&quot;qian-yan&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#qian-yan&quot; aria-label=&quot;Anchor link for: qian-yan&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
前言&lt;/h2&gt;
&lt;p&gt;Rancher、Gitea、SonarQube 就位之后，还缺一环：&lt;strong&gt;依赖安全&lt;/strong&gt;：程序里真正跑起来的代码，绝大部分不是我们自己写的，而是从开源仓库拉进来的依赖（例子里的 Go 程序就依赖 16 个第三方模块）。依赖里出了已知漏洞，SonarQube 扫不出来（它只看自己写的代码），需要 &lt;strong&gt;SCA（Software Composition Analysis，软件成分分析）&lt;/strong&gt; 工具盯着。&lt;/p&gt;
&lt;p&gt;这篇在内网部署 &lt;strong&gt;Dependency-Track（DT）&lt;/strong&gt;（一个专门收 SBOM（软件物料清单）、持续匹配依赖漏洞的平台，然后接进 Gitea Actions 流水线，每次发版自动把 SBOM 推上去。&lt;/p&gt;
&lt;h2 id=&quot;1-bei-jing-gai-nian-sbom-sca-he-dt&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#1-bei-jing-gai-nian-sbom-sca-he-dt&quot; aria-label=&quot;Anchor link for: 1-bei-jing-gai-nian-sbom-sca-he-dt&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
1 背景概念：SBOM、SCA 和 DT&lt;/h2&gt;
&lt;h3 id=&quot;1-1-sbom-ruan-jian-wu-liao-qing-dan&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#1-1-sbom-ruan-jian-wu-liao-qing-dan&quot; aria-label=&quot;Anchor link for: 1-1-sbom-ruan-jian-wu-liao-qing-dan&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
1.1 SBOM：软件物料清单&lt;/h3&gt;
&lt;p&gt;现代程序 = 自己的代码 + 大量开源依赖。以 Go 为例，&lt;code&gt;go.mod&lt;/code&gt; 声明了项目依赖哪些模块、什么版本（example 项目是 1 个直接依赖 gin 框架 + 15 个间接依赖，共 16 个）。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;SBOM（Software Bill of Materials，软件物料清单）&lt;/strong&gt; 是一份机器可读的组件清单：列出软件包含的所有组件及版本。有了它，漏洞披露时（比如“某库 1.2.3 以下有漏洞“）就能立刻回答“我用没用这个库？什么版本？受不受影响？“；没有它，就得人肉翻依赖树，间接依赖动辄上百个，翻不动。&lt;/p&gt;
&lt;p&gt;两个配套术语：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;CycloneDX&lt;/strong&gt;：主流 SBOM 格式之一（JSON 或 XML，另一个主流格式是 SPDX）。DT 两种都收。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;PURL（Package URL，包统一标识）&lt;/strong&gt;：一个软件包的全局唯一标识，如 &lt;code&gt;pkg:golang/github.com/gin-gonic/gin@v1.10.0&lt;/code&gt;。DT 主要靠“PURL + 版本“把 SBOM 里的组件和漏洞库对起来。&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;1-2-sca-bu-zi-ji-shen-ji-er-shi-cha-shu-ju-ku&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#1-2-sca-bu-zi-ji-shen-ji-er-shi-cha-shu-ju-ku&quot; aria-label=&quot;Anchor link for: 1-2-sca-bu-zi-ji-shen-ji-er-shi-cha-shu-ju-ku&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
1.2 SCA：不自己审计，而是查数据库&lt;/h3&gt;
&lt;p&gt;SCA 做的事：拿 SBOM 里的每个组件，去一堆&lt;strong&gt;漏洞数据库&lt;/strong&gt;里比对，找出已知漏洞。相关术语：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;CVE&lt;/strong&gt;（Common Vulnerabilities and Exposures）：漏洞的公开编号，如 &lt;code&gt;CVE-2024-1234&lt;/code&gt;。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;KEV&lt;/strong&gt;（Known Exploited Vulnerabilities，已知被利用漏洞）：“在真实攻击里被用过了“的漏洞精选清单。CISA（美国网络安全与基础设施安全局）发布官方 KEV 目录；组件一旦命中 KEV，修复优先级应该最高，攻击者已经在用了，不是“迟早“而是“正在”。&lt;/li&gt;
&lt;li&gt;数据源没有银弹：不同源的覆盖范围、更新速度、准确度都不一样。DT 的设计就是“多数据源、可开关“，开哪几个是工程取舍。&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;1-3-dependency-track-sbom-de-hui-ju-ping-tai&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#1-3-dependency-track-sbom-de-hui-ju-ping-tai&quot; aria-label=&quot;Anchor link for: 1-3-dependency-track-sbom-de-hui-ju-ping-tai&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
1.3 Dependency-Track：SBOM 的汇聚平台&lt;/h3&gt;
&lt;p&gt;DT 的职责链条：&lt;strong&gt;接收 SBOM&lt;/strong&gt;（任何来源、CycloneDX/SPDX 格式）→ 维护项目与组件数据库 → &lt;strong&gt;持续匹配&lt;/strong&gt;各漏洞源 → 输出漏洞清单和组合级统计（多少项目、多少有漏洞组件、趋势如何）。&lt;/p&gt;
&lt;p&gt;注意“&lt;strong&gt;持续&lt;/strong&gt;“二字：SBOM 传一次之后不需要重复上传：DT 定期从各数据源拉新数据，新漏洞镜像下来后自动对存量组件重新匹配（官方叫 continuous analysis）。也就是说，“传一次 SBOM”= 登记了项目的依赖快照，之后 DT 替你持续盯着。&lt;/p&gt;
&lt;h3 id=&quot;1-4-dt-he-sonarqube-de-fen-gong&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#1-4-dt-he-sonarqube-de-fen-gong&quot; aria-label=&quot;Anchor link for: 1-4-dt-he-sonarqube-de-fen-gong&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
1.4 DT 和 SonarQube 的分工&lt;/h3&gt;
&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;SonarQube&lt;/th&gt;&lt;th&gt;Dependency-Track&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;
&lt;tr&gt;&lt;td&gt;分析对象&lt;/td&gt;&lt;td&gt;&lt;strong&gt;你自己写的代码&lt;/strong&gt;（SAST 静态分析）&lt;/td&gt;&lt;td&gt;&lt;strong&gt;你引用的依赖&lt;/strong&gt;（SCA）&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;发现什么&lt;/td&gt;&lt;td&gt;注入风险、逻辑缺陷、代码坏味道&lt;/td&gt;&lt;td&gt;依赖组件的已知漏洞（CVE/KEV）&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;输入&lt;/td&gt;&lt;td&gt;源代码&lt;/td&gt;&lt;td&gt;SBOM&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;典型动作&lt;/td&gt;&lt;td&gt;修代码&lt;/td&gt;&lt;td&gt;升级依赖版本&lt;/td&gt;&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;SonarQube 本身也有一个小的依赖漏洞功能，但 DT 是专门平台：SBOM 多格式、多项目聚合、数据源可配、团队权限模型完整。分工一句话：&lt;strong&gt;SonarQube 看代码，DT 看依赖&lt;/strong&gt;，两条流水线各管一段、互不干扰。&lt;/p&gt;
&lt;h2 id=&quot;2-da-jian&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#2-da-jian&quot; aria-label=&quot;Anchor link for: 2-da-jian&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
2 搭建&lt;/h2&gt;
&lt;h3 id=&quot;2-1-zong-ti-si-lu-yao-na-xie-zu-jian&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#2-1-zong-ti-si-lu-yao-na-xie-zu-jian&quot; aria-label=&quot;Anchor link for: 2-1-zong-ti-si-lu-yao-na-xie-zu-jian&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
2.1 总体思路：要哪些组件&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;DT 本体&lt;/strong&gt;：一个 Web 服务（Helm chart 部署的 Deployment）。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;数据库&lt;/strong&gt;：PostgreSQL。不随 chart 自带，复用集群 &lt;code&gt;middleware&lt;/code&gt;（中间件）命名空间里已在运行的&lt;strong&gt;共享 PostgreSQL&lt;/strong&gt;，给 DT 建一个专属数据库。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;文件存储&lt;/strong&gt;：10Gi 的 PVC（Persistent Volume Claim，持久卷声明，给 Pod 挂一块跨重启不丢的磁盘），存 DT 的文件类数据。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;chart&lt;/strong&gt;：官方 &lt;code&gt;owasp/dependency-track&lt;/code&gt; Helm chart。&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;2-2-zai-gong-xiang-postgresql-shang-jian-ku-kubectl&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#2-2-zai-gong-xiang-postgresql-shang-jian-ku-kubectl&quot; aria-label=&quot;Anchor link for: 2-2-zai-gong-xiang-postgresql-shang-jian-ku-kubectl&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
2.2 在共享 PostgreSQL 上建库（kubectl）&lt;/h3&gt;
&lt;p&gt;在集群节点上执行：&lt;/p&gt;
&lt;pre class=&quot;giallo z-code&quot; &gt;&lt;code data-lang=&quot;shellscript&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;# 从现成的 secret 读 postgres 密码（middleware ns、postgresql 这个 release 的 secret）&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;#    secret 里的密码是 base64 编码存的，管道里 base64 -d 解码&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-9&quot;&gt;export&lt;/span&gt;&lt;span&gt; POSTGRES_PASSWORD&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;=&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;$(&lt;/span&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;kubectl&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; get secret --namespace middleware postgresql&lt;/span&gt;&lt;span class=&quot;z-16&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;  -o jsonpath=&amp;quot;{.data.postgres-password}&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt; |&lt;/span&gt;&lt;span class=&quot;z-3 z-i&quot;&gt; base64&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; -d&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;)&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;# 起一个临时 pod（bitnami postgresql-client 镜像）进去执行 psql：&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;#    --rm                退出后自动删 pod&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;#    --restart=&amp;#39;Never&amp;#39;   保证不会反复重启&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;#    --tty -i            分配终端、接标准输入&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;#    --command -- ...    覆盖容器默认启动命令，直接跑 psql&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;kubectl&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; run postgresql-client --rm --tty -i --restart=&amp;#39;Never&amp;#39;&lt;/span&gt;&lt;span class=&quot;z-16&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;  --namespace middleware&lt;/span&gt;&lt;span class=&quot;z-16&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;  --image registry-1.docker.io/bitnami/postgresql:latest&lt;/span&gt;&lt;span class=&quot;z-16&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;  --env=&amp;quot;PGPASSWORD=&lt;/span&gt;&lt;span&gt;$POSTGRES_PASSWORD&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-16&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;  --command -- psql --host postgresql -U postgres -d postgres -p&lt;/span&gt;&lt;span class=&quot;z-14&quot;&gt; 5432&lt;/span&gt;&lt;span class=&quot;z-16&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;  -c &amp;#39;CREATE DATABASE dtrack;&amp;#39;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;kubectl&lt;/code&gt; 本身没有 psql 客户端，所以临时起一个 postgresql-client 容器进去执行，退出后自动销毁。密码从 secret 读而不是敲在命令里（不进 shell 历史）；数据库名 &lt;code&gt;dtrack&lt;/code&gt; 随意，只要和 values 里的 URL 一致即可。&lt;/p&gt;
&lt;p&gt;实际输出：&lt;code&gt;CREATE DATABASE&lt;/code&gt; 一行成功提示，随后 pod 自动删除。&lt;/p&gt;
&lt;h3 id=&quot;2-3-helm-values-gai-dong&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#2-3-helm-values-gai-dong&quot; aria-label=&quot;Anchor link for: 2-3-helm-values-gai-dong&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
2.3 Helm values 改动&lt;/h3&gt;
&lt;p&gt;部署时的 values 改动（diff 形式；&lt;code&gt;DT_OIDC_CLIENT_ID&lt;/code&gt; 的真实值与 master key 已替换为占位符，数据库密码按记录原样保留占位值 &lt;code&gt;yourMasterPassword&lt;/code&gt;）：&lt;/p&gt;
&lt;pre class=&quot;giallo z-code&quot; &gt;&lt;code data-lang=&quot;diff&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;@@&lt;/span&gt;&lt;span&gt; 主容器（DT 应用）extraEnv&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt; @@&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;-&lt;/span&gt;&lt;span class=&quot;z-11&quot;&gt;  extraEnv: []&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;  extraEnv:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;    - name: DT_DATASOURCE_DEFAULT_URL&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;      value: jdbc:postgresql://postgresql.middleware.svc.cluster.local:5432/dtrack&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;    - name: DT_DATASOURCE_DEFAULT_USERNAME&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;      value: postgres&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;    - name: DT_DATASOURCE_DEFAULT_PASSWORD&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;      value: yourMasterPassword&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;    - name: DT_DATASOURCE_DEFAULT_DRIVER&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;      value: org.postgresql.Driver&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;    - name: DT_OIDC_ENABLED&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;      value: &amp;#39;true&amp;#39;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;    - name: DT_OIDC_ISSUER&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;      value: https://hub.kali-team.internal&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;    - name: DT_OIDC_CLIENT_ID&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;      value: &amp;lt;client-id&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;    - name: DT_OIDC_USERNAME_CLAIM&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;      value: preferred_username&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;    - name: DT_OIDC_USER_PROVISIONING&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;      value: &amp;#39;true&amp;#39;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;    - name: DT_OIDC_TEAM_SYNCHRONIZATION&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;      value: &amp;#39;true&amp;#39;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;    - name: DT_OIDC_TEAMS_CLAIM&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;      value: groups&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;@@&lt;/span&gt;&lt;span&gt; chart 的 postgresql 小节&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt; @@&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   jdbcUrl: jdbc:postgresql://postgresql:5432/dtrack?reWriteBatchedInserts=true&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;-&lt;/span&gt;&lt;span class=&quot;z-11&quot;&gt;  password: &amp;#39;&amp;#39;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;-&lt;/span&gt;&lt;span class=&quot;z-11&quot;&gt;  username: &amp;#39;&amp;#39;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;  password: &amp;#39;yourMasterPassword&amp;#39;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;  username: &amp;#39;postgres&amp;#39;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;@@&lt;/span&gt;&lt;span&gt; fileStorage 小节&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt; @@&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;-&lt;/span&gt;&lt;span class=&quot;z-11&quot;&gt;    storageClassName: &amp;#39;&amp;#39;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;    storageClassName: local-path&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;@@&lt;/span&gt;&lt;span&gt; chart 另一组件的 extraEnv&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt; @@&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;  extraEnv:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;    - name: OIDC_ISSUER&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;      value: https://hub.kali-team.internal&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;    - name: OIDC_CLIENT_ID&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;      value: &amp;lt;client-id&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;    - name: OIDC_SCOPE&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;      value: openid profile email groups&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;@@&lt;/span&gt;&lt;span&gt; ingress 小节&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt; @@&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;-&lt;/span&gt;&lt;span class=&quot;z-11&quot;&gt;  enabled: false&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;-&lt;/span&gt;&lt;span class=&quot;z-11&quot;&gt;  hostname: example.com&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;-&lt;/span&gt;&lt;span class=&quot;z-11&quot;&gt;  ingressClassName: &amp;#39;&amp;#39;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;  enabled: true&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;  hostname: dependency-track.kali-team.internal&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;  ingressClassName: traefik&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;@@&lt;/span&gt;&lt;span&gt; masterKey 小节&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt; @@&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   mode: config&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;-&lt;/span&gt;&lt;span class=&quot;z-11&quot;&gt;  value: &amp;#39;&amp;#39;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;  value: &amp;lt;master-key&amp;gt;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   provider: database&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;配置&lt;/th&gt;&lt;th&gt;原因&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;
&lt;tr&gt;&lt;td&gt;数据源（DT 主容器 &lt;code&gt;extraEnv&lt;/code&gt;）&lt;/td&gt;&lt;td&gt;&lt;code&gt;DT_DATASOURCE_DEFAULT_URL/USERNAME/PASSWORD/DRIVER&lt;/code&gt; 四个变量指定 JDBC 数据源。JDBC URL 拆开看：&lt;code&gt;jdbc:postgresql://&lt;/code&gt; 是驱动协议，&lt;code&gt;postgresql.middleware.svc.cluster.local&lt;/code&gt; 是集群内部服务域名（&lt;code&gt;middleware&lt;/code&gt; 是命名空间，&lt;code&gt;svc.cluster.local&lt;/code&gt; 是固定后缀），&lt;code&gt;:5432&lt;/code&gt; 端口，&lt;code&gt;/dtrack&lt;/code&gt; 库名。DT 程序优先读这组环境变量，“连外部共享库“靠它实现，不用 chart 自带的库。&lt;code&gt;yourMasterPassword&lt;/code&gt; 是记录里的占位值，实际部署时填真实库密码&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;OIDC 登录（同组环境变量）&lt;/td&gt;&lt;td&gt;&lt;code&gt;DT_OIDC_ENABLED=true&lt;/code&gt; 开启 OIDC 登录；&lt;code&gt;DT_OIDC_ISSUER=https://hub.kali-team.internal&lt;/code&gt; 指定身份提供方（IdP，即 Gitea）；&lt;code&gt;DT_OIDC_CLIENT_ID&lt;/code&gt; 是 Gitea 侧 OAuth2 应用的客户端 ID；&lt;code&gt;DT_OIDC_USERNAME_CLAIM=preferred_username&lt;/code&gt; 指定用令牌里的哪个字段当用户名；&lt;code&gt;DT_OIDC_USER_PROVISIONING=true&lt;/code&gt; 首次登录&lt;strong&gt;自动创建用户&lt;/strong&gt;；&lt;code&gt;DT_OIDC_TEAM_SYNCHRONIZATION=true&lt;/code&gt; + &lt;code&gt;DT_OIDC_TEAMS_CLAIM=groups&lt;/code&gt; 按令牌里的 &lt;code&gt;groups&lt;/code&gt; 声明自动建/同步 DT 团队，登录后人自动进对应团队（效果见图 10）&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;chart 的 postgresql 小节&lt;/td&gt;&lt;td&gt;chart 自带的 PostgreSQL 配置（&lt;code&gt;jdbcUrl&lt;/code&gt; 指向 &lt;code&gt;dtrack&lt;/code&gt; 库，&lt;code&gt;reWriteBatchedInserts=true&lt;/code&gt; 是 PG 驱动参数，批量写入提速）。本环境实际生效的是上面的外部数据源 URL，这节属于 chart 基线配置，按记录保留&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;&lt;code&gt;fileStorage&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code&gt;provider: local&lt;/code&gt;（文件存本地磁盘）+ &lt;code&gt;10Gi&lt;/code&gt; PVC + &lt;code&gt;storageClassName: local-path&lt;/code&gt;（K3s 自带的本地存储类，数据落节点本地磁盘）&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;chart 另一组件的 &lt;code&gt;extraEnv&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code&gt;OIDC_ISSUER&lt;/code&gt;/&lt;code&gt;OIDC_CLIENT_ID&lt;/code&gt;/&lt;code&gt;OIDC_SCOPE&lt;/code&gt;（&lt;code&gt;openid profile email groups&lt;/code&gt;），issuer 和 client 与 DT 登录配置相同，scope 额外请求组信息。这是本次部署 chart 附带的 OIDC 组件配置；chart 版本没有这一节时无需配置&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;&lt;code&gt;ingress&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code&gt;enabled: true&lt;/code&gt; + &lt;code&gt;hostname: dependency-track.kali-team.internal&lt;/code&gt; + &lt;code&gt;ingressClassName: traefik&lt;/code&gt;，走 Traefik 网关对内网暴露&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;&lt;code&gt;masterKey&lt;/code&gt;&lt;/td&gt;&lt;td&gt;DT 的“主密钥“，用来&lt;strong&gt;加密数据库里的敏感数据&lt;/strong&gt;（API token 等）。一旦丢失，已加密的数据无法恢复，必须固定在 values 里并妥善保存（和库密码同一安全等级），本文一律占位符 &lt;code&gt;&amp;lt;master-key&amp;gt;&lt;/code&gt;。&lt;code&gt;provider: database&lt;/code&gt; 表示主密钥与数据库绑定存放&lt;/td&gt;&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;h3 id=&quot;2-4-an-zhuang&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#2-4-an-zhuang&quot; aria-label=&quot;Anchor link for: 2-4-an-zhuang&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
2.4 安装&lt;/h3&gt;
&lt;pre class=&quot;giallo z-code&quot; &gt;&lt;code data-lang=&quot;shellscript&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;# release 名/命名空间自行选择；values.yaml 即 2.3 的完整 values&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;helm&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; upgrade --install dependency-track owasp/dependency-track&lt;/span&gt;&lt;span class=&quot;z-16&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;  --namespace&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt; &amp;lt;&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;namespac&lt;/span&gt;&lt;span&gt;e&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;&amp;gt;&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; --create-namespace&lt;/span&gt;&lt;span class=&quot;z-16&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;  -f values.yaml&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;安装完成后，浏览器访问 &lt;code&gt;https://dependency-track.kali-team.internal&lt;/code&gt;（内网域名，&lt;code&gt;/etc/hosts&lt;/code&gt; 已登记）。&lt;/p&gt;
&lt;h2 id=&quot;3-shou-ci-deng-lu-yu-chu-shi-pei-zhi&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#3-shou-ci-deng-lu-yu-chu-shi-pei-zhi&quot; aria-label=&quot;Anchor link for: 3-shou-ci-deng-lu-yu-chu-shi-pei-zhi&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
3 首次登录与初始配置&lt;/h2&gt;
&lt;h3 id=&quot;3-1-jin-men-xian-gai-admin-mi-ma&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#3-1-jin-men-xian-gai-admin-mi-ma&quot; aria-label=&quot;Anchor link for: 3-1-jin-men-xian-gai-admin-mi-ma&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
3.1 进门先改 admin 密码&lt;/h3&gt;
&lt;p&gt;DT 首次访问会强制改初始 admin 密码（图 1）：默认密码是公开信息，不改等于把管理账号暴露在明处。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-DependencyTrack/password-update.png&quot; alt=&quot;首次登录改密码&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 1：DT 首次访问的改密码页（Update Password）：用初始 admin 账号密码登录后必须设置新密码&lt;/em&gt;&lt;/p&gt;
&lt;h3 id=&quot;3-2-mian-ban-yu-ji-ben-she-zhi&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#3-2-mian-ban-yu-ji-ben-she-zhi&quot; aria-label=&quot;Anchor link for: 3-2-mian-ban-yu-ji-ben-she-zhi&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
3.2 面板与基本设置&lt;/h3&gt;
&lt;p&gt;改完密码进入面板（图 2，此时还是英文界面）。左侧导航分三大块：&lt;strong&gt;PORTFOLIO&lt;/strong&gt;（项目/组件/漏洞/许可证/标签）、&lt;strong&gt;GLOBAL AUDIT&lt;/strong&gt;（全局审计）、&lt;strong&gt;ADMINISTRATION&lt;/strong&gt;（策略管理、系统设置）。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-DependencyTrack/dashboard-first.png&quot; alt=&quot;DT 面板&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 2：DT 面板（Dashboard）：四个统计卡片初始都是 0（还没有项目上传 SBOM）&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;系统设置 → 基本设置（图 3）：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;基础 URL&lt;/strong&gt;：填 &lt;code&gt;https://dependency-track.kali-team.internal&lt;/code&gt; 并点右侧校验（绿色对勾 = 验证通过）。DT 用它生成对外链接（徽章、通知里的地址等）。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;默认语言&lt;/strong&gt;：ZH（中文）。保存后整个界面转中文（图 4 起即中文界面）。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-DependencyTrack/settings-general.png&quot; alt=&quot;基本设置&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 3：系统设置-基本设置：基础 URL 校验通过（绿色对勾），默认语言 ZH&lt;/em&gt;&lt;/p&gt;
&lt;h3 id=&quot;3-3-guan-bi-yao-ce&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#3-3-guan-bi-yao-ce&quot; aria-label=&quot;Anchor link for: 3-3-guan-bi-yao-ce&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
3.3 关闭遥测&lt;/h3&gt;
&lt;p&gt;系统设置 → 遥测：DT 默认会定期向官方项目上报“匿名使用统计“。图 4 里那段 JSON 就是它最后一次自动提交的内容（&lt;code&gt;system_id&lt;/code&gt; 系统标识、&lt;code&gt;dt_version&lt;/code&gt; 版本、&lt;code&gt;db_type&lt;/code&gt;/&lt;code&gt;db_version&lt;/code&gt; 数据库信息）。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-DependencyTrack/telemetry-off.png&quot; alt=&quot;关闭遥测&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 4：遥测设置页：“启用遥测提交“已关闭；下方 JSON 是最后一次自动提交的内容（DT 5.2.0、PostgreSQL 18.6）&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;为什么关&lt;/strong&gt;：一是原则问题，内网环境不想让“我们在跑一个 DT“这件事以任何形式外泄；二是内网本来就发不出去。这段 JSON 也顺带确认了两个事实：本环境是 &lt;strong&gt;DT 5.2.0&lt;/strong&gt;，数据库是 &lt;strong&gt;PostgreSQL 18.6&lt;/strong&gt;。&lt;/p&gt;
&lt;h3 id=&quot;3-4-tian-jia-lou-dong-shu-ju-yuan&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#3-4-tian-jia-lou-dong-shu-ju-yuan&quot; aria-label=&quot;Anchor link for: 3-4-tian-jia-lou-dong-shu-ju-yuan&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
3.4 添加漏洞数据源&lt;/h3&gt;
&lt;p&gt;DT 的漏洞匹配 = SBOM 组件 × 启用的数据源。系统设置里相关页面分两组：&lt;strong&gt;漏洞来源&lt;/strong&gt;（Vulnerability Sources）和 &lt;strong&gt;KEV Sources&lt;/strong&gt;（已知被利用漏洞源）。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;先建两个密钥&lt;/strong&gt;（系统设置 → 密钥管理）。DT 调第三方 API 用“密钥“（名称 → 真实值）间接引用，避免每个配置页都填一遍真值：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;vulncheck&lt;/strong&gt;：到 vulncheck 官网注册并申请 API key（免费社区版就够，官方页面原话 “A free community token is sufficient”），在密钥管理里建一个名为 &lt;code&gt;vulncheck&lt;/code&gt; 的密钥（图 5，真实值已在图中打码）。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;ossindex&lt;/strong&gt;：Sonatype（OSS Index 的维护方）免费注册账号，申请一个 &lt;strong&gt;PAT（Personal Access Token，个人访问令牌&lt;/strong&gt;，让程序代表你调 API 的凭据，Sonatype 的以 &lt;code&gt;sonatype_pat_&lt;/code&gt; 开头），建名为 &lt;code&gt;ossindex&lt;/code&gt; 的密钥（图 6，已打码）。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-DependencyTrack/key-vulncheck.png&quot; alt=&quot;创建 vulncheck 密钥&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 5：密钥管理-创建密钥：名称 vulncheck，值为官网申请的 API key（图中已打码）&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-DependencyTrack/key-ossindex.png&quot; alt=&quot;创建 ossindex 密钥&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 6：密钥管理-创建密钥：名称 ossindex，值为 Sonatype 的 PAT（&lt;code&gt;sonatype_pat_&lt;/code&gt; 开头，图中已打码）&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;启用 VulnCheck KEV 源&lt;/strong&gt;（KEV Sources → VulnCheck KEV，图 7）：打开 Enabled，API URL 保持默认 &lt;code&gt;https://api.vulncheck.com&lt;/code&gt;，API Token 下拉选 &lt;code&gt;vulncheck&lt;/code&gt; 密钥。页面官方说明：VulnCheck KEV 是社区维护的“已被真实利用“漏洞目录，比 CISA 官方 KEV 覆盖更多漏洞、记录更早，组件命中它则修复优先级最高。配完可以点 “Mirror now” 立即同步一批数据。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-DependencyTrack/kev-vulncheck.png&quot; alt=&quot;VulnCheck KEV 配置&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 7：KEV Sources 里的 VulnCheck KEV：已启用，API URL 与 Token（选密钥名）已配&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;启用 Sonatype OSS Index&lt;/strong&gt;（漏洞来源 → Sonatype OSS Index，图 8）：打开 Enabled（Alias Synchronization 默认开，同步组件别名信息，利于匹配），API URL 默认 &lt;code&gt;https://ossindex.sonatype.org&lt;/code&gt;，Username 填 Sonatype 账号邮箱，API Token 下拉选 &lt;code&gt;ossindex&lt;/code&gt; 密钥，可以先点 Test 验证连通再保存。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-DependencyTrack/vuln-source-ossindex.png&quot; alt=&quot;Sonatype OSS Index 配置&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 8：漏洞来源里的 Sonatype OSS Index：已启用，Username 为 Sonatype 账号邮箱，API Token 选 ossindex 密钥&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;为什么加这两个&lt;/strong&gt;：DT 内置数据源已具备基础匹配能力，加源是为了&lt;strong&gt;扩大覆盖面&lt;/strong&gt;。OSS Index 是 Sonatype 维护的免费社区漏洞库，数据量大；VulnCheck 补“真实被利用“维度。源越多召回率越高，但可能引入误报、分析变慢。本环境选“宁多勿漏“，两个都加；你也可以按需开关。&lt;/p&gt;
&lt;h3 id=&quot;3-5-pei-zhi-gitea-sso-oidc-deng-lu&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#3-5-pei-zhi-gitea-sso-oidc-deng-lu&quot; aria-label=&quot;Anchor link for: 3-5-pei-zhi-gitea-sso-oidc-deng-lu&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
3.5 配置 Gitea SSO（OIDC）登录&lt;/h3&gt;
&lt;p&gt;接入方式与其它平台相同：只在 Gitea（IdP）登录一次，其它系统都问 Gitea“这人是谁“。配置分两侧：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;Gitea 侧建 OAuth2 应用&lt;/strong&gt;（图 9）：Gitea → 组织（dev-sec-ops）→ 设置 → 应用 → 创建 OAuth2 应用程序：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;应用名称&lt;/strong&gt;：&lt;code&gt;DependencyTrack&lt;/code&gt;；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;重定向 URL&lt;/strong&gt;：&lt;code&gt;https://dependency-track.kali-team.internal/static/oidc-callback.html&lt;/code&gt;，DT 固定的回调页。用户在 Gitea 授权后，Gitea 会把浏览器送回这个地址完成登录闭环；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;机密客户端&lt;/strong&gt;：勾选（confidential client，有密钥的后端 Web 应用，区别于跑在用户本地的脚本类应用）。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;保存后 Gitea 生成 &lt;strong&gt;Client ID&lt;/strong&gt; 和 &lt;strong&gt;Client Secret&lt;/strong&gt;（图 9 已抹掉真实值；Client Secret 等同于密码，只进 DT 的 values/配置，不进文章和提交记录）。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-DependencyTrack/gitea-oidc-app.png&quot; alt=&quot;Gitea OAuth2 应用&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 9：Gitea 组织的 OAuth2 应用：应用名 DependencyTrack，重定向 URL 指向 DT 的回调页，勾选机密客户端&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;DT 侧&lt;/strong&gt;：上面的 &lt;code&gt;DT_OIDC_*&lt;/code&gt; 环境变量就是 DT 侧的全部配置（issuer/client/claim/自动建用户/团队同步），装好即生效，界面上无需再填。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;团队同步&lt;/strong&gt;（图 10）：系统设置 → 用户和权限 → OpenID Connect 组。本环境预建了 &lt;code&gt;dev-sec-ops&lt;/code&gt; 团队（与 Gitea 组织同名）。用户登录时，DT 按令牌里的 &lt;code&gt;groups&lt;/code&gt; 声明把人放进对应团队。&lt;strong&gt;团队是 DT 的权限单元&lt;/strong&gt;：权限（如 API 密钥权限）授给团队，团队成员自动获得，权限管理从此按“团队“而不是“个人“来。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-DependencyTrack/oidc-group.png&quot; alt=&quot;OIDC 组&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 10：OpenID Connect 组：预建了 dev-sec-ops 团队，用于按 groups 声明同步用户&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;登录流程&lt;/strong&gt;（图 11–13）：DT 登录页此时只剩一个 OpenID 按钮（图 11；密码登录在“更多选项“里）→ 点击跳 hub 授权 → 浏览器被送回 DT 回调页 → DT 自动创建用户、进入面板（图 13，右上角显示“已连接为 Kali-Team“）。首次登录后在 OpenID Connect 用户表里能看到自动创建的用户记录（图 12）。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-DependencyTrack/login-page.png&quot; alt=&quot;OIDC 登录页&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 11：DT 登录页：OIDC 开启后主入口是 OpenID 按钮，密码登录收入“更多选项“&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-DependencyTrack/oidc-user.png&quot; alt=&quot;OIDC 用户&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 12：OpenID Connect 用户表：首次登录后自动创建 Kali-Team 用户（主题标识符 16，所属 3 个团队）&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-DependencyTrack/dashboard-oidc.png&quot; alt=&quot;OIDC 登录后面板&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 13：OIDC 登录后进入面板（中文界面），右上角显示当前身份 Kali-Team&lt;/em&gt;&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;现状说明&lt;/strong&gt;：本环境日常操作目前仍用 DT 的&lt;strong&gt;本地 admin 账号&lt;/strong&gt;登录。Gitea SSO 链路已按上述配置完成并验证（图 11–13）；SSO 不可用时，用本地 admin 账号操作即可，不影响流水线（流水线走 API Token，不走 SSO）。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3 id=&quot;3-6-gei-ci-jian-api-token-tuan-dui-api-mi-yao&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#3-6-gei-ci-jian-api-token-tuan-dui-api-mi-yao&quot; aria-label=&quot;Anchor link for: 3-6-gei-ci-jian-api-token-tuan-dui-api-mi-yao&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
3.6 给 CI 建 API Token（团队 API 密钥）&lt;/h3&gt;
&lt;p&gt;流水线要往 DT 里传 SBOM，需要&lt;strong&gt;机器身份&lt;/strong&gt;：界面登录是给人用的，程序调 REST API 用 API token，不给它人的账号。&lt;/p&gt;
&lt;p&gt;本环境用&lt;strong&gt;团队 API 密钥&lt;/strong&gt;（图 14）：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;系统设置 → 用户和权限 → 团队：可以看到 &lt;code&gt;Administrators&lt;/code&gt;（1 名成员，即 admin）和 &lt;code&gt;Automation&lt;/code&gt;（0 名成员，专为 CI 建的“纯机器团队“，不挂真人）。&lt;/li&gt;
&lt;li&gt;进入 Automation 团队页添加 API 密钥。密钥有一个 &lt;strong&gt;Public ID&lt;/strong&gt;（公开标识）；&lt;strong&gt;密钥本体（secret）只在创建那一刻显示一次&lt;/strong&gt;，直接复制进 Gitea 仓库的 Secret &lt;code&gt;DEPENDENCYTRACK_APIKEY&lt;/code&gt;。&lt;/li&gt;
&lt;li&gt;给团队配&lt;strong&gt;最小权限&lt;/strong&gt;：&lt;code&gt;BOM_UPLOAD&lt;/code&gt;（允许上传 SBOM）+ &lt;code&gt;VIEW_PORTFOLIO&lt;/code&gt;（允许查看面板）+&lt;code&gt;PROJECT_CREATION_UPLOAD&lt;/code&gt;(允许项目的创建)。CI 只需要“投递清单 + 看结果“，不给管理权限。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-DependencyTrack/team-automation.png&quot; alt=&quot;Automation 团队与 API 密钥&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 14：团队页- Automation 团队：API 密钥已创建（图中可见 Public ID，密钥本体创建时一次性显示），权限仅 BOM_UPLOAD 与 VIEW_PORTFOLIO&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;页面有一句官方提示（原意）：&lt;em&gt;团队 API 密钥永不过期，且无法归属到具体使用者，人多时建议改用 service account（服务账号）&lt;/em&gt;。本环境 CI 只有一条流水线、一个密钥，团队密钥够用；如果以后多个自动化都来传，就迁到服务账号（能定位到“是谁在用“）。&lt;/p&gt;
&lt;h2 id=&quot;4-shi-yong-sbom-sheng-cheng-yu-shang-chuan&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#4-shi-yong-sbom-sheng-cheng-yu-shang-chuan&quot; aria-label=&quot;Anchor link for: 4-shi-yong-sbom-sheng-cheng-yu-shang-chuan&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
4 使用：SBOM 生成与上传&lt;/h2&gt;
&lt;h3 id=&quot;4-1-chuang-jian-xiang-mu&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#4-1-chuang-jian-xiang-mu&quot; aria-label=&quot;Anchor link for: 4-1-chuang-jian-xiang-mu&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
4.1 创建项目&lt;/h3&gt;
&lt;p&gt;界面上：PORTFOLIO → 项目 → 新建项目（名称/版本/描述）。本例没手工建，由流水线 &lt;code&gt;autoCreate&lt;/code&gt; 自动创建，效果等价于在界面建了名为 &lt;code&gt;example&lt;/code&gt;、版本 &lt;code&gt;main&lt;/code&gt; 的项目。私有项目的处理见“常见问题与坑“。&lt;/p&gt;
&lt;h3 id=&quot;4-2-go-xiang-mu-sheng-cheng-sbom-cyclonedx&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#4-2-go-xiang-mu-sheng-cheng-sbom-cyclonedx&quot; aria-label=&quot;Anchor link for: 4-2-go-xiang-mu-sheng-cheng-sbom-cyclonedx&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
4.2 Go 项目生成 SBOM（CycloneDX）&lt;/h3&gt;
&lt;p&gt;工具选 &lt;strong&gt;cyclonedx-gomod&lt;/strong&gt;：CycloneDX 官方针对 Go 生态的 SBOM 生成器，读 &lt;code&gt;go.mod&lt;/code&gt;/&lt;code&gt;go.sum&lt;/code&gt; 就能出清单。命令（项目根目录执行）：&lt;/p&gt;
&lt;pre class=&quot;giallo z-code&quot; &gt;&lt;code data-lang=&quot;shellscript&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;cyclonedx-gomod&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; app&lt;/span&gt;&lt;span class=&quot;z-16&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;  -json&lt;/span&gt;&lt;span class=&quot;z-16&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;  -output bom.json&lt;/span&gt;&lt;span class=&quot;z-16&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;  -packages -files -licenses -main&lt;/span&gt;&lt;span class=&quot;z-16&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;  .&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;逐参数说：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;app&lt;/code&gt;：子命令 = 生成“应用依赖“的 SBOM（该工具还有其它子命令，&lt;code&gt;cyclonedx-gomod help&lt;/code&gt; 可查）；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;-json&lt;/code&gt;：输出 JSON 格式（CycloneDX 也支持 XML）；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;-output bom.json&lt;/code&gt;：写到文件（不写就打到终端）；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;-packages&lt;/code&gt;：包含模块里的全部包（不只被直接 import 的）；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;-files&lt;/code&gt;：包含文件级信息；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;-licenses&lt;/code&gt;：附带各组件的许可证信息（从模块源码的 license 文件读）；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;-main&lt;/code&gt;：把主模块（example 项目自己）也作为组件收录（&lt;code&gt;application&lt;/code&gt; 类型），SBOM 里就能看出“这份清单属于哪个应用“；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;.&lt;/code&gt;：要分析的项目目录（&lt;code&gt;go.mod&lt;/code&gt; 所在处）。&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;4-3-shi-ce-example-xiang-mu-de-sbom&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#4-3-shi-ce-example-xiang-mu-de-sbom&quot; aria-label=&quot;Anchor link for: 4-3-shi-ce-example-xiang-mu-de-sbom&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
4.3 实测：example 项目的 SBOM&lt;/h3&gt;
&lt;p&gt;用&lt;strong&gt;与流水线完全相同的命令&lt;/strong&gt;（任务容器镜像、Go 1.25.14、模块依赖走 Nexus goproxy）实际跑了一遍，结果：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;输出 &lt;code&gt;bom.json&lt;/code&gt; 共 &lt;strong&gt;418 KiB（428,224 字节）&lt;/strong&gt;；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;16 个组件&lt;/strong&gt;，与 &lt;code&gt;go.mod&lt;/code&gt; 的 16 个 &lt;code&gt;require&lt;/code&gt; 一一对应（1 个直接依赖 + 15 个间接依赖）；&lt;/li&gt;
&lt;li&gt;内容节选（真实输出，缩写）：&lt;/li&gt;
&lt;/ul&gt;
&lt;pre class=&quot;giallo z-code&quot; &gt;&lt;code data-lang=&quot;json&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;{&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;  &amp;quot;&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt;bomFormat&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;&amp;quot;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;CycloneDX&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;  &amp;quot;&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt;specVersion&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;&amp;quot;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;1.6&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;  &amp;quot;&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt;serialNumber&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;&amp;quot;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;urn:uuid:a17815c3-…&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;  &amp;quot;&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt;metadata&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;&amp;quot;: {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;    &amp;quot;&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt;component&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;&amp;quot;: {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;      &amp;quot;&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt;type&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;&amp;quot;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;application&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;      &amp;quot;&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt;name&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;&amp;quot;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;hub.kali-team.internal/dev-sec-ops/example&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;      &amp;quot;&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt;version&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;&amp;quot;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;v0.0.0-20261016082839-9cae0e5&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;      &amp;quot;&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt;purl&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;&amp;quot;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;pkg:golang/hub.kali-team.internal/dev-sec-ops/example@…?type=module&amp;quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;  },&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;  &amp;quot;&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt;components&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;&amp;quot;: [&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;    {&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;      &amp;quot;&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt;name&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;&amp;quot;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;github.com/gin-gonic/gin&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;      &amp;quot;&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt;version&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;&amp;quot;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;v1.10.0&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;      &amp;quot;&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt;type&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;&amp;quot;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;library&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;,&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;      &amp;quot;&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt;purl&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;&amp;quot;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;pkg:golang/github.com/gin-gonic/gin@v1.10.0?goarch=amd64&amp;amp;goos=linux&amp;amp;type=module&amp;quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;    }&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;    …（共&lt;/span&gt;&lt;span class=&quot;z-14&quot;&gt; 16&lt;/span&gt;&lt;span&gt; 个）&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;  ]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;两个值得注意的细节：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;主模块的版本是 Go 的&lt;strong&gt;伪版本&lt;/strong&gt;（pseudo-version）&lt;code&gt;v0.0.0-日期时间-提交号前缀&lt;/code&gt;：对没有正式 tag 的仓库，Go 用 git 信息自动生成版本号。从它就能看出这份 SBOM 生成时用的是哪个提交（&lt;code&gt;9cae0e5&lt;/code&gt; 正是当时的代码提交）。&lt;/li&gt;
&lt;li&gt;运行时有条警告 &lt;code&gt;no licenses detected&lt;/code&gt;：example 项目没有 LICENSE 文件，所以 &lt;code&gt;-licenses&lt;/code&gt; 无内容可读（参数本身有效，换个带许可证的项目就会带上许可证信息）。&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;4-4-shang-chuan-sbom-dao-dt&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#4-4-shang-chuan-sbom-dao-dt&quot; aria-label=&quot;Anchor link for: 4-4-shang-chuan-sbom-dao-dt&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
4.4 上传 SBOM 到 DT&lt;/h3&gt;
&lt;p&gt;两种方式：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;界面&lt;/strong&gt;：项目页 → BOMs → 上传文件（试用、偶尔手工传一次，用这个）；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;REST API&lt;/strong&gt;（CI 用这个）：&lt;/li&gt;
&lt;/ul&gt;
&lt;pre class=&quot;giallo z-code&quot; &gt;&lt;code data-lang=&quot;shellscript&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;curl&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; -F &amp;quot;bom=@bom.json&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-16&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;     -F &amp;quot;autoCreate=true&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-16&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;     -F &amp;quot;projectName=example&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-16&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;     -F &amp;quot;projectVersion=main&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-16&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;     -H &amp;quot;X-Api-Key: &amp;lt;dt-api-token&amp;gt;&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-16&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;     https://dependency-track.kali-team.internal/api/v1/bom&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;X-Api-Key&lt;/code&gt; 请求头认证（上面的团队 API 密钥）；&lt;code&gt;autoCreate=true&lt;/code&gt; 表示“项目不存在就现场建“（此时 &lt;code&gt;projectName&lt;/code&gt;/&lt;code&gt;projectVersion&lt;/code&gt; 生效）；成功返回 &lt;strong&gt;200&lt;/strong&gt;，响应体是这份 BOM 的唯一 ID（UUID）。&lt;/li&gt;
&lt;li&gt;流水线是机器，点不了按钮，API 就是“界面上传按钮“的程序形态，行为和界面一致。&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;4-5-dt-de-fen-xi-ji-zhi-shang-chuan-zhi-hou-fa-sheng-liao-shen-me&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#4-5-dt-de-fen-xi-ji-zhi-shang-chuan-zhi-hou-fa-sheng-liao-shen-me&quot; aria-label=&quot;Anchor link for: 4-5-dt-de-fen-xi-ji-zhi-shang-chuan-zhi-hou-fa-sheng-liao-shen-me&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
4.5 DT 的分析机制：上传之后发生了什么&lt;/h3&gt;
&lt;p&gt;DT 收到 BOM 后：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;入库&lt;/strong&gt;：解析组件，按 PURL + 版本去重，挂到项目下（项目可以有多个 BOM 版本，对应不同代码版本）；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;匹配&lt;/strong&gt;：拿每个组件去各&lt;strong&gt;启用&lt;/strong&gt;的漏洞源比对（CycloneDX 的 purl 是主匹配键）；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;出报告&lt;/strong&gt;：项目页生成漏洞清单：漏洞编号、严重级别、影响版本、修复版本、是否 KEV 等；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;持续分析&lt;/strong&gt;：DT 定期从各源镜像新数据，新漏洞落地后自动对存量组件重匹配，&lt;strong&gt;不用重传 SBOM&lt;/strong&gt;。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;所以“上传一次“= 登记了依赖快照，之后 DT 持续盯着。&lt;/p&gt;
&lt;h3 id=&quot;4-6-lou-dong-bao-gao-zen-me-du&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#4-6-lou-dong-bao-gao-zen-me-du&quot; aria-label=&quot;Anchor link for: 4-6-lou-dong-bao-gao-zen-me-du&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
4.6 漏洞报告怎么读&lt;/h3&gt;
&lt;p&gt;（按 DT 5.x 的界面设计讲解；字段含义以官方文档为准。）&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;项目页顶部统计卡&lt;/strong&gt;：项目漏洞数、有漏洞的组件数等；严重级别分布 Critical（严重）/ High（高危）/ Medium（中危）/ Low（低危）。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;单条漏洞怎么看&lt;/strong&gt;：
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;漏洞 ID&lt;/strong&gt;：&lt;code&gt;CVE-20xx-xxxx&lt;/code&gt; 这类公开编号，可拿去查详情；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;是否 KEV&lt;/strong&gt;：真实世界已被利用 → 修复优先级最高，别排期，直接修；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;影响版本 / 修复版本&lt;/strong&gt;：给了修复版本就直接升级依赖（Go 里 &lt;code&gt;go get github.com/xxx@vX.Y.Z&lt;/code&gt;），然后重跑流水线生成新 SBOM 再传，DT 会自动对比新旧版本，修掉的漏洞从清单里消掉；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;组件 PURL&lt;/strong&gt;：对照 &lt;code&gt;go.mod&lt;/code&gt; 确认是哪个依赖、直接还是间接。&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;面板（Dashboard，图 13）&lt;/strong&gt;：跨项目聚合：“全部项目总体安全水位“看这里；单个项目的细节看项目页。&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;4-7-an-yu-yan-xuan-sbom-sheng-cheng-gong-ju&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#4-7-an-yu-yan-xuan-sbom-sheng-cheng-gong-ju&quot; aria-label=&quot;Anchor link for: 4-7-an-yu-yan-xuan-sbom-sheng-cheng-gong-ju&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
4.7 按语言选 SBOM 生成工具&lt;/h3&gt;
&lt;p&gt;上文是 Go 的完整流程（cyclonedx-gomod）。团队若有 Node.js / Python 项目，选工具逻辑不变：&lt;strong&gt;每种语言选一个主流的 CycloneDX 生成器，产出同样格式的 &lt;code&gt;bom.json&lt;/code&gt;，按上文的上传方式原样照用&lt;/strong&gt;。常用三语言的速查表：&lt;/p&gt;
&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;语言&lt;/th&gt;&lt;th&gt;推荐工具&lt;/th&gt;&lt;th&gt;安装&lt;/th&gt;&lt;th&gt;生成&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;
&lt;tr&gt;&lt;td&gt;Go&lt;/td&gt;&lt;td&gt;&lt;code&gt;cyclonedx-gomod&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code&gt;go install&lt;/code&gt;（模块经 Nexus goproxy）&lt;/td&gt;&lt;td&gt;&lt;code&gt;cyclonedx-gomod app -json -output bom.json -packages -files -licenses -main .&lt;/code&gt;（参数说明见上文）&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;Node.js&lt;/td&gt;&lt;td&gt;&lt;code&gt;@cyclonedx/cyclonedx-npm&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code&gt;npm install -g @cyclonedx/cyclonedx-npm&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code&gt;cyclonedx-npm --output-file bom.json&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;Python&lt;/td&gt;&lt;td&gt;&lt;code&gt;cyclonedx-bom&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code&gt;pip install cyclonedx-bom&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;code&gt;cyclonedx-py --output bom.json&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;其他语言与构建工具（Java、.NET 等）的完整工具清单，以 &lt;a class=&quot;external&quot; rel=&quot;noopener nofollow noreferrer external&quot; target=&quot;_blank&quot; href=&quot;https://cyclonedx.org/tool-center/&quot;&gt;CycloneDX 官方 Tool Center&lt;/a&gt; 为准，上表只是最常用的速查。&lt;/p&gt;
&lt;p&gt;一句提醒：安装命令（npm / pip）要求对应&lt;strong&gt;包源&lt;/strong&gt;可达（包源 = 安装第三方库时下载库文件的服务器，相当于 Go 的 GOPROXY）；内网开发机按本环境的源配置执行，或在有外网的机器上先装好再使用。&lt;/p&gt;
&lt;h3 id=&quot;4-8-ui-li-kan-jie-guo-dian-na-li&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#4-8-ui-li-kan-jie-guo-dian-na-li&quot; aria-label=&quot;Anchor link for: 4-8-ui-li-kan-jie-guo-dian-na-li&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
4.8 UI 里看结果点哪里&lt;/h3&gt;
&lt;p&gt;上一节讲了“漏洞报告怎么读“，这一节只讲“点哪里“：项目详情页的四个主要 tab：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Vulnerabilities（漏洞）&lt;/strong&gt;：项目漏洞清单，按严重级别分类；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Components（组件）&lt;/strong&gt;：项目包含的组件列表（对应 SBOM 里的 components），从这里看“哪个组件带漏洞“；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Licenses（许可证）&lt;/strong&gt;：各组件的许可证信息，合规视角，与漏洞互补；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;BOMs（SBOM）&lt;/strong&gt;：&lt;strong&gt;上传历史&lt;/strong&gt;：每次上传的时间、格式（CycloneDX）、版本、组件数都在这里；“界面上传“入口也在这一页。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;一个项目可以有多个 BOM 版本（对应不同代码版本，4.5 的“入库“按 PURL + 版本去重），BOMs 页就是这些版本的列表。&lt;/p&gt;
&lt;h2 id=&quot;5-ci-lian-dong-dependency-track-yaml-zhu-duan-jiang&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#5-ci-lian-dong-dependency-track-yaml-zhu-duan-jiang&quot; aria-label=&quot;Anchor link for: 5-ci-lian-dong-dependency-track-yaml-zhu-duan-jiang&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
5 CI 联动：dependency-track.yaml 逐段讲&lt;/h2&gt;
&lt;p&gt;两条流水线分工：SonarQube 那条看&lt;strong&gt;代码质量&lt;/strong&gt;，这条看&lt;strong&gt;依赖安全&lt;/strong&gt;，同一仓库、互不干扰。&lt;/p&gt;
&lt;h3 id=&quot;5-1-zi-tuo-guan-action&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#5-1-zi-tuo-guan-action&quot; aria-label=&quot;Anchor link for: 5-1-zi-tuo-guan-action&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
5.1 自托管 action&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;actions/cyclonedx-gomod-generate-sbom@v2&lt;/code&gt;：&lt;code&gt;go run github.com/CycloneDX/cyclonedx-gomod/cmd/cyclonedx-gomod@&amp;lt;version&amp;gt; &amp;lt;args&amp;gt;&lt;/code&gt;，依赖走 &lt;code&gt;GOPROXY&lt;/code&gt;（Nexus），带 &lt;code&gt;-buildvcs=false&lt;/code&gt; 绕开 Go 1.25 的 VCS 戳记问题；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;actions/upload-sbom@v3&lt;/code&gt;：&lt;code&gt;curl -F&lt;/code&gt; multipart POST &lt;code&gt;/api/v1/bom&lt;/code&gt;，非 2xx 响应按失败处理。&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;5-2-liu-shui-xian-quan-wen-yi-ru-ku-example-cang-ku-commit-9cae0e5&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#5-2-liu-shui-xian-quan-wen-yi-ru-ku-example-cang-ku-commit-9cae0e5&quot; aria-label=&quot;Anchor link for: 5-2-liu-shui-xian-quan-wen-yi-ru-ku-example-cang-ku-commit-9cae0e5&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
5.2 流水线全文（已入库 example 仓库，commit &lt;code&gt;9cae0e5&lt;/code&gt;）&lt;/h3&gt;
&lt;pre class=&quot;giallo z-code&quot; &gt;&lt;code data-lang=&quot;yaml&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-14&quot;&gt;on&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;  push&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;    tags&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;      -&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;v*&amp;quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;  pull_request&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;      types&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt; [&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;opened&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; synchronize&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;,&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; reopened&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;  repository_dispatch&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;  # 通过 Webhook 触发&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;  workflow_dispatch&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;   # 支持手动立即触发&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;# 说明：&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;# - 旧版引用的旧环境自托管 action（gh-gomod-generate-sbom / gh-upload-sbom）已随旧环境失效，&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;#   现改为 Gitea actions 组织自托管的 cyclonedx-gomod-generate-sbom / upload-sbom（composite 实现）。&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;# - cyclonedx-gomod 的模块依赖走 Nexus goproxy（任务容器自带 Go，无需 setup-go）；&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;#   SBOM 经 DT REST API（POST /api/v1/bom，multipart）上传。&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;name&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; DependencyTrack Workflow&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;jobs&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;  dependency-track&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;    runs-on&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; ubuntu-host&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;    env&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;      GOPROXY&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;https://nexus.kali-team.internal/repository/goproxy/&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;  # Go 模块走 Nexus 代理&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;      GOSUMDB&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;sum.golang.org https://nexus.kali-team.internal/repository/go-sumdb/&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;  # sumdb 校验走 Nexus go-sumdb 代理，保持在线校验不关闭（go.sum 本地哈希校验始终生效）&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;    steps&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;      -&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt; name&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; Init导入内网CA证书&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;        run&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-9&quot;&gt; |&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;          echo -n | openssl s_client -showcerts -connect hub.kali-team.internal:443 2&amp;gt;/dev/null | sed -ne &amp;#39;/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p&amp;#39; &amp;gt;&amp;gt; hub.kali-team.internal.crt&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;          sudo cp hub.kali-team.internal.crt /usr/local/share/ca-certificates/&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;          sudo update-ca-certificates&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;      -&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt; name&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; Checkout code&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;        uses&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; https://hub.kali-team.internal/actions/checkout@v4&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;        env&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;          GIT_SSL_NO_VERIFY&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-14&quot;&gt; true&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;        with&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;          submodules&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-14&quot;&gt; true&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;          fetch-depth&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-14&quot;&gt; 0&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;          token&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; ${{ secrets.TOKEN }}&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;      -&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt; name&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; Verify Certificate 信任dev-sec-ops证书&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;        run&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-9&quot;&gt; |&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;          sudo cp kali-team-ca.crt /usr/local/share/ca-certificates/&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;          sudo update-ca-certificates&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;          sudo mkdir -p /etc/docker/certs.d/mirror.kali-team.internal&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;          sudo cp kali-team-ca.crt /etc/docker/certs.d/mirror.kali-team.internal/ca.crt&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;      -&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt; name&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; 准备 Go 模块依赖&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;        run&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-9&quot;&gt; |&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;          go version&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;          go mod download&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;      -&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt; name&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; 生成 CycloneDX SBOM&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;        uses&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; https://hub.kali-team.internal/actions/cyclonedx-gomod-generate-sbom@v2&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;        with&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;          version&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;v1.10.0&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;  # cyclonedx-gomod 的 Go 模块版本（经 Nexus goproxy 下载编译）&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;          args&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;app -json -output bom.json -packages -files -licenses -main .&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;  # 生成 SBOM 文件，输出为 bom.json&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;      -&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt; name&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; 上传 SBOM 到 Dependency-Track&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;        uses&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; https://hub.kali-team.internal/actions/upload-sbom@v3&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;        with&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;          serverHostname&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; dependency-track.kali-team.internal&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;  # DependencyTrack 的域名&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;          port&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;443&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;  # 端口&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;          protocol&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; https&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;  # 协议&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;          apiKey&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; ${{ secrets.DEPENDENCYTRACK_APIKEY }}&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;  # DT 的 API 密钥（只存 repo Secret，文章里用占位符）&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;          projectName&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; example&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;  # DT 上创建的项目名称（autoCreate 时）&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;          projectVersion&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; main&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;  # DT 上创建的项目版本&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;          bomFilename&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; bom.json&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;  # 上一步生成的 bom.json 文件&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;          autoCreate&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;true&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;  # 项目不存在时自动创建。注意：自动创建的项目默认所有人可见；&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;                              # 若要私有项目：在 DT 上手动建项目并加入 Automation 团队，&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;                              # 然后这里 autoCreate 设 false，并用 project 参数传项目 UUID&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;逐段讲：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;on&lt;/code&gt; 触发条件&lt;/strong&gt;：推 &lt;code&gt;v*&lt;/code&gt; tag（每次发版自动做“依赖安全验收“）、PR（合并前看一眼）、&lt;code&gt;repository_dispatch&lt;/code&gt;（Webhook 触发，比如漏洞源大更新后批量重刷）、&lt;code&gt;workflow_dispatch&lt;/code&gt;（Gitea 页面手动跑）。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;job 级 &lt;code&gt;env&lt;/code&gt;&lt;/strong&gt;：&lt;code&gt;GOPROXY&lt;/code&gt; 指向 Nexus goproxy（Go 模块全走内网，与 Dockerfile 一致）；&lt;code&gt;GOSUMDB&lt;/code&gt; 指向 Nexus go-sumdb 代理（两字段写法，sumdb 查询走内网、在线校验保持开启；&lt;code&gt;go.sum&lt;/code&gt; 的本地哈希校验始终生效）。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Init&lt;/strong&gt;：&lt;code&gt;openssl s_client&lt;/code&gt; 从 hub 拉证书链装进系统 CA 库，后续访问 nexus/DT 的 https 才能通过证书校验。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Checkout&lt;/strong&gt;：自托管 checkout action（完整 URL 引用 &lt;code&gt;@v4&lt;/code&gt;）。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Verify Certificate&lt;/strong&gt;：安装仓库自带的 &lt;code&gt;kali-team-ca.crt&lt;/code&gt;（step 中间 CA + 根 CA），覆盖所有内网平台的证书。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;准备 Go 模块依赖&lt;/strong&gt;：&lt;code&gt;go mod download&lt;/code&gt; 下载 example 自己的依赖（顺带校验 go.sum）。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;生成 CycloneDX SBOM&lt;/strong&gt;：上面那节的自托管 action，参数即上面的生成命令，产出 &lt;code&gt;bom.json&lt;/code&gt;。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;上传 SBOM 到 Dependency-Track&lt;/strong&gt;：上面那节的自托管 action；&lt;code&gt;apiKey&lt;/code&gt; 来自 repo Secret &lt;code&gt;DEPENDENCYTRACK_APIKEY&lt;/code&gt;（Automation 团队密钥）；&lt;code&gt;autoCreate=true&lt;/code&gt; + &lt;code&gt;projectName=example&lt;/code&gt; + &lt;code&gt;projectVersion=main&lt;/code&gt;。&lt;/li&gt;
&lt;/ol&gt;
&lt;h3 id=&quot;5-3-secret-qing-dan-yu-yu-ming-jie-xi&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#5-3-secret-qing-dan-yu-yu-ming-jie-xi&quot; aria-label=&quot;Anchor link for: 5-3-secret-qing-dan-yu-yu-ming-jie-xi&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
5.3 Secret 清单与域名解析&lt;/h3&gt;
&lt;p&gt;Secret（只存 Gitea 仓库设置，文/码中一律占位）：&lt;/p&gt;
&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;Secret&lt;/th&gt;&lt;th&gt;内容&lt;/th&gt;&lt;th&gt;谁签发&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;
&lt;tr&gt;&lt;td&gt;&lt;code&gt;TOKEN&lt;/code&gt;&lt;/td&gt;&lt;td&gt;Gitea 访问令牌（checkout 用）&lt;/td&gt;&lt;td&gt;Gitea&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;&lt;code&gt;DEPENDENCYTRACK_APIKEY&lt;/code&gt;&lt;/td&gt;&lt;td&gt;DT Automation 团队 API 密钥&lt;/td&gt;&lt;td&gt;DT&lt;/td&gt;&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;任务容器的域名解析&lt;/strong&gt;（本环境实际踩到的坑）：流水线任务容器不继承宿主机的 &lt;code&gt;/etc/hosts&lt;/code&gt;，它解析内网域名靠 runner 配置的 &lt;code&gt;container.options&lt;/code&gt;：&lt;/p&gt;
&lt;pre class=&quot;giallo z-code&quot; &gt;&lt;code data-lang=&quot;plain&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;--add-host=hub.kali-team.internal:10.111.13.105&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;--add-host=mirror.kali-team.internal:10.111.13.105&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;--add-host=nexus.kali-team.internal:10.111.13.105&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;--add-host=sonarqube.kali-team.internal:10.111.13.105&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;--add-host=rancher.kali-team.internal:10.111.13.99&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;--add-host=ca.kali-team.internal:10.111.13.99&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;# DT 上线后追加：&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;--add-host=dependency-track.kali-team.internal:&amp;lt;IP&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;宿主机 &lt;code&gt;/etc/hosts&lt;/code&gt; 和 runner &lt;code&gt;--add-host&lt;/code&gt; &lt;strong&gt;两层都要有&lt;/strong&gt;，流水线才能访问到 DT。&lt;/p&gt;
&lt;h2 id=&quot;6-xiao-guo&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#6-xiao-guo&quot; aria-label=&quot;Anchor link for: 6-xiao-guo&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
6 效果&lt;/h2&gt;
&lt;p&gt;流水线跑起来之后，example 项目在 DT 里的现状如下。四张图是项目页最常用的四个 tab：概览、组件、漏洞审计、利用预测。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-DependencyTrack/example-overview.png&quot; alt=&quot;example 项目概览&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 15：example 项目概览页：43 条漏洞（Critical 10 / High 15 / Medium 17 / Low 1），风险评分 227；BOM 导入于 32 天前、最近一次分析在 2 小时前。漏洞源同步新数据后 DT 自动对存量组件重新匹配，无需重传 SBOM&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-DependencyTrack/example-components.png&quot; alt=&quot;example 项目组件列表&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 16：example 项目组件 tab：共 430 个组件：除 16 个模块依赖外，&lt;code&gt;-files&lt;/code&gt; 参数还把项目源码文件作组件带了进来；列表给出每个组件的版本、许可证、风险评分与漏洞数&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-DependencyTrack/example-vulns.png&quot; alt=&quot;example 项目漏洞审计&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 17：example 项目漏洞审计 tab：每条漏洞列出受影响组件与版本、CVE 编号、严重程度、KEV 标记和命中数据源（分析器列，截图中均为 OSS Index）&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-DependencyTrack/example-epss.png&quot; alt=&quot;example 项目利用预测&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 18：example 项目利用预测 tab：每条漏洞的 CVSSv3 分值与 EPSS（Exploit Prediction Scoring System）分值、百分位数；EPSS 估计漏洞近期在真实攻击中被利用的概率，分值越高越值得优先修&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;日常查看顺序：概览看严重级别分布掌握整体情况，组件里定位漏洞在哪个组件，漏洞审计和利用预测合起来决定修复优先级。&lt;/p&gt;
&lt;h2 id=&quot;7-chang-jian-wen-ti-yu-keng&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#7-chang-jian-wen-ti-yu-keng&quot; aria-label=&quot;Anchor link for: 7-chang-jian-wen-ti-yu-keng&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
7 常见问题与坑&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;master key 管理。&lt;/strong&gt; 必须固定在 values（本环境 &lt;code&gt;provider: database&lt;/code&gt; + &lt;code&gt;mode: config&lt;/code&gt;），和数据库密码同一安全等级保存；丢了，库里的加密数据（API token 等）全部无法恢复。本文及一切公开场合只用占位符 &lt;code&gt;&amp;lt;master-key&amp;gt;&lt;/code&gt;。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;autoCreate 建出的项目是公开的。&lt;/strong&gt; 流水线自动创建的项目默认所有人可见。要私有项目：界面手工建项目（设为私有）→ 把项目加入 Automation 团队（授上传权限）→ 流水线 &lt;code&gt;autoCreate&lt;/code&gt; 改 &lt;code&gt;false&lt;/code&gt;，用 &lt;code&gt;project&lt;/code&gt; 参数传项目 UUID。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;漏洞源的第三方密钥。&lt;/strong&gt; vulncheck 免费社区 token 即可（官方 UI 原文 “A free community token is sufficient”）；ossindex 必须申请 Sonatype 账号的 PAT（免费）。密钥只进 DT 的密钥管理（CI 侧只进 Gitea Secret），文章/提交/聊天里一律占位符，本环境记录截图中的密钥值也已打码。&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;xiao-jie&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#xiao-jie&quot; aria-label=&quot;Anchor link for: xiao-jie&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
小结&lt;/h2&gt;
&lt;p&gt;这一篇给内网 DevSecOps 体系补上了&lt;strong&gt;依赖安全&lt;/strong&gt;一环：流水线生成 CycloneDX SBOM（&lt;code&gt;go run&lt;/code&gt; 走 Nexus goproxy，零外网），推给 DT，DT 持续匹配各漏洞源，依赖的已知漏洞从此在面板上可见、可排序、可追踪。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;搭建&lt;/strong&gt;：复用现有设施：middleware 共享 PostgreSQL（kubectl 临时 pod 建库）、local-path PVC、Traefik ingress；values 的要点是数据源、master key、OIDC、ingress；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;初始配置三件事&lt;/strong&gt;：关遥测（数据不出内网）、加漏洞源（vulncheck KEV + ossindex，扩大召回）、建 API Token（机器账号、最小权限 BOM_UPLOAD + VIEW_PORTFOLIO）；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;OIDC 登录&lt;/strong&gt;：Gitea 当 IdP，DT 接入统一登录，团队按 &lt;code&gt;groups&lt;/code&gt; 声明自动同步；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;CI 联动&lt;/strong&gt;：两个 action 用 composite 重做（&lt;code&gt;go run&lt;/code&gt; + curl）；域名解析是两层问题（宿主机 &lt;code&gt;/etc/hosts&lt;/code&gt; + runner &lt;code&gt;--add-host&lt;/code&gt;）。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;下一步可选：DT 策略（Policies and Conditions，例如“命中 KEV 即违规“）、webhook 通知（漏洞更新推 Gitea/IM）、portfolio 访问控制，以及把更多项目类型接进来（CycloneDX 生态里各语言都有 SBOM 工具）。&lt;/p&gt;
&lt;h2 id=&quot;can-kao&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#can-kao&quot; aria-label=&quot;Anchor link for: can-kao&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
参考&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a class=&quot;external&quot; rel=&quot;noopener nofollow noreferrer external&quot; target=&quot;_blank&quot; href=&quot;https://docs.dependencytrack.org/&quot;&gt;Dependency-Track 官方文档&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a class=&quot;external&quot; rel=&quot;noopener nofollow noreferrer external&quot; target=&quot;_blank&quot; href=&quot;https://docs.dependencytrack.org/api/&quot;&gt;Dependency-Track API 文档&lt;/a&gt;（BOM 上传端点 &lt;code&gt;/api/v1/bom&lt;/code&gt;）&lt;/li&gt;
&lt;li&gt;&lt;a class=&quot;external&quot; rel=&quot;noopener nofollow noreferrer external&quot; target=&quot;_blank&quot; href=&quot;https://cyclonedx.org/specification/&quot;&gt;CycloneDX 规范&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a class=&quot;external&quot; rel=&quot;noopener nofollow noreferrer external&quot; target=&quot;_blank&quot; href=&quot;https://github.com/CycloneDX/cyclonedx-gomod&quot;&gt;cyclonedx-gomod（本文 SBOM 生成工具）&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a class=&quot;external&quot; rel=&quot;noopener nofollow noreferrer external&quot; target=&quot;_blank&quot; href=&quot;https://ossindex.sonatype.org/&quot;&gt;Sonatype OSS Index&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a class=&quot;external&quot; rel=&quot;noopener nofollow noreferrer external&quot; target=&quot;_blank&quot; href=&quot;https://vulncheck.com/&quot;&gt;VulnCheck&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a class=&quot;external&quot; rel=&quot;noopener nofollow noreferrer external&quot; target=&quot;_blank&quot; href=&quot;https://docs.gitea.com/usage/actions/&quot;&gt;Gitea Actions 文档&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
</content>
        <summary type="html">内网部署 Dependency-Track（SCA 平台）：Helm + 共享 PostgreSQL 搭建，配好漏洞源、OIDC 登录与 API Token，再用自托管 Actions 把 Go 项目的 CycloneDX SBOM 自动推上去</summary>
        </entry>
</feed>
