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 专业人士的解答。