技能介绍

它解决什么问题

在域名资产梳理、攻击面排查和证书审计时，工程师经常需要把某个 hostname 放到 SecurityTrails 里反复查询：它关联了哪些域名、当前 DNS 记录是什么、SSL 证书是否有效、已知有哪些子域名。手动在 Web 控制台切换页面、复制结果、再粘贴到报告里，既打断流程，也不利于把查询纳入自动化脚本或 Agent 工具链。oo-securitytrails 把这个动作包装成可调用的 connector 操作，让模型通过 oo CLI 直接发起查询，而不是操作网页或保存 token。

工作方式与关键步骤

该技能通过 OOMOL 已连接账号调用 SecurityTrails connector，凭据由 OOMOL 服务端注入，客户端不需要处理原始 API token。它暴露 4 个 action：find_associated_domains 查找与一个 hostname 关联的域名，get_domain 获取当前 DNS 与域名详情，get_domain_ssl 获取 SSL 证书详情，get_subdomains 列出已知子域名。

调用前先读取契约，用 oo connector schema 拿到权威 input/output schema，再构造 --data。--data 可以传 JSON object string，也可以传 @path/to/file.json；省略则发送 {}。返回结构为 { "data": ..., "meta": { "executionId": "..." } }，执行 id 在 meta.executionId。每个 action 的参考文件说明用途和准确命令，应先读参考文件再取 live schema。

安全边界：get / list / search 这类读取操作可以直接执行；create、update、send、post 会改变 SecurityTrails 状态，执行前必须和用户确认准确 payload 与影响；delete 或 remove 具有破坏性，必须先确认目标并获得明确批准。

适用边界

它适合把 SecurityTrails 查询嵌入 Agent 工作流、批量侦察前的数据补全、DNS/SSL 变更核对和子域名资产盘点。前提是用户已经安装 oo CLI、登录并连接 SecurityTrails；不要主动执行 oo auth login 或打开连接 URL，只有在命令真的因认证或连接错误失败时，才回退到一次性 setup。遇到 oo: command not found 时需要先具备 CLI；未登录或认证错误时做一次性登录；scope_missing、credential_expired、app_not_ready、app_not_found 说明连接缺失、过期或 scope 不足，需要用 API key 重新连接 SecurityTrails；HTTP 402 或 OOMOL_INSUFFICIENT_CREDIT 表示计费中断，需要先在 OOMOL 控制台充值再重试。