PhishRod

本文档介绍了如何将 PhishRod 与 Google SecOps 集成。

在 Google Security Operations 中配置 PhishRod 集成

有关如何在 Google SecOps 中配置集成的详细说明,请参阅配置集成。

集成参数

使用以下参数配置集成:

参数显示名称 类型 默认值 为必填项 说明
API 根 字符串 https://api.bitsighttech.com 是 PhishRod 实例的 API 根。
API 密钥 密码 不适用 是 PhishRod 账号的 API 密钥。
客户端 ID 密码 不适用 是 PhishRod 账号的客户端 ID。
用户名 字符串 不适用 是 PhishRod 账号的用户名。
密码 密码 不适用 是 PhishRod 账号的密码。
验证 SSL 复选框 勾选 是 如果启用,则会验证与 BitSight 服务器连接的 SSL 证书是否有效。

操作

Ping

说明

使用 Google SecOps Content Hub 页面中的集成配置页面上提供的参数,测试与 PhishRod 的连接。

参数

不适用

运行时间

该操作不会对实体执行,也没有强制性输入参数。

操作执行结果

脚本结果

脚本结果名称 “值”选项 示例
is_success True/False is_success:False

案例墙

结果类型 值 / 说明 类型
输出消息*

操作不应失败,也不应停止 playbook 执行:

如果成功 (is_success=true): “已使用提供的连接参数成功连接到 PhishRod 服务器!”

操作应失败并停止 playbook 执行:

如果未成功 (is_success= false):“Failed to connect to the PhishRod server! Error is {0}".format(exception.stacktrace)

常规

更新突发事件

说明

在 PhishRod 中更新突发事件。

参数

参数显示名称 类型 默认值 为必填项 说明
突发事件 ID 字符串 不适用 是 指定需要更新的突发事件的 ID。
状态 DDL

删除

可能的值:

  • 安全
  • 删除
否 指定突发事件的状态。

运行时间

此操作不会对实体执行。

操作执行结果

脚本结果

脚本结果名称 值选项 示例
is_success True/False is_success:False

JSON 结果

{
    "statusMarked": false,
    "message": "Incident status is already marked."
}

案例墙

结果类型 说明 类型
输出消息*

操作不应失败,也不应停止 playbook 执行:

如果 statusmarked == "true" (is_success=true):“已成功在 PhishRod 中更新突发事件 {incident id}。

如果 statusmarked == "false" (is_success=false):“突发事件 {incident id} 的状态之前已在 PhishRod 中修改过。”

操作应失败并停止 playbook 执行:

如果报告了严重错误(例如凭据错误、无法连接到服务器等),则会显示以下消息:“Error executing action "Update Incident". Reason: {0}''.format(error.Stacktrace)

如果 message != "Incident status is already marked." 且 ""statusMarked"": false "Error executing action "Update Incident". Reason: {0}".format(message)"

常规

标记突发事件

说明

在 PhishRod 中标记突发事件。

参数

参数显示名称 类型 默认值 为必填项 说明
突发事件 ID 字符串 不适用 是 指定需要标记的突发事件的 ID。
状态 DDL

标记为待进行次级分析

可能的值:

  • 标记为次要分析
  • 标记为垃圾邮件
  • 标记为安全
否 指定突发事件的标记方式。
评论 字符串 不适用 是 指定说明突发事件标记原因的注释。

运行时间

此操作不会对实体执行。

操作执行结果

脚本结果

脚本结果名称 值选项 示例
is_success True/False is_success:False

JSON 结果

{
    "code": "200",
    "status": "Incident status has already been updated before."
}

案例墙

结果类型 说明 类型
输出消息*

操作不应失败,也不应停止 playbook 执行:

如果报告了 200 状态代码 (is_success=true):“已成功在 PhishRod 中标记突发事件 {incident id}。”

如果报告了 200 状态代码,并且状态为“Incident status has already been updated before”(is_success = false):表示“突发事件 {incident id} 之前已在 PhishRod 中标记。

操作应失败并停止 playbook 执行:

如果报告了严重错误(例如凭据错误、无法连接到服务器等):“执行操作‘标记突发事件’时出错。Reason: {0}''.format(error.Stacktrace)

如果报告了 400 或 404 状态代码:“Error executing action "Mark Incident". Reason: {0}".format(message)"

常规

连接器

PhishRod - Incidents Connector

说明

从 PhishRod 中提取突发事件相关信息。

在 Google SecOps 中配置 PhishRod - Incidents 连接器

如需详细了解如何在 Google SecOps 中配置连接器,请参阅配置连接器。

连接器参数

使用以下参数配置连接器:

参数显示名称 类型 默认值 为必填项 说明
产品字段名称 字符串 产品名称 是 输入源字段名称,以便检索产品字段名称。
事件字段名称 字符串 事件字段 是 输入源字段名称,以检索事件字段名称。
环境字段名称 字符串 不适用 否

描述存储环境名称的字段的名称。

如果未找到环境字段,则环境为默认环境。

环境正则表达式模式 字符串 .* 否

要对“环境字段名称”字段中的值运行的正则表达式模式。

默认值为 .*,用于捕获所有值并返回未更改的值。

用于允许用户通过正则表达式逻辑操作环境字段。

如果正则表达式模式为 null 或空,或者环境值为 null,则最终环境结果为默认环境。

脚本超时(秒) PythonProcessTimeout 300 是 运行当前脚本的 Python 进程的超时限制。
API 根 字符串 https://{instance}.phishrod.co 是 PhishRod 实例的 API 根。
API 密钥 密码 不适用 是 PhishRod 账号的 API 密钥。
客户端 ID 密码 不适用 是 PhishRod 账号的客户端 ID。
用户名 字符串 不适用 是 PhishRod 账号的用户名。
密码 密码 不适用 是 PhishRod 账号的密码。
提醒严重程度评分 字符串 中 是

根据突发事件设置提醒的严重级别。

可能的值:信息、低、中、高、严重。

将动态列表用作黑名单 复选框 尚未核查 是 如果启用,动态列表将用作黑名单。
验证 SSL 复选框 勾选 是 如果启用此设置,系统会验证与 Crowdstrike 服务器连接的 SSL 证书是否有效。
代理服务器地址 字符串 不适用 否 要使用的代理服务器的地址。
代理用户名 字符串 不适用 否 用于进行身份验证的代理用户名。
代理密码 密码 不适用 否 用于进行身份验证的代理密码。

连接器规则

代理支持

此连接器支持代理。

需要更多帮助?获得社区成员和 Google SecOps 专业人士的解答。