SuperAPI AI 工具集

aiprise-webhooks

安全与审计

查看项目

更新于 10-15 22:14

技能介绍

用途:AiPrise 是身份验证(KYC/KYB)平台,通过签名 HTTP POST 回调(webhook)通知服务器验证结果与业务资料变更。本技能用于搭建 AiPrise 回调处理程序、调试签名校验失败、处理验证结果。

主要能力:校验 X-HMAC-SIGNATURE 头;处理 APPROVED、DECLINED、REVIEW、UNKNOWN 四种验证结果;关联验证会话;区分两类回调目标。

签名验证:AiPrise 对原始请求体做 HMAC-SHA256,输出小写十六进制放入 X-HMAC-SIGNATURE 头。HMAC 密钥直接使用 AiPrise API 私钥,没有单独的签名密钥或端点密钥,也不是 Standard Webhooks。必须对精确的原始请求体字节验证,重新序列化 JSON 会改变字节并导致签名失败。示例代码见资料中的 verifyAiPriseWebhook 函数,完整处理器见 examples/express/、examples/nextjs/、examples/fastapi/。

验证结果:无丰富类型事件系统,结果取自 aiprise_summary.verification_result。APPROVED 表示通过,可开通访问或标记已验证;DECLINED 表示失败,应阻止或要求重新提交;REVIEW 需人工审核,排队给分析师;UNKNOWN 结果不确定,需重试或排查。回调还带处理状态(COMPLETED、PENDING、FAILED 等),用 verification_session_id 和可选的 client_reference_id 关联记录。

回调目标:callback_url 用于验证结果回调;events_callback_url 用于业务资料变更事件,两者签名方式相同。

环境变量:AIPRISE_API_KEY 为 AiPrise API 私钥,同时作为 HMAC 签名密钥。

本地开发:npx hookdeck-cli listen 3000 aiprise --path /webhooks/aiprise

参考材料:references/overview.md、references/setup.md、references/verification.md。建议配合 webhook-handler-patterns 技能使用,处理顺序、幂等、错误处理与重试逻辑。

限制:资料未提供具体收费、价格、平台支持范围与效果数据。