You need to enable JavaScript to run this app. 如何通过ARM模板管理Azure API Management的CA证书
优惠活动
大模型
产品
解决方案
定价
更多

如何通过ARM模板管理Azure API Management的CA证书

解决方案

该问题由API版本及资源类型选择错误导致,正确实现方式如下:

核心修正点

  1. 选择2021-08-01及以上版本的Microsoft.ApiManagement/service资源API,低版本对CA证书的certificates属性支持存在缺陷,即使配置了storeName也不会同步到CA证书存储区。
  2. 直接在APIM服务资源的properties下配置certificates数组,不需要单独部署子资源,数组内每个对象需明确指定:
    • encodedCertificate:Base64编码的PFX格式证书内容
    • certificatePassword:证书密码,无密码可填空字符串
    • storeName:固定填Root(对应CA根证书存储)或CertificateAuthority(对应中级CA证书存储)

可用模板示例

以下是经过验证的正确配置片段,可直接替换原有模板中的对应部分:

{
  "apiVersion": "2021-08-01",
  "name": "[parameters('apimName')]",
  "type": "Microsoft.ApiManagement/service",
  "location": "[parameters('location')]",
  "sku": {
    "name": "[parameters('sku')]",
    "capacity": "[parameters('skuCapacity')]"
  },
  "properties": {
    // 其他原有配置保持不变
    "certificates": [
      {
        "encodedCertificate": "[parameters('RootCertificateBase64Content')]",
        "certificatePassword": "[parameters('RootCertificatePassword')]",
        "storeName": "Root"
      },
      // 可添加多个CA证书
      {
        "encodedCertificate": "[parameters('IntermediateCertificateBase64Content')]",
        "certificatePassword": "[parameters('IntermediateCertificatePassword')]",
        "storeName": "CertificateAuthority"
      }
    ]
  }
}

注意事项

  • 增量部署时如果模板中certificates数组只包含你要保留的证书,不会删除其他手动上传的证书;如果数组为空,会清空所有已配置的CA证书。
  • 可使用以下PowerShell命令生成证书的Base64编码内容:
    $pfxContent = Get-Content "你的证书本地路径.pfx" -Encoding Byte
    [System.Convert]::ToBase64String($pfxContent)
    
  • 部署完成后可以在APIM门户的「CA certificates」菜单下验证证书是否正确上传。

内容的提问来源于stack exchange,提问作者Félix

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.12 15:48:02