rewired89/HSIP-1PHASE

# HSIP — 本地身份服务器 **单一二进制文件。无云端。无订阅。为个人、AI 代理和金融机构提供加密身份与防篡改审计追踪。** [](LICENSE) [](https://github.com/rewired89/HSIP-1PHASE/actions) [](https://github.com/rewired89/HSIP-1PHASE/actions/workflows/security-audit.yml) ## 快速安装 **Windows** — [下载 hsip-windows-x64.exe](https://github.com/rewired89/HSIP-1PHASE/releases/latest/download/hsip-windows-x64.exe) → 双击 → 自动打开浏览器。 **macOS / Linux** — 一条命令： ``` curl -sSf https://raw.githubusercontent.com/rewired89/HSIP-1PHASE/main/install.sh | sh ``` **Homebrew:** ``` brew tap rewired89/hsip https://github.com/rewired89/HSIP-1PHASE && brew install hsip ``` ## 为什么现在需要它 2026年，三件事同时发生： - **AI 代理代表你行动**，却没有关于它们做了什么或谁授权的可靠记录。 - **OpenAI、Google 和 Meta 在你用来思考的工具中投放广告**。你的 prompt 正在训练他们的模型。 - **Deepfake 让数字证据变得毫无意义** —— 除非它带有无法伪造的加密签名。 HSIP 就是这三者的解决方案。它运行在你的硬件上，用你的密钥签署一切，并为你提供完全拥有的防篡改审计追踪。 ## 它是为谁准备的？ | 我想要... | 运行什么 | |---|---| | **停止被追踪** — 在我使用的所有应用中阻止广告、遥测和监控 | [DNS Tracker Blocker](#1-dns-tracker-blocker--block-everything-system-wide) | | **证明我说过的话** — 创造法庭可采信的证据，证明我在此时间撰写了此消息 | [Signed Messages + Audit Trail](#2-signed-messages--fight-deepfakes-and-win-disputes) | | **控制我的 AI 代理** — 准确查看我的 AI 做了什么，并立即撤销访问权限 | [AI Watch + Consent Wallet](#3-ai-watch--know-exactly-what-your-ai-did) | | **构建尊重隐私的软件** — 为我的应用或 AI 代理添加 consent 基础设施 | [Developer SDK →](#for-developers) | | **企业审计合规** — GDPR、法庭记录、法律级证据链 | [Enterprise deployment →](#for-enterprises) | | **金融服务基础设施** — 针对受监管环境的审计追踪和密钥管理模式 | [Financial Services →](#financial-services) | ## 下载 | 平台 | 文件 | |----------|------| | **Windows** | [`hsip-windows-x64.exe`](https://github.com/rewired89/HSIP-1PHASE/releases/tag/latest) | | macOS Apple Silicon | [`hsip-macos-arm64`](https://github.com/rewired89/HSIP-1PHASE/releases/tag/latest) | | macOS Intel | [`hsip-macos-x64`](https://github.com/rewired89/HSIP-1PHASE/releases/tag/latest) | | Linux | [`hsip-linux-x64`](https://github.com/rewired89/HSIP-1PHASE/releases/tag/latest) | ## 功能 ### 1. DNS Tracker Blocker — 全系统级拦截 HSIP 在追踪请求到达你的机器之前，就在 DNS 级别进行拦截。不仅是针对某一个浏览器 —— 而是你运行的每一个应用。 拦截 Google Analytics、Facebook Pixel、Hotjar、TikTok、DoubleClick、Microsoft 遥测等 200 多种服务。在 dashboard 中一键开启。零配置。 **与浏览器扩展的区别：** 浏览器扩展只能保护一个浏览器。HSIP 在网络层进行拦截 —— 桌面应用、后台进程、所有浏览器，同时生效。 ### 2. Signed Messages — 对抗 Deepfake 并赢得争议 你通过 HSIP 发送的每一条消息都使用你的个人 Ed25519 密钥进行签名。其结果是数学证明： - 你写下的正是这些话 - 就在这个确切的时间戳 - 没有被任何人篡改 这种证明可以被任何人验证，无论是在法庭上还是由机器进行。它无法被伪造。 **实际用例：** - *合同确认：* “我确认我们在 2026 年 3 月 28 日达成了这些条款。” —— 经过签名、打上时间戳、可验证。 - *争议证据：* 在几秒钟内生成加密收据，证明你说了什么以及何时说的。 - *Deepfake 防御：* 当有人声称你说了你没说过的话时 —— 你经过签名的历史记录可以证明并非如此。 - *AI 指令授权：* 你向 AI 代理发出的每一条指令都使用你的密钥进行了签名。不可否认性不复存在 —— 而且是双向的。 ### 3. AI Watch — 准确了解你的 AI 做了什么 你连接的每个 AI 代理（Claude、ChatGPT、Siri、任何支持 HTTP 的工具）都会被实时追踪： - **速率监控** — 如果代理发出了异常数量的请求则发出警报 - **异常检测** — 标记超出正常模式的行为 - **一键断开连接** — 立即撤销任何代理的访问权限 - **完整的签名审计追踪** — 代理采取的每一个动作都经过签名并打上时间戳 这就是你 AI 的“黑匣子记录仪”。当出现问题时，你能准确知道发生了什么以及何时发生的。 ### 4. Consent Wallet — 机器可读的访问控制 HSIP 并非使用那些你不看就直接点击的 cookie 横幅，而是创建了一个你真正能够控制的 consent 层： - 查看每一个有权联系你或访问你数据的参与方 - 准确查看每一方被允许做什么 - 为 consent 设置时间限制 —— 它会自动过期 - 一键撤销任何 consent，立即生效 ### 5. 防篡改审计日志 HSIP 中的每一个操作 —— 消息签名、consent 授权、密钥生成、AI 动作记录 —— 都会写入一个仅可追加的审计日志。审计记录没有删除或更新的 endpoint。 你可以随时导出日志，用于法律诉讼、合规审计或个人记录。 ## 金融服务 HSIP 是为银行、交易部门、金融科技公司以及任何需要防篡改审计追踪、AI 代理治理和跨机构身份验证的受监管机构提供的密码学基础设施 —— 中间不需要中央云供应商。 **客户是机构，而不是散户投资者。** HSIP 在你的数据中心（或本地）运行，使用你的 Ed25519 密钥对签署每一个动作，并产生具有法律辩护力的证据，证明你的系统、分析师和 AI 代理完全按照审计追踪所记载的那样执行了操作。 ### 为什么金融机构现在需要它 **1. AI 代理代表你的机构行事** —— 监管机构会询问谁授权了每一项操作。如果没有附加到每个代理的加密身份以及每个请求的仅追加日志，你就无法回答这个问题。HSIP 为每个 AI 代理分配自己的 Ed25519 密钥对，记录其采取的每一个动作，并允许你在几毫秒内撤销其访问权限。 **2. 受监管的环境要求你证明** 你的系统做了什么、何时做的以及基于谁的授权。HSIP 将每个操作写入仅追加的审计日志 —— 不存在删除或更新 endpoint。每个条目都使用租户的 Ed25519 密钥进行签名，因此每条记录的来源在密码学上都是可验证的。 **3. 有时间限制的 consent 是许多金融工作流中的设计要求。** HSIP 的 Consent Wallet 正好生成这种东西：一个经过密码学签名、限定于特定操作、自动过期且可实时撤销的授权。 **4. 机构间的信任已经破裂。** 当一条消息来自交易对手时，你如何验证它在传输过程中没有被篡改？HSIP 的 Federated Trust 层允许机构带外（电子邮件、安全通道）交换 Ed25519 验证密钥，然后在本地以密码学方式验证未来的任何消息 —— 无需中央注册表，无需 PKI 供应商，没有单点故障。 **5. 异常的 AI 和自动化系统行为需要检测和响应。** HSIP 的速率监控会标记超过 100 个请求/分钟的代理，并在 1,000 个请求/分钟时自动撤销访问权限 —— 每一步都有经过签名的审计条目。 ### HSIP 为受监管环境提供什么 HSIP 未获得任何监管框架的认证。它提供密码学基础设施 —— 即构建合规架构的基石。 | 能力 | 它的作用 | |---|---| | **仅追加、哈希链审计日志** | 不存在删除或更新 endpoint。每个条目扩展一个按租户划分的 BLAKE3 哈希链（`GET /v1/audit/verify` 会重新计算并检查它），因此修改或删除行会破坏其后的所有链接。可导出供审计员使用。 | | **Ed25519 签名的操作** | 每个控制操作都使用机构的密钥进行签名。时间戳 + 签名 = 不可否认的记录。 | | **有时间限制的 consent 授权** | 具有作用域、过期时间和撤销功能的机器可读授权，通过 `POST /v1/consent/grant` 实现。 | | **被遗忘权** | `DELETE /v1/tenant/erase` 永久删除所有租户数据，并记录擦除事件。 | | **AI 代理身份与撤销** | 每个代理都有一个唯一的密钥对。速率监控、异常检测、自动撤销。 | | **机构间消息验证** | Ed25519 验证密钥带外交换。在本地验证消息，无需中央授权机构。 | | **不可否认性** | 带有公开验证密钥的签名消息。任何交易对手都可以在不调用你的服务器的情况下进行验证。 | 这些能力是否满足你所在司法管辖区的特定监管要求是一个法律问题，而不是产品声明。在受监管环境中部署 HSIP 之前，请咨询你的合规团队和法律顾问。联系 [sanchezleal1989@gmail.com](mailto:sanchezleal1989@gmail.com) 讨论你的架构。 ### 面向金融机构的 AI 代理治理 你的机构部署的每一个 AI 系统 —— 交易算法、文档处理器、面向客户的聊天机器人、内部助手 —— 都会在 HSIP 中注册其专用的 Ed25519 密钥对。 ``` # 将交易算法注册为受控 AI agent hsip agent register "algo-trading-v2" --expires-days 90 # 列出所有活跃的 agent 及其请求速率 hsip agent list # 立即撤销行为异常的 agent hsip agent revoke "algo-trading-v2" ``` 你为每个代理获得： - **唯一的 Ed25519 密钥对** —— 它签名的每一个动作都可以追溯到那个特定的代理，而不仅仅是“系统” - **速率监控** —— 请求 > 100次/分钟会触发异常审计条目；> 1,000次/分钟触发自动撤销 - **完整的签名审计追踪** —— 代理进行的每一次 API 调用，都带有时间戳并形成链条 - **即时撤销** —— `DELETE /v1/keys/:id` 在数据库写入完成之前就在内存中生效；传输中的请求会通过 `pending_revocation` 集合立即被阻止 这就是监管机构和你自己的风险团队在 AI 代理做出意外举动时所需要的“黑匣子记录仪”。 ### Federated trust — 跨机构 Ed25519 验证 当你的交易部门需要验证来自交易对手银行的消息是否真实时，你有两个选择：信任中央证书颁发机构（单点故障、供应商锁定）或者直接交换 Ed25519 验证密钥并在本地进行验证。 HSIP 实现了第二种方法： ``` # 您的交易对手通过带外方式向您发送其 Ed25519 verify key hsip trust add "Deutsche Bank Desk A" "d75a980182b10ab7d54bfed3c964073a0ee172f3daa62325af021a68f707511a" # 在本地验证他们发送给您的任何消息 — 无需网络调用 hsip trust verify --from "Deutsche Bank Desk A" \ "Trade confirmation: AAPL 1000 @ 182.50" \ "signature_hex_here" ``` 没有中央注册表。没有 PKI 供应商。没有单点故障。每个机构都直接持有对方的公开密钥。验证在本地 `<1ms` 内完成。 API： ``` POST /v1/trust/peer Add a trusted counterparty's verify key GET /v1/trust/peers List all trusted counterparties DELETE /v1/trust/peers/:id Remove a counterparty POST /v1/trust/verify Verify a signed message from a named counterparty ``` ### 主密钥轮换与备份 主密钥会在静态存储时加密每个租户的私钥。它会在首次启动时自动生成 —— 备份它，并根据你的合规政策要求的时间表进行轮换： ``` # 确认您的备份文件确实与正在运行的程序匹配 — 无密钥暴露，无需轮换 hsip keys master-fingerprint # 按计划轮换：重新加密每个身份，热切换，无需重启，无停机 hsip keys rotate-master # → 在执行任何操作前请求确认；传递 --yes 以用于脚本化/计划运行 ``` 仅限管理员密钥。对于由文件支持的密钥（默认设置），开箱即用。对于源自 `HSIP_MASTER_KEY` 的密钥（例如指向 Vault 或 AWS Secrets Manager），请将 `HSIP_ROTATION_HOOK` 设置为一个脚本，该脚本会将接收到的新密钥（通过 stdin 接收十六进制编码）写入你的 secrets manager —— HSIP 会调用它并信任其退出代码，但本身绝不持有你的 secrets manager 凭据： ``` export HSIP_ROTATION_HOOK=/opt/hsip/hooks/vault-write.sh # 您的脚本，使用其已有的任何认证方式： # #!/bin/sh # vault kv put secret/hsip/master-key value=$(cat) ``` 如果没有 hook，在 `HSIP_MASTER_KEY` 来源的部署上进行轮换会拒绝执行并给出解释，而不是默默地什么都不做。 ### 金融服务 API 示例 ``` export KEY="hsip_your_institutional_key_here" export BASE="http://127.0.0.1:7474" # 签署交易授权 — 创建不可抵赖的、带时间戳的证明 curl -X POST $BASE/v1/messages/sign \ -H "Authorization: Bearer $KEY" \ -H "Content-Type: application/json" \ -d '{"content": "AUTHORIZED: Sell 500 TSLA @ market. Analyst: J.Smith. 2026-06-20T14:32:00Z"}' # 向支付处理器授予有时限的 PSD2 同意 curl -X POST $BASE/v1/consent/grant \ -H "Authorization: Bearer $KEY" \ -H "Content-Type: application/json" \ -d '{"peer_verify_key": "counterparty_pubkey_hex", "scope": "payment_initiation", "expires_in_seconds": 3600}' # 为监管机构导出完整的审计跟踪（最近 500 条记录） curl "$BASE/v1/audit?limit=500" \ -H "Authorization: Bearer $KEY" # GDPR 被遗忘权（第 17 条） curl -X DELETE $BASE/v1/tenant/erase \ -H "Authorization: Bearer $KEY" ``` ## 密码学 — 底层原理 HSIP 全面使用了经过审计的 [RustCrypto](https://github.com/RustCrypto) 库。**没有自定义密码学。** 每个基础组件都是发布过、独立审计过的标准，并且已被你信任的系统所使用。 | 内容 | 算法 | 标准 | 原因 | |------|-----------|----------|-----| | 身份与签名 | Ed25519 | RFC 8032 | 被 Signal、Tor、SSH、TLS 1.3、OpenSSH 和大多数现代 HSM 使用。128 位安全级别。确定性 —— 没有随机性故障模式。 | | 密钥静态加密 | ChaCha20-Poly1305 | RFC 8439 | 恒定时间实现。没有时序侧信道。用于 TLS 1.3、WireGuard、Signal。AEAD —— 在一次操作中完成加密和身份验证。 | | 密钥派生 | HKDF-SHA-256 | RFC 5869 | 从主密钥派生加密密钥。标准、审计，用于 TLS 1.3 和 Signal Protocol。 | | 审计日志完整性 | BLAKE3 哈希链 | — | 每个 `audit_entries` 行通过 `entry_hash = BLAKE3(prev_hash \|\| ...)` 链接到前一行。`GET /v1/audit/verify` 在服务器端重新计算链条；修改或删除行会破坏其后的所有链接。按策略设计为仅可追加（无删除/更新 endpoint），且现已通过哈希链实现防篡改。 | | 会话密钥交换 | X25519 ephemeral | RFC 7748 | Curve25519 上的椭圆曲线 Diffie-Hellman。每次连接使用新的会话密钥 = 完美前向保密。如果长期密钥被泄露，过去的会话也无法被解密。 | | **后量子身份** † | **ML-DSA-65 (Dilithium)** | **NIST FIPS 204** | **抗“现在收集，以后解密”攻击。即使拥有公开密钥，量子计算机也无法伪造签名。** | | **后量子密钥交换** † | **ML-KEM-768 (Kyber)** | **NIST FIPS 203** | **针对 Shor 算法安全的封装机制。为必须存活到 2030 年以后的长寿命密钥材料启用。** | ### 为什么这些选择对金融机构很重要 **ChaCha20-Poly1305 与 AES-GCM 对比：** AES-GCM 容易受到 nonce 重用的攻击。ChaCha20-Poly1305 可以平稳降级。更重要的是，ChaCha20 没有时序侧信道 —— 在没有硬件加速的 CPU 上，AES 会通过缓存时序泄露密钥材料。HSIP 全面采用了恒定时间实现。 **仅追加、哈希链审计日志：** HTTP API 没有用于审计记录的删除或更新 endpoint —— 省略或更改需要直接的数据库访问权限，这属于操作系统级别的入侵。现在，每个审计条目还通过 BLAKE3 哈希链（`entry_hash = BLAKE3(prev_hash || id || tenant_id || action || peer_verify_key || details || timestamp)`）链接到前一个条目，可通过 `GET /v1/audit/verify` 按需验证 —— 因此，即使是拥有直接数据库写入权限的攻击者，如果不破坏其后所有内容的链条，也无法修改或删除行。这（目前）还不能防止在未被检测到的情况下删除*整个*链条 —— 请参阅下文的锚定说明和 `THREAT_MODEL.md` §4.8 了解剩余的范围。 **后量子时间表：** NIST 于 2024 年确定了 ML-KEM 和 ML-DSA。NSA 的 CNSA 2.0 套件要求在 2030 年前对绝密（TOP SECRET）材料使用后量子算法，并建议现在就开始迁移。HSIP 现在就内置了这两种算法，默认禁用，只需一个配置标志即可启用 —— 这样机构就可以按照自己的时间表开始 PQ 迁移，而无需进行软件升级。 ### 密钥存储架构 ``` Master key (file, or HSIP_MASTER_KEY from a secrets manager) ↓ HKDF-SHA-256 derivation Wrapping key ↓ ChaCha20-Poly1305 encryption Encrypted Ed25519 private key → stored in SQLite ``` 默认情况下，主密钥存在于一个具有严格文件系统权限的文件中（`~/.hsip/master.key`，或配置的路径）；设置 `HSIP_MASTER_KEY` 以便从 secrets manager 获取它，从而使其完全不保留在这台机器的磁盘上。无论哪种方式，仅仅数据库文件的泄露并不会暴露私钥 —— 攻击者还需要主密钥。`POST /v1/admin/master-key/rotate` 可以在不重启的情况下实时替换它。API 密钥仅以 SHA-256 哈希形式存储；原始密钥在创建时仅显示一次，从不存储。 ### 形式化验证 HSIP 包含一个可选的 Z3 SMT 求解器模块（`crates/hsip-verify`），用于机器检查的安全证明。不仅仅是测试 —— 而是确保特定安全属性成立的数学保证。需单独构建（需要 Z3 系统库）： ``` cargo build -p hsip-verify ``` ## 面向开发者 HSIP 在 `http://127.0.0.1:7474` 暴露了 REST API。支持 Python、Node.js 和 Go 的 SDK。 ``` export KEY="hsip_your_key_here" # 签署消息 — 创建带加密和时间戳的证明 curl -X POST http://127.0.0.1:7474/v1/messages/sign \ -H "Authorization: Bearer $KEY" \ -H "Content-Type: application/json" \ -d '{"content": "I authorize this transaction."}' # 获取 AI agent 能力规范 — 注入到任何 AI 系统 prompt 中 curl http://127.0.0.1:7474/v1/agent/capabilities \ -H "Authorization: Bearer $KEY" # 向对等方授予有时限的同意 curl -X POST http://127.0.0.1:7474/v1/consent/grant \ -H "Authorization: Bearer $KEY" \ -H "Content-Type: application/json" \ -d '{"peer_verify_key": "...", "scope": "contact", "expires_in_seconds": 86400}' # 启用 DNS tracker blocker curl -X POST http://127.0.0.1:7474/v1/dns/enable \ -H "Authorization: Bearer $KEY" \ -H "Content-Type: application/json" \ -d '{"port": 5300}' ``` 当 HSIP 运行时，可在 `http://127.0.0.1:7474/docs` 获取完整的交互式 API 文档（OpenAPI 3.0）。 ### Python SDK ``` from hsip import HSIPClient client = HSIPClient(api_key="hsip_...", base_url="http://localhost:7474") identity = client.get_or_create_identity() signed = client.sign_message("I authorized this action.") client.grant_consent(peer_verify_key="...", scope="contact") ``` ### 连接 AI 代理 将任何 AI 指向 capabilities endpoint，它就能准确知道 HSIP 能做什么： ``` GET http://127.0.0.1:7474/v1/agent/capabilities Authorization: Bearer hsip_... ``` 返回一个机器可读的规范。将其粘贴到任何 AI 的 system prompt 中。然后，该 AI 就可以在你的授权下发送签名消息、检查 consent 并记录操作。 ## 面向企业 HSIP 开箱即用地支持 PostgreSQL、多租户和 Kubernetes。 ``` # 单机设置 docker compose up # 使用 PostgreSQL 的生产级 HA # 有关完整的 Helm chart + TLS + 备份配置，请参阅 DEPLOYMENT.md ``` **专为受监管环境构建：** - **仅追加、哈希链审计日志** —— 没有删除或更新 endpoint。每个条目都扩展一个 BLAKE3 哈希链，可通过 `GET /v1/audit/verify` 验证。可通过 `GET /v1/audit` 批量导出。 - **不可否认的签名操作** —— Ed25519 签名证明每条指令或 consent 操作的授权、身份和时间戳。 - **有时间限制的 consent 授权** —— 有作用域、机器可读、可撤销。`POST /v1/consent/grant` 支持 `expires_in_seconds`。 - **被遗忘权** —— `DELETE /v1/tenant/erase` 永久删除所有租户数据，并向审计日志写入一条经过签名的擦除事件。 - **AI 代理治理** —— 速率监控、异常检测、自动撤销。所有事件都在签名的审计追踪中。 - **机构间消息身份验证** —— Ed25519 验证密钥，无共享密钥。Federated trust 密钥交换，在本地验证。 - **无遥测、无回传、无许可证服务器** —— 你的密钥和审计追踪永远不会离开你的基础设施。 **部署架构：** - 单一二进制文件，适用于本地或私有云 - 使用 PostgreSQL 实现生产高可用性（`DATABASE_URL` 环境变量） - 多租户：每个租户有隔离的密钥对、审计日志和 API 密钥 - Kubernetes：`DEPLOYMENT.md` 中的 Helm chart，包含 TLS 终止和 secret 管理 - 支持气隙部署 —— 不需要出站网络 有关生产环境设置、TLS、PostgreSQL 和灾难恢复，请参阅 [DEPLOYMENT.md](DEPLOYMENT.md)。 ## 如何连接你的 AI 助手 打开 HSIP 后，转到 **AI Watch → Connect an AI**。为连接命名并复制显示的密钥。 **Siri（iPhone / Mac）** 设置指南将引导你在 4 个步骤中创建一个 Siri 快捷指令。完成后，说*“嘿 Siri，发送 HSIP 消息”* —— Siri 会问你想要说什么，用你的密钥对其签名，并附带时间戳进行存储。 **Claude Desktop** 从设置指南中复制预写好的 system prompt，并将其粘贴到任何 Claude 对话中。当你要求记录或验证消息时，Claude 会调用 HSIP。 ## 从源码构建 ``` # 1. 构建 dashboard cd dashboard && npm install && npm run build && cd .. # 2. 构建内置 dashboard 的二进制文件 cargo build --release -p hsip-api --features hsip-api/embed-dashboard # 3. 运行 ./target/release/hsip-api # 浏览器将在 http://127.0.0.1:7474 自动打开 ``` ``` cargo run -p hsip-api # API on :7474 cd dashboard && npm run dev # UI on :5173 with hot reload ``` 运行完整的测试套件（238 个测试）： ``` cargo test --workspace ``` ## 架构 ``` ┌────────────────────────────────────────────────────────────┐ │ hsip-api Rust / Axum / Tokio — REST API + auth │ │ hsip-core Ed25519, X25519, ChaCha20-Poly1305, │ │ ML-KEM-768, ML-DSA-65, HKDF-SHA-256 │ │ hsip-dns UDP :5300 — DNS tracker blocker │ │ hsip-session Ephemeral sessions, X25519 forward secrecy │ │ hsip-auth Identity and authentication primitives │ │ hsip-telemetry-guard Telemetry + anomaly detection │ │ hsip-mcp MCP server — AI agent integration │ │ hsip-cli hsip agent / trust / up CLI │ │ SQLite / PostgreSQL Local or HA storage │ │ React Embedded dashboard — single binary │ └────────────────────────────────────────────────────────────┘ ``` 所有功能都在一个单一的二进制文件中运行，供桌面/本地使用。只需一个 `config.toml`，即可切换到 PostgreSQL 和多租户模式进行生产级金融部署，无需更改任何代码。 16 个专门的 crate。262 个测试（`cargo test --workspace`；排除了 `hsip-verify`，详见上文，它有自己的套件）。已验证 RFC 8032 (Ed25519) + RFC 8439 (ChaCha20-Poly1305) + RFC 5869 (HKDF) + RFC 7748 (X25519) 合规性。可通过 `hsip-verify` 获取 NIST FIPS 203 + 204 后量子算法（不属于默认构建的一部分）。全面使用经过审计的 RustCrypto 基础组件 —— 没有自定义密码学。 ## 安全性 - **静态加密的私钥** —— ChaCha20-Poly1305 + HKDF-SHA-256。仅数据库文件的泄露不会暴露私钥 —— 还需要主密钥。默认情况下，主密钥位于磁盘上的文件中（`~/.hsip/master.key` 或配置的路径）；如果你不希望这样，可以将 `HSIP_MASTER_KEY` 指向 secrets manager（Vault、AWS KMS 等）。 - **主密钥轮换** —— `hsip keys rotate-master`（或直接使用 `POST /v1/admin/master-key/rotate`；仅限 bootstrap 管理员密钥）使用新密钥重新加密每个身份，并实时替换它，无需重启。以前根本没有轮换路径。`hsip keys master-fingerprint` 允许你验证备份文件是否与正在运行的密钥匹配，而不会暴露或轮换任何内容。通过 `HSIP_ROTATION_HOOK` 也可以适用于 `HSIP_MASTER_KEY` 来源（secrets manager）的部署 —— HSIP 调用你自己的脚本来写入新密钥，本身绝不持有 Vault/AWS 凭据。 - **API 密钥仅以 SHA-256 哈希形式存储** —— 原始密钥在创建时仅显示一次，从不存储。数据库的泄露不会暴露 API 凭据。 - **所有 endpoint 的速率限制** —— 默认每个密钥 300 请求/分钟，可通过 `RATE_LIMIT_RPM` 进行配置。 - **AI 代理速率监控** —— 超过 100 请求/分钟时记录异常；超过 1,000 请求/分钟时自动撤销密钥，并在数据库写入之前立即在内存中阻止，并且使撤销在重启后依然持久的数据库写入现在会带退避重试，如果仍然失败会强烈记录日志。 - **仅追加、哈希链审计追踪** —— 不存在删除或更新 endpoint。每个条目都扩展一个 BLAKE3 哈希链（`GET /v1/audit/verify` 重新计算并检查它）。篡改需要操作系统级别的数据库访问权限，而不仅仅是 API 访问权限，并且一旦尝试就会被检测到。 - **Consent 记录谁授权了它** —— 每次授权/撤销都会记录是哪种类型的密钥（人类 / 服务 / ai_agent）执行了它，因此“consent”不能悄悄意味着“一个 AI 代理批准了自己的操作”而不被察觉。 - **防止 UDP 会话/consent 协议上的重放攻击** —— 单调的 nonce 计数器（`hsip-core`）会拒绝零、以前见过的以及陈旧的 nonce。**这目前不涵盖 HTTP REST API** —— 捕获到的带有有效 API 密钥的 HTTP 请求可以在密钥过期或被撤销之前被重放；那里的缓解措施是速率限制器和密钥过期，而不是基于请求的 nonce。请参阅 `THREAT_MODEL.md` §4.3。 - **即时撤销** —— `pending_revocation` DashSet 会在异步数据库写入完成之前在内存中阻止传输中的请求。没有竞争窗口。 - **无遥测、无分析、无回传** —— 绝对没有。经代码审查验证：除了启用 DNS 拦截器时的 DNS 转发 (1.1.1.1:53) 外，没有任何出站连接。 - **`HSIP_SANDBOX=true` 会被醒目标记** —— 它开启了 API 中唯一一个完全不需要 bearer 密钥的 endpoint（一个为公开演示部署设计的、有速率限制、有上限、24 小时的试用配置器）。启用它会记录一条不可忽视的启动警告，并增加一个专门的指标。 - **协议层的形式化验证可用，但尚未成为 CI 的一部分** —— 可选的 Z3 SMT 求解器模块（`hsip-verify`）提供了安全属性的机器检查证明，而不仅仅是测试。被排除在默认的 workspace 构建之外（`cargo build`/`cargo test --workspace` 不会触及它）—— 使用 `cargo build -p hsip-verify` 显式构建和测试它。 有关 HSIP 防御什么以及不防御什么的完整分析，请参见 [THREAT_MODEL.md](THREAT_MODEL.md)。 报告漏洞：**sanchezleal1989@gmail.com** ## 许可证 © 2025–2026 Dayana Sanchez。保留所有权利。 HSIP 是**专有软件**。源代码可供审查。 - **个人和评估用途** —— 免费。运行它、阅读代码、进行评估。 - **商业用途** —— 需要付费许可证。这包括生产部署、商业使用、集成、基于 HSIP 构建的 SaaS 产品，以及在任何组织内部的使用。 **如需为商业或机构用途授权 HSIP：** [sanchezleal1989@gmail.com](mailto:sanchezleal1989@gmail.com) 完整条款请见 [LICENSE](LICENSE)。 **你的数据。你的密钥。你的机器。**

标签：可视化界面, 通知系统