本頁面由 Cloud Translation API 翻譯而成。

使用 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` 類別

FirebaseAuth 類別是所有 API 呼叫的閘道，您可透過 FirebaseAuth.DefaultInstance 存取。

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

使用 Firebase SDK 處理登入流程

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

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

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

選用：指定您想要的其他自訂 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");

選用：指定基本設定檔以外的其他 OAuth 2.0 範圍，設為要向驗證服務供應商發出要求
```
providerData.Scopes = new List<string>();
providerData.Scopes.Add("mail.read");
providerData.Scopes.Add("calendars.read");
```
詳情請參閱 Microsoft 權限和同意聲明說明文件。

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

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

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

如要啟動登入流程，請呼叫 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。

以上範例著重登入流程，不過您可以可將 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);
});

相同的模式可與 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 支援的其他 OAuth 供應商，例如 Google、Facebook 和 Twitter，使用 OAuth 存取權杖直接登入基於這個原因，Firebase Auth 不支援這是因為 Firebase 無法使用驗證伺服器，用於驗證 Microsoft OAuth 存取權杖的目標對象。這是重大的安全需求，可能會公開應用程式和會導致網站重新發動攻擊，攻擊者必須取得 Microsoft OAuth 存取權杖一個專案 (攻擊者) 可用來登入另一個專案 (受害者)。而是讓 Firebase 驗證能夠處理整個 OAuth 流程，使用 OAuth 用戶端 ID 和密鑰進行授權碼交換就可在 Firebase 控制台設定因為授權碼搭配特定的用戶端 ID/密鑰 (授權碼) 每項專案取得的均無法與另一項專案搭配使用

如果必須在不支援的環境中使用這些提供者，第三方 OAuth 程式庫 Firebase 自訂驗證。需要前者才能向供應商進行驗證和後者，用於交換自訂權杖的提供者憑證。

後續步驟

使用者首次登入後，系統會建立新的使用者帳戶也就是使用者的名稱和密碼號碼或驗證提供者資訊，也就是使用者登入時使用的網址。這項新功能帳戶儲存為 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();