PAYATHON 2026

Bruno 获取 Azure Management API OAuth2 token 时 Audience 错误

数据小许

结论

先将 Bruno 实际发送的 token 请求与 POSTMAN 中成功的请求对齐。题目中的请求使用 v1 endpoint:/oauth2/token,并在请求体中通过 resource=https://management.azure.com/ 指定目标资源。如果 Bruno 使用 v2 endpoint:/oauth2/v2.0/token,则需要使用对应的 scope。Microsoft identity platform 参数说明

现有信息没有给出 Bruno 发出的完整请求和错误的 aud 值,还无法确定具体原因,也不能认定是 Bruno 的缺陷。

为什么 token 能生成,Audience 却不对?

取得 token 说明认证服务器签发了 token;它是否面向 Azure Management API,还要看申请时指定的目标资源。

即使两个工具的界面中填写了相同的 Client ID 和 Client Secret,实际发出的请求也可能不同。可以检查:

  • Access Token URL 是否完全一致,尤其是有没有 /v2.0。
  • resource 是否进入了 token 请求体,变量替换后是否仍为 https://management.azure.com/。
  • 是否把 v1 的 resource 值直接填入了 Scope 字段。
  • 当前查看或发送的 token 是否来自此前的配置,或被其他认证配置覆盖。

Azure Resource Manager 资源地址末尾的 / 有实际意义。通过 v2 endpoint 请求与 https://management.azure.com/ 对应的 .default scope 时,应保留资源地址自身的 /,得到 https://management.azure.com//.default。这里有意保留了双斜杠。Microsoft 关于末尾斜杠的说明

先按原请求配置 Bruno

为便于对照,先继续使用题目中的 v1 endpoint。在 collection 的认证设置中选择 OAuth 2.0,填写以下配置:

配置项 值
Grant Type Client Credentials
Access Token URL https://login.microsoftonline.com/<tenant-id>/oauth2/token
Client ID 与 POSTMAN 相同的 client_id
Client Secret 与 POSTMAN 相同的 client_secret
Add Credentials to Request Body
Scope 此次 v1 对照请求不填写
token 请求体附加参数 resource=https://management.azure.com/

Bruno 的 Client Credentials 配置支持设置 token endpoint、客户端凭据和凭据发送位置,具体界面以所用版本为准。Bruno 官方配置文档

如果当前版本支持为 token 请求添加额外的 body 参数,就在那里添加 resource。普通 Azure Management API 请求的 Body 或 Query 参数不会自动成为 token 请求的参数。

如果找不到相应入口,可以在 Bruno 中新建一个普通 POST 请求,手动获取 token,再与 POSTMAN 的结果对照。

用显式 POST 请求核对结果

下面是一个新的 cURL 对照示例,沿用原问题中的 endpoint 和参数含义,使用 application/x-www-form-urlencoded 编码。原 POSTMAN 脚本中的 mode: 'formdata' 在问题描述中原样保留。

curl --request POST \
  'https://login.microsoftonline.com/<tenant-id>/oauth2/token' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'client_id=<client-id>' \
  --data-urlencode 'client_secret=<client-secret>' \
  --data-urlencode 'resource=https://management.azure.com/' \
  --data-urlencode 'grant_type=client_credentials'

在 Bruno 的普通请求中,可以选择对应的表单编码方式,填写这四个字段。--data-urlencode 会处理参数中的特殊字符,避免 Client Secret 中的 +、& 等字符被错误解析。Microsoft 的 Client Credentials 协议示例也使用表单编码,并要求正确编码 Client Secret。Microsoft Client Credentials 文档

取得响应中的 access_token 后,将其用于管理 API 请求:

Authorization: Bearer <access_token>

如果显式请求取得的 token 正常,而 OAuth2 面板取得的 token 不同,就对比两者实际发送的 URL、请求体和变量值,重点检查 resource 是否遗漏或被覆盖。

如果需要使用 v2 endpoint

切换到 v2 时,要同时调整 endpoint 和资源参数。为对应原请求中带末尾 / 的资源地址,可以使用:

Access Token URL: https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token
Grant Type: Client Credentials
Scope: https://management.azure.com//.default

此时用 scope 指定目标资源,并移除 v1 请求中的 resource 参数。不要只更换 endpoint,而保留不匹配的参数配置。

验证时注意什么?

修改配置后,清除已保存的 token,再点击 Get Access Token。如果使用 Token ID,检查其他 OAuth 配置是否复用了同一 Token ID。Bruno 文档说明,这种情况下已有 token 数据会被覆盖。Bruno token 管理说明

对比新响应中的 access_token 和最终 API 请求实际发送的 Bearer token。对于可解码的 JWT,可以在本地检查 aud,并与 POSTMAN 成功请求的结果对照。解码只能用于排查,不能代替签名和有效性验证。

如果仍有差异,请保留脱敏后的 Bruno 版本、实际 token 请求 URL、请求体、两边的 aud 值和 Azure Management API 返回的错误信息,以便进一步判断是参数配置、token 复用还是特定版本的行为。

备注:内容仅供参考。