Android डिवाइस के लिए लिंक किए गए खाते से साइन इन करना

लिंक किए गए खाते से साइन इन करने की सुविधा, उन उपयोगकर्ताओं के लिए Google खाते से एक टैप में साइन इन करने की सुविधा चालू करती है जिनका Google खाता आपकी सेवा से पहले से लिंक है. इससे उपयोगकर्ताओं को बेहतर अनुभव मिलता है, क्योंकि वे अपना उपयोगकर्ता नाम और पासवर्ड फिर से डाले बिना, एक क्लिक में साइन इन कर सकते हैं. इससे, आपकी सेवा पर उपयोगकर्ताओं के डुप्लीकेट खाते बनाने की संभावना भी कम हो जाती है.

लिंक किए गए खाते से साइन-इन करने की सुविधा, Android के लिए One Tap साइन इन फ़्लो के हिस्से के तौर पर उपलब्ध है. इसका मतलब है कि अगर आपके ऐप्लिकेशन में पहले से ही One Tap की सुविधा चालू है, तो आपको अलग से कोई लाइब्रेरी इंपोर्ट करने की ज़रूरत नहीं है.

इस दस्तावेज़ में, आपको अपने Android ऐप्लिकेशन में बदलाव करने का तरीका बताया गया है, ताकि लिंक किए गए खाते से साइन-इन करने की सुविधा काम कर सके.

यह कैसे काम करता है

  1. आपने वन टैप साइन-इन के दौरान, लिंक किए गए खाते दिखाने के लिए ऑप्ट इन किया हो.
  2. अगर उपयोगकर्ता ने Google पर साइन इन किया है और अपने Google खाते को आपकी सेवा पर मौजूद अपने खाते से लिंक किया है, तो लिंक किए गए खाते के लिए एक आईडी टोकन दिखाया जाएगा.
  3. उपयोगकर्ता को One Tap साइन-इन प्रॉम्प्ट दिखाया जाता है. इसमें, लिंक किए गए खाते से आपकी सेवा में साइन इन करने का विकल्प होता है.
  4. अगर उपयोगकर्ता, लिंक किए गए खाते का इस्तेमाल जारी रखने का विकल्प चुनता है, तो उपयोगकर्ता का आईडी टोकन आपके ऐप्लिकेशन को वापस भेज दिया जाता है. इस टोकन को उस टोकन से मैच करें जो दूसरे चरण में आपके सर्वर पर भेजा गया था. इससे, लॉग इन किए हुए उपयोगकर्ता की पहचान की जा सकेगी.

सेटअप

लिंक किए गए खाते से साइन-इन करने की सुविधा सेट अप करने के लिए, अपना डेवलपमेंट एनवायरमेंट और ऐप्लिकेशन कॉन्फ़िगर करें.

अपना डेवलपमेंट एनवायरमेंट सेट अप करना

अपने डेवलपमेंट होस्ट पर Google Play services का नया वर्शन पाने के लिए:

  1. Android SDK Manager खोलें.

  1. एसडीके टूल में जाकर, Google Play services ढूंढें.

  2. अगर इन पैकेज का स्टेटस 'इंस्टॉल नहीं किया गया' है, तो दोनों को चुनें और Install Packages पर क्लिक करें.

अपना ऐप्लिकेशन कॉन्फ़िगर करना

  1. अपने प्रोजेक्ट-लेवल की build.gradle फ़ाइल में, buildscript और allprojects, दोनों सेक्शन में Google की Maven रिपॉज़िटरी को शामिल करें.

    buildscript {
    repositories {
        google()
    }
}

allprojects {
    repositories {
        google()
    }
}

  2. अपने मॉड्यूल की ऐप्लिकेशन-लेवल की gradle फ़ाइल में, "Google से लिंक करें" एपीआई के लिए डिपेंडेंसी जोड़ें. आम तौर पर, यह फ़ाइल app/build.gradle होती है:

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

लिंक किए गए खाते से साइन इन करने की सुविधा देने के लिए, अपने Android ऐप्लिकेशन में बदलाव करना

लिंक किए गए खाते से साइन-इन करने की प्रोसेस के आखिर में, आपके ऐप्लिकेशन को एक आईडी टोकन मिलता है. उपयोगकर्ता को साइन इन कराने से पहले, आईडी टोकन की पुष्टि की जानी चाहिए.

यहां दिए गए कोड सैंपल में, आईडी टोकन को वापस पाने, उसकी पुष्टि करने, और उपयोगकर्ता को साइन इन कराने का तरीका बताया गया है.

  1. साइन-इन इंटेंट का नतीजा पाने के लिए, कोई गतिविधि बनाएं

    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. साइन-इन करने के लिए पेंडिंग इंटेंट लॉन्च करना

    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 आईडी टोकन की पुष्टि करने के लिए, Java 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.");
  }

GoogleIdTokenVerifier.verify() मेथड, JWT सिग्नेचर, aud क्लेम, iss क्लेम, और exp क्लेम की पुष्टि करता है.

अगर आपको यह पुष्टि करनी है कि आईडी टोकन, Google Workspace या Cloud संगठन के खाते से जुड़ा है, तो hd दावे की पुष्टि की जा सकती है. इसके लिए, Payload.getHostedDomain() तरीके से मिले डोमेन नेम की जांच करें.