SuperAPI AI 工具集

greendot-webhooks

安全与审计

查看项目

更新于 10-16 05:52

技能介绍

用途:帮助搭建 Green Dot 合作伙伴 Webhook 端点,认证并处理 Green Dot Embedded Finance(BaaS)投递的事件。Green Dot 不使用标准 Webhooks 规范或单一 HMAC 签名,而是推送认证:由 Green Dot 向你的端点证明身份,主方式是每次投递携带 OAuth 2.0 client_credentials Bearer 令牌(scope 为 post:webhook),备选为证书(mTLS)变体。

主要能力:验证 Bearer 令牌并强制要求 post:webhook scope,这是真正的准入关卡,认证通过后再解析 JSON;mTLS 变体下改由 TLS 终止器/反向代理做客户端证书校验。分发事件(依据 body 的 eventType 字段),常见类型包括 transaction、accountUpdated、achTransfer、cardUpdate、billPayTransfer、directDepositSwitch、provisioning 等,具体启用的类型因项目而异,需与 Green Dot 代表确认。回显 x-GD-RequestId 头并以 200/201 返回 responseDetails 响应体,否则投递被判为失败。

使用方式:需设置环境变量 GREENDOT_WEBHOOK_TOKEN_SECRET 与 GREENDOT_WEBHOOK_SCOPE(默认 post:webhook)。示例代码见 examples/express/、examples/nextjs/、examples/fastapi/。本地开发可运行:npx hookdeck-cli listen 3000 greendot --path /webhooks/greendot。端点由 Green Dot 代表注册,无自助面板;重试需按合作伙伴显式开启,开启后在 5xx、超时、DNS/连接/SSL 失败时按小时重试最多 24 小时。无官方 SDK,所有校验均需手动实现。

限制:x-gd-signature 头的算法、编码与覆盖负载均未公开,本技能不实现签名校验,避免对未验证负载产生虚假信心;如需负载级校验,须先向 Green Dot 代表获取确切规范与签名密钥。API-Key 头只是你项目自身静态密钥的回显,不是签名。文档未提供价格、官方 SDK 等信息,暂未提供。