ClearScreen 文档

集成

ClearScreen 可连接你的身份提供商、用于部署的 Intune,以及你的日志管道。

Microsoft Entra ID 登录

在 Business 方案中,控制台用户可以通过 Spot Suite 使用 Microsoft Entra ID 单点登录。设备代理程序从不使用用户密码。

Microsoft Intune

在 Business 方案中,Intune 标签页会为你的租户保存一个 Microsoft Entra 应用注册。该应用注册需要应用程序权限 DeviceManagementConfiguration.ReadWrite.All 和 Group.Read.All,并经管理员同意。密钥以加密方式存储,之后不会再次显示。选择“验证连接”进行测试。

要部署代理程序,请将 Enrollment 标签页中的安装命令作为 Intune 脚本或 Win32 应用运行。对于 Win32 应用,请使用能找到该服务的检测规则:

Get-Service -Name ClearScreen -ErrorAction SilentlyContinue

威胁情报源

代理程序使用已签名的数据包进行过滤,数据包由 URLhaus 和 OpenPhish 情报源以及 UT1 和 StevenBlack 类别列表构建。数据包每 15 分钟刷新一次。代理程序在使用数据包之前会检查其 Ed25519 签名,离线时会继续使用最近一次验证过的数据包进行过滤。允许的查询通过 DoH 转发到 Cloudflare 1.1.1.1。

用于日志转发的事件导出

可以使用导出令牌拉取拦截事件。管理员通过控制台 API 创建该令牌,令牌以 csat_ 开头。它只显示一次,系统只保留其哈希值。

curl -H "Authorization: Bearer <export token>" \
  "https://<workspace>.clear-screen.ai/v1/agent/export/events?since=2026-01-01T00:00:00Z"

一次响应最多包含 500 条事件,以及读取下一页时作为 since 和 after 回传的值。对复核报告,请以同样方式使用 GET /v1/agent/export/reviews。