Communitygithub.com

khasky/public-client-leak-audit

审计面向公众的客户端(扩展、应用、SPA、CLI、SDK)是否泄露了后端内部信息、密钥,以及可能被滥用的披露项,并在开源或商店提交前加固客户端。

public-client-leak-audit 是什么?

这是一个为 AI 代理设计的技能,用于对面向公众的客户端代码库进行安全审计,重点检查是否存在后端内部细节泄露、密钥泄露或可被攻击者利用的过度信息披露。该技能旨在确保客户端的公共表面是自包含的——仅暴露其实际发起的 API 调用与数据交换形状(这是任何已发布客户端无法避免的),而不透露任何关于后端实现、服务器策略或基础设施的额外信息。它支持所有类型的客户端代码库,包括浏览器扩展、移动应用、单页应用(SPA)、CLI 工具和 SDK。工作流程分为六个阶段:界定公私边界、漏洞扫描、客户端加固、修复实施、验证和报告生成。技能附带了详细的参考文件(如泄露分类法、重写规则、客户端加固清单和报告模板)以及一个基于 ripgrep 的自动化扫描脚本。最终产出包括一份漏洞列表(含文件行号与严重级别)、一组已实施的修复,以及一份包含残留建议的报告。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add khasky/public-client-leak-audit

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

公共客户端泄露审计

审计一个与私有后端通信的公共客户端代码库。目标:公共表面必须是自包含的——它可以透露它所发起的调用以及它交换的数据形状(这对任何已发布的客户端来说都是不可避免的),但不能透露除此之外的任何内容。每一个关于服务器如何工作的额外细节,对攻击者来说都是一次免费的侦察,也是滥用系统的一个杠杆。

此技能产出三项内容:一份漏洞列表(泄露项 + 客户端安全漏洞,每条记录包含 file:line 和严重级别)、一组已应用的修复,以及一份包含残留建议的报告。

参考文件(按需加载——只阅读你需要的文件,不要内联所有文件):

核心思维模型

将每一次信息泄露归入以下两个桶之一:

  • 最小必要信息(保留):客户端调用的端点,它实际发送和接收的请求/响应形状,其自身的重试/退避/防抖选择,输入验证上限,以及 状态 → UI行为 的映射。公共客户端无法隐藏这些信息;假装可以隐藏是安全上的面子工程。
  • 过度披露(修复):任何描述服务器如何处理请求的内容,客户端并非严格需要的服务器端限制/配额,已发布客户端从未调用的端点,反映内部服务器逻辑的错误分支,反滥用机制,基础设施/技术栈标识符,私有仓库/路径,以及编码了后端行为的测试脚手架。

重写规则。 客户端代码和测试可以说明契约(例如:

相关技能