API 密钥和范围
ClearScreen 没有可配置范围的密钥。每种密钥类型只有一项用途。
| 密钥 | 开头 | 用途 |
|---|---|---|
| 注册密钥 | csk_ | 通过 clearscreen enroll 注册设备。每个工作区一个,轮换时只显示一次。 |
| 设备密钥 | csk_ | 每台设备一个。代理程序用它获取策略并上报拦截。它在设备上以 0600 权限存储,在服务器上以哈希值存储。 |
| 导出令牌 | csat_ | 读取拦截事件和复核报告,用于日志转发。管理员可以通过控制台 API 创建和撤销。 |
密钥的处理
- 请将注册密钥视为机密。轮换后,旧密钥无法再用于新的注册。已注册的设备继续正常工作。
- 再次用相同的计算机名称注册会签发新的设备密钥,旧密钥随即失效。
- 只有工作区管理员可以轮换注册密钥或管理导出令牌。
- 切勿将密钥放入工单、聊天或截图中。
检查域名
公开的检查端点针对共享的情报源和类别给出答复。它不需要密钥,并有速率限制。
curl "https://clearscreen.spot-suite.com/v1/check?domain=example.org"