Azure OpenAI 凭据#

您可以使用以下凭据对下列节点进行身份验证：

• Chat Azure OpenAI
• Embeddings Azure OpenAI

前置要求#

• 创建 Azure 订阅
• 在该订阅中获取 Azure OpenAI 访问权限。如果您的组织尚未获得权限，可能需要申请访问

支持的认证方式#

• API 密钥
• Azure Entra ID (OAuth2)

相关资源#

有关该服务的更多信息，请参阅 Azure OpenAI API 文档

使用 API 密钥#

配置此凭据需要准备：

• 资源名称：您为资源指定的名称
• API 密钥：推荐使用密钥 1。部署前可在密钥和终结点中获取
• 凭据应使用的 API 版本。有关 Azure OpenAI 中的 API 版本控制，请参阅 Azure OpenAI API 预览生命周期文档

要获取上述信息，请创建并部署 Azure OpenAI 服务资源

Azure OpenAI 节点的模型名称

部署资源后，请将部署名称作为模型名称用于使用此凭据的 Azure OpenAI 节点

使用 Azure Entra ID (OAuth2)#

n8n Cloud 用户须知

云端用户无需提供连接详细信息。选择连接我的账户即可通过浏览器连接

对于自托管用户，从头开始配置 OAuth2 需要两个主要步骤：

1. 在 Microsoft 身份平台注册应用程序
2. 为该应用程序生成客户端密钥

请按照以下每个步骤的详细说明操作。有关 Microsoft OAuth2 网络流程的更多细节，请参阅 Microsoft 身份验证和授权基础

注册应用程序#

在 Microsoft 身份平台注册应用程序：

1. 打开 Microsoft 应用程序注册门户
2. 选择注册应用程序
3. 输入应用程序的名称
4. 在支持的账户类型中，选择任何组织目录中的账户（任何 Azure AD 目录 - 多租户）和个人 Microsoft 账户（例如 Skype、Xbox）
5. 在注册应用程序中：
   1. 从 n8n 凭据复制 OAuth 回调 URL
   2. 将其粘贴到重定向 URI（可选） 字段
   3. 选择选择平台 > Web
6. 选择注册完成应用程序创建
7. 复制应用程序（客户端）ID 并粘贴到 n8n 作为客户端 ID

更多信息请参阅在 Microsoft 身份平台注册应用程序

生成客户端密钥#

创建应用程序后，为其生成客户端密钥：

1. 在 Microsoft 应用程序页面，选择左侧导航栏的证书和密码
2. 在客户端密码部分，选择 + 新建客户端密码
3. 输入客户端密码的描述，例如 n8n credential
4. 选择添加
5. 复制值列中的密码
6. 将其粘贴到 n8n 作为客户端密码
7. 在 n8n 中选择连接我的账户完成连接设置
8. 登录您的 Microsoft 账户并允许应用访问您的信息

有关添加客户端密钥的更多信息，请参阅 Microsoft 的添加凭据

设置自定义范围#

Azure Entra ID 凭据默认使用以下范围：

• openid
• offline_access
• AccessReview.ReadWrite.All
• Directory.ReadWrite.All
• NetworkAccessPolicy.ReadWrite.All
• DelegatedAdminRelationship.ReadWrite.All
• EntitlementManagement.ReadWrite.All
• User.ReadWrite.All
• Directory.AccessAsUser.All
• Sites.FullControl.All
• GroupMember.ReadWrite.All

要为凭据选择不同范围，请启用自定义范围滑块并编辑已启用范围列表。请注意，使用限制性更强的范围可能导致某些功能无法按预期工作