【 Cloud 】使用 Node.js 透過 Azure Functions 取得 Azure Digital Twins Token

內容

• 學習目標
• 前置準備作業
• 建立 Azure Functions
• 設定身分識別
• 透過 Postman 取得 Token
• 透過 Postman 操作 Azure Digital Twins

學習目標

• 如何使用 Node.js 透過 Azure Functions 取得 Azure Digital Twins Token

前置準備作業

• 已建立 Azure 帳號並能正常登入
• 已於完成建立與設定 Azure Digital Twins、Azure Active Directory ( Azure AD )
  • Ref https://learningsky.io/azure-digital-twins-authenticates-using-azure-ad-security-tokens-based-on-oauth/

建立 Azure Functions

Step 1. 在上方搜尋框輸入 function 關鍵字並點選 Function App 的搜尋結果

Step 2. 點選 + Create

Step 3. 輸入相關資訊

• Subscription 欄位選擇所要使用的訂閱。
• Resource group 欄位輸入此 Function 所要歸屬於的群組。
• Function App name 欄位輸入一個可識別的名稱。
• Publish 欄位請選擇 Code。
• Runtime stack 欄位請選擇 Node.js。
• Version 欄位請選擇 14 LTS。
• Region 欄位請選擇 SignalR 服務所要位於的資料中心。
• 當輸入完成後點選 Review + create

Step 4. 建立服務

• 確認資訊正確則點選 Create

Step 5. 點選 Go to resource

Step 6. 建立 getToken

• 點選左側的 Functions > 再點選上方的 + Create

• 選擇 HTTP trigger

• Template details 輸入相關資訊
  • New Function 欄位請輸入 getToken
  • 當輸入完成後點選 Create

• 設定 getToken
  • ① 點選 getToken
  • ② 點選左側的 Code + Test

• 點選上方的選單選擇 index.js 再輸入下方程式後再點選上方的 Save 按鈕

• 點選上方的選單選擇 function.json 再輸入下方的設定後再點選上方的 Save 按鈕

Step 7. 安裝套件

• 點選左側的 Advanced Tools > 再點選 Go →

• 點選上方的 Debug console > CMD

• 切換路徑到 getToken 資料夾
  • 請輸入 cd site\wwwroot\getToken

• 初始化專案
  • 請輸入 npm init -y

• 安裝 @azure/identity 套件 ( 需花一段時間進行安裝 )
  • 請輸入 npm i @azure/identity

Step 8. 取得 Azure Function URL

• 點選 Get function URL

• 點選 URL 欄位後方的複製按鈕

設定身分識別

Step 1. 點選所建立的 Azure Function 左側的 identity

Step 2. 將 Status 設成 On > 再點選 Save

Step 3. 再點選 Yes

Step 4. 點選 Azure role assignments

Step 5. 點選 + Add role assignment (Preview)

Step 6. 填寫相關資訊

• Scope 欄位請點選 Subscription
• Subscription 欄位請點選所要使用的訂閱
• Role 欄位請選擇 Azure Digital Twins Data Owner
• 資料選取完成後再點選 Save

透過 Postman 取得 Token

Step 1. 下載 Postman 並開啟 Postman

• 下載網址 https://www.postman.com/

Step 2. 取得 Token

• 點選 +

• 在 Enter Request URL 的輸入框輸入 建立 Azure Functions 段落的 Step 8 中所取得的 URL

• 點選 Send

透過 Postman 操作 Azure Digital Twins

Models - DigitalTwinModels List

Step 1. 設定 Request URL

• 點選 +

• 在 Enter Request URL 的輸入框輸入 https://Host-Name/models?api-version=2020-10-31
  • ㊟ 將 Host-Name 修改成所建立的 Azure Digital Twins中的 Host name

Step 2. 設定 Authorization Header

• 點選 Headers 頁籤

• 輸入相關資訊
  • 在 KEY 欄位輸入 Authorization
  • 在 VALUE 欄位輸入Bearer 再加上 透過 Postman 取得 Token 段落所取得的 Token
    • ㊟ Bearer 須加上一個空白

Step 3. 執行

• 點選 Send

• 執行結果

Reference

• https://docs.microsoft.com/en-us/rest/api/azure-digitaltwins/

GitHub

• ArcherHuang @ GitHub

List of blogs

• https://oranwind.org/author/archer/
• https://learningsky.io/author/archer/