网络与安全
Human Plugin 信任它所处的网络，由您控制谁可以访问它。
信任边界
Human Plugin 提供纯 HTTP 服务，不对调用方进行身份验证或授权，不按客户端限定请求范围，也不终止 TLS。任何能够访问该端口的人，都可以使用您的访问密钥创建流程，并读取该安装中的任何流程。
因此：
- 仅向您的后端开放该端口：本机、sidecar，或配置了网络策略或安全组的私有网络。
- 切勿通过公共入口（ingress）或负载均衡器对外发布。
- 如果需要 TLS 或调用方身份验证，请在 Human Plugin 前面提供，例如由您运营的网关、服务网格或反向代理。
Human Plugin 建立的连接
| 目标地址 | 时机 | 说明 |
|---|---|---|
humantoken.unico.app (443) | 流程运行期间 | 使用您的访问密钥 |
human-token-assets.unico.app (443) | 启动时一次 | 属性目录 |
pkg.unico.run (443) | 拉取镜像时 | Unico 的镜像仓库。由 Docker 或 kubelet 使用，Human Plugin 本身不需要 |
| 您的 PostgreSQL | 始终 | 默认要求 SSL |
请在出站规则中允许这些目标地址。
密钥
访问密钥和数据库密码来自环境变量。请从您的密钥存储中注入。Human Plugin 不会将它们写入日志。更改其中任何一个都需要重启容器。
数据处理
- 敏感数据保留在您的基础设施内：您在
credential中发送的文档、您的客户端 ID 以及 intelligence 数据都保存在您的数据库中。 - 响应中包含 Human Token，对于 Journey 流程还包含 SDK 令牌和链接。Human Plugin 不会记录它们，您的网关和应用程序日志也不应记录。
- Human Plugin 不会存储自拍照，自拍响应也不会被缓存。请在您自己的系统中将其视为生物识别数据。
- Human Plugin 日志中从不包含图像、文档值、令牌或访问密钥。
- 客户端或品牌之间的隔离由安装实例及其数据库实现。
clientId是 intelligence 的计数维度，而不是访问边界。