Linear

配置 Linear 集成

Ostorlab 提供了使用 Ostorlab 工单轻松管理漏洞并将其与 Linear 无缝同步的可能性。

Linear 配置在组织层面完成：连接后，Ostorlab 工单将单向或双向同步到 Linear。

Linear 配置：

要启用 Linear 集成，该组织必须拥有企业订阅。

Ostorlab 使用个人 API 密钥连接到 Linear：无需单独配置用户名或工作区 URL。

创建 Linear API 密钥：

1. 访问您的 Linear API 设置。
2. 创建一个个人 API 密钥。
3. 复制生成的密钥。

连接 Linear 集成：

前往 Linear 集成菜单 Library -> Integrations -> Linear -> Configuration。

1. 打开 Ostorlab 主菜单。
2. 点击 "Library"。
3. 点击 "Integrations"。
4. 选择 Linear 集成。
5. 打开开关以启用 Linear 集成。
6. 添加 Linear API 密钥。
7. 选择要同步工单的 Linear 团队。输入有效的 API 密钥后，团队列表将实时从 Linear 获取。

您可以保存配置并测试与 Linear 的连接。所有测试都应通过。

注意： 如果您想将与您的 Linear 实例通信的 Ostorlab Linear 客户端加入白名单，请联系支持团队。

---

从 Ostorlab 工单自动创建 Linear 工单：

---

请确保已完成 连接 Linear 集成 中的步骤，并且连接检查通过。

要启用 Linear 工单的自动创建，请打开 "Automatically create Ticket" 开关。

您还可以选择：

• 将更新从 Ostorlab 同步到 Linear。
• 将更新从 Linear 同步到 Ostorlab。

配置好同步模式后，您需要选择：

• 用于工单的 Linear 团队（参见上文的 连接 Linear 集成）。
• 如果您希望将工单创建为现有工单的子工单，可以设置要使用的父工单 ID。此字段为可选项。
• 要同步的字段：Linear 仅支持自动同步工单的 标题 和 描述；其他字段需要字段映射（见下文）。
• 要同步到 Linear 的工单风险评级。
• 点击 Save。

您可以点击测试按钮，检查该集成是否能够在 Linear 团队中写入工单。

---

字段映射类型

---

在配置 Ostorlab 和 Linear 之间的字段映射时，您可以使用三种不同的映射类型：

1. Field Mapping（字段映射）：将 Ostorlab 字段直接映射到 Linear 字段（例如标题、描述、优先级、状态、负责人、标签、截止日期）
2. Value Mapping（值映射）：为 Linear 字段设置一个静态值
3. Template Mapping（模板映射）：使用 Ostorlab 工单变量为 Linear 字段提供自定义模板

模板映射

模板映射允许您使用 Ostorlab 工单变量创建自定义字段值。使用双大括号引用工单变量：{{variable_name}}

可用的变量： - {{title}}：工单标题 - {{description}}：工单描述 - {{risk_rating}}：工单风险评级 - {{status}}：工单状态 - {{assigned}}：已分配用户的用户名 - {{due_date}}：工单到期日 - {{target}}：工单的扫描目标 - {{tags.<tag_name>}}：名为 <tag_name> 的工单标签的值

示例模板：

Assigned to {{assigned}}