在 Android 裝置上透過 Apple 登入使用者

本文說明如何使用 Identity Platform，在 Android 應用程式中新增「使用 Apple 登入」功能。

事前準備

向 Apple 設定應用程式

在 Apple 開發人員網站上：

  1. 按照「為網站設定『使用 Apple 帳戶登入』功能」一文中的步驟操作。 包括：

    1. 註冊返回網址，如下所示：

      https://project-id.firebaseapp.com/__/auth/handler

    2. 在下列網址暫時代管檔案，以驗證網域：

      https://project-id.firebaseapp.com/.well-known/apple-developer-domain-association.txt

    此外，請記下「服務 ID」和「Apple 團隊 ID」，下一節會用到。

  2. 使用 Apple 私密金鑰建立登入功能。 下一節會用到金鑰和 ID。

  3. 如果您使用 Identity Platform 傳送電子郵件給使用者，請使用下列電子郵件透過 Apple 的私人電子郵件轉送服務設定專案：

    noreply@project-id.firebaseapp.com

    如果應用程式有自訂電子郵件範本，也可以使用該範本。

遵守 Apple 的去識別化資料規定

Apple 讓使用者選擇匿名處理資料，包括電子郵件地址。選取這個選項後，Apple 會為使用者指派網域為 privaterelay.appleid.com 的模糊化電子郵件地址。

您的應用程式必須遵守 Apple 針對匿名 Apple ID 制定的所有適用開發人員政策或條款。包括在將任何個人識別資訊 (PII) 與匿名 Apple ID 建立關聯前，先徵求使用者同意。涉及 PII 的動作包括但不限於：

  • 將電子郵件地址連結至匿名 Apple ID，或反向操作。
  • 將電話號碼連結至匿名 Apple ID，或反向操作
  • 將非匿名社群憑證 (例如 Facebook 或 Google) 連結至匿名 Apple ID，反之亦然。

詳情請參閱 Apple 開發人員帳戶的《Apple Developer Program 授權協議》。

將 Apple 設為提供者

如要將 Apple 設定為識別資訊提供者，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「Identity Providers」(身分識別提供者) 頁面。

    前往「Identity Providers」頁面

  2. 按一下「新增提供者」。

  3. 從清單中選取「Apple」。

  4. 在「平台」下方，選取「Android」。

  5. 輸入「服務 ID」、「Apple 團隊 ID」、「金鑰 ID」和「私密金鑰」。

  6. 按一下「已授權網域」下方的「新增網域」，註冊應用程式的網域。為方便開發，localhost 預設為啟用狀態。

  7. 在「設定應用程式」下方，按一下「Android」。將程式碼片段複製到應用程式的程式碼中，初始化 Identity Platform 用戶端 SDK。

  8. 按一下 [儲存]。

透過用戶端 SDK 登入使用者

  1. 使用 ID apple.com 建立 OAuthProvider 提供者物件的執行個體：

    Java 

    OAuthProvider.Builder provider = OAuthProvider.newBuilder("apple.com");

    Kotlin 

    val provider = OAuthProvider.newBuilder("apple.com")

  2. 選用：新增 OAuth 範圍。範圍會指定您向 Apple 要求的資料。如果資料較為敏感，可能需要特定範圍。根據預設，啟用「每個電子郵件地址只能建立一個帳戶」後，Identity Platform 會要求 email 和 name 範圍。

    Java 

    List<String> scopes =
    new ArrayList<String>() {
      {
        add("email");
        add("name");
      }
    };
provider.setScopes(scopes);

    Kotlin 

    provider.setScopes(arrayOf("email", "name"))

  3. 選用：將驗證流程在地化。你可以指定語言，或使用裝置的預設語言：

    Java 

    // Localize the Apple authentication screen in French.
provider.addCustomParameter("locale", "fr");

    Kotlin 

    // Localize the Apple authentication screen in French.
provider.addCustomParameter("locale", "fr");

  4. 使用 Identity Platform 登入使用者帳戶。

    1. 呼叫 startActivityForSignInWithProvider()，檢查是否已有回應：

      Java 

      mAuth = FirebaseAuth.getInstance();
Task<AuthResult> pending = mAuth.getPendingAuthResult();
if (pending != null) {
    pending.addOnSuccessListener(new OnSuccessListener<AuthResult>() {
        @Override
        public void onSuccess(AuthResult authResult) {
            Log.d(TAG, "checkPending:onSuccess:" + authResult);
            // Get the user profile with authResult.getUser() and
            // authResult.getAdditionalUserInfo(), and the ID
            // token from Apple with authResult.getCredential().
        }
    }).addOnFailureListener(new OnFailureListener() {
        @Override
        public void onFailure(@NonNull Exception e) {
            Log.w(TAG, "checkPending:onFailure", e);
        }
    });
} else {
    Log.d(TAG, "pending: null");
}

      Kotlin 

      val pending = auth.pendingAuthResult
if (pending != null) {
    pending.addOnSuccessListener { authResult ->
        Log.d(