如何在 Azure 中使用密钥认证(而非短期令牌)部署微调后的 GPT 模型?

梦宇吖_4620

梦宇吖_4620

2026-11-16

279人浏览

原创

如何在 Azure 中使用密钥认证(而非短期令牌)部署微调后的 GPT 模型?

azure 管理平面 api(如模型部署)不支持 api 密钥认证,仅接受 azure ad 身份验证方式(服务主体、托管标识或 azure cli 登录态),因此无法用 endpoint key 替代短期访问令牌。

azure 管理平面 api(如模型部署)不支持 api 密钥认证,仅接受 azure ad 身份验证方式(服务主体、托管标识或 azure cli 登录态),因此无法用 endpoint key 替代短期访问令牌。

在 Azure AI Services(原 Azure OpenAI)中部署微调模型,本质是资源管理操作——即通过 Azure Resource Manager(ARM)创建或更新 Microsoft.CognitiveServices/accounts/deployments 资源。这类操作属于 management plane(控制平面),严格遵循 Azure RBAC 和 OAuth 2.0 认证机制,不接受任何基于 API key 的身份验证(包括你在门户中看到的“Key1/Key2”或终结点密钥)。这些密钥仅用于 data plane(数据平面)调用,例如向已部署的模型发送 /chat/completions 请求。

✅ 正确且生产就绪的身份验证方式有以下三种(均基于 Azure AD):

  • 托管标识(Managed Identity)(推荐用于云环境)
    若部署脚本运行在 Azure VM、App Service、Function App 或 Azure Container Apps 中,可启用系统分配或用户分配的托管标识,并为其授予 Cognitive Services Contributor 或自定义 RBAC 角色(作用域为你的 Cognitive Services 资源组或资源)。Python 示例:

    from azure.identity import ManagedIdentityCredential
    from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
    
    credential = ManagedIdentityCredential()
    client = CognitiveServicesManagementClient(
        credential=credential,
        subscription_id="YOUR_SUBSCRIPTION_ID"
    )
    
    deployment_params = {
        "sku": {"name": "Standard", "capacity": 1},
        "properties": {
            "model": {
                "format": "OpenAI",
                "name": "gpt-4o-mini-2024-07-18.ft-abc123def456",
                "version": "1"
            }
        }
    }
    
    client.deployments.begin_create_or_update(
        resource_group_name="my-rg",
        account_name="my-openai-account",
        deployment_name="ft-gpt4o-mini-prod",
        parameters=deployment_params
    ).result()
  • 服务主体(Service Principal)+ Client Secret/Certificate(推荐用于 CI/CD 或本地自动化)
    创建服务主体、分配角色、保存 client_id、client_secret 和 tenant_id,然后使用 ClientSecretCredential:

    from azure.identity import ClientSecretCredential
    from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
    
    credential = ClientSecretCredential(
        tenant_id="YOUR_TENANT_ID",
        client_id="YOUR_CLIENT_ID",
        client_secret="YOUR_CLIENT_SECRET"
    )
    client = CognitiveServicesManagementClient(credential, "YOUR_SUBSCRIPTION_ID")
    # 后续调用同上
  • Azure CLI 登录态(DefaultAzureCredential)(适合开发与调试)
    运行 az login 后,DefaultAzureCredential 会自动链式尝试 CLI 凭据(无需硬编码 token):

    from azure.identity import DefaultAzureCredential
    from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
    
    credential = DefaultAzureCredential()
    client = CognitiveServicesManagementClient(credential, "YOUR_SUBSCRIPTION_ID")

⚠️ 注意事项:

  • ❌ 不要尝试将门户中的 Key1 或 endpoint + key 用于管理 API —— 它们仅适用于 https://.openai.azure.com/openai/deployments/... 类 data plane 接口;
  • ✅ 微调模型部署成功后,其 data plane 终结点才真正可用,此时你可安全使用 API key + endpoint 发起推理请求;
  • ? 始终遵循最小权限原则:服务主体或托管标识只需 Microsoft.CognitiveServices/accounts/deployments/* 权限,避免授予 Owner 级别权限;
  • ? 所有示例依赖 azure-mgmt-cognitiveservices>=23.0.0b1(对应 2024-10-01 API 版本)和 azure-identity 包,请确保已安装:
    pip install azure-mgmt-cognitiveservices azure-identity

总结:不存在“用 endpoint key 部署模型”的技术路径——这不是限制,而是 Azure 安全架构的设计原则。管理操作必须通过 Azure AD 强身份认证,而数据操作才允许轻量级密钥认证。选择托管标识或服务主体,即可彻底规避短期 token 刷新问题,实现稳定、可审计、符合企业合规要求的自动化部署。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
cdn加速软件有哪些
cdn加速软件有哪些

CDN加速软件可以帮助网站提高内容访问速度和用户体验,降低服务器负载。在选择CDN加速软件时,需要根据实际需求和预算进行权衡,选择合适的软件和服务商。cdn加速软件有AWS CloudFront、Azure Content Delivery Network、Google Cloud CDN、Fastly、Cloudflare和Incapsula。

2023.10.19

3967

6

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

100

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

60

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

60

15

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

160

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

120

13

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

2026.11.06

120

10

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

2026.11.05

100

12

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

2026.11.05

80

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习