Azure 认证

通用 Azure 身份验证层

某些适用于 Dapr 的 Azure 组件支持 通用 Azure 身份验证层，这使得应用程序能够通过使用 Azure AD 进行身份验证来访问存储在 Azure 资源中的数据。 因此，管理员可以通过 RBAC（基于角色的访问控制）利用微调权限的所有优势，并且在某些 Azure 服务（如 Azure VM、Azure Kubernetes Service 或许多 Azure 平台服务）上运行的应用程序可以利用 托管服务身份 （MSI）。

有些 Azure 组件提供替代身份验证方法，例如基于"主密钥"或"共享密钥"的系统。 在可能的情况下，建议你使用 Azure AD 对 Dapr 组件进行身份验证，以提高安全性和易管理性，并且如果你的应用在受支持的 Azure 服务上运行，同时能够利用 MSI。

目前，只有适用于 Dapr 的 Azure 组件的子集提供对此身份验证方法的支持。 随着时间的推移，支持将扩展到 Dapr 的所有其他 Azure 组件。 您可以在 这个 issue 上跟踪各个组件工作进度。

关于使用 Azure AD 进行身份验证

Azure AD 是 Azure 的身份和访问管理 （IAM） 解决方案，用于对用户和服务进行身份验证和授权。

Azure AD 构建在开放标准（如 OAuth 2.0）之上，该标准允许服务（应用程序）获取访问令牌以向 Azure 服务（包括 Azure 存储、Azure Key Vault、Cosmos DB 等）发出请求。 在 Azure 术语中，应用程序也称为"服务主体"。

上面列出的许多服务还支持使用其他系统进行身份验证，例如"主密钥"或"共享密钥"。 尽管这些方法始终是验证应用程序的有效方法（并且 Dapr 继续支持它们，如每个组件的参考页中所述），但尽可能使用 Azure AD 具有多种优势，包括：

• 能够利用托管服务标识，这允许应用程序使用 Azure AD 进行身份验证，并获取访问令牌以向 Azure 服务发出请求，而无需使用任何凭据。 当应用程序在受支持的 Azure 服务（包括但不限于 Azure VM、Azure Kubernetes 服务、Azure Web 应用等）上运行时，可以在基础结构级别分配应用程序的身份。
  这样，您的代码就不必处理任何类型的凭据，消除了安全管理凭据带来的挑战，允许在开发和运营团队之间更好地分离关注点，并减少有权访问凭据的人数，最后简化操作方面 - 特别是在使用多个环境时。
• 将 RBAC（基于角色的访问控制）与受支持的服务（如 Azure 存储和 Cosmos DB）结合使用时，可以微调授予应用程序的权限，例如允许限制对数据子集的访问或将其设置为只读。
• 更好的访问审核。
• 能够使用证书进行身份验证（可选）。

凭据元数据字段

若要使用 Azure AD 进行身份验证，需要将以下凭据添加为 Dapr 组件的元数据中的值（请阅读下一部分，了解如何创建它们）。 有多种选择，具体取决于您选择将凭据传递给 Dapr 服务的方式。

使用客户端凭据进行身份验证：

在 Kubernetes 上运行时，您还可以对上述任何或所有值使用对 Kubernetes secret 的引用。

使用 PFX 证书进行身份验证：

在 Kubernetes 上运行时，您还可以对上述任何或所有值使用对 Kubernetes 秘密的引用。

使用托管服务标识 （MSI） 进行身份验证：

使用 MSI 时，不需要指定任何值，但如果需要，可以选择 azureClientId 。

别名

出于向后兼容性的原因，支持将元数据中的以下值作为别名，但不建议使用它们。

生成新的 Azure AD 应用程序和服务主体

首先，请创建一个新的 Azure AD 应用程序，该应用程序也将用作服务主体。

前期准备:

• Azure Subscription
• Azure CLI
• jq
• OpenSSL（默认包含在所有 Linux 和 macOS 系统以及 WSL 上）
• 下面的脚本针对 bash 或 zsh shell 进行了优化

如果尚未登录，请先使用 Azure CLI 登录到 Azure：

# Log in Azure
az login
# Set your default subscription
az account set -s [your subscription id]

创建 Azure AD 应用程序

首先，使用以下命令创建 Azure AD 应用程序：

# Friendly name for the application / Service Principal
APP_NAME="dapr-application"

# Create the app
APP_ID=$(az ad app create \
  --display-name "${APP_NAME}" \
  --available-to-other-tenants false \
  --oauth2-allow-implicit-flow false \
  | jq -r .appId)

• Client secret
• Certificate

az ad app credential reset \
  --id "${APP_ID}" \
  --years 2 \
  --password $(openssl rand -base64 30)

{
  "appId": "c7dd251f-811f-4ba2-a905-acd4d3f8f08b",
  "name": "c7dd251f-811f-4ba2-a905-acd4d3f8f08b",
  "password": "Ecy3XG7zVZK3/vl/a2NSB+a1zXLa8RnMum/IgD0E",
  "tenant": "cd4b2887-304c-47e1-b4d5-65447fdd542b"
}

az ad app credential reset \
  --id "${APP_ID}" \
  --create-cert

{
  "appId": "c7dd251f-811f-4ba2-a905-acd4d3f8f08b",
  "fileWithCertAndPrivateKey": "/Users/alessandro/tmpgtdgibk4.pem",
  "name": "c7dd251f-811f-4ba2-a905-acd4d3f8f08b",
  "password": null,
  "tenant": "cd4b2887-304c-47e1-b4d5-65447fdd542b"
}

创建服务主体

创建 Azure AD 应用程序后，请为该应用程序创建服务主体，这将允许我们授予其对 Azure 资源的访问权限。 运行：

SERVICE_PRINCIPAL_ID=$(az ad sp create \
  --id "${APP_ID}" \
  | jq -r .objectId)
echo "Service Principal ID: ${SERVICE_PRINCIPAL_ID}"

输出将类似于：

服务主体 ID： 1d0ccf05-5427-4b5e-8eb4-005ac5f9f163

请注意，上面的值是 服务主体 的 ID，它与 Azure AD 中的应用程序 ID（客户端 ID）不同！ 前者在 Azure 租户中定义，用于向应用程序授予对 Azure 资源的访问权限。 客户端ID反而被你的应用程序用来验证。 总结一下：

• 你将使用Dapr清单中的客户ID来配置Azure服务的认证。
• 你将使用服务主体 ID 向应用程序授予访问 Azure 资源的权限

请记住，默认情况下，刚创建的服务主体无权访问任何 Azure 资源。 需要根据需要授予对每个资源的访问权限，如组件的文档中所述。

注意：此步骤与 官方文档 不同，因为其中包含的速记命令会创建一个服务主体，该服务主体对订阅中的所有 Azure 资源具有广泛的读写访问权限。
这样做不仅会授予我们的服务主体比你可能需要的更多的访问权限，而且这也适用于 Azure 管理平面（Azure 资源管理器或 ARM），这与 Dapr 无关（所有 Azure 组件都设计为与各种服务的数据平面进行交互， 而不是 ARM）。

Dapr 组件中的用法示例

在此示例中，将设置使用 Azure AD 进行身份验证的 Azure Key Vault 机密存储组件。

• Self-Hosted
• Kubernetes

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: azurekeyvault
  namespace: default
spec:
  type: secretstores.azure.keyvault
  version: v1
  metadata:
  - name: vaultName
    value: "[your_keyvault_name]"
  - name: azureTenantId
    value: "[your_tenant_id]"
  - name: azureClientId
    value: "[your_client_id]"
  - name: azureClientSecret
    value : "[your_client_secret]"

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: azurekeyvault
  namespace: default
spec:
  type: secretstores.azure.keyvault
  version: v1
  metadata:
  - name: vaultName
    value: "[your_keyvault_name]"
  - name: azureTenantId
    value: "[your_tenant_id]"
  - name: azureClientId
    value: "[your_client_id]"
  - name: azureCertificateFile
    value : "[pfx_certificate_file_fully_qualified_local_path]"

使用托管服务标识

使用 MSI，认证会自动发生，因为应用程序运行在具有已分配身份的 Azure 服务之上。 例如，当你创建 Azure VM 或 Azure Kubernetes 服务群集并选择为其启用托管身份时，将为你创建一个 Azure AD 应用程序并自动分配给该服务。 然后，Dapr 服务可以透明地利用该身份向 Azure AD 进行身份验证，而无需指定任何凭据。

若要开始使用托管标识，首先需要将标识分配给新的或现有的 Azure 资源。 说明取决于服务使用情况。 以下是官方文档的链接：

• Azure Kubernetes Service （AKS）
• Azure App Service （包括 Azure Web Apps 和 Azure Functions）
• Azure Virtual Machines (VM)
• Azure Virtual Machines Scale Sets (VMSS)
• Azure Container Instance (ACI)

其他 Azure 应用程序服务可能提供对 MSI 的支持; 请查看这些服务的文档，了解如何配置它们。

将托管身份分配给 Azure 资源后，你将拥有以下凭据：

{
    "principalId": "<object-id>",
    "tenantId": "<tenant-id>",
    "type": "SystemAssigned",
    "userAssignedIdentities": null
}

从上面的列表中，记下 principalId 这是创建的服务主体的 ID。 需要它才能向服务主体授予对 Azure 资源的访问权限。

支持其他 Azure 环境

默认情况下，Dapr 组件配置为与"公有云"中的 Azure 资源进行交互。 如果你的应用程序已部署到其他云（如 Azure 中国、Azure 政府或 Azure 德国），则可以通过将 azureEnvironment 元数据属性设置为受支持的值，为支持的组件启用该值：

• Azure 公有云 (默认): "AZUREPUBLICCLOUD"
• Azure 中国: "AZURECHINACLOUD"
• Azure Government: "AZUREUSGOVERNMENTCLOUD"
• Azure Germany: "AZUREGERMANCLOUD"

参考资料

• Azure AD app 凭据：Azure CLI 引用
• Azure 托管服务标识 （MSI） 概述
• 密钥构建块
• 指南：获取密钥
• 指南：在Dapr组件中引用密钥
• 密钥 API 参考