כניסה לחשבון מקושר עבור Android

התכונה "כניסה באמצעות חשבון מקושר" מאפשרת כניסה באמצעות חשבון Google בלחיצה אחת למשתמשים שכבר ביצעו קישור של חשבון Google לשירות שלכם. כך המשתמשים יכולים להיכנס לחשבון בלחיצה אחת, בלי להזין מחדש את שם המשתמש והסיסמה, וליהנות מחוויית שימוש משופרת. הוא גם מקטין את הסיכוי שמשתמשים ייצרו חשבונות כפולים בשירות שלכם.

הכניסה לחשבון מקושר זמינה כחלק מתהליך הכניסה בלחיצה אחת ב-Android. כלומר, אם כבר הפעלתם באפליקציה את התכונה "כניסה בקליק אחד", אתם לא צריכים לייבא ספרייה נפרדת.

במסמך הזה נסביר איך לשנות את אפליקציית Android כדי לתמוך בכניסה באמצעות חשבון מקושר.

איך זה עובד

1. אתם מביעים הסכמה להצגת חשבונות מקושרים במהלך תהליך הכניסה בלחיצה אחת.
2. אם המשתמש מחובר ל-Google וקישר את חשבון Google שלו לחשבון בשירות שלכם, יוחזר טוקן של מזהה לחשבון המקושר.
3. למשתמש מוצגת הנחיה לכניסה בלחיצה אחת, עם אפשרות להיכנס לשירות שלכם באמצעות החשבון המקושר.
4. אם המשתמש בוחר להמשיך עם החשבון המקושר, הטוקן של המזהה של המשתמש מוחזר לאפליקציה. אתם מתאימים אותו לטוקן שנשלח לשרת שלכם בשלב 2 כדי לזהות את המשתמש המחובר.

הגדרה

כדי להגדיר כניסה באמצעות חשבון מקושר, צריך להגדיר את סביבת הפיתוח ואת האפליקציה.

הגדרת סביבת הפיתוח

מורידים את הגרסה העדכנית של Google Play Services למארח הפיתוח:

1. פותחים את Android SDK Manager.

1. בקטע SDK Tools, מחפשים את Google Play Services.

2. אם הסטטוס של החבילות האלה הוא לא Installed, בוחרים את שתיהן ולוחצים על Install Packages.

הגדרת האפליקציה

1. בקובץ build.gradle ברמת הפרויקט, צריך לכלול את מאגר ה-Maven של Google בקטעים buildscript ו-allprojects.

   buildscript {
       repositories {
           google()
       }
   }
   
   allprojects {
       repositories {
           google()
       }
   }
   

2. מוסיפים את יחסי התלות של Link with Google API לקובץ Gradle ברמת האפליקציה של המודול, שבדרך כלל נמצא ב-app/build.gradle:

   dependencies {
     implementation 'com.google.android.gms:play-services-auth:21.3.0'
   }
   

שינוי אפליקציית Android כדי לתמוך בכניסה לחשבון מקושר

בסוף תהליך הכניסה לחשבון המקושר, האפליקציה מקבלת טוקן של מזהה. לפני שהמשתמש נכנס לחשבון, צריך לאמת את התקינות של הטוקן של המזהה.

בדוגמת הקוד הבאה מפורטים השלבים לאחזור, אימות של טוקן המזהה ולאחר מכן כניסה של המשתמש.

1. יוצרים פעילות כדי לקבל את התוצאה של ה-intent של הכניסה.

   Kotlin

     private val activityResultLauncher = registerForActivityResult(
       ActivityResultContracts.StartIntentSenderForResult()) { result ->
       if (result.resultCode == RESULT_OK) {
         try {
           val signInCredentials = Identity.signInClient(this)
                                   .signInCredentialFromIntent(result.data)
           // Review the Verify the integrity of the ID token section for
           // details on how to verify the ID token
           verifyIdToken(signInCredential.googleIdToken)
         } catch (e: ApiException) {
           Log.e(TAG, "Sign-in failed with error code:", e)
         }
       } else {
         Log.e(TAG, "Sign-in failed")
       }
     }
   

   Java

     private final ActivityResultLauncher<IntentSenderResult>
       activityResultLauncher = registerForActivityResult(
       new ActivityResultContracts.StartIntentSenderForResult(),
       result -> {
       If (result.getResultCode() == RESULT_OK) {
           try {
             SignInCredential signInCredential = Identity.getSignInClient(this)
                            .getSignInCredentialFromIntent(result.getData());
             verifyIdToken(signInCredential.getGoogleIdToken());
           } catch (e: ApiException ) {
             Log.e(TAG, "Sign-in failed with error:", e)
           }
       } else {
           Log.e(TAG, "Sign-in failed")
       }
   });
   

2. יצירת בקשת הכניסה

   Kotlin

   private val tokenRequestOptions =
   GoogleIdTokenRequestOptions.Builder()
     .supported(true)
     // Your server's client ID, not your Android client ID.
     .serverClientId(getString("your-server-client-id")
     .filterByAuthorizedAccounts(true)
     .associateLinkedAccounts("service-id-of-and-defined-by-developer",
                              scopes)
     .build()
   

   Java

    private final GoogleIdTokenRequestOptions tokenRequestOptions =
        GoogleIdTokenRequestOptions.Builder()
     .setSupported(true)
     .setServerClientId("your-service-client-id")
     .setFilterByAuthorizedAccounts(true)
     .associateLinkedAccounts("service-id-of-and-defined-by-developer",
                               scopes)
     .build()
   

3. הפעלת ה-intent "בהמתנה לכניסה"

   Kotlin

    Identity.signInClient(this)
       .beginSignIn(
     BeginSignInRequest.Builder()
       .googleIdTokenRequestOptions(tokenRequestOptions)
     .build())
       .addOnSuccessListener{result ->
         activityResultLauncher.launch(result.pendingIntent.intentSender)
     }
     .addOnFailureListener {e ->
       Log.e(TAG, "Sign-in failed because:", e)
     }
   

   Java

    Identity.getSignInClient(this)
     .beginSignIn(
       BeginSignInRequest.Builder()
         .setGoogleIdTokenRequestOptions(tokenRequestOptions)
         .build())
     .addOnSuccessListener(result -> {
       activityResultLauncher.launch(
           result.getPendingIntent().getIntentSender());
   })
   .addOnFailureListener(e -> {
     Log.e(TAG, "Sign-in failed because:", e);
   });
   

אימות התקינות של טוקן המזהה

שימוש בספריית לקוח של Google API

הדרך המומלצת לאמת אסימוני מזהה של Google בסביבת ייצור היא באמצעות ספריית הלקוח של Google API ל-Java.

  import com.google.api.client.googleapis.auth.oauth2.GoogleIdToken;
  import com.google.api.client.googleapis.auth.oauth2.GoogleIdToken.Payload;
  import com.google.api.client.googleapis.auth.oauth2.GoogleIdTokenVerifier;

  ...

  GoogleIdTokenVerifier verifier = new GoogleIdTokenVerifier.Builder(transport, jsonFactory)
      // Specify the CLIENT_ID of the app that accesses the backend:
      .setAudience(Collections.singletonList(CLIENT_ID))
      // Or, if multiple clients access the backend:
      //.setAudience(Arrays.asList(CLIENT_ID_1, CLIENT_ID_2, CLIENT_ID_3))
      .build();

  // (Receive idTokenString by HTTPS POST)

  GoogleIdToken idToken = verifier.verify(idTokenString);
  if (idToken != null) {
    Payload payload = idToken.getPayload();

    // Print user identifier
    String userId = payload.getSubject();
    System.out.println("User ID: " + userId);

    // Get profile information from payload
    String email = payload.getEmail();
    boolean emailVerified = Boolean.valueOf(payload.getEmailVerified());
    String name = (String) payload.get("name");
    String pictureUrl = (String) payload.get("picture");
    String locale = (String) payload.get("locale");
    String familyName = (String) payload.get("family_name");
    String givenName = (String) payload.get("given_name");

    // Use or store profile information
    // ...

  } else {
    System.out.println("Invalid ID token.");
  }

ה-method‏ GoogleIdTokenVerifier.verify() מאמתת את החתימה של ה-JWT, את ההצהרה aud, את ההצהרה iss ואת ההצהרה exp.

אם אתם צריכים לאמת שאסימון המזהה מייצג חשבון של ארגון ב-Google Workspace או ב-Cloud, אתם יכולים לאמת את ההצהרה hd על ידי בדיקת שם הדומיין שמוחזר על ידי השיטה Payload.getHostedDomain().