Strix 云端渗透 API
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/usestrix-strix-managed-pentesting-with-strix。
技能介绍
要解决什么问题
在沙箱化托管 Agent、CI 或团队协同时,你往往不能在本机起 Docker、也不能自带 LLM,但仍要对自有域名、仓库或内网资产做自主渗透测试。Strix 开源 CLI 适合完全本地、离线或 BYO-LLM 场景;本技能覆盖的是 Strix 托管云 API 路径:扫描在 Strix 基础设施上执行,进度与漏洞在组织级仪表板里沉淀,与 CLI 共用同一引擎与 SARIF 输出,可按环境混用。
技能如何工作
集成方按 OpenAPI(docs.app.strix.ai)对接 https://app.strix.ai/api/v1,用仪表板 Settings → API Access 签发的 org-scoped Bearer Token 鉴权,并按最小权限勾选 scans:read/write、vulnerabilities:read/write、assets:read/write 等 scope。
典型流水线分四步:
- 注册资产:扫描对象须先登记为 asset(
GET /domains、GET /repositories查重后注册),不能对未登记 URL 裸扫。 - 发起扫描:
POST /scans绑定domain_ids/repository_ids/internal_targets,可配置engagement_type、凭据与 MFA、自定义 HTTP 头、focus/concerns 等以引导 Agent。 - 异步轮询:
GET /scans/{scanId}跟踪pending → running → completed,耗时从分钟到小时,勿阻塞主流程。 - 读取与处置:详情含
executive_summary、vulnerabilities[](含 CVSS、CWE、PoC 等);组织级可用GET /vulnerabilities做分诊,严重度需按 critical→high→medium→low 排序而非字母序。
扩展能力还包括 PR 安全评审(pr_reviews:write)、定时任务(Pro 计划 schedules)与 Webhooks 订阅 scan.completed 等事件,减少轮询。HTTP 需处理 401/402/403/422 等错误。
适用边界与注意点
仅扫描组织拥有或已获授权的资产;外域扫描受平台 DNS/文件/meta 验证约束,不可绕过。可下载 PDF/DOCX 报告属 Enterprise 计划;需完全免费、气隙或本地 LLM 时请改用 penetration-testing-with-strix CLI 技能。修复闭环可交接 fix-security-vulnerabilities-with-strix。
使用场景
- CI 流水线在合并前通过 API 登记仓库资产并触发 `code_review` 或 `live_test` 扫描,轮询完成后将 findings 写入工单
- 托管沙箱 Agent 无法安装 Docker,需用 Bearer Token 调用 `POST /scans` 对已验证域名做定时安全检测
- 安全团队用 `GET /vulnerabilities` 跨多次扫描汇总分诊,并配合 Webhook 把 `vulnerability.created` 推到 Slack
- 对 GitHub/GitLab PR 调用 PR review 接口,让评审结果以评论形式出现在合并请求中
适合人员
- 负责将安全扫描嵌入 Jenkins/GitHub Actions、且运行环境禁止本地容器的 DevSecOps 工程师
- 在团队仪表板中需要统一查看扫描状态、分诊漏洞并更新 open/fixed 状态的应用安全负责人
- 为多个域名/仓库维护资产清单、并需 Pro 计划定时任务替代本机 cron 拉 CLI 的安全运营
- 编写自定义集成(Slack/工单)并需按 scope 最小权限管理 org API Token 的平台后端开发