使用 Webhook
Webhooks 允许你对用户注册、登录等行为进行监听,从而对其做一些自定义处理。
使用 Webhook 的方法是在 Authing 平台中配置 HTTP URL,当你的用户登录、注册、修改密码后,都会给远程 HTTP URL 发送一个 POST 请求。
配置 Webhook
点击进入 用户池 - 扩展能力- Webhook 页面:
点击页面的「添加」按钮即可开始配置,如下图所示:
参数解释
参数名称 | 参数解释 |
请求地址 | 远程 HTTP URL 地址 |
请求密钥 | 设置好密钥(值由开发者自定)后,Authing 将在每个请求中(HTTP Header:X-Authing-Token)附带此密钥,你可以通过验证此密钥来避免一些非法操作 |
请求数据格式 | 指定发起 Webhook 请求时 Request body 的数据格式,可选值有 |
触发事件 | |
激活 | 是否启用此 Hook |
管理 Webhook
在创建完 Webhook 之后可以看到详细的事件记录:
刚创建好的 Hook 请求事件都为空,这时你可以点击「测试」触发一个「测试事件」:
测试成功后你将看到详细的请求信息和返回信息。
调试 Webhook
调试 Webhook 的方法如下图所示:
点击后将发送一个 Post 请求到配置好的 HTTP URL 中。
请求数据为:
支持的事件
事件列表
事件名 | 事件描述 |
login | 登录事件,当用户进行登录时会触发此事件,无论是否登录成功都会触发。 |
register | 注册事件,当用户注册或管理员手动创建用户时会触发此事件,无论是否成功都会触发 |
change-password | 修改密码事件,当用户修改密码或管理员手动修改密码时会触发此事件,无论成功与否都会触发 |
change-user-info | 修改用户信息时间,当用户修改自己的信息或管理员手动修改用户信息时会触发词时间,无论成功与否都会触发 |
请求类型
指定发起 Webhook 请求时 Request body 的数据格式,可选值有 application/json
和 application/x-www-form-urlencoded
附带的数据
每一个事件都会携带一些特定的请求参数。
Request headers
我们会在 HTTP POST 头中携带一些自定义头信息,如下表所示:
Header | 描述 |
| 值为 |
| 请求秘钥,值为你在 Webhook 配置中设置的秘钥,对此秘钥进行验证,可以用来防止第三方的恶意请求 |
| 本次 hook 触发的事件,值为上述 |
Request body
请求体中也会携带一些特定参数
参数名 | 描述 |
| 本次事件是否成功,0 为失败,1 为成功 |
| 本次事件的结果描述 |
| 本次事件执行时的时间戳,单位为 |
| 用户进行此次操作时携带的参数 |
|
|
user_updated |
|
Request 示例
headers
login event body
register event body
change-password event body
change-user-info event body
Last updated