在 Azure Maps 中管理身份验证

创建 Azure Maps 帐户时，会自动创建客户端 ID 和共享密钥。 使用 Microsoft Entra ID 或 共享密钥身份验证时，需要这些值进行身份验证。

先决条件

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

• 熟悉 Azure 资源托管标识。 请务必了解这两种 托管标识类型 及其差异。
• Azure Maps 帐户。
• 熟悉 Azure Maps 的身份验证。

查看身份验证详细信息

若要查看 Azure Maps 身份验证详细信息，请执行以下作：

1. 登录到 Azure 门户。

2. 在“Azure 服务”部分选择“所有资源”，然后选择 Azure Maps 帐户。

   

3. 在左窗格的设置部分选择 “身份验证 ”。

   

选择身份验证类别

根据应用程序需求，应用程序安全性有特定的路径。 Microsoft Entra ID 定义特定的身份验证类别，以支持各种身份验证流。 若要为应用程序选择最佳类别，请参阅 应用程序类别。

如何添加和删除托管标识

若要使用 Azure Maps REST API 启用 共享访问签名（SAS）令牌身份验证 ，需要将用户分配的托管标识添加到 Azure Maps 帐户。

创建管理标识

可以在创建地图帐户之前或之后创建用户分配的托管标识。 可以通过门户、Azure 管理 SDK 或 Azure 资源管理器 （ARM） 模板添加托管标识。 若要通过 ARM 模板添加用户分配的托管标识，请指定用户分配的托管标识的资源标识符。

"identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
        "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/example/providers/Microsoft.ManagedIdentity/userAssignedIdentities/exampleidentity": {}
    }
}

删除托管标识

可以通过在门户中禁用功能或通过 Azure 资源管理器模板（和创建标识的方法相同）来删除系统分配的标识。 可以单独删除用户分配的标识。 若要删除所有标识，请将标识类型设置为 "None"。

以这种方式删除系统分配的身份标识也会将其从 Microsoft Entra ID 中删除。 删除 Azure Maps 帐户时，系统分配的标识也会从 Microsoft Entra ID 中自动删除。

若要使用 Azure 资源管理器模板删除所有标识，请更新本部分：

"identity": {
    "type": "None"
}

选择身份验证和授权方案

下表概述了 Azure Maps 中的常见身份验证和授权方案。 每个方案描述了可用于访问 Azure Maps REST API 的应用类型。 使用链接了解每个方案的详细配置信息。

查看内置的 Azure Maps 角色定义

若要查看内置的 Azure Maps 角色定义，

1. 在左窗格中，选择“访问控制(IAM)”。

2. 选择角色选项卡。

3. 在搜索框中输入“Azure Maps”。

结果显示 Azure Maps 的可用内置角色定义。

查看角色分配

若要查看已授予 Azure Maps 访问权限的用户和应用，请转到访问控制（IAM）。 在那里，选择 “角色分配”，然后按 Azure Maps 进行筛选。

1. 在左窗格中，选择“访问控制(IAM)”。

2. 选择“角色分配”选项卡。

3. 在搜索框中输入“Azure Maps”。

结果显示当前的 Azure Maps 角色分配。

请求 Azure Maps 的令牌

从 Microsoft Entra 令牌终结点获取令牌。 在Microsoft Entra ID 请求中，使用以下详细信息：

有关为用户和服务主体从 Microsoft Entra ID 请求访问令牌的详细信息，请参阅 Microsoft Entra ID 的身份验证方案。 若要查看特定方案，请参阅 方案表。

管理和轮换共享密钥

Azure Maps 订阅密钥类似于 Azure Maps 帐户的根密码。 请始终小心保护订阅密钥。 使用 Azure Key Vault 安全地管理和轮换密钥。 避免将访问密钥分发给其他用户、硬编码密钥，或者将它们保存在其他人可访问的纯文本中。 如果你认为密钥可能已泄露，请轮换密钥。

手动轮换订阅密钥

为了帮助保护 Azure Maps 帐户的安全，我们建议定期轮换订阅密钥。 如果可能，请使用 Azure 密钥保管库管理访问密钥。 如果不使用 Key Vault，则需要手动轮换密钥。

分配了两个订阅密钥，以便轮换密钥。 拥有两个密钥可确保应用程序在整个过程中保持对 Azure Maps 的访问权限。

若要在 Azure 门户中轮换 Azure Maps 订阅密钥，请执行以下作：

1. 更新应用程序代码以引用 Azure Maps 帐户的辅助密钥并部署。
2. 在 Azure 门户中，导航到 Azure Maps 帐户。
3. 在“设置”下选择“身份验证”。
4. 若要重新生成 Azure Maps 帐户的主密钥，请选择主密钥旁边的 “重新生成 ”按钮。
5. 更新应用程序代码以引用新的主密钥并部署。
6. 以相同的方式重新生成辅助密钥。

后续步骤

查找 Azure Maps 帐户的 API 使用指标：

探索演示如何将 Microsoft Entra ID 与 Azure Maps 集成的示例：