用途:为 Ramp 集成建立严格的沙箱、预发布与生产环境隔离,使环境选择成为一道类型化的安全边界,确保凭据与数据不跨边界流动。
主要能力:定义封闭的环境枚举(主机、应用 ID、密钥引用、重定向 URI、父来源、Webhook 端点、实体允许列表与写入策略);创建相互独立的 Ramp 应用与密钥管理命名空间;在每次启动前校验主机允许列表、TLS、重定向/来源精确性与令牌环境;通过合成与沙箱测试后,仅提升相同制品与经审阅的配置模式,不复制沙箱数据或凭据;要求带时间限制的生产写入启用,包含负责人、实体、操作、回滚与自动故障关闭。
必要用法:Ramp 沙箱使用 demo.ramp.com 与 demo-api.ramp.com,生产使用 app.ramp.com 与 api.ramp.com;令牌仅在签发环境有效,沙箱与生产应用拥有独立凭据与设置;生产 Embedded Cards 来源必须为经过验证的精确 HTTPS 来源,localhost 不被生产集成接受。使用前需识别 Ramp 应用、环境、业务实体、受影响数据与工作流、责任人及回滚边界,阅读 references/official-docs.md 并复核端点架构、权限范围、限制与支持状态;在生产访问与业务影响获明确批准前,应使用合成夹具或 Ramp 沙箱,并准备已批准的密钥存储与净化证据位置。
限制:沙箱不能转移真实资金,其成功行为不能证明生产授权或数据等价;本地文件工具不授权任何 Ramp 操作,也不替代负责人批准;环境缺失或未知、令牌仅在提升后失败、生产来源含 localhost 或通配符等情况需按既定规则处理,未解决的行为、权限或财务状态应视为停止条件。部分具体操作细节暂未提供。