用途：为 Grammarly API 集成提供安全基础实践，处理可能包含机密商务通信、法律草稿或个人信件的文本内容，重点在 OAuth 客户端凭据管理、避免不必要地持久化或记录用户文本，以及保护可读写用户文档与建议历史的访问令牌。
主要能力：客户端凭据从环境变量读取（GRAMMARLY_CLIENT_ID、GRAMMARLY_CLIENT_SECRET），缺失即抛错；访问令牌仅存内存、不落盘。Webhook 使用 x-grammarly-signature 头与 HMAC-SHA256 校验，并用 timingSafeEqual 比较。输入校验用 zod 定义 TextAnalysisSchema，限制 document_id 为 UUID、text 长度 1 至 100000、language 与 domain 枚举、goals 可选。日志脱敏覆盖 document_text、user_email、access_token、client_secret、suggestion_context 等敏感字段，并截断文本预览。安全检查清单包括：密钥存于密钥库而非源码、令牌仅内存、不记录用户文本、强制 HTTPS、pre-commit 钩子阻止凭据泄露、令牌刷新处理过期、本地缓存加密、OAuth 范围最小化。
使用方式：按环境与集成划分凭据，从密钥管理器注入，拒绝未知范围或目标；提交前校验输入大小、来源、同意与 schema，失败用不透明关联 ID 隔离；解析前验证 Webhook 真实性，拒绝过期或重放事件，仅记录有界脱敏信封；每次客户端或配置变更后用合成数据测试同意与保留控制；怀疑凭据泄露立即撤销，数据完整性不确定时禁用集成，仅保留脱敏证据。输出安全回执，含环境、集成范围、密钥引用版本、校验/同意结果、轮换/撤销状态、关联 ID 与回滚动作，绝不包含令牌、文本或原始事件。
适用场景：Grammarly 集成的认证与令牌处理搭建、Webhook 接入、日志与缓存的数据保护。
限制：资料未提供具体价格、平台支持范围或性能数据；前置条件要求威胁模型、低权限沙箱凭据与合成文本、轮换与撤销运行手册，生产凭据不得进入 shell、源码、夹具或日志。