使用 Microsoft 和 Unity 進行驗證

您可以讓使用者使用 OAuth 供應商通過 Firebase 驗證，例如 整合網頁式一般 OAuth 登入機制的 Microsoft Azure Active Directory 進入您的應用程式，並透過 Firebase SDK 執行端對端登入流程。 這個流程需要使用手機式 Firebase SDK，因此 Android 和 Apple 平台。

事前準備

使用前 Firebase Authentication、 請完成下列操作：

• 註冊 Unity 專案，並將其設定為使用 Firebase。

  • 如果您的 Unity 專案已在使用 Firebase， 已完成註冊和設定程序。

  • 如果您沒有 Unity 專案，可以 範例應用程式。

• 將 Firebase Unity SDK (特別是 FirebaseAuth.unitypackage) 新增至 Unity 專案

請注意，將 Firebase 新增至 Unity 專案時，必須一併執行以下兩者的工作： Firebase 控制台，然後在開啟的 Unity 專案中 (例如，您可以從控制台下載 Firebase 設定檔，然後 放入您的 Unity 專案中)。

存取 Firebase.Auth.FirebaseAuth 類別

Firebase.Auth.FirebaseAuth auth = Firebase.Auth.FirebaseAuth.DefaultInstance;

使用 Firebase SDK 處理登入流程

如要使用 Firebase SDK 處理登入流程，請按照下列步驟操作：

1. 建構已設定的 FederatedOAuthProviderData 例項 與 Microsoft 相關的提供者 ID

   Firebase.Auth.FederatedOAuthProviderData providerData =
     new Firebase.Auth.FederatedOAuthProviderData();
   providerData.ProviderId = Firebase.Auth.MicrosoftAuthProvider.ProviderId;
   

2. 選用：指定您想要的其他自訂 OAuth 參數。 與 OAuth 要求一起傳送

   providerData.CustomParameters = new Dictionary<string,string>;
   
   // Prompt user to re-authenticate to Microsoft.
   providerData.CustomParameters.Add("prompt", "login");
   
   // Target specific email with login hint.
   providerData.CustomParameters.Add("login_hint",
       "user@firstadd.onmicrosoft.com");
   

   如需 Microsoft 支援的參數，請參閱 Microsoft OAuth 說明文件。 請注意，您無法透過 setCustomParameters()。這些參數都是 client_id response_type、redirect_uri、state、scope 和 response_mode：

   只允許特定 Azure AD 用戶群的使用者簽署 插入應用程式，即 Azure AD 用戶群的易記網域名稱 可以使用用戶群 GUID ID。方法是指定 「用戶群」欄位的值。

   // Optional "tenant" parameter in case you are using an Azure AD tenant.
   // eg. '8eaef023-2b34-4da1-9baa-8bc8c9d6a490' or 'contoso.onmicrosoft.com'
   // or "common" for tenant-independent tokens.
   // The default value is "common".
   providerData.CustomParameters.Add("tenant", "TENANT_ID");
   

3. 選用：指定基本設定檔以外的其他 OAuth 2.0 範圍， 設為要向驗證服務供應商發出要求

   providerData.Scopes = new List<string>();
   providerData.Scopes.Add("mail.read");
   providerData.Scopes.Add("calendars.read");
   

   詳情請參閱 Microsoft 權限和同意聲明說明文件。

4. 設定供應商資料後，請使用該資料建立 FederatedOAuthProvider。

   // Construct a FederatedOAuthProvider for use in Auth methods.
   Firebase.Auth.FederatedOAuthProvider provider = new Firebase.Auth.FederatedOAuthProvider();
   provider.SetProviderData(providerData);
   

5. 使用驗證提供者物件向 Firebase 進行驗證。請注意，這不像 其他 FirebaseAuth 作業，這會透過彈出通訊視窗控制您的 UI 供使用者輸入憑證的網頁檢視畫面。

   如要啟動登入流程，請呼叫 SignInAndRetrieveDataWithCredentialAsync：

   auth.SignInWithProviderAsync(provider).ContinueOnMainThread(task => {
       if (task.IsCanceled) {
           Debug.LogError("SignInWithProviderAsync was canceled.");
           return;
       }
       if (task.IsFaulted) {
           Debug.LogError("SignInWithProviderAsync encountered an error: " +
             task.Exception);
           return;
       }
   
       Firebase.Auth.AuthResult authResult = task.Result;
       Firebase.Auth.FirebaseUser user = authResult.User;
       Debug.LogFormat("User signed in successfully: {0} ({1})",
           user.DisplayName, user.UserId);
   });
   

   使用 OAuth 存取權杖可讓您呼叫 Microsoft Graph API。

   有別於 Firebase Auth 支援的其他供應商，Microsoft 不需要 提供相片網址，並改為個人資料相片的二進位資料 透過以下方式要求： Microsoft Graph API。

6. 以上範例著重登入流程，不過您可以 可將 Microsoft Azure Active Directory 提供者連結至現有提供者 使用者透過 LinkWithProviderAsync。舉例來說 以便將兩者登入

   user.LinkWithProviderAsync(provider).ContinueOnMainThread(task => {
       if (task.IsCanceled) {
           Debug.LogError("LinkWithProviderAsync was canceled.");
           return;
       }
       if (task.IsFaulted) {
           Debug.LogError("LinkWithProviderAsync encountered an error: "
             + task.Exception);
           return;
       }
   
       Firebase.Auth.AuthResult authResult = task.Result;
       Firebase.Auth.FirebaseUser user = authResult.User;
       Debug.LogFormat("User linked successfully: {0} ({1})",
           user.DisplayName, user.UserId);
   });
   

7. 相同的模式可與 ReauthenticateWithProviderAsync 搭配使用 可用於擷取機密作業的最新憑證 。

   user.ReauthenticateWithProviderAsync(provider).ContinueOnMainThread(task => {
       if (task.IsCanceled) {
           Debug.LogError("ReauthenticateWithProviderAsync was canceled.");
           return;
       }
       if (task.IsFaulted) {
           Debug.LogError(
           "ReauthenticateWithProviderAsync encountered an error: " +
               task.Exception);
           return;
       }
   
       Firebase.Auth.AuthResult authResult = task.Result;
       Firebase.Auth.FirebaseUser user = authResult.User;
       Debug.LogFormat("User reauthenticated successfully: {0} ({1})",
           user.DisplayName, user.UserId);
   });
   

後續步驟

使用者首次登入後，系統會建立新的使用者帳戶 也就是使用者的名稱和密碼 號碼或驗證提供者資訊，也就是使用者登入時使用的網址。這項新功能 帳戶儲存為 Firebase 專案的一部分，可用來識別 即可限制使用者登入專案中的所有應用程式

• 在您的應用程式中，您可以透過 Firebase.Auth.FirebaseUser 物件：

  Firebase.Auth.FirebaseUser user = auth.CurrentUser;
  if (user != null) {
    string name = user.DisplayName;
    string email = user.Email;
    System.Uri photo_url = user.PhotoUrl;
    // The user's Id, unique to the Firebase project.
    // Do NOT use this value to authenticate with your backend server, if you
    // have one; use User.TokenAsync() instead.
    string uid = user.UserId;
  }

• 在你的Firebase Realtime Database和Cloud Storage中 查看安全性規則 透過 auth 變數取得已登入使用者的不重複使用者 ID。 控管使用者可以存取的資料

您可以讓使用者透過多重驗證機制登入您的應用程式 將驗證供應商憑證連結至 現有的使用者帳戶

如要登出使用者，請呼叫 SignOut()：

auth.SignOut();