Google Drive Watch API 如何配置Webhook通知的请求头与请求体
关于Google Drive v3 API files.watch 接口Webhook鉴权配置说明
自定义请求头、请求体的配置限制
files.watch接口注册通知通道时,可配置的Channel资源字段均为Google官方定义的固定枚举字段,没有预留自定义请求头、自定义请求体的扩展配置项,因此无法在注册环节直接指定给Webhook推送通知添加额外的自定义鉴权头、请求体参数。
可实现鉴权校验的官方内置方案
无需自定义请求头/体即可完成通知合法性校验,Google为推送通知提供了多个内置的可自定义或可校验的标识字段:
- 自定义通道令牌字段
token
注册files.watch通知通道时,可在Channel配置中传入任意符合长度限制的自定义字符串作为token值,该值会被原样添加到每次推送通知的X-Goog-Channel-Token请求头中。你可以将自定义鉴权密钥设置为这个token的值,Webhook收到通知后校验该请求头的值是否与预设密钥匹配,即可实现基础鉴权效果。 - 通道与资源ID校验
注册通知通道成功后,接口会返回专属的channelId与对应监听资源的resourceId,每次推送通知都会携带X-Goog-Channel-ID、X-Goog-Resource-ID请求头,Webhook端可校验这两个值是否为自身合法注册过的通道对应ID,拦截伪造请求。 - 官方数字签名校验
所有Google发起的推送通知都会携带X-Goog-Signature请求头,该值是Google使用你在Google Cloud Console中配置的密钥对请求体计算的HMAC-SHA256签名,Webhook端可使用相同密钥完成验签,这是安全性最高的校验方式。
补充说明
- 自定义
token字段支持传入任意符合官方限制的字符串,完全可以满足存储自定义鉴权令牌的需求,不需要额外配置自定义请求头。
内容的提问来源于stack exchange,提问作者yuhr
相关产品推荐
相关产品推荐

