原生認證概述

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

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

內建原生驗證是一種認證方式,讓您的應用程式呈現註冊、登入及重設密碼的資訊,同時 Microsoft Entra 外部 ID 驗證憑證並強制執行驗證要求。 您的應用程式控制介面,並處理原生驗證 API 回傳的動作、可用方法與連結。

API 版本邊界

Important

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

主要參考資料描述回應驅動的原生驗證 API,其路由如 /api/v2.0。 請跟隨服務回傳的連結,無需重寫其版本或路徑。 /oauth2/v2.0 OAuth 端點路徑也被 V1 整合所使用。

現有的 V1 整合仍可繼續使用 V1 API 參考 及其 SDK 函式庫參考。 舊版 V1 指南與教學已從本文件中移除。 此文件變更並不宣告 V1 或其 SDK 將被淘汰。 請參閱 SDK 相容性與遷移 以了解平台與套件需求。

應用程式擁有的體驗,服務控制的驗證

透過內建原生驗證,行動、桌面或單頁應用程式(SPA)可在其自身介面內提供驗證。 您的應用程式控制版面配置、互動與驗證回饋。 Microsoft Entra 外部 ID 會驗證憑證、強制執行驗證要求,並發放令牌。

租戶與條件存取政策及應用程式的使用者流程適用於 Microsoft 託管驗證、嵌入式原生驗證,以及自帶 UX(BYO UX)。 呈現與整合的職責各不相同。 透過內建原生驗證,您的應用程式會處理所需的互動,例如密碼驗證後的第二因素挑戰,或電子郵件驗證後的更多屬性收集。

Microsoft 代管的驗證會代表您的應用程式顯示頁面。 當您的團隊需要控制介面並能實施回應處理與安全責任時,請選擇嵌入式原生驗證。 請參閱 「選擇驗證方式」 以取得更廣泛的比較。

客戶旅程

同一個授權交易貫穿每趟旅程。 您的應用程式啟動授權,完成回傳的驗證互動,恢復授權,並將授權碼交換為令牌。

旅程 Behavior
註冊 建立一個帶密碼的電子郵件或無密碼一次性密碼(OTP)電子郵件帳戶。 收集屬性並完成使用者流程所要求的驗證步驟。
登入 請提交客戶識別碼及完整的密碼,或使用所提供的方法完成電子郵件一次性密碼驗證。 已設定的本機帳戶也支援使用者名稱與密碼登入功能。
密碼重設 驗證所提供的電子郵件或簡訊一次性密碼,提交新密碼,並依照密碼更新輪詢回應操作。 復原可以在登入識別流程之前開始,或透過密碼方法的 recover 連結開始。
多重身份驗證(MFA)與線上註冊 當政策要求 MFA 時,請完成電子郵件或簡訊驗證。 若需註冊,請處理傳回的 enroll 與 activate 作業。 電子郵件 OTP 第一因素帳戶則使用不同的第二因素,例如 SMS。
註冊或重設密碼後的政策要求 在請求令牌之前,請繼續處理所需的驗證,包括 MFA 與條件存取。 完成帳號建立或密碼更新並不會繞過政策。

從目前交易中可用的旅程與方法中選擇。 您的應用程式可以呈現一個選項,或在這些選項中套用其流程邏輯。

原生驗證 API 不支援聯邦、電話號碼作為首要因素、基於時間的一次性密碼(TOTP)、通行金鑰、推播驗證或外部 MFA 方法。 不支援後續作業的 step-up 驗證,以及將原生發行的權杖用於個人檔案或認證管理 API。 請參閱與 Microsoft 託管驗證及 BYO UX 比較的方法與整合矩陣。

有關支援的自訂驗證擴充事件,請參閱 作法比較。 有關設定,請參閱 自訂驗證擴充功能。

整合責任

使用設定指南與 API 參考資料進行直接整合,或使用文件化的 JavaScript、Android 或 Apple SDK。 SDK 快速入門 會設定 React Next.js 範例。 SDK 入口點與支援的接續介面是針對套件與平台而定的。

責任 您的應用程式實作了什麼
回應處理 使用最新的 state、 action及連結,透過使用者選擇或應用程式流程邏輯選擇允許的操作。
方法選擇 從回傳的方法中選擇,必要時使用遮罩提示,並依照所選方法的連結操作。
屬性集合 根據回傳的欄位需求與驗證中繼資料收集值。 不需要頁面分組的元資料。
交易連續性 將最新的續接權標記保留在記憶體中,並只與同一回應的連結一起使用。
授權 先申請所需的範疇,並以最終授權碼交換代幣。
復原 處理驗證失敗、節流、過期、不支援的互動以及取消,且不會自動重新提交認證資料。 另外設定的瀏覽器登入會啟動新的驗證嘗試;它不會恢復原生的進展。

具備內嵌原生驗證與 BYO UX 網站的 SPA,需要針對跨來源瀏覽器 API 呼叫制定代理或邊緣跨來源資源共享(CORS)政策。 在 Android 和 iOS 上使用原生 HTTP 傳輸的應用程式不需要 CORS 或 CORS 代理。 請參閱 原生驗證 CORS 概念。

原生驗證 API V2 要求瀏覽器應用程式(如 SPA)使用租戶驗證的自訂網域,以協助防範跨站請求偽造(CSRF)。 非瀏覽器用戶端,例如使用原生 HTTP 傳輸的 Android 和 iOS 應用程式,不需要自訂網域。 嵌入式瀏覽器或 webview 並非原生的 HTTP 傳輸。 自帶用戶體驗(BYO)的 UX 網站仍然需要經租戶驗證的自訂網域。 在開始旅程前設定服務授權單位;請參閱 設定 API 授權單位。

安全界限

您的應用程式會處理認證資料,因此請保護密碼、一次性密碼、延續權杖、授權碼以及已發出的權杖。 使用 HTTPS,不要記錄驗證請求本文,也不要快取認證資料回應。 在傳送交易資料之前,先驗證回傳的 URL 授權單位。

使用客戶端驗證協助客戶修正輸入。 該服務會驗證驗證要求。

工作階段邊界

嵌入式原生驗證支援嵌入式 webview 的單一登入(SSO)。 已登入的原生應用程式會為該網頁資源請求存取權杖,並將其包含在 webview 請求的 Authorization 標頭中。 該資源會驗證令牌並建立會話,允許在不需其他登入提示的情況下存取。 請參閱「從原生應用程式驗證嵌入的網頁檢視」。

登出原生應用程式不會終止其他應用程式或瀏覽器的工作階段。 當您的登出體驗需要時,請分別清除每個應用程式的工作階段。

現有的 V1 應用程式配置

對於現有的 V1 應用程式, 請啟用公開用戶端及原生驗證流程,然後更新您的平台設定。 V1 API 參考說明了挑戰類型與功能。 若要進行回應驅動的整合,請依照「 設定應用程式 」選擇並設定 V2 入口點。

條件式存取與登入頻率

Microsoft Entra 外部 ID 支援 Conditional Access登入頻率(SIF)工作階段控制,適用於 Microsoft 託管與原生驗證。

對於原生驗證,當政策要求重新驗證時,Microsoft Entra 外部 ID 會阻止在重新整理權杖授予期間發出權杖(grant_type=refresh_token)。 您的應用程式必須處理失敗的權杖更新,並提示使用者重新登入,才能取得新的權杖。 政策不會顯示您應用程式的登入介面。

下一步