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] 提出任何其他問題或意見。