Skip to main content

注册和安装包

安装程序包是您构建用于部署代理的单元。它捆绑了平台、设备应加入的标签和组以及专用注册密钥,因此安装命令是独立的。

创建包

在 管理 → 代理注册表 → 操作系统代理 中,使用以下命令创建一个包: 保存时,SecureAI 自动生成范围为 agent:enroll 的专用 API 密钥,并将其存储为包的注册密钥,因此安装命令不需要单独的凭据。删除该包会停用该密钥。

注册组(自动固定)

程序包的 注册组 是硬引脚:通过程序包注册的设备在第一次联系时绑定到该组。然后,组成员身份将决定设备解析哪些策略。

注册握手

当代理首次运行时,它使用注册密钥调用 POST /enroll 并发送其计算机 ID、主机名、操作系统、体系结构、版本、指纹和功能。后端:
  1. 注册(或匹配)设备。
  2. 发出每设备令牌,显示一次,用于验证所有后续调用。
  3. 返回运行时配置(解析的策略、出口设置、路由等)。
每设备令牌在每次注册时轮换。已被 撤销 的设备无法重新注册 - 注册响应报告 revoked: true,并且设备将保持断开状态,直到管理员重新启用它。

后端URL解析

特工给BACKEND_URL家里打电话。在服务器端,有效 URL 是从转发/请求源标头解析的,并且可以使用 SECUREAI_AGENT_URL 环境变量覆盖,这在反向代理后面很有用。

管理注册设备

在“操作系统代理”选项卡中,您可以针对每个设备:发送命令、撤销/重新启用、删除、分配组以及链接/取消链接所有者用户。支持批量操作。命令通过具有心跳队列回退功能的 WebSocket 通道进行传递(设备离线时排队的命令将在其下一个心跳时传递,TTL 为 1 小时)。

相关