Microsoft Foundry 凭据
您可以使用这些凭据来验证以下节点:
这些凭据之前分别名为 Azure OpenAI credentials(API key)和 Azure Entra ID (Azure Active Directory) API(Entra ID)。
先决条件
- 创建一个 Azure 订阅。
- 在该订阅中拥有 Azure OpenAI 或 Microsoft Foundry 的访问权限。对于 Azure OpenAI,如果组织尚未获得访问权限,可能需要申请访问权限。
支持的认证方式
- API key
- Microsoft Foundry (Entra ID):应用使用客户端 ID 和密钥登录,无需用户登录。
相关资源
请参考 Azure OpenAI 的 API 文档{:target=_blank .external-link} 了解更多关于该服务的信息。
Endpoint type 端点类型
两种凭据类型都有 Endpoint Type 端点类型设置,用于确定节点调用的 Azure 端点。
- Classic 经典:用于位于
*.openai.azure.com的 Azure OpenAI 资源。凭据需要 Resource Name 资源名称和 API Version API 版本。你还可以输入可选的 Endpoint 端点。 - Microsoft Foundry:用于位于
*.services.ai.azure.com的 Microsoft Foundry 资源。凭据需要完整的 Endpoint 端点 URL,例如https://<resource>.services.ai.azure.com/openai/v1。你还可以输入可选的 Project 项目。
Project 项目
Project 项目字段是可选的,仅在选择 Microsoft Foundry 端点类型时显示。请输入拥有这些部署的 Microsoft Foundry 项目名称。可以在 Foundry 门户的项目概览页面上查看该名称。
n8n 使用该项目列出你的部署。在 Chat Model 节点中,节点自身的 Project 项目字段会覆盖此值。如需使用凭据中的项目,请将节点字段留空。
某些 Chat Model 节点功能需要 Microsoft Foundry 端点类型,包括部署列表、Claude 模型和 Responses API。有关详情,请参阅 Microsoft Foundry Chat Model。
使用 API key
要配置此凭据,您需要:
- Endpoint Type 端点类型:Classic 或 Microsoft Foundry。
- API key:Key 1 即可。可在部署前通过 Keys and Endpoint 获取。
- 对于 Classic 端点类型:
- Resource Name 资源名称:创建资源时指定的 Name。
- 凭据应使用的 API Version API 版本。有关 Azure OpenAI API 版本控制的更多信息,请参阅 Azure OpenAI API 预览生命周期文档。
- 对于 Microsoft Foundry 端点类型:资源的完整 Endpoint 端点 URL,以及可选的 Project 项目。
要获取上述信息,请创建并部署资源:
- Classic:创建并部署 Azure OpenAI Service 资源。
- Microsoft Foundry:创建 Microsoft Foundry 资源,并在其中部署模型。
提示
Microsoft Foundry 节点的模型名称
部署资源后,将 Deployment name 部署名称作为使用此凭据的 Microsoft Foundry 节点的模型名称。
使用 Microsoft Foundry (Entra ID)
Microsoft Foundry (Entra ID) 凭据以 Entra 应用的身份登录,并使用客户端凭据授权。你无需通过浏览器登录,也没有 Connect 连接按钮或重定向 URI。
要配置此凭据,你需要:
- Endpoint Type 端点类型和匹配的端点字段。请参阅 Endpoint type 端点类型。
- Tenant ID 租户 ID:应用注册的 Directory (tenant) ID。此字段没有默认值。
- 应用注册的 Client ID 客户端 ID 和 Client Secret 客户端密钥。
按照以下步骤操作:
现有凭据会继续工作。Connect 连接按钮和 scope 设置不再显示,已存储的登录 token 也不再使用。
注册一个应用程序
在 Microsoft 身份平台注册应用程序:
- 打开 Microsoft 应用程序注册门户。
- 选择 Register an application。
- 为应用输入 Name 名称。
- 在 Supported account types 中,选择包含你的租户的选项。
- 选择 Register 完成应用创建。无需填写 Redirect URI。
- 复制 Application (client) ID,并将其粘贴到 n8n 中作为 Client ID 客户端 ID。
- 复制 Directory (tenant) ID,并将其粘贴到 n8n 中作为 Tenant ID 租户 ID。
请参考 在 Microsoft 身份平台注册应用程序 了解更多信息。
生成客户端密钥
创建应用程序后,为其生成客户端密钥:
- 在您的 Microsoft 应用程序页面上,在左侧导航中选择 Certificates & secrets。
- 在 Client secrets 中,选择 + New client secret。
- 为您的客户端密钥输入一个 Description,比如
n8n credential。 - 选择 Add。
- 复制 Value 列中的 Secret。
- 将其粘贴到 n8n 中作为 Client Secret 客户端密钥。
请参考 Microsoft 的 添加凭据 了解更多关于添加客户端密钥的信息。
授予应用访问权限
应用需要在 Azure 资源上拥有角色。如果没有该角色,模型调用将失败并返回 403 错误。角色分配最长可能需要五分钟才生效。
在 Azure 门户中打开资源,然后转到 Access control (IAM)。将角色分配给应用,并将成员类型选为 User, group, or service principal。
- Classic 端点类型:分配 Cognitive Services OpenAI User 角色。
- Microsoft Foundry 端点类型:在 Foundry 资源上分配 Foundry User 角色。Microsoft 之前将此角色称为 Azure AI User,门户中仍可能显示该名称。
有关更多信息,请参阅 Microsoft 的 Azure OpenAI Entra ID 身份验证和 Microsoft Foundry 基于角色的访问控制文档。