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

# Devin Security 连接

> 介绍哪些 Devin Security 连接会导入发现项，哪些会将问题分诊操作（忽略、完成、重新打开、优先级）回写到来源工具，以及各连接的限制。

## 支持的连接

**Read** 表示将发现项导入 Devin Security 看板。**Write** 表示在 Devin 中执行的问题分诊操作 (忽略、完成、重新打开、优先级) 会同步更新来源中匹配的记录；若未写回全部四项操作，“说明”列会列出实际写回的操作。**Create** 表示 Devin 自身扫描产生的发现项会在来源中创建为新记录。

| 连接 | Read | Write | Create | 说明 |
| - | - | - | - | - |
| **Linear** | 是 | 是 | 是 | 同步工作流程状态和优先级；新问题会创建到该连接对应的团队中。 |
| **Jira** | 是 | 是 | 是 | 仅支持 Jira Cloud。按项目的工作流程流转问题，并依据项目的优先级方案设置优先级；新问题会创建到该连接对应的项目中。若工作流程中只有一个进入 Done 的转换，忽略和完成将使用同一转换；若工作流程中没有匹配的转换，问题保持不变。 |
| **Snyk** | 是 | 是 | 否 | 忽略会添加 `wont-fix` 忽略规则，重新打开会将其移除。完成不写回任何内容 (Snyk 会在重新扫描时关闭问题) 。不写回严重程度。 |
| **Socket** | 是 | 是 | 否 | 忽略 / 完成会创建告警处置记录，重新打开会将其删除。作用于整个 Socket 组织内的该软件包版本。不写回严重程度。 |
| **ArmorCode** | 是 | 是 | 否 | 忽略 → risk accepted，完成 → mitigated，重新打开，优先级 → 严重程度。 |
| **Wiz** | 是 | 是 | 否 | 忽略 → `REJECTED`，完成 → `RESOLVED`，重新打开 → `OPEN`。Wiz 仅对 Threat Detection Issues 接受 `RESOLVED`。不写回严重程度。需要一个具备 [Wiz](#wiz) 中所列作用域的服务账号。 |
| **GitHub Advanced Security** | 是 | 暂不支持 | 暂不支持 | 代码扫描、secrets 扫描和 Dependabot 告警。 |
| **SonarQube** | 暂不支持 | 暂不支持 | 否 | Issues 和 Security Hotspots。 |
| **Veracode** | 是 | 是 | 否 | 单个应用程序的 Static、Dynamic、Manual 和 SCA 发现项。忽略会提交一项 `ACCEPTRISK` 缓解措施提议，仍需 Mitigation Approver 在 Veracode 中批准；重新打开会拒绝该提议 (直接在 Veracode 中创建的缓解措施不受影响) 。完成不写回任何内容 (Veracode 会在重新扫描时关闭缺陷) 。不写回严重程度。SCA 发现项仅支持导入。 |
| **Vanta** | 是 | 否 | 暂不支持 | |
| **JFrog** | 是 | 否 | 否 | 来自 Xray 监视项的违规。 |
| **Black Duck** | 是 | 是 | 否 | 单个项目版本中存在漏洞的组件。忽略 → `IGNORED`，完成 → `REMEDIATION_COMPLETE`，重新打开 → `NEW` 修复状态。不写回严重程度。 |
| **Zafran** | 是 | 否 | 否 | |
| **CSV** | 是 | 否 | 否 | 一次性导入。 |
| **Custom** | 是 | 否 | 否 | Devin 会按照您的指示从任意 API 拉取发现项。 |

## Wiz

Devin 以服务账号身份连接 Wiz，通过 OAuth 客户端凭据访问您租户的 GraphQL API。请在 Wiz 的 **Settings → Service Accounts** 中创建服务账号，然后为该连接提供以下信息：

* **GraphQL 端点**：您租户的 API 端点，可在 **Settings → Tenant** 中查看，例如 `https://api.us1.app.wiz.io/graphql`。Devin 会据此推导出令牌端点。
* **客户端 ID** 和 **客户端密钥**：服务账号的凭据，均分别存储为组织 secrets。

### 作用域

为服务账号授予以下作用域：

| 用途 | 作用域 |
| - | - |
| 导入 Issue | `read:issues`, `read:threat_issues` |
| 回写问题分诊结果 | `write:issue_status`, `write:threat_issue_status`, `write:issue_ignore` |

忽略 Issue 时，Wiz 会检查 `write:issue_ignore`；将 Threat Detection Issue 标记为完成时，Wiz 会检查 `write:threat_issue_status`。仅凭 `write:issue_status` 无法执行上述任一操作。仅具有读取作用域的服务账号仍可导入发现项，但所有写入操作都会被拒绝。

### 写入内容

| Devin 中的操作 | Wiz 中的结果 |
| - | - |
| 忽略 | 状态设为 `REJECTED`，解决原因为 `WONT_FIX` |
| 完成 | 状态设为 `RESOLVED`，解决原因为 `ISSUE_FIXED` |
| 重新打开 | 状态设为 `OPEN` |

执行“忽略”和“完成”操作时，还会在该 Issue 上添加一条备注，注明对应的 Devin 工单。

### 限制

* Wiz 仅对 Threat Detection Issues 接受 `RESOLVED`。其他所有类型的 Issue 均由 Wiz 自行解决：当重新扫描不再发现该问题时，Wiz 会将其关闭。因此，在 Devin 中完成此类 Issue 后，它在 Wiz 中仍处于未解决状态。
* 不会写回严重程度：Wiz Issue 的严重程度取决于其 Control。
* 当 Wiz 拒绝写入时 (例如缺少作用域) ，Devin 会启动一个会话，并附上它尝试进行的更改以及 Wiz 返回的错误。


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