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

使用 Microsoft 和 Unity 進行身份驗證

通過使用 Firebase SDK 將基於 Web 的通用 OAuth 登錄集成到您的應用程序中，您可以讓您的用戶使用 OAuth 提供程序（如 Microsoft Azure Active Directory）向 Firebase 進行身份驗證，以執行端到端的登錄流程。由於此流程需要使用基於手機的 Firebase SDK，因此僅在 Android 和 Apple 平台上受支持。

在你開始之前

在您可以使用Firebase 身份驗證之前，您需要：

註冊您的 Unity 項目並將其配置為使用 Firebase。
- 如果您的 Unity 項目已經使用 Firebase，那麼它已經為 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()傳遞 Firebase 所需的參數。這些參數是client_id 、 response_type 、 redirect_uri 、 state 、 scope和response_mode 。

若要僅允許來自特定 Azure AD 租戶的用戶登錄應用程序，可以使用 Azure AD 租戶的友好域名或租戶的 GUID 標識符。這可以通過在自定義參數對像中指定“租戶”字段來完成。

// 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);

使用 Auth 提供程序對象向 Firebase 進行身份驗證。請注意，與其他 FirebaseAuth 操作不同，這將通過彈出一個用戶可以在其中輸入其憑據的 Web 視圖來控制您的 UI。

要啟動登錄流程，請調用SignInWithProviderAsync ：

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.SignInResult signInResult = task.Result;
    Firebase.Auth.FirebaseUser user = signInResult.User;
    Debug.LogFormat("User signed in successfully: {0} ({1})",
        user.DisplayName, user.UserId);
});

使用 OAuth 訪問令牌，您可以調用Microsoft Graph API 。

與 Firebase Auth 支持的其他提供商不同，Microsoft 不提供照片 URL，而是必須通過Microsoft Graph API請求個人資料照片的二進制數據。

雖然上述示例側重於登錄流程，但您還可以使用LinkWithProviderAsync將 Microsoft Azure Active Directory 提供程序鏈接到現有用戶。例如，您可以將多個提供商鏈接到同一個用戶，允許他們使用其中任何一個登錄。

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.SignInResult signInResult = task.Result;
    Firebase.Auth.FirebaseUser user = signInResult.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.SignInResult signInResult = task.Result;
    Firebase.Auth.FirebaseUser user = signInResult.User;
    Debug.LogFormat("User reauthenticated successfully: {0} ({1})",
        user.DisplayName, user.UserId);
});

與 Firebase 支持的其他 OAuth 提供程序（例如 Google、Facebook 和 Twitter）不同，可以使用基於 OAuth 訪問令牌的憑據直接實現登錄，Firebase Auth 不支持 Microsoft 等提供程序的相同功能，因為無法使用Firebase 身份驗證服務器，用於驗證 Microsoft OAuth 訪問令牌的受眾。這是一項關鍵的安全要求，可能會使應用程序和網站遭受重放攻擊，其中為一個項目（攻擊者）獲得的 Microsoft OAuth 訪問令牌可用於登錄另一個項目（受害者）。相反，Firebase Auth 提供了使用在 Firebase 控制台中配置的 OAuth 客戶端 ID 和密碼來處理整個 OAuth 流程和授權代碼交換的能力。由於授權碼只能與特定的客戶 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 實時數據庫和雲存儲安全規則中，您可以從auth變量中獲取登錄用戶的唯一用戶 ID，並使用它來控制用戶可以訪問哪些數據。

您可以通過將身份驗證提供程序憑據鏈接到現有用戶帳戶來允許用戶使用多個身份驗證提供程序登錄您的應用程序。

要註銷用戶，請調用SignOut() ：

auth.SignOut();

使用 Microsoft 和 Unity 進行身份驗證

在你開始之前

訪問Firebase.Auth.FirebaseAuth類

使用 Firebase SDK 處理登錄流程

高級：手動處理登錄流程

下一步

訪問`Firebase.Auth.FirebaseAuth`類