钉钉机器人如何限制只能特定群使用

文章导读
标题中的“限制只能特定群使用”要分两种机器人来看。钉钉自定义群机器人在创建时就绑定了一个群,每个群的Webhook地址是独立的,所以Webhook本身可以被视为群的唯一标识,只要地址不泄露,消息只会发到该群。但如果后端需要同时对接多个群,并且只允许其中几个群触发动作,自定义机器人就做不到了,因为它只支持主动推消息,收不到群里的消息。真正能实现按群粒度控制的,是钉钉企业内部应用机器人,它可以通过消息
📋 目录
  1. 一 自定义机器人:加签和IP白名单是主要防线
  2. 二 企业内部应用机器人:按会话ID做白名单
  3. 三 加签不等于按群授权,边界要分清
  4. 四 常见坑:地址硬编码和回调伪造
  5. 五 改完后怎么验证
A A

标题中的“限制只能特定群使用”要分两种机器人来看。钉钉自定义群机器人在创建时就绑定了一个群,每个群的Webhook地址是独立的,所以Webhook本身可以被视为群的唯一标识,只要地址不泄露,消息只会发到该群。但如果后端需要同时对接多个群,并且只允许其中几个群触发动作,自定义机器人就做不到了,因为它只支持主动推消息,收不到群里的消息。真正能实现按群粒度控制的,是钉钉企业内部应用机器人,它可以通过消息回调感知群事件,并在代码里判断来源。因此,动手之前先确认当前用的是哪种机器人,再决定后续方案。

自定义机器人:加签和IP白名单是主要防线

对于自定义群机器人,最稳妥的保护手段是加签和IP白名单。创建机器人时选择“加签”方式,会得到一串密钥,每次请求都要用时间戳和密钥生成签名,钉钉服务器会校验签名。同时可以在安全设置里填写固定的公网IP段,只允许公司出口IP发起请求。这样即使Webhook地址被别人拿走,由于没有密钥且来源IP不在白名单内,请求也会被拒绝。需要说明的是,这种方式限制的是“谁能调用”,而不是“哪个群能调”,但因为Webhook指向的群是绑定的,只要Webhook没被替换,消息最终只会落到这个群里。

如果你的后端只负责向一个群推送通知,用这两种手段就够。配置加签后,请求体里要带timestamp和sign字段,生成签名的伪代码如下:

secret = 你自己的密钥
timestamp = 当前毫秒时间戳
stringToSign = timestamp + "\n" + secret
sign = urlEncode(base64(hmacSha256(stringToSign, secret)))

这里建议把密钥放到环境变量或配置中心,不要写死在代码里。IP白名单则要填稳定出口IP,如果公司有多个出口,需要都加进去,否则会偶发推送失败。

企业内部应用机器人:按会话ID做白名单

企业内部应用机器人要实现特定群才能使用,可以在回调事件中取出会话ID(类似cid开头的字符串),然后与后端配置好的会话ID白名单做比较。服务端收到消息后,先判断conversationId是否在集合中,如果不在就直接return,不做任何处理;如果在,才继续走业务逻辑。这样可以在代码层精确控制机器人只响应指定群的指令。需要注意,会话ID不是群名称,同一群在不同时间可能不变,但为了安全,不要只按群名判断,要用不可变ID作为依据。

实际代码里,可以在消息回调的处理函数开头加一个过滤:

if conversationId not in allowlist:
    return "ok"
# 继续处理业务

这里的allowlist建议从数据库或远程配置读取,方便后续增加或移除群,不用改代码重新发布。

钉钉机器人如何限制只能特定群使用

加签不等于按群授权,边界要分清

一个容易误解的地方是,加签机制并不能限制消息是发给哪个群的。签名只证明调用方持有合法密钥,和消息目标群没有关系。如果攻击者同时拿到了Webhook地址和密钥,他仍然可以往你的群里发消息。所以在安全设计上,应该把加签当成防止伪造请求的手段,而不是按群授权的方案。对于自定义机器人,如果要禁止其他群使用,实际上没有直接入口,因为机器人只属于创建它的那一个群;而企业内部应用可以通过管理后台限制可用部门和人员,但也没有按群授权的开关。

如果企业内部应用需要进一步限定“哪些群能用”,除了代码白名单,还可以在钉钉开放平台配置机器人可用范围,比如只对指定部门可见。但那个是组织维度的控制,不是按群维度。真正精确到群,还是得靠回调里的conversationId做判断。

常见坑:地址硬编码和回调伪造

最常见的坑是把Webhook地址或密钥硬编码在代码里,导致群调整后无人同步。删掉群机器人再重新添加,Webhook会变成新地址,旧地址直接失效,线上推送就会静默失败。建议把Webhook和对应群ID做成配置文件或数据库表,并加上备注。另外,企业内部机器人的回调地址属于公网接口,必须校验钉钉发送的加签请求头,否则攻击者可以伪造一个假的消息事件,绕过会话ID白名单,直接触发你的业务逻辑。

校验加签请求头时,要用钉钉开放平台提供的加签算法,核对请求头中的timestamp和sign,并且注意时间戳的过期范围,通常建议只在几分钟内有效。如果校验失败,直接返回错误或忽略消息,避免走后续逻辑。

改完后怎么验证

完成按群限制后,建议做双向验证。先在允许使用的群里发一条测试消息,确认机器人正常响应;再到未授权的群发同样内容,机器人应该没有任何反应。这里的静默可能来自多个环节:机器人本身不在群里、应用未在该群所在组织启用,或是代码里白名单拦截。如果未授权群之前能响应,配置后不再响应,基本说明会话ID白名单生效。对于自定义机器人,没有回调概念,验证时要从外部网络发送请求,观察是否出现签名错误或IP拒绝的报错,从而确认防护规则在起作用。

验证时建议同时看服务端日志。企业内部机器人回调被拦截时,最好输出一条debug日志,记录被拒绝的conversationId和请求来源,这样排查问题会更快。要注意日志里不要打印完整密钥或加签内容,避免泄露敏感信息。