快速入門:使用嵌入式原生驗證登入

適用於: 綠色圓圈,帶有白色勾選標記符號,表示以下內容適用於外部租戶。 外部租戶(了解更多)

認證方式: 嵌入式原生驗證。

在本快速入門中,您將設定一個用於嵌入式原生驗證的 React Next.js 範例,並使用 Microsoft 驗證資源庫 (MSAL) for JavaScript 5.29.1。 電子郵件與密碼流程使用經租戶驗證的自訂網域,並在邊緣端支援跨來源資源共享(CORS)。

Important

原生驗證 API V2 目前處於預覽階段。 原生驗證 API V1 仍然普遍提供。 請參閱 Microsoft Azure 預覽補充使用條款,了解適用於預覽功能的法律條款。

Prerequisites

  • 一個外部租戶以及一個設定為嵌入式原生驗證的公共用戶端應用程式。 完成 設定應用程式。
  • 已驗證租戶的自訂網域、應用程式 ID 以及目錄租戶 GUID。
  • 為範例的瀏覽器來源設定於自訂網域邊緣的 CORS。http://localhost:3000 將 共用代理合約 套用於來源、預檢、SDK 標頭,以及成功與錯誤回應。
  • 一個帶有電子郵件和密碼的客戶帳號。 如果租戶政策要求多重要素驗證(MFA),請為此範例旅程準備已啟用的電子郵件或簡訊驗證方式。
  • Node.js 20.9.0 或更新版本、npm、Git 以及程式碼編輯器。
  • 可供應用程式使用的連接埠 3000。

取得範例

範例有統一的 V1 與 V2 啟動器。 請使用下方固定的修訂版本與 SDK 版本,以追蹤此快速入門:

  1. 複製儲存庫,檢視範例版本,並開啟其 React Next.js 應用程式:

    git clone https://github.com/Azure-Samples/ms-identity-ciam-native-javascript-samples
    cd ms-identity-ciam-native-javascript-samples
    git checkout --detach 49c4e250a1e6eb97e2b813e9fce6670c996a2808
    cd typescript/native-auth/react-nextjs-sample
    
  2. 安裝與範例相依項相符的確切 SDK 版本:

    npm install --save-exact "@azure/msal-browser@5.29.1"
    

設定應用程式

在此邊緣路由中,將 https://<tenant-verified-custom-domain>/<tenant-GUID> 同時用於服務權威與 SDK API 傳輸基底。 保持該授權單位的不透明絕對 HAL 連結不變。 不要在瀏覽器設定中新增用戶端密鑰。

  1. 開啟 src/config/auth-config.ts。
  2. 請以應用程式 ID 取代 Enter_the_Application_Id_Here 。
  3. 將完整 auth.authority 值替換為 https://<tenant-verified-custom-domain>/<tenant-GUID>,其中以您已驗證的主機名稱和租戶 GUID 取代。
  4. 新增 auth.knownAuthorities 為包含已驗證主機名稱的陣列,但不含方案或路徑。
  5. 將所需的 customAuth.authApiProxyUrl 字串設定為相同的完整 https://<tenant-verified-custom-domain>/<tenant-GUID> authority。 在兩個 SDK URL 設定中都包含租戶的 GUID。
  6. 儲存組態檔。 V2 範例使用 SDK 的預設範圍,且未設定自訂聲明。 MFA 要求來自你的租戶原則,而非選擇 V2。

執行範例程式

從範例目錄執行應用程式。 此自訂網域邊緣設定不使用範例的本地 CORS 代理:

  1. 開始申請:

    npm run dev
    
  2. 在瀏覽器中開啟 http://localhost:3000 並選擇 V2。 在測試期間,請讓應用程式持續執行。

登入測試客戶

使用範例的統一啟動器,僅測試目前交易中啟用的方法。

  1. 輸入測試客戶的電子郵件地址,然後選擇「登入」。
  2. 如果服務提供多種第一因素方法,請選擇密碼方法。 在被要求時輸入密碼並選擇 「登入」。
  3. 如果服務要求 MFA,請選擇系統提供的電子郵件或簡訊驗證方式,並輸入其驗證碼。
  4. 確認範例顯示已完成登入。 不要在截圖、日誌或支援輸出中暴露代幣。

電子郵件一次性密碼登入使用為該方法配置的客戶帳戶及使用者流程。 這個快速入門課程依循電子郵件和密碼流程。

清除工作階段

在不刪除共用租戶設定的情況下結束本機測試。

登出範例不會終止其他應用程式或瀏覽器工作階段。

  1. 登出範例並清除帳戶相關應用程式介面。
  2. 在其終端機中停止應用程式處理程序。