用途:在持续集成中为 Procore 适配器建立契约门禁,默认以离线 fixture 作为校验基准,把需要凭据的沙箱测试隔离在显式保护之后,避免改动生产数据。
主要能力:覆盖必需请求头、请求与响应结构、API 版本、分页链接,以及 401、403、隐藏 404、422、429、503 和超时行为;检测端点漂移、只取首页的分页缺陷、不安全重试、租户路由丢失和密钥泄露;校验 fixture 中的密钥模式、客户标识、时间敏感断言与未记录路由;可选在 Developer Sandbox 中做有界检查并清理测试数据;输出门禁回执,记录发布标识、适配器集合、fixture 哈希、离线结果、provider 通道状态、清理结果与已知缺口。
使用方式:先定义契约用例,再添加安全守卫(禁止选中生产主机、缺少公司上下文、打印 Authorization 数据或在受保护沙箱外启用 provider 变更时失败),然后测试分页与重试,校验 fixture,最后在存在受保护凭据时运行有界 provider 检查并输出回执。离线测试仅用合成令牌;可选 provider 检查从受保护 CI 密钥获取沙箱 OAuth 2.0 Bearer 令牌,绝不暴露,并拒绝生产凭据与主机。使用 Read 和 Grep 检查适配器、fixture、工作流与日志,仅对已批准的测试、fixture、CI 配置或回执使用 Write 或 Edit。
适用场景:Procore 适配器的 CI 契约校验、分页与重试安全回归、密钥与主机守卫、可选沙箱验证。
限制:需要资源适配器清单、当前公开端点参考、带来源的脱敏成功与失败 fixture、受保护沙箱凭据来源与清理负责人;沙箱凭据缺失时显式跳过 provider 通道,离线门禁仍为必需;fixture 含敏感数据需隔离替换;清理失败则 provider 通道失败并指派清理负责人;实时参考变化需人工审查,不自动接受 provider 漂移。具体命令与配置资料未提供。