使用托管标识来访问应用程序配置

本文介绍如何利用管理标识访问应用程序配置。 它建立在快速入门中介绍的 Web 应用之上。 在继续操作之前，先使用应用程序配置创建 ASP.NET Core 应用。

本文介绍如何利用管理标识访问应用程序配置。 它建立在快速入门中介绍的 Web 应用之上。 在继续之前，请先使用 Azure 应用程序配置创建一个 Java Spring 应用。

• .NET Core SDK。

• 具有活动订阅的 Azure 帐户。 创建试用版订阅。
• Azure 应用程序配置存储。 创建存储区。
• 受支持的 Java 开发工具包 (JDK) 版本 11。
• Apache Maven 版本 3.0 或更高版本。

1. 添加对 Azure.Identity 包的引用：

   dotnet add package Azure.Identity
   

2. 查找应用程序配置存储区的终结点。 此 URL 列于 Azure 门户中的存储的“访问密钥”选项卡上。

3. 打开 appsettings.json 文件，并添加以下脚本。 将 <service_endpoint>（含括号）替换为应用配置存储区的 URL。

   "AppConfig": {
       "Endpoint": "<service_endpoint>"
   }
   

4. 打开 Program.cs 文件，然后添加对 Azure.Identity 和 Microsoft.Azure.Services.AppAuthentication 命名空间的引用：

   using Azure.Identity;
   

5. 若要访问存储在应用程序配置中的值，请更新 Builder 配置以使用 AddAzureAppConfiguration() 方法。

   var builder = WebApplication.CreateBuilder(args);
   
   builder.Configuration.AddAzureAppConfiguration(options =>
       options.Connect(
           new Uri(builder.Configuration["AppConfig:Endpoint"]),
           new ManagedIdentityCredential()));
   

   注意

   如果要使用“用户分配的托管标识”，请确保在创建 ManagedIdentityCredential 时指定 clientId。

   new ManagedIdentityCredential("<your_clientId>")
   

   如“Azure 资源的托管标识常见问题解答”中所述，系统将采用默认方法来解析使用的是哪个托管标识。 在这种情况下，Azure 标识库会强制要求你指定所需的标识，以避免未来可能出现的运行时问题。 例如，如果添加了新的用户分配的托管标识，或者启用了系统分配的托管标识。 因此，即使只定义了一个用户分配的托管标识，并且没有系统分配的托管标识，也需要指定 clientId。

1. 查找应用程序配置存储区的终结点。 此 URL 列于 Azure 门户中存储的“概述”选项卡上。

2. 打开 bootstrap.properties，删除 connection-string 属性并将其替换为系统指定标识的终结点：

spring.cloud.azure.appconfiguration.stores[0].endpoint=<service_endpoint>

对于用户分配的标识：

spring.cloud.azure.appconfiguration.stores[0].endpoint=<service_endpoint>
spring.cloud.azure.credential.managed-identity-enabled= true
spring.cloud.azure.credential.client-id= <client_id>

使用托管标识时，必须将应用部署到 Azure 服务。 托管标识不能用于对本地运行的应用进行身份验证。 若要部署你在使用应用配置创建 ASP.NET Core 应用快速入门中创建并修改的 .NET Core 应用，以便使用托管标识，请按照发布 Web 应用中的指南操作。

使用托管标识需要将应用部署到 Azure 服务。 托管标识不能用于对本地运行的应用进行身份验证。 若要部署你在使用 Azure 应用程序配置创建 Java Spring 应用快速入门中创建的并已修改为使用托管标识的 Spring 应用，请按照发布 Web 应用中的指导操作。