摘要
通过任何 AI 代理进行 ThreatAware 网络资产管理:跨越你的安全和 IT 工具的合并设备和用户清单、开放的警报、每个安全控制的健康状况(Vitals,今天或过去某天)、一个连接工具的原始记录,以及门户用户、角色和团队。只读。Cloud ID 和 API 密钥。
引导式设置
2 分钟将 ThreatAware 连接到 Claude、ChatGPT 或 Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 ThreatAware,再把你的 MCP URL 添加到你的 AI 助手。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
ThreatAware 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → ThreatAware,粘贴你的凭据,生成 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
ThreatAware
通过任何 AI 代理进行 ThreatAware 网络资产管理:跨越你的安全和 IT 工具的合并设备和用户清单、开放的警报、每个安全控制的健康状况(Vitals,今天或过去某天)、一个连接工具的原始记录,以及门户用户、角色和团队。只读。Cloud ID 和 API 密钥。
设置
设置大约需要 3 分钟。
- 登录到你的门户并记下其地址的第一部分:对于
https://acme-corp.threataware.com,Cloud ID 是acme-corp。将其放入THREATAWARE_CLOUD_ID。 - 打开 设置,API 访问(地址
/settings/api)并点击 生成密钥。命名密钥,选择过期时间(1 天、1 周、1 个月或从不;默认是 1 天,因此请有意选择)并保存。 - 立即复制密钥(仅显示一次)到
THREATAWARE_API_KEY。它在X-ThreatAware-ApiKey头中发送。
密钥看到其创建者看到的内容。ThreatAware 建议在专用服务用户下创建它,角色较窄,而不是个人账户。
从哪里开始
threataware_list_vitals显示每个连接工具及其内部名称(key),以及在 Vitals 开启时,部署了多少设备、正常工作和正确配置。将这三个对作为一个漏斗来阅读:部署的数量与预期相比,正常工作的数量与已部署的数量相比,配置的数量与正常工作的数量相比。threataware_list_alerts使用过滤器allunresolved列出当前开放的内容;state红色表示紧急,琥珀色表示警告。threataware_list_devices是合并的设备清单。设备上的SecurityTools显示每个工具的警报计数,ConnectedSystems显示设备已知的地方。threataware_list_users是合并的人员列表,metadata中包含 MFA 和管理员标志,以及最后一次成功和失败的登录。threataware_list_inventory返回一个工具的原始记录,当你需要合并列表中没有的字段时。它需要工具的内部名称,即来自threataware_list_vitals的key,而不总是门户中显示的名称(Microsoft Intune 是devices_msgraph,SCCM 是mecmsystem)。- 门户管理:
threataware_list_portal_users、threataware_list_roles和threataware_list_teams描述谁可以登录到 ThreatAware 以及具有哪些权限。
分页:每个列表接受 offset 和 limit,并回答 total。当未发送限制时,ThreatAware 返回整个数据集,因此此连接器始终发送一个(默认 100)。在设备和用户上,偏移量在 10,000 条记录处停止(超出状态 400);请使用 filter 进行缩小。
读取数据
- 时间为 ISO 8601 格式,不带时区,例如
2026-10-10T08:49:28.0000000。0001-01-01T00:00:00表示“从未”(未确认、未解决、未延迟)。 - 服务器端没有按主机名、用户或严重性进行搜索:获取页面并自行过滤结果。
- 设备和用户数据是个人数据(姓名、电子邮件、IP 地址、登录位置)。仅分享问题所需的信息。
限制和错误:整个门户每分钟 50 个请求,无论使用哪个密钥;状态 429 表示等待一分钟。状态 400 和“发生意外错误。”表示密钥错误、禁用或过期(ThreatAware 对坏密钥返回 400,而不是 401)。401 表示未发送密钥。403 表示密钥的用户缺乏该区域的权限。无法解析的门户地址表示 Cloud ID 错误。
先决条件:THREATAWARE_CLOUD_ID,THREATAWARE_API_KEY
在本地安装连接器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
打开 http://localhost:3000/connectors/store,选择 ThreatAware 并粘贴在先决条件下列出的环境变量。
可用工具
| 工具 | 功能 |
|---|---|
threataware_list_devices | 列出 ThreatAware 从所有连接工具合并的设备。每个设备都有 id、hostName、os、osVersion、lastOnline、firstSeen… |
threataware_list_users | 列出 ThreatAware 从连接的目录和身份提供者收集的人员。每个用户都有 id、name、email、jobTitle… |
threataware_list_alerts | 列出 ThreatAware 在环境中提出的警报(问题)。每个警报都有状态(红色、琥珀色或绿色)、产品(工具和… |
threataware_list_inventory | 读取 ThreatAware 为一个连接工具保存的原始记录,使用该工具自己的字段名称(例如 Automox 补丁计数,或… |
threataware_list_vitals | 获取每个连接安全工具的健康状况(Vitals),今天或过去某天。每个条目都有 key(该工具使用的内部名称… |
threataware_list_portal_users | 列出可以登录到 ThreatAware 门户本身的账户(而不是在目录中找到的人:对于那些请调用… |
threataware_list_roles | 列出 ThreatAware 门户的角色。每个角色都有 id(例如 superAdmin、analyst 或 viewer)、name、description、default(true… |
threataware_list_teams | 列出 ThreatAware 门户的团队及其成员。每个团队都有 id、name 和成员(用户名、姓名和姓氏)。团队范围… |
示例提示
- “哪些安全工具在预期和已部署设备之间存在最大差距?”
- “列出所有未解决的红色警报。”
- “哪些用户没有 MFA 但有管理员权限?”
- “显示缺少 EDR 代理的设备。”
- “谁可以登录我们的 ThreatAware 门户,以及具有哪些角色?”
下一步
这份指南对你有帮助吗?