调用DirectLine Endpoint 'directline/tokens/generate'返回403错误求助

安全阿岳

2026-6-13

解决Direct Line Tokens Generate接口403错误（BadArgument: siteKey null）

针对调用https://directline.botframework.com/v3/directline/tokens/generate返回403、错误提示Invalid token or secret, siteKey null的问题，结合错误信息里的siteKey null关键点，给出以下针对性排查方案：

检查Direct Line增强认证模式状态
登录Azure门户的机器人Direct Line渠道配置页，查看「增强认证」是否开启。如果开启了该模式，调用/tokens/generate接口时，除了在Authorization头传入Bearer {Direct Line主/副密钥}，还必须在请求体中添加siteKey字段，值为渠道配置里的「站点密钥」（注意不是主/副密钥）。错误信息里的siteKey null就是因为缺少这个必填参数。如果不需要增强认证，可以临时关闭后再测试接口。
验证请求头格式正确性
确认Authorization头的格式严格为Bearer {密钥内容}，注意Bearer与密钥之间有且仅有一个空格，密钥没有多余的换行、空格或隐藏字符。可以将密钥复制到纯文本编辑器（如Notepad）中检查后，再粘贴到Postman的请求头里。
核对密钥类型匹配
Direct Line渠道有两类密钥：主/副密钥用于令牌生成的身份认证，站点密钥仅在增强认证模式下配合使用。如果开启了增强认证，必须同时提供：
- 请求头：Authorization: Bearer {主/副密钥}
- 请求体（JSON格式）：
```
{
  "user": {"id": "自定义用户ID"},
  "siteKey": "{站点密钥}"
}
```
尝试切换接口版本
改用V3.1版本接口https://directline.botframework.com/v3.1/directline/tokens/generate测试，部分场景下版本差异会导致参数校验逻辑不同。