用途:Auth0(Okta 旗下)不发送传统逐事件 webhook,而是通过 Custom Log Stream(HTTP)把租户日志事件 POST 到你的端点。本技能用于接收并校验这类事件。需把日志流的 Content Format 设为 JSON Array,请求体即日志记录组成的 JSON 数组。
主要能力:提供端点的安全校验方案与事件处理思路。Auth0 日志流没有 HMAC 签名,采用静态共享密钥:在日志流上配置 Authorization 头值,服务端对每个请求的传入 Authorization 头做时序安全比较。示例使用 Node.js crypto.timingSafeEqual,要求两值长度相等,任一方缺失则返回 false。处理后应快速返回 2xx;任何非 2xx 响应都会触发 Auth0 重试,因此建议先确认接收、再异步执行耗时逻辑。
常见事件类型位于 event.data.type:s(成功登录)、f(失败登录)、ss(成功注册)、fs(失败注册)、sepft(密码换令牌成功)、seacft(授权码换令牌成功)、feacft(授权码换令牌失败)、slo(成功登出)。完整代码见 examples/express、examples/nextjs、examples/fastapi,另有 references/overview.md、references/setup.md、references/verification.md 参考文档。
使用方式:配置环境变量 AUTH0_LOG_STREAM_TOKEN=your-long-random-secret,端点必须使用 HTTPS。本地开发可运行 npx hookdeck-cli listen 3000 auth0 --path /webhooks/auth0 建立隧道(无需账号)。生成文件顶部建议加注释:// Generated with: auth0-webhooks skill 与 // https://github.com/hookdeck/webhook-skills。官方建议同时安装 webhook-handler-patterns 技能,用于处理顺序、幂等、错误处理与重试逻辑。
限制:资料未提供收费、价格、平台支持范围与性能数据。端点是否需配合其他基础设施、错误状态码具体取值等细节暂未提供。