教程：使用托管标识从应用服务连接到 Azure 数据库，而无需使用密钥

项目
2024-10-03

应用服务在 Azure 中提供高度可缩放、自修补的 Web 托管服务。它还为应用提供托管标识，这是一项统包解决方案，可以确保安全地访问 Azure SQL 数据库，包括：

注意

本教程不包括 Azure Cosmos DB 指南，该指南支持以不同的方式进行 AMicrosoft Entra 身份验证。有关详细信息，请参阅 Azure Cosmos DB 文档，例如使用系统分配的托管标识访问 Azure Cosmos DB 数据。

应用服务中的托管标识可以让应用更安全，因为不需在应用中存储机密，例如连接字符串中的凭据。本教程介绍如何使用托管标识从应用服务连接到上述数据库。

要学习的知识：

将 Microsoft Entra 用户配置为 Azure 数据库的管理员。
以 Microsoft Entra 用户身份连接数据库。
为应用服务应用配置系统分配或用户分配的托管标识。
授予数据库访问托管标识的权限。
使用托管标识从代码 (.NET Framework 4.8、.NET 6、Node.js、Python、Java) 连接到 Azure 数据库。
以 Microsoft Entra 用户身份从开发环境连接到 Azure 数据库。

如果没有 Azure 订阅，请在开始之前创建一个 Azure 免费帐户。

先决条件

基于 .NET、Node.js、Python 或 Java 在应用服务中创建应用。
使用 Azure SQL 数据库、Azure Database for MySQL 或 Azure Database for PostgreSQL 创建数据库服务器。
应熟悉标准连接模式（使用用户名和密码），并且能够成功从应用服务应用连接到所选的数据库。

为 Azure CLI 准备环境。

在 Azure Cloud Shell 中使用 Bash 环境。有关详细信息，请参阅 Azure Cloud Shell 中的 Bash 快速入门。
如需在本地运行 CLI 参考命令，请安装 Azure CLI。如果在 Windows 或 macOS 上运行，请考虑在 Docker 容器中运行 Azure CLI。有关详细信息，请参阅如何在 Docker 容器中运行 Azure CLI。
- 如果使用的是本地安装，请使用 az login 命令登录 Azure CLI。若要完成身份验证过程，请遵循终端中显示的步骤。有关其他登录选项，请参阅使用 Azure CLI 登录。
- 出现提示时，请在首次使用时安装 Azure CLI 扩展。有关扩展详细信息，请参阅使用 Azure CLI 的扩展。
- 运行 az version 以查找安装的版本和依赖库。若要升级到最新版本，请运行 az upgrade。

1.安装服务连接器无密码扩展

为 Azure CLI 安装最新服务连接器无密码扩展：

az extension add --name serviceconnector-passwordless --upgrade

注意

请通过运行 az version，检查扩展“serviceconnector-passwordless”的版本是否为“2.0.2”或更高版本。可能需要先升级 Azure CLI 才能升级扩展版本。

2.创建无密码连接

接下来，使用服务连接器创建无密码连接。

提示

Azure 门户可以帮助编写以下命令。在 Azure 门户中，转到 Azure 应用服务资源，从左侧菜单中选择“服务连接器”，然后选择“创建”。使用所有必需的参数填写表单。 Azure 自动生成连接创建命令，可以复制该命令以在 CLI 中使用或在 Azure Cloud Shell 中执行。

以下 Azure CLI 命令使用 --client-type 参数。

（可选）运行 az webapp connection create sql -h 以获取支持的客户端类型。

选择客户端类型并运行相应的命令。将下面的占位符替换为你自己的信息。

用户分配的托管标识
系统分配的托管标识

az webapp connection create sql \
    --resource-group <group-name> \
    --name <server-name> \
    --target-resource-group <sql-group-name> \
    --server <sql-name> \
    --database <database-name> \
    --user-identity client-id=<client-id> subs-id=<subscription-id> \
    --client-type <client-type>

az webapp connection create sql \
    --resource-group <group-name> \
    --name <server-name> \
    --target-resource-group <group-name> \
    --server <sql-name> \
    --database <database-name> \
    --system-identity \
    --client-type <client-type>

注意

对于 Azure Database for MySQL 灵活服务器，必须先手动设置 Microsoft Entra 身份验证，这需要单独的用户分配的托管标识和特定的 Microsoft Graph 权限。此步骤无法自动执行。

手动设置 Azure Database for MySQL 灵活服务器的 Microsoft Entra 身份验证。
（可选）运行 az webapp connection create mysql-flexible -h 命令以获取支持的客户端类型。

选择客户端类型并运行相应的命令。以下 Azure CLI 命令使用 --client-type 参数。

用户分配的托管标识
系统分配的托管标识

az webapp connection create mysql-flexible \
    --resource-group <group-name> \
    --name <server-name> \
    --target-resource-group <group-name> \
    --server <mysql-name> \
    --database <database-name> \
    --user-identity client-id=XX subs-id=XX mysql-identity-id=$IDENTITY_RESOURCE_ID \
    --client-type <client-type>

az webapp connection create mysql-flexible \
--resource-group <group-name> \
--name <server-name> \
--target-resource-group <group-name> \
--server <mysql-name> \
--database <database-name> \
--system-identity mysql-identity-id=$IDENTITY_RESOURCE_ID \
--client-type <client-type>

以下 Azure CLI 命令使用 --client-type 参数。

（可选）运行 az webapp connection create postgres-flexible -h 命令以获取所有支持的客户端类型的列表。

选择客户端类型并运行相应的命令。

用户分配的托管标识
系统分配的托管标识

az webapp connection create postgres-flexible \
    --resource-group <group-name> \
    --name <server-name> \
    --target-resource-group <group-name> \
    --server <postgresql-name> \
    --database <database-name> \
    --user-identity client-id=XX subs-id=XX \
    --client-type java

az webapp connection create postgres-flexible \
    --resource-group <group-name> \
    --name <server-name> \
    --target-resource-group <group-name> \
    --server <postgresql-name> \
    --database <database-name> \
    --system-identity \
    --client-type <client-type>

授予对预先创建的表的权限

接下来，如果你在使用服务连接器之前已经在 PostgreSQL 灵活服务器中创建了表和序列，则你需要以所有者身份进行连接，并向服务连接器创建的 <aad-username> 授予权限。服务连接器设置的连接字符串或配置中的用户名应类似于 aad_<connection name>。如果使用 Azure 门户，请选择 Service Type 列旁边的展开按钮并获取值。如果使用 Azure CLI，请检查 CLI 命令输出中的 configurations。

然后，执行用于授予权限的查询。

az extension add --name rdbms-connect

az postgres flexible-server execute -n <postgres-name> -u <owner-username> -p "<owner-password>" -d <database-name> --querytext "GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA public TO \"<aad-username>\";GRANT ALL PRIVILEGES ON ALL SEQUENCES IN SCHEMA public TO \"<aad username>\";"

<owner-username> 和 <owner-password> 是现有表的所有者，可以向他人授予权限。 <aad-username> 是由服务连接器创建的用户。将其替换为实际值。

通过此命令验证结果：

az postgres flexible-server execute -n <postgres-name> -u <owner-username> -p "<owner-password>" -d <database-name> --querytext "SELECT distinct(table_name) FROM information_schema.table_privileges WHERE grantee='<aad-username>' AND table_schema='public';" --output table

此服务连接器命令将在后台完成以下任务：

为 Azure 应用服务托管的应用 <server-name> 启用系统分配的托管标识或分配用户标识。
将 Microsoft Entra 管理员设置为当前已登录用户。
为系统分配的托管标识或用户分配的托管标识添加数据库用户。向此用户授予数据库 <database-name> 的所有权限。可以在上述命令输出的连接字符串中找到用户名。
根据数据库类型将名为 AZURE_MYSQL_CONNECTIONSTRING、AZURE_POSTGRESQL_CONNECTIONSTRING 或 AZURE_SQL_CONNECTIONSTRING 的配置设置为 Azure 资源。
对于应用服务，配置是在“应用设置”边栏选项卡中设置的。

如果在创建连接时遇到任何问题，请参阅故障排除获取帮助。

3、修改代码

安装依赖项。

dotnet add package Microsoft.Data.SqlClient

从服务连接器添加的环境变量中获取 Azure SQL 数据库连接字符串。

using Microsoft.Data.SqlClient;

// AZURE_SQL_CONNECTIONSTRING should be one of the following:
// For system-assigned managed identity:"Server=tcp:<server-name>.database.windows.net;Database=<database-name>;Authentication=Active Directory Default;TrustServerCertificate=True"
// For user-assigned managed identity: "Server=tcp:<server-name>.database.windows.net;Database=<database-name>;Authentication=Active Directory Default;User Id=<client-id-of-user-assigned-identity>;TrustServerCertificate=True"

string connectionString = 
    Environment.GetEnvironmentVariable("AZURE_SQL_CONNECTIONSTRING")!;

using var connection = new SqlConnection(connectionString);
connection.Open();

有关详细信息，请参阅使用 Active Directory 托管标识身份验证。

将以下依赖项添加到 pom.xml 文件：

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity</artifactId>
    <version>1.4.6</version>
</dependency>
<dependency>
    <groupId>com.microsoft.sqlserver</groupId>
    <artifactId>mssql-jdbc</artifactId>
    <version>10.2.0.jre11</version>
</dependency>

从服务连接器添加的环境变量中获取 Azure SQL 数据库连接字符串。

import java.sql.Connection;
import java.sql.ResultSet;
import java.sql.Statement;

import com.microsoft.sqlserver.jdbc.SQLServerDataSource;

public class Main {
    public static void main(String[] args) {
        // AZURE_SQL_CONNECTIONSTRING should be one of the following:
        // For system-assigned managed identity: "jdbc:sqlserver://{SQLName}.database.windows.net:1433;databaseName={SQLDbName};authentication=ActiveDirectoryMSI;"
        // For user-assigned managed identity: "jdbc:sqlserver://{SQLName}.database.windows.net:1433;databaseName={SQLDbName};msiClientId={UserAssignedMiClientId};authentication=ActiveDirectoryMSI;"
        String connectionString = System.getenv("AZURE_SQL_CONNECTIONSTRING");
        SQLServerDataSource ds = new SQLServerDataSource();
        ds.setURL(connectionString);
        try (Connection connection = ds.getConnection()) {
            System.out.println("Connected successfully.");
        } catch (SQLException e) {
            e.printStackTrace();
        }
    }
}

有关详细信息，请参阅使用 Microsoft Entra 身份验证进行连接。

安装依赖项。
```
python -m pip install pyodbc
```

从服务连接器添加的环境变量中获取 Azure SQL 数据库连接配置。对想要使用的身份验证类型的代码片段部分取消注释。

import os;
import pyodbc

server = os.getenv('AZURE_SQL_SERVER')
port = os.getenv('AZURE_SQL_PORT')
database = os.getenv('AZURE_SQL_DATABASE')
authentication = os.getenv('AZURE_SQL_AUTHENTICATION')  # The value should be 'ActiveDirectoryMsi'

# Uncomment the following lines according to the authentication type.
# For system-assigned managed identity.
# connString = f'Driver={{ODBC Driver 18 for SQL Server}};Server={server},{port};Database={database};Authentication={authentication};Encrypt=yes;'

# For user-assigned managed identity.
# client_id = os.getenv('AZURE_SQL_USER')
# connString = f'Driver={{ODBC Driver 18 for SQL Server}};Server={server},{port};Database={database};UID={client_id};Authentication={authentication};Encrypt=yes;'

conn = pyodbc.connect(connString)

对于替代方法，还可以使用访问令牌连接到 Azure SQL 数据库，请参阅迁移 Python 应用程序以将无密码连接用于 Azure SQL 数据库。

安装依赖项。
```
npm install mssql
```

从服务连接器添加的环境变量中获取 Azure SQL 数据库连接配置。对想要使用的身份验证类型的代码片段部分取消注释。

import sql from 'mssql';

const server = process.env.AZURE_SQL_SERVER;
const database = process.env.AZURE_SQL_DATABASE;
const port = parseInt(process.env.AZURE_SQL_PORT);
const authenticationType = process.env.AZURE_SQL_AUTHENTICATIONTYPE;

// Uncomment the following lines according to the authentication type.
// For system-assigned managed identity.
// const config = {
//     server,
//     port,
//     database,
//     authentication: {
//         authenticationType
//     },
//     options: {
//        encrypt: true
//     }
// };  

// For user-assigned managed identity.
// const clientId = process.env.AZURE_SQL_CLIENTID;
// const config = {
//     server,
//     port,
//     database,
//     authentication: {
//         type: authenticationType
//     },
//     options: {
//         encrypt: true,
//         clientId: clientId
//     }
// };  

this.poolconnection = await sql.connect(config);

有关详细信息，请参阅 Microsoft SQL Server 客户端编程的主页。有关代码示例，请参阅通过服务连接器创建与数据库服务的无密码连接。

代码中与 Azure Database for MySQL 的连接遵循所有语言堆栈的 DefaultAzureCredential 模式。 DefaultAzureCredential 足够灵活，可以适应开发环境和 Azure 环境。在本地运行时，它可以从所选的环境中 (Visual Studio、Visual Studio Code、Azure CLI 或Azure PowerShell) 检索已登录的 Azure 用户。在 Azure 中运行时，它会检索托管标识。因此，可以在开发时和生产环境中连接到数据库。模式如下：

从 Azure 标识客户端库实例化 DefaultAzureCredential。如果使用用户分配的标识，请指定标识的客户端 ID。
获取 Azure Database for MySQL 的访问令牌：https://ossrdbms-aad.database.windows.net/.default。
将令牌添加到连接字符串。
打开连接。

对于 .NET，请使用 Azure.Identity 等客户端库获取托管标识的访问令牌。然后，使用访问令牌作为密码来连接到数据库。使用下面的代码时，请确保取消注释与你要使用的身份验证类型相对应的代码片段部分。

using Azure.Core;
using Azure.Identity;
using MySqlConnector;

// Uncomment the following lines according to the authentication type.
// For system-assigned managed identity.
// var credential = new DefaultAzureCredential();

// For user-assigned managed identity.
// var credential = new DefaultAzureCredential(
//     new DefaultAzureCredentialOptions
//     {
//         ManagedIdentityClientId = Environment.GetEnvironmentVariable("AZURE_MYSQL_CLIENTID");
//     });

var tokenRequestContext = new TokenRequestContext(
    new[] { "https://ossrdbms-aad.database.windows.net/.default" });
AccessToken accessToken = await credential.GetTokenAsync(tokenRequestContext);
// Open a connection to the MySQL server using the access token.
string connectionString =
    $"{Environment.GetEnvironmentVariable("AZURE_MYSQL_CONNECTIONSTRING")};Password={accessToken.Token}";

using var connection = new MySqlConnection(connectionString);
Console.WriteLine("Opening connection using access token...");
await connection.OpenAsync();

// do something

将以下依赖项添加到 pom.xml 文件：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.33</version>
</dependency>
<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity-extensions</artifactId>
    <version>1.2.0</version>
</dependency>

从环境变量获取连接字符串，并添加插件名称以连接到数据库：

String url = System.getenv("AZURE_MYSQL_CONNECTIONSTRING");  
String pluginName = "com.azure.identity.extensions.jdbc.mysql.AzureMysqlAuthenticationPlugin";
Connection connection = DriverManager.getConnection(url + "&defaultAuthenticationPlugin=" +
    pluginName + "&authenticationPlugins=" + pluginName);

有关详细信息，请参阅将 Java 和 JDBC 与 Azure Database for MySQL 灵活服务器配合使用。

安装依赖项。

pip install azure-identity
# install Connector/Python https://dev.mysql.com/doc/connector-python/en/connector-python-installation.html
pip install mysql-connector-python

使用 azure-identity 库中的访问令牌进行身份验证。从服务连接器添加的环境变量中获取连接信息。使用下面的代码时，请确保取消注释与你要使用的身份验证类型相对应的代码片段部分。

from azure.identity import ManagedIdentityCredential, ClientSecretCredential
import mysql.connector
import os

# Uncomment the following lines according to the authentication type.
# For system-assigned managed identity.
# cred = ManagedIdentityCredential()    

# For user-assigned managed identity.
# managed_identity_client_id = os.getenv('AZURE_MYSQL_CLIENTID')
# cred = ManagedIdentityCredential(client_id=managed_identity_client_id)

# acquire token
accessToken = cred.get_token('https://ossrdbms-aad.database.windows.net/.default')

# open connect to Azure MySQL with the access token.
host = os.getenv('AZURE_MYSQL_HOST')
database = os.getenv('AZURE_MYSQL_NAME')
user = os.getenv('AZURE_MYSQL_USER')
password = accessToken.token

cnx = mysql.connector.connect(user=user,
                              password=password,
                              host=host,
                              database=database)
cnx.close()

安装依赖项。

npm install --save @azure/identity
npm install --save mysql2

从服务连接器添加的环境变量中使用 @azure/identity 和 Azure MySQL 数据库信息获取访问令牌。使用下面的代码时，请确保取消注释与你要使用的身份验证类型相对应的代码片段部分。

import { DefaultAzureCredential,ClientSecretCredential } from "@azure/identity";

const mysql = require('mysql2');

// Uncomment the following lines according to the authentication type.
// for system-assigned managed identity
// const credential = new DefaultAzureCredential();

// for user-assigned managed identity
// const clientId = process.env.AZURE_MYSQL_CLIENTID;
// const credential = new DefaultAzureCredential({
//    managedIdentityClientId: clientId
// });

// acquire token
var accessToken = await credential.getToken('https://ossrdbms-aad.database.windows.net/.default');

const connection = mysql.createConnection({
  host: process.env.AZURE_MYSQL_HOST,
  user: process.env.AZURE_MYSQL_USER,
  password: accessToken.token,
  database: process.env.AZURE_MYSQL_DATABASE,
  port: process.env.AZURE_MYSQL_PORT,
  ssl: process.env.AZURE_MYSQL_SSL
});

connection.connect((err) => {
  if (err) {
    console.error('Error connecting to MySQL database: ' + err.stack);
    return;
  }
  console.log('Connected to MySQL database');
});

有关代码示例，请参阅通过服务连接器创建与数据库服务的无密码连接。

代码中与 Azure Database for PostgreSQL 的连接遵循所有语言堆栈的 DefaultAzureCredential 模式。 DefaultAzureCredential 足够灵活，可以适应开发环境和 Azure 环境。在本地运行时，它可以从所选的环境中 (Visual Studio、Visual Studio Code、Azure CLI 或Azure PowerShell) 检索已登录的 Azure 用户。在 Azure 中运行时，它会检索托管标识。因此，可以在开发时和生产环境中连接到数据库。模式如下：

从 Azure 标识客户端库实例化 DefaultAzureCredential。如果使用用户分配的标识，请指定标识的客户端 ID。
获取 Azure Database for PostgreSQL 的访问令牌：https://ossrdbms-aad.database.windows.net/.default。
将令牌添加到连接字符串。
打开连接。

using Azure.Identity;
using Azure.Core;
using Npgsql;

// Uncomment the following lines according to the authentication type.
// For system-assigned identity.
// var sqlServerTokenProvider = new DefaultAzureCredential();

// For user-assigned identity.
// var sqlServerTokenProvider = new DefaultAzureCredential(
//     new DefaultAzureCredentialOptions
//     {
//         ManagedIdentityClientId = Environment.GetEnvironmentVariable("AZURE_POSTGRESQL_CLIENTID");
//     }
// );

// Acquire the access token. 
AccessToken accessToken = await sqlServerTokenProvider.GetTokenAsync(
    new TokenRequestContext(scopes: new string[]
    {
        "https://ossrdbms-aad.database.windows.net/.default"
    }));

// Combine the token with the connection string from the environment variables provided by Service Connector.
string connectionString =
    $"{Environment.GetEnvironmentVariable("AZURE_POSTGRESQL_CONNECTIONSTRING")};Password={accessToken.Token}";

// Establish the connection.
using (var connection = new NpgsqlConnection(connectionString))
{
    Console.WriteLine("Opening connection using access token...");
    connection.Open();
}

将以下依赖项添加到 pom.xml 文件：

<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
    <version>42.7.5</version>
</dependency>
<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity-extensions</artifactId>
    <version>1.2.0</version>
</dependency>

从环境变量获取连接字符串，并添加插件名称以连接到数据库：

import java.sql.*;

String url = System.getenv("AZURE_POSTGRESQL_CONNECTIONSTRING");
String pluginName = "com.Azure.identity.extensions.jdbc.postgresql.AzurePostgresqlAuthenticationPlugin";  
Connection connection = DriverManager.getConnection(url + "&authenticationPluginClassName=" + pluginName);

有关更多信息，请参见以下资源：

安装依赖项。

pip install azure-identity
pip install psycopg2-binary

使用 azure-identity 库中的访问令牌进行身份验证并将该令牌用作密码。从服务连接器添加的环境变量中获取连接信息。使用下面的代码时，请确保取消注释与你要使用的身份验证类型相对应的代码片段部分。

from azure.identity import DefaultAzureCredential
import psycopg2

# Uncomment the following lines according to the authentication type.
# For system-assigned identity.
# cred = DefaultAzureCredential()

# For user-assigned identity.
# managed_identity_client_id = os.getenv('AZURE_POSTGRESQL_CLIENTID')
# cred = ManagedIdentityCredential(client_id=managed_identity_client_id)   

# Acquire the access token
accessToken = cred.get_token('https://ossrdbms-aad.database.windows.net/.default')

# Combine the token with the connection string from the environment variables added by Service Connector to establish the connection.
conn_string = os.getenv('AZURE_POSTGRESQL_CONNECTIONSTRING')
conn = psycopg2.connect(conn_string + ' password=' + accessToken.token)

有关更多信息，请参阅以下资源：

安装依赖项。

npm install --save @azure/identity
npm install --save pg

在代码中，使用服务连接器服务添加的环境变量中的 PostgreSQL 连接信息通过 @azure/identity 获取访问令牌。组合使用它们来建立连接。使用下面的代码时，请确保取消注释与你要使用的身份验证类型相对应的代码片段部分。

import { DefaultAzureCredential, ClientSecretCredential } from "@azure/identity";
const { Client } = require('pg');

// Uncomment the following lines according to the authentication type.  
// For system-assigned identity.
// const credential = new DefaultAzureCredential();

// For user-assigned identity.
// const clientId = process.env.AZURE_POSTGRESQL_CLIENTID;
// const credential = new DefaultAzureCredential({
//     managedIdentityClientId: clientId
// });

// Acquire the access token.
var accessToken = await credential.getToken('https://ossrdbms-aad.database.windows.net/.default');

// Use the token and the connection information from the environment variables added by Service Connector to establish the connection.
(async () => {
const client = new Client({
    host: process.env.AZURE_POSTGRESQL_HOST,
    user: process.env.AZURE_POSTGRESQL_USER,
    password: accesstoken.token,
    database: process.env.AZURE_POSTGRESQL_DATABASE,
    port: Number(process.env.AZURE_POSTGRESQL_PORT) ,
    ssl: process.env.AZURE_POSTGRESQL_SSL
});
await client.connect();

await client.end();
})();

有关代码示例，请参阅通过服务连接器创建与数据库服务的无密码连接。

4、设置开发环境

此代码示例使用 DefaultAzureCredential 从 Microsoft Entra ID 为 SQL 数据库获取可使用的令牌，然后将其添加到数据库连接。虽然可以自定义 DefaultAzureCredential，但默认情况下已广泛适用。它从已登录的 Microsoft Entra 用户或托管标识获取令牌，具体取决于是在开发环境中还是在应用服务本地运行。

无需进一步更改，代码即可在 Azure 中运行。但是，若要在本地调试代码，开发环境需要已登录 Microsoft Entra 的用户。在此步骤中，你将以 Microsoft Entra 用户身份登录来配置所选环境。

Visual Studio for Windows 集成了 Microsoft Entra 身份验证。若要在 Visual Studio 中启用开发和调试，请在 Visual Studio 中添加 Microsoft Entra 用户，方法是从菜单中依次选择“文件”>“帐户设置”，然后选择“登录”或“添加”。
若要设置进行 Azure 服务身份验证的 Microsoft Entra 用户，请从菜单中依次选择“工具”>“选项”，然后依次选择“Azure 服务身份验证”>“帐户选择”。选择已添加的 Microsoft Entra 用户，然后选择“确定”。

Visual Studio for Mac 未集成 Microsoft Entra 身份验证。但是，稍后将使用的 Azure 标识客户端库可以使用来自 Azure CLI 的令牌。若要在 Visual Studio 中启用开发和调试，请在本地计算机上安装 Azure CLI。
以 Microsoft Entra 用户身份通过以下命令登录到 Azure CLI：
```
az login --allow-no-subscriptions
```

稍后将使用的 Azure 标识客户端库可以从 Azure CLI 中使用令牌。若要启用基于命令行的开发，请在本地计算机上安装 Azure CLI。
以 Microsoft Entra 用户身份通过以下命令登录到 Azure：
```
az login --allow-no-subscriptions
```

稍后将使用的 Azure 标识客户端库可以从 Azure PowerShell 中使用令牌。若要启用基于命令行的开发，请在本地计算机上安装 Azure PowerShell。
以 Microsoft Entra 用户身份通过以下 cmdlet 登录到 Azure CLI：
```
Connect-AzAccount
```

有关为 Microsoft Entra 身份验证设置开发环境的详细信息，请参阅适用于 .NET 的 Azure 标识客户端库。

现已准备好将 SQL 数据库作为后端，使用 Microsoft Entra 身份验证来开发和调试应用程序。

5、测试并发布

在开发环境中运行代码。代码使用环境中的已登录 Microsoft Entra 用户连接到后端数据库。用户可以访问数据库，因为该用户已配置为数据库的 Microsoft Entra 管理员。
使用首选发布方法将代码发布到 Azure。在应用服务中，代码使用应用的托管标识连接到后端数据库。

常见问题

托管标识是否支持 SQL Server？
我收到错误 Login failed for user '<token-identified principal>'.
我更改了应用服务身份验证或关联的应用注册。为什么我仍然获取旧令牌？
如何将托管标识添加到 Microsoft Entra 组？
我收到错误 SSL connection is required. Please specify SSL options and retry。
我使用 Web 应用 + 数据库模板创建了应用，现在无法使用服务连接器命令创建托管标识连接。

托管标识是否支持 SQL Server？

是的。有关详细信息，请参阅：

我收到错误 `Login failed for user '<token-identified principal>'.`

尝试为其请求令牌的托管标识无权访问 Azure 数据库。

我更改了应用服务身份验证或关联的应用注册。为什么我仍然获取旧令牌？

托管标识的后端服务还保留一个令牌缓存，只有在过期的情况下才更新目标资源的令牌。如果在尝试在使用应用获取令牌后修改权限，则在缓存的令牌过期之前，实际上不会获得具有更新权限的新令牌。解决此问题的最佳方式是使用新的 InPrivate (Edge) /private (Safari) /Incognito (Chrome) 窗口测试更改。这样一来，请务必从新的经过身份验证的会话开始。

如何将托管标识添加到 Microsoft Entra 组？

如果需要，可将该标识添加到 Microsoft Entra 组，然后将访问权限授予 Microsoft Entra 组，而不是授予该标识。例如，以下命令将上一步中的托管标识添加到名为 myAzureSQLDBAccessGroup 的新组：

groupid=$(az ad group create --display-name myAzureSQLDBAccessGroup --mail-nickname myAzureSQLDBAccessGroup --query objectId --output tsv)
msiobjectid=$(az webapp identity show --resource-group <group-name> --name <app-name> --query principalId --output tsv)
az ad group member add --group $groupid --member-id $msiobjectid
az ad group member list -g $groupid

若要为 Microsoft Entra 组授予数据库权限，请参阅相应数据库类型的文档。

我收到错误 `SSL connection is required. Please specify SSL options and retry`。

连接到 Azure 数据库需要其他设置，并且超出了本教程的范围。有关详细信息，请参阅下列相应链接：

在 Azure Database for PostgreSQL 中配置 TLS 连接 - 单一服务器在应用程序中配置 SSL 连接，以便安全地连接到 Azure Database for MySQL

我使用 Web 应用 + 数据库模板创建了应用，现在无法使用服务连接器命令创建托管标识连接。

服务连接器需要对数据库的网络访问权限才能为应用标识授予访问权限。使用 Web 应用 + 数据库模板在 Azure 门户中创建默认安全的应用和数据库体系结构时，该体系结构会锁定对数据库的网络访问，并且仅允许从虚拟网络内部进行连接。 Azure Cloud Shell 也是如此。但你可以在虚拟网络中部署 Cloud Shell，然后在该 Cloud Shell 中运服务连接器命令。

后续步骤

你已了解：

将 Microsoft Entra 用户配置为 Azure 数据库的管理员。
以 Microsoft Entra 用户身份连接数据库。
为应用服务应用配置系统分配或用户分配的托管标识。
授予数据库访问托管标识的权限。
使用托管标识从代码 (.NET Framework 4.8、.NET 6、Node.js、Python、Java) 连接到 Azure 数据库。
以 Microsoft Entra 用户身份从开发环境连接到 Azure 数据库。

如何使用应用服务和 Azure Functions 的托管标识

教程：使用托管标识从 .NET 应用服务连接到 SQL 数据库，而无需使用机密

教程：连接到不支持托管标识的 Azure 服务（使用 Key Vault）

教程：使用虚拟网络集成隔离后端通信

通过

教程：使用托管标识从应用服务连接到 Azure 数据库，而无需使用密钥

先决条件

1.安装服务连接器无密码扩展

2.创建无密码连接

3、修改代码

4、设置开发环境

5、测试并发布

常见问题

托管标识是否支持 SQL Server？

我收到错误 Login failed for user '<token-identified principal>'.

我更改了应用服务身份验证或关联的应用注册。 为什么我仍然获取旧令牌？

如何将托管标识添加到 Microsoft Entra 组？

我收到错误 SSL connection is required. Please specify SSL options and retry。

我使用 Web 应用 + 数据库模板创建了应用，现在无法使用服务连接器命令创建托管标识连接。

后续步骤

反馈

其他资源

我收到错误 `Login failed for user '<token-identified principal>'.`

我更改了应用服务身份验证或关联的应用注册。为什么我仍然获取旧令牌？

我收到错误 `SSL connection is required. Please specify SSL options and retry`。