Azure 地图 AzureAD 示例

页面类型	语言	产品	描述	url片段
样本	夏普 javascript	天蓝色的 azure 地图 ASPNET核心 天蓝色广告	展示如何将 Azure Active Directory 与 Azure Maps 集成的示例集合。	AzureMapsAAD示例

Azure 地图和 Azure Active Directory 示例

这些是使用 AspNetCore C# 快速启动对 Azure Maps 的 Azure AD 身份验证的 4 个不同示例。每个示例根据 Azure AD 和 Azure 基于角色的访问控制 (RBAC) 支持的应用程序需求使用不同的身份验证协议。

内容

概述存储库的文件内容。它可以帮助用户浏览代码库、构建配置和任何相关资产。

文件/文件夹	描述
src/ImplicitGrant	用于显示没有服务器组件的用户身份验证的示例。
src/OpenIdConnect	使用 Microsoft 推荐的安全 Web 应用程序协议的示例
src/ClientGrant	显示无需用户交互的应用程序身份验证的示例。
.gitignore	定义提交时要忽略的内容。
CONTRIBUTING.md	贡献样本的指南。
README.md	起始自述文件。
LICENSE	样本的许可证。

先决条件

下载这些示例之前

• 具有ASP.NET 和 Web 开发工作负载的 Visual Studio 2019 或 Visual Studio Code。
• 您将需要 Azure 订阅，如有必要，请注册免费帐户。
• 与 Azure 订阅关联的 Azure Active Directory 的免费 SKU 。

设置

在 Azure Active Directory 中，创建新的应用程序注册

• 该应用程序注册将代表网络应用程序。
• 每个具体示例将描述不同身份验证协议所需的步骤。
• 对于此示例存储库，可以使用相同的应用程序注册。
• 对于生产，我们建议为每个 Web 应用程序注册不同的应用程序。此外，我们强烈建议使用 Azure 托管标识对 Azure Maps 进行任何非交互式身份验证。这将节省凭证管理成本。
• 对于显示名称，我们可以将其命名为“WebApp”，并将重定向 uri 暂时保留为空，然后按照个人示例README.md进行操作。

在 Azure 门户中创建 Azure Maps 帐户

• 在创建新资源时搜索“Azure Maps”，然后按照门户创建新帐户。
• 创建帐户后，检索 Azure Maps 客户端 ID 并保留在您想要运行的特定示例中。
• 该值应在所有 HTTP 请求的 x-ms-client-id 中使用。
• 如果使用任何 SDK，请将其添加到身份验证选项 (JS)。

运行示例

• 运行 Web 应用程序示例基于 AspNetCore MVC v2.2 文档
• 配置完所有单个示例 README.md 后，“调试”（F5 键）应构建并启动应用程序。
• 确保在配置了 HTTPS 的情况下运行 Web 应用程序。
• 如果提示通过 IIS 或 AspNetCore 开发 HTTPS 证书，请接受信任该证书的提示。

关键概念

• 使用 Azure Maps Web SDK 支持两种 Azure AD 访问令牌方法。
• 如果像 AspNetCore MVC 这样的服务器组件可用于您的应用程序，我们建议使用 OpenID Connect。
• 在没有服务器组件的情况下，您必须使用隐式授予来实现用户交互式登录体验。但是，在没有交互式登录的情况下，必须存在某些服务器组件来检索访问令牌并将其提供给 Azure Maps Web SDK。
• 使用 Azure 服务身份验证库将有助于降低凭据管理的复杂性和成本，并允许在托管平台（例如 Azure 虚拟机或 Azure 应用服务）上使用 Azure 托管标识。

贡献

该项目欢迎贡献和建议。大多数贡献都要求您同意贡献者许可协议 (CLA)，声明您有权并且实际上授予我们使用您的贡献的权利。有关详细信息，请访问 https://cla.opensource.microsoft.com。

当您提交拉取请求时，CLA 机器人将自动确定您是否需要提供 CLA 并适当地装饰 PR（例如，状态检查、评论）。只需按照机器人提供的说明进行操作即可。您只需使用我们的 CLA 在所有存储库中执行一次此操作。

该项目采用了微软开源行为准则。有关详细信息，请参阅行为准则常见问题解答或联系 [email protected] 提出任何其他问题或意见。