用途:在 Procore 故障升级时,构建一份仅含请求元数据与断言的诊断清单,而非原始归档。支持方可通过方法、URL、状态、脱敏后的请求头与正文及发生时间进行排查;密钥与施工数据只会增加风险,无助于诊断。
主要能力:声明采集范围,拒绝递归日志目录、数据库转储、环境文件、OAuth 响应与附件集合;采集 UTC 时间、环境、方法、规范化 URL、状态、耗时、API 版本、公司与项目别名、速率头、重试头及应用发布标识;脱敏时移除 Authorization 与目标头、客户端凭据、令牌、Cookie、用户信息、项目名、查询密钥、请求体、响应负载及签名文件 URL;校验脱敏结果,用 Grep 检查密钥模式与禁止字段,人工检查剩余值并将提供方标识替换为稳定别名;封装并传输,写入校验和、采集者身份、范围声明、脱敏结果、过期时间与访问列表,仅通过批准的加密通道传输;按计划删除,记录删除负责人与截止时间,仅保留非敏感事件回执。
使用方式:需先具备事件标识、负责人、受众、保留期限与批准目的地、精确失败请求窗口与规范化路由、组织脱敏规则。使用 Read 与 Grep 仅检查批准文件并验证脱敏,使用 Write 或 Edit 仅写入受限清单与回执,不得复制原始日志树或客户数据。输出采集清单与明确排除项、脱敏验证与工件校验和、传输访问保留删除回执,以批准引用返回工件位置,绝不内联敏感内容。
限制:该流程从不获取或刷新 OAuth 凭据,禁止清单中出现 Bearer 令牌、客户端密钥、刷新令牌、Webhook 目标头、Cookie 与签名 URL。若发现密钥模式,停止传输、隔离工件、重新脱敏并在暴露时轮换;范围无法限定时仅以元数据升级;支持方索要原始凭据时拒绝并提供受控复现;缺少保留负责人时不得传输。