用途:为 Flexport API 集成配置凭证与令牌边界,优先采用按端点限定的 OAuth 2.0 客户端凭证,仅在记录必要性后接受范围较广的 API Key。
主要能力:区分凭证类型;按系统分别创建凭证(生产、非生产与独立工作负载隔离);请求并缓存访问令牌;验证最小权限;无歧义地轮换与吊销凭证。
使用方式:向 /oauth/token 发送 POST 请求,携带 client_id、client_secret、audience https://api.flexport.com 和 client_credentials 授权类型;将 JWT 与过期时间存入并发安全缓存,在到期前带抖动和 single-flight 锁刷新,避免按业务请求获取令牌。REST 调用使用缓存的 Bearer 令牌,MCP 调用使用 https://mcp.flexport.com/mcp 的已认证连接,并受各工具账户权限约束。
限制与约束:客户端凭证令牌有效期为 24 小时,令牌请求每天限 10 次。Flexport 不允许向现有凭证追加端点,范围扩展需新建替代凭证。不得在浏览器、shell 历史或回执中暴露密钥,不得记录凭证或令牌。凭证轮换需先创建并验证替代凭证、切换单个工作负载、观察后再吊销旧凭证。
错误处理:令牌请求被拒时检查 audience、授权类型、客户端身份与密钥来源,不要循环重试;每日令牌预算告急时停止按请求获取并修复共享缓存;缺少所需端点时创建新凭证而非替换为宽泛密钥;密钥泄露时立即吊销或轮换并清理派生日志。