> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enclave.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Enclave in these docs is the code and cloud security platform at enclave.ai. It is not Open Enclave, Intel SGX or other hardware enclaves, or enclave.gg.
> People use Enclave in the web app at https://app.enclave.ai or the desktop app. These docs describe no public Enclave API or CLI, so don't invent endpoints, commands, or config files.
> Connecting an integration needs a person to sign in and approve access in a browser. Tell the user the exact step to take instead of saying you completed it.

# Dependencies

> 查看仓库固定的所有第三方包，找出存在已知漏洞的包，并规划升级或评估影响。

**Dependencies** 列出组织各仓库中固定的第三方包，以及你所用版本中的已知漏洞。它告诉你是否存在有漏洞的依赖，以及它们在哪里。它不会创建 finding。

![Dependencies 页面，易受攻击的包排在最前，已打开的包显示其易受攻击的仓库、Plan upgrade to 和 Assess impact 按钮以及公告](https://mintcdn.com/enclave/1011OotUHO5RJRMm/images/product/dependencies.png?fit=max\&auto=format\&n=1011OotUHO5RJRMm\&q=85\&s=b6d9fdc3144c16ee51c9db9f62378d59)

## Enclave 如何收集依赖

仓库连接时，以及推送到其默认分支（例如合并一个 pull request）并更改了 lockfile 或 manifest 等依赖文件时，Enclave 都会扫描该仓库的依赖。你无需做任何设置。

每次扫描都会读取仓库的 lockfile。如果某个清单文件没有 lockfile，Enclave 会将其解析为全新安装会得到的版本。如果解析失败，则保留清单文件中写明的版本。仓库自身的包（例如 workspace 包）不会列出。

支持的生态系统有 npm、PyPI、Go、Cargo、Maven、RubyGems、Packagist 和 NuGet。

Enclave 会将每个固定版本与 [OSV](https://osv.dev) 漏洞数据库进行比对。新的公告无需新的推送即可显示。

## 查找包

有漏洞的包排在最前面，按严重程度从高到低排列，并带有虫子图标和以该颜色显示的严重程度；如果没有公告给出评级，则显示 **Unknown**。每一行还会显示使用该包的仓库数量。其余的包按使用它们的仓库数量排序。

点击搜索图标可按包名搜索。点击筛选图标可按 **Vulnerability**、**Ecosystem**、**Type**（**Direct** 或 **Transitive**）或 **Repository** 筛选。**Vulnerability** 只列出有漏洞的包：选择 **Any severity**，或选择一个最低严重程度，例如 **High or worse**。

## 扫描状态

页面右上角显示最近一次扫描的时间，以及处于以下各状态的仓库数量：

* **Updating:** 扫描正在运行。页面会自动刷新。
* **Out of date:** 默认分支有比上次扫描更新的提交，而新的扫描失败或未启动。结果来自较早的提交。
* **Not scanned:** 该仓库从未被扫描过，例如它在依赖扫描功能推出之前就已连接，或者它的首次扫描失败。

点击 **Scan** 可扫描所有 Out of date 或 Not scanned 的仓库。否则，每个仓库会在下次推送到默认分支时被扫描。

## 开启或关闭依赖扫描

默认情况下，所有仓库都开启了依赖扫描。你需要 **Owner** 或 **Admin** 角色才能更改。关闭某个仓库的扫描后，Enclave 将不再扫描它，其包也会从 Dependencies 中移除。关闭前 Enclave 会请你确认。

* **单个仓库：** 使用仓库 **Scan** 标签页上的 **Auto dependency scans** 开关，或 [Repositories](https://docs.enclave.ai/zh/repositories.md) 中该仓库所在行的 **Auto dependency scans** 开关。点击页面顶部的 **Repositories** 即可打开该页面。开启扫描后，仓库会立即被扫描。
* **所有仓库：** 点击页面顶部的 **Dependency scans**，然后点击显示仓库数量的 **Turn off for** 或 **Turn on for**。以这种方式开启的仓库会显示为 **Not scanned**，直到你点击 **Scan** 或有人推送到其默认分支。
* **Fork：** 关闭页面顶部的 **Scan forks**，即可停止扫描所有 fork，包括之后连接的 fork。该开关默认开启。

## 查看包

点击某个包将其打开。如果有仓库固定了有漏洞的版本，**Vulnerable in N repos** 会列出每个仓库及其有漏洞的版本。展开某个仓库，可以看到它的上次扫描、固定该包的每个文件，以及每条公告的严重程度和修复版本。

没有 lockfile 的文件会显示其版本的来源：**Resolved at scan** 或 **Declared only**。声明的版本不一定是实际安装的版本。

每个有漏洞的仓库都有两个按钮。两者都会打开一个附带该仓库的 [Research 会话](https://docs.enclave.ai/zh/research/sessions.md)：

* **Plan upgrade to** *版本*（例如 **Plan upgrade to 1.2.6**）显示修复这些公告的最新版本。会话会检查是否有破坏性变更，并给出清单文件和 lockfile 的确切修改。如果某条公告没有修复版本，按钮会显示为 **Plan a fix**，并在没有可用升级时推荐替代包或缓解措施。
* **Assess impact** 检查仓库是否使用了有漏洞的代码，以及不可信的输入能否到达这些代码，然后告诉你暴露程度以及修复的紧迫性。

| 标签页 | 显示内容 |
| - | - |
| **Overview** | 影响所用版本的漏洞，包括严重程度和修复版本，以及该包的最新版本和近期发布 |
| **Repositories** | 固定该包的每个仓库，包括其类型、版本和上次扫描时间 |

要立即向 OSV 查询新公告，请点击包标题栏中的 **Check advisories**。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.