SuperAPI AI 工具集

hex-security-basics

安全与审计

查看项目

更新于 10-15 23:26

技能介绍

用途:本技能面向 Hex 协作式数据分析平台的安全实践。Hex 中笔记本会查询生产数据库、生成可视化并跨团队共享,安全重点在于 API 令牌管理(read 与 run 作用域)、保护嵌入项目的数据库连接凭据,以及防止含敏感业务数据的查询结果经日志或导出泄露。run 作用域令牌一旦泄露可对已连接数据库触发任意查询。

主要能力:提供 API 密钥管理示例,按作用域从环境变量读取令牌(HEX_RUN_TOKEN 或 HEX_READ_TOKEN),缺失即报错,并提示令牌应存入密钥管理器而非代码;提供 Webhook 签名校验,使用 x-hex-signature 头与 HMAC-SHA256 及 timingSafeEqual 比对;提供基于 zod 的输入验证,校验 project_id、input_params、notify_on_completion、update_cache;提供日志脱敏,对 db_connection_string、query_results、api_token、input_params、export_url 等字段替换为 [REDACTED];并给出安全清单与风险缓解对照表。

使用方式:按资料中的代码示例初始化客户端、校验 Webhook、验证请求与脱敏日志。前置条件包括:明确令牌保管人、项目与数据所有者、不可信参数、事件负责人和已批准的密钥管理器的威胁模型;低权限沙箱凭据及不含生产敏感数据的验证项目;轮换、吊销、禁用项目与取消运行的运维手册及经过测试的回滚。操作上按环境与项目限定凭据作用域,从密钥管理器注入,拒绝未知作用域或目标;运行前验证参数、来源、大小与允许项目;解析前验证 Webhook 真实性,拒绝过期或重放事件;每次授权或客户端变更后在沙箱项目测试最小权限与拒绝访问;怀疑凭据泄露立即吊销,完整性不确定时取消相关运行,仅保留脱敏证据。输出安全回执,含环境、项目作用域、密钥引用版本、验证与授权结果、轮换吊销状态、关联 ID 与回滚动作,不得包含令牌、SQL、输出或原始事件。

限制:资料未提供具体收费、价格、平台支持范围或效果数据;示例代码需按实际环境调整,本技能不替代 Hex 官方文档与 OWASP API 安全指南。