授权事件通知
当许可证激活、续期或被吊销时,Licentivo 可以向你的服务器发一条通知,用来同步订单、客户和售后系统。
要实现授权到期与续费提醒,可以订阅即将到期、到期和续期事件,由你的网站核对最新状态后发送客户邮件。事件通知提供状态变化,不会自动替厂商向客户发送提醒。
设置接收地址
打开“授权事件通知”,添加你服务器的 HTTPS 地址,选择需要的事件。保存时会显示一次签名密钥,把它保存在接收通知的服务器上。正式环境不允许请求本机或内网地址。
接收后检查签名
读取 X-Licentivo-Timestamp、X-Licentivo-Event 和原始请求正文。拼接为“时间戳 + 点号 + 事件 ID + 点号 + 正文”,用签名密钥计算 HMAC-SHA256。加上 sha256= 前缀后,与 X-Licentivo-Signature 做恒定时间比较。时间戳与当前时间相差超过 5 分钟时拒绝。
事件 ID 是去重依据。先检查签名,再把事件放入自己的事务或队列,持久化成功后返回 2xx。重复事件返回 2xx 即可,不重复执行订单操作。
失败会怎样?
系统最多自动尝试 8 次,逐步延长重试间隔。控制台能查看每次 HTTP 状态、尝试时间和错误,也可以手动重新投递。事件与授权操作在同一个数据库事务里记录,服务重启后会继续投递。
支持创建、更新、续期、吊销、激活、释放、功能消耗、即将到期、到期和维护期变化事件。通知只带授权前缀,不包含完整许可证密钥。