用途:在搭建 Ramp 集成时,帮助根据信任模型选择正确的 OAuth 授权类型,并配置作用域、环境与密钥生命周期。内部服务器到服务器集成使用 Client Credentials;第三方或多租户应用使用带 state 和刷新处理的 Authorization Code。
主要能力:区分内部与第三方架构;为沙箱与生产注册独立应用,仅启用选定授权与最小端点作用域;管理客户端密钥与刷新令牌的存储、轮换和吊销;为 Authorization Code 生成并校验加密随机 state,使用精确匹配的 HTTPS 重定向 URI;为 Client Credentials 保持令牌交换在服务端。
必要事实:令牌端点为 /developer/v1/token,通常对客户端使用 HTTP Basic 认证。Client Credentials 令牌有效期 10 天;Authorization Code 与刷新令牌的访问令牌有效期 1 小时(依据当前授权指南)。令牌不透明、绑定环境与作用域,更改作用域需重新获取令牌。第三方集成必须使用 Authorization Code,其授权码短时有效,重定向 URI 需精确匹配。
使用方式:先识别内部或第三方架构、目标环境、租户、重定向来源、所需操作、数据类别与责任应用所有者;在沙箱获取令牌,验证一个最小作用域读取和一个被拒绝操作;记录独立批准后的生产提升。使用本地文件工具(Glob、Grep、Read、Write、Edit)定位与检查文件,但本地工具不授权 Ramp 操作,也不替代所有者批准。
适用场景:内部记账 worker 使用 Client Credentials 和仅交易/记账作用域;多租户合作伙伴应用使用 Authorization Code、精确重定向、校验 state、加密刷新令牌与租户吊销。
限制与边界:业务所有者批准应用,安全团队批准授权、重定向、作用域与密钥生命周期,每个租户的授权用户授予第三方访问。生产访问与业务效果需明确批准前使用合成数据或沙箱。官方文档、端点模式、作用域、限制与支持状态等具体内容暂未提供完整细节,操作前需重新核对最新合同与 OpenAPI 模式。错误处理涵盖 invalid_client、invalid_scope、业务未授权等情况。