如何在Azure中使用证书生成OAuth令牌 解决Bot配置仅显示client secret问题

这是Azure Bot服务可视化配置面板的固有UI限制：当你在Bot的「设置->配置->添加OAuth连接设置」路径选择「Azure Active Directory V2」作为服务提供商时，表单仅会展示客户端密钥（Client Secret）输入项，没有提供证书认证的可视化配置入口，和你提前在App注册中上传证书的操作无关。
Azure Bot OAuth连接配置界面截图（仅展示Client Secret选项）

你在App注册的「证书和密码」板块上传证书的前置操作是完全有效的，只需要绕过可视化表单，直接通过Azure资源管理接口配置证书参数即可完成设置，具体操作步骤如下：

前置准备 #

提前收集好以下必填参数：

• App注册的客户端ID（Client ID）、所属Azure租户ID（Tenant ID）
• 已上传证书的SHA1指纹（Thumbprint）、证书私钥的Base64编码字符串
• Bot资源所在的资源组名称、Bot资源名称、你要创建的OAuth连接自定义名称

配置方式（三选一即可） #

• 方式1：通过Azure CLI命令快速创建
  替换以下命令中的占位符为你自己的参数，在Azure Cloud Shell或本地已登录的Azure CLI环境中直接执行：

  az bot authsetting create \
    --resource-group <Bot所在资源组名> \
    --name <Bot资源名称> \
    --setting-name <自定义OAuth连接名称> \
    --client-id <App注册客户端ID> \
    --client-secret "" \
    --service-provider "Azure Active Directory v2" \
    --tenant-id <Azure租户ID> \
    --parameters clientSecret="" \
    --parameters certificateThumbprint=<证书指纹> \
    --parameters certificatePrivateKey=<证书Base64编码私钥>
  

  注意：命令中client-secret和clientSecret参数传空字符串即可，系统识别到证书参数后会自动启用证书认证模式，不会校验客户端密钥值。

• 方式2：通过Portal内置的资源编辑器修改
  1. 在Azure Portal打开你的Bot资源，左侧菜单找到「资源浏览器」，点击「转到资源浏览器」
  2. 导航到路径：订阅/<你的订阅ID>/资源组/<资源组名>/providers/Microsoft.BotService/botServices/<Bot名称>/connections/<你新建的空连接名称>
  3. 切换到编辑模式，将properties节点下的clientSecret字段值置空，新增certificateThumbprint、certificatePrivateKey两个字段，分别填入对应证书参数
  4. 点击顶部「保存」按钮提交修改即可
• 方式3：通过ARM模板部署配置
  编写Bot服务OAuth连接类型的ARM资源定义，在properties段直接传入证书指纹、证书私钥参数，部署模板即可完成配置，不会触发表单的客户端密钥必填校验。

配置校验 #

回到Bot的OAuth连接配置列表，找到刚配置好的连接，点击「测试连接」按钮，如果可以正常完成授权流程、返回有效令牌，就说明证书模式的OAuth配置已经生效。

注意事项 #

• 配置中填写的证书指纹、私钥必须和你上传到App注册中的证书完全匹配，否则会出现认证失败错误
• 证书到期续期时，需要同时更新App注册中的证书，以及Bot OAuth连接中存储的证书参数，两边保持一致才能正常认证
• 不要同时配置客户端密钥和证书参数，系统会默认优先使用客户端密钥认证，导致证书配置不生效

内容的提问来源于stack exchange，提问作者vishwanath raja