फ़ेडरेटेड आइडेंटिटी और सोशल साइन-इन

सोशल ऑथेंटिकेशन, पुष्टि करने का एक ऐसा तरीका है जिसमें कई चरण होते हैं. इसकी मदद से, किसी उपयोगकर्ता को किसी खाते में साइन इन कराया जा सकता है या उसे किसी मौजूदा खाते से लिंक किया जा सकता है.

नेटिव प्लैटफ़ॉर्म और वेब, दोनों ही क्रेडेंशियल बनाने की सुविधा देते हैं. इसके बाद, क्रेडेंशियल को signInWithCredential या linkWithCredential तरीकों में पास किया जा सकता है. इसके अलावा, वेब प्लैटफ़ॉर्म पर, पुष्टि करने की प्रोसेस को पॉप-अप या रीडायरेक्ट के ज़रिए ट्रिगर किया जा सकता है.

Google

Firebase के साथ Google Sign-In का इस्तेमाल करते समय, ज़्यादातर कॉन्फ़िगरेशन पहले से सेट अप होते हैं. हालांकि, आपको यह पक्का करना होगा कि आपकी मशीन की SHA1 कुंजी को Android के साथ इस्तेमाल करने के लिए कॉन्फ़िगर किया गया हो. पुष्टि करने से जुड़े दस्तावेज़ में, कुंजी जनरेट करने का तरीका देखा जा सकता है.

पक्का करें कि Firebase कंसोल पर, "Google" साइन-इन प्रोवाइडर चालू हो.

अगर आपका उपयोगकर्ता, पहले से मैन्युअल तरीके से खाता रजिस्टर करने के बाद, Google से साइन इन करता है, तो पुष्टि करने वाली सेवा देने वाली कंपनी अपने-आप Google पर बदल जाएगी. ऐसा, भरोसेमंद सेवा देने वाली कंपनियों के Firebase Authentication के कॉन्सेप्ट की वजह से होगा. इस बारे में ज़्यादा जानने के लिए, यहां जाएं.

iOS+ और Android

नेटिव प्लैटफ़ॉर्म पर, पुष्टि करने के फ़्लो को ट्रिगर करने के लिए, तीसरे पक्ष की लाइब्रेरी की ज़रूरत होती है.

आधिकारिक google_sign_in प्लग इन इंस्टॉल करें.

इंस्टॉल होने के बाद, साइन-इन फ़्लो को ट्रिगर करें और नया क्रेडेंशियल बनाएं:

import 'package:google_sign_in/google_sign_in.dart';

Future<UserCredential> signInWithGoogle() async {
  // Trigger the authentication flow
  final GoogleSignInAccount? googleUser = await GoogleSignIn().signIn();

  // Obtain the auth details from the request
  final GoogleSignInAuthentication? googleAuth = await googleUser?.authentication;

  // Create a new credential
  final credential = GoogleAuthProvider.credential(
    accessToken: googleAuth?.accessToken,
    idToken: googleAuth?.idToken,
  );

  // Once signed in, return the UserCredential
  return await FirebaseAuth.instance.signInWithCredential(credential);
}

वेब

वेब पर, Firebase SDK टूल आपके Firebase प्रोजेक्ट का इस्तेमाल करके, पुष्टि करने के फ़्लो को अपने-आप मैनेज करने की सुविधा देता है. उदाहरण के लिए:

Google का ऑथराइज़ेशन प्रोवाइडर बनाएं और उपयोगकर्ता से वह अनुमति का दायरा मांगें जो आपको चाहिए:

GoogleAuthProvider googleProvider = GoogleAuthProvider();

googleProvider.addScope('https://www.googleapis.com/auth/contacts.readonly');
googleProvider.setCustomParameters({
  'login_hint': '[e-mail]'
});

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

Future<UserCredential> signInWithGoogle() async {
  // Create a new provider
  GoogleAuthProvider googleProvider = GoogleAuthProvider();

  googleProvider.addScope('https://www.googleapis.com/auth/contacts.readonly');
  googleProvider.setCustomParameters({
    'login_hint': '[e-mail]'
  });

  // Once signed in, return the UserCredential
  return await FirebaseAuth.instance.signInWithPopup(googleProvider);

  // Or use signInWithRedirect
  // return await FirebaseAuth.instance.signInWithRedirect(googleProvider);
}

Google Play Games (सिर्फ़ Android के लिए)

पक्का करें कि Firebase कंसोल पर, "Play Games" साइन-इन प्रोवाइडर चालू हो. Play Games के Firebase प्रोजेक्ट को सेट अप करने के लिए, इन निर्देशों का पालन करें.

अपने Firebase ऐप्लिकेशन के साथ, Play Games की सेवाओं को कॉन्फ़िगर करने के लिए इन निर्देशों का पालन करें.

Android

Future<void> _signInWithPlayGames() async {
  // Get server auth code from 3rd party provider
  // See PR description for details on how you might get the server auth code:
  // https://github.com/firebase/flutterfire/pull/12201#issue-2100392487
  final serverAuthCode = '...';
  final playGamesCredential = PlayGamesAuthProvider.credential(
                                          serverAuthCode: serverAuthCode);

  await FirebaseAuth.instance
    .signInWithCredential(playGamesCredential);
}

Facebook

शुरू करने से पहले, अपना Facebook डेवलपर ऐप्लिकेशन सेटअप करें. इसके बाद, Facebook Login की सुविधा चालू करने के लिए सेटअप की प्रोसेस को पूरा करें.

पक्का करें कि Firebase Console पर, "Facebook" साइन-इन प्रोवाइडर चालू हो. साथ ही, Facebook ऐप्लिकेशन आईडी और सेक्रेट सेट हो.

iOS+ और Android

नेटिव प्लैटफ़ॉर्म पर, Facebook SDK टूल को इंस्टॉल करने और पुष्टि करने के फ़्लो को ट्रिगर करने के लिए, तीसरे पक्ष की लाइब्रेरी की ज़रूरत होती है.

flutter_facebook_auth प्लग इन इंस्टॉल करें.

आपको प्लग इन के दस्तावेज़ में दिए गए निर्देशों का पालन करना होगा, ताकि यह पक्का किया जा सके कि Android और iOS, दोनों के लिए Facebook SDK टूल सही तरीके से शुरू हो गए हैं. इसके बाद, साइन-इन फ़्लो को ट्रिगर करें, Facebook क्रेडेंशियल बनाएं, और उपयोगकर्ता को साइन इन कराएं:

import 'package:flutter_facebook_auth/flutter_facebook_auth.dart';

Future<UserCredential> signInWithFacebook() async {
  // Trigger the sign-in flow
  final LoginResult loginResult = await FacebookAuth.instance.login();

  // Create a credential from the access token
  final OAuthCredential facebookAuthCredential = FacebookAuthProvider.credential(loginResult.accessToken.token);

  // Once signed in, return the UserCredential
  return FirebaseAuth.instance.signInWithCredential(facebookAuthCredential);
}

वेब

वेब पर, Firebase SDK टूल, पुष्टि करने के फ़्लो को अपने-आप मैनेज करने की सुविधा देता है. इसके लिए, Firebase कंसोल पर दी गई Facebook ऐप्लिकेशन की जानकारी का इस्तेमाल किया जाता है. उदाहरण के लिए:

Facebook प्रोवाइडर बनाएं और उपयोगकर्ता से वह अनुमति का दायरा तय करें जिसे आपको चाहिए.

पक्का करें कि Firebase कंसोल से लिया गया OAuth रीडायरेक्ट यूआरआई, आपके Facebook ऐप्लिकेशन में मान्य OAuth रीडायरेक्ट यूआरआई के तौर पर जोड़ा गया हो.

FacebookAuthProvider facebookProvider = FacebookAuthProvider();

facebookProvider.addScope('email');
facebookProvider.setCustomParameters({
  'display': 'popup',
});

signInWithPopup तरीके के लिए क्रेडेंशियल दें. इससे एक नई विंडो खुलेगी, जिसमें उपयोगकर्ता को आपके Facebook ऐप्लिकेशन में साइन-इन करने के लिए कहा जाएगा:

Future<UserCredential> signInWithFacebook() async {
  // Create a new provider
  FacebookAuthProvider facebookProvider = FacebookAuthProvider();

  facebookProvider.addScope('email');
  facebookProvider.setCustomParameters({
    'display': 'popup',
  });

  // Once signed in, return the UserCredential
  return await FirebaseAuth.instance.signInWithPopup(facebookProvider);

  // Or use signInWithRedirect
  // return await FirebaseAuth.instance.signInWithRedirect(facebookProvider);
}

ध्यान दें: अगर आपका उपयोगकर्ता Facebook से लॉग इन करता है, तो Firebase User.isEmailVerified प्रॉपर्टी को true पर सेट नहीं करेगा. अगर आपका उपयोगकर्ता, ईमेल की पुष्टि करने वाली किसी सेवा (जैसे, Google साइन इन) का इस्तेमाल करके लॉगिन करता है, तो यह 'सही' पर सेट हो जाएगा. ज़्यादा जानकारी के लिए, यह समस्या देखें.

Apple

iOS+

शुरू करने से पहले, 'Apple से साइन इन करें' सुविधा को कॉन्फ़िगर करें और Apple को साइन-इन करने की सुविधा देने वाली कंपनी के तौर पर चालू करें.

इसके बाद, पक्का करें कि आपके Runner ऐप्लिकेशन में "Apple से साइन इन करें" सुविधा काम करती हो.

Android

शुरू करने से पहले, 'Apple से साइन इन करें' सुविधा को कॉन्फ़िगर करें और Apple को साइन-इन करने की सुविधा देने वाली कंपनी के तौर पर चालू करें.

वेब

शुरू करने से पहले, 'Apple से साइन इन करें' सुविधा को कॉन्फ़िगर करें और Apple को साइन-इन करने की सुविधा देने वाली कंपनी के तौर पर चालू करें.

import 'package:firebase_auth/firebase_auth.dart';

Future<UserCredential> signInWithApple() async {
  final appleProvider = AppleAuthProvider();
  if (kIsWeb) {
    await FirebaseAuth.instance.signInWithPopup(appleProvider);
  } else {
    await FirebaseAuth.instance.signInWithProvider(appleProvider);
  }
}

सिर्फ़ Apple प्लैटफ़ॉर्म पर साइन इन करने की सुविधा

iOS+ प्लैटफ़ॉर्म पर Apple से साइन इन करने के लिए, यह तरीका भी अपनाया जा सकता है:

// Implement a function that generates a nonce. See iOS documentation for how to create a nonce:
// https://firebase.google.com/docs/auth/ios/apple#sign_in_with_apple_and_authenticate_with_firebase
String rawNonce = createNonce();
// Create a SHA-256 hash of the nonce. Consider using the `crypto` package from the pub.dev registry.
String hashSHA256String = createHashSHA256String(rawNonce);
// Use the hash of the nonce to get the idToken. Consider using the `sign_in_with_apple` plugin from the pub.dev registry.
String idToken = await getIdToken();

final fullName = AppleFullPersonName(
  familyName: 'Name',
  givenName: 'Your',
);
// Use the `rawNonce` and `idToken` to get the credential
final credential = AppleAuthProvider.credentialWithIDToken(
  idToken,
  rawNonce,
  fullName,
);

await FirebaseAuth.instance.signInWithCredential(credential);

Apple के पुष्टि करने वाले टोकन रद्द करना

Apple के प्लैटफ़ॉर्म पर Apple साइन-इन करने पर, एक ऑथराइज़ेशन कोड मिलता है. इसका इस्तेमाल, revokeTokenWithAuthorizationCode() एपीआई का इस्तेमाल करके, Apple के ऑथराइज़ेशन टोकन को रद्द करने के लिए किया जा सकता है.

import 'package:firebase_auth/firebase_auth.dart';

Future<UserCredential> signInWithApple() async {
  final appleProvider = AppleAuthProvider();

  UserCredential userCredential = await FirebaseAuth.instance.signInWithPopup(appleProvider);
  // Keep the authorization code returned from Apple platforms
  String? authCode = userCredential.additionalUserInfo?.authorizationCode;
  // Revoke Apple auth token
  await FirebaseAuth.instance.revokeTokenWithAuthorizationCode(authCode!);
}

Apple Game Center (सिर्फ़ Apple डिवाइसों के लिए)

पक्का करें कि Firebase कंसोल पर, साइन इन करने के लिए "Game Center" की सुविधा चालू हो. Game Center Firebase प्रोजेक्ट सेट-अप करने के लिए, इन निर्देशों का पालन करें.

Firebase Game Center क्रेडेंशियल जारी करने और Firebase से लॉग इन करने से पहले, आपको Game Center से लॉगिन करना होगा. ऐसा करने के तरीके के बारे में यहां कुछ निर्देश दिए गए हैं.

iOS+

Future<void> _signInWithGameCenter() async {
  final credential = GameCenterAuthProvider.credential();
  await FirebaseAuth.instance
      .signInWithCredential(credential);
}

Microsoft

iOS+

iOS के लिए Microsoft Login को कॉन्फ़िगर करने और अपने Runner में कस्टम यूआरएल स्कीम जोड़ने (पहला चरण) से पहले, यह तरीका अपनाएं.

Android

शुरू करने से पहले, Android के लिए Microsoft Login को कॉन्फ़िगर करें.

अपने ऐप्लिकेशन का SHA-1 फ़िंगरप्रिंट जोड़ना न भूलें.

वेब

शुरू करने से पहले, Microsoft Login for Web को कॉन्फ़िगर करें.

import 'package:firebase_auth/firebase_auth.dart';

Future<UserCredential> signInWithMicrosoft() async {
  final microsoftProvider = MicrosoftAuthProvider();
  if (kIsWeb) {
    await FirebaseAuth.instance.signInWithPopup(microsoftProvider);
  } else {
    await FirebaseAuth.instance.signInWithProvider(microsoftProvider);
  }
}

Twitter

पक्का करें कि Firebase Console पर, "Twitter" साइन-इन प्रोवाइडर चालू हो. साथ ही, एपीआई पासकोड और एपीआई पासकोड के लिए सेट किया गया पासवर्ड भी चालू हो. पक्का करें कि आपका Firebase OAuth रीडायरेक्ट यूआरआई (उदाहरण के लिए, my-app-12345.firebaseapp.com/__/auth/handler), Twitter ऐप्लिकेशन के कॉन्फ़िगरेशन पर, आपके ऐप्लिकेशन के सेटिंग पेज में अनुमति के लिए कॉलबैक यूआरआई के तौर पर सेट हो.

आपको अपने ऐप्लिकेशन के हिसाब से, एपीआई के ऐक्सेस का अनुरोध भी करना पड़ सकता है.

iOS+

आपको अपने कस्टम यूआरएल स्कीम को iOS गाइड के पहले चरण में बताए गए तरीके के मुताबिक कॉन्फ़िगर करना होगा.

Android

अगर आपने अब तक अपने ऐप्लिकेशन का SHA-1 फ़िंगरप्रिंट नहीं दिया है, तो Firebase कंसोल के सेटिंग पेज पर जाकर ऐसा करें. अपने ऐप्लिकेशन का SHA-1 फ़िंगरप्रिंट पाने के तरीके के बारे में जानने के लिए, अपने क्लाइंट की पुष्टि करना लेख पढ़ें.

वेब

यह बिना किसी सेटअप के काम करता है.

import 'package:firebase_auth/firebase_auth.dart';

Future<void> _signInWithTwitter() async {
  TwitterAuthProvider twitterProvider = TwitterAuthProvider();

  if (kIsWeb) {
    await FirebaseAuth.instance.signInWithPopup(twitterProvider);
  } else {
    await FirebaseAuth.instance.signInWithProvider(twitterProvider);
  }
}

GitHub

पक्का करें कि आपने GitHub डेवलपर सेटिंग से OAuth ऐप्लिकेशन सेट अप किया हो और Firebase कंसोल पर "GitHub" साइन-इन प्रोवाइडर चालू हो. साथ ही, क्लाइंट आईडी और सीक्रेट सेट हो और GitHub ऐप्लिकेशन में कॉलबैक यूआरएल सेट हो.

iOS+ और Android

नेटिव प्लैटफ़ॉर्म के लिए, आपको google-services.json और GoogleService-Info.plist जोड़ने होंगे.

iOS के लिए, कस्टम यूआरएल स्कीम जोड़ें. इसके लिए, iOS गाइड के पहले चरण में बताया गया तरीका अपनाएं.

Future<UserCredential> signInWithGitHub() async {
  // Create a new provider
  GithubAuthProvider githubProvider = GithubAuthProvider();

  return await FirebaseAuth.instance.signInWithProvider(githubProvider);
}

वेब

वेब पर, GitHub SDK टूल, पुष्टि करने के फ़्लो को अपने-आप मैनेज करने की सुविधा देता है. इसके लिए, यह Firebase कंसोल पर दी गई GitHub ऐप्लिकेशन की जानकारी का इस्तेमाल करता है. पक्का करें कि Firebase कंसोल में मौजूद कॉलबैक यूआरएल, डेवलपर कंसोल पर आपके GitHub ऐप्लिकेशन में कॉलबैक यूआरएल के तौर पर जोड़ा गया हो.

उदाहरण के लिए:

GitHub की सेवा देने वाली कंपनी बनाएं और signInWithPopup तरीके के लिए क्रेडेंशियल दें. इससे एक नई विंडो खुलेगी, जिसमें उपयोगकर्ता को आपके GitHub ऐप्लिकेशन में साइन-इन करने के लिए कहा जाएगा:

Future<UserCredential> signInWithGitHub() async {
  // Create a new provider
  GithubAuthProvider githubProvider = GithubAuthProvider();

  // Once signed in, return the UserCredential
  return await FirebaseAuth.instance.signInWithPopup(githubProvider);

  // Or use signInWithRedirect
  // return await FirebaseAuth.instance.signInWithRedirect(githubProvider);
}

Yahoo

पक्का करें कि Firebase कंसोल पर, "Yahoo" साइन-इन प्रोवाइडर चालू हो. साथ ही, एपीआई पासकोड और एपीआई पासकोड सेट किया गया हो. यह भी पक्का करें कि आपका Firebase OAuth रीडायरेक्ट यूआरआई (उदाहरण के लिए, my-app-12345.firebaseapp.com/__/auth/handler), आपके ऐप्लिकेशन के Yahoo Developer Network कॉन्फ़िगरेशन में रीडायरेक्ट यूआरआई के तौर पर सेट हो.

iOS+

शुरू करने से पहले, iOS के लिए Yahoo Login को कॉन्फ़िगर करें और अपने Runner में कस्टम यूआरएल स्कीम जोड़ें (पहला चरण).

Android

शुरू करने से पहले, Android के लिए Yahoo Login को कॉन्फ़िगर करें.

अपने ऐप्लिकेशन का SHA-1 फ़िंगरप्रिंट जोड़ना न भूलें.

वेब

यह बिना किसी सेटअप के काम करता है.

import 'package:firebase_auth/firebase_auth.dart';

Future<UserCredential> signInWithYahoo() async {
  final yahooProvider = YahooAuthProvider();
  if (kIsWeb) {
    await _auth.signInWithPopup(yahooProvider);
  } else {
    await _auth.signInWithProvider(yahooProvider);
  }
}

OAuth ऐक्सेस टोकन का इस्तेमाल करना

AuthProvider का इस्तेमाल करके, यहां दिया गया अनुरोध करके, प्रोवाइडर से जुड़ा ऐक्सेस टोकन पाया जा सकता है.

final appleProvider = AppleAuthProvider();

final user = await FirebaseAuth.instance.signInWithProvider(appleProvider);
final accessToken = user.credential?.accessToken;

// You can send requests with the `accessToken`

पुष्टि करने वाली सेवा देने वाली कंपनी को लिंक करना

अगर आपको किसी मौजूदा उपयोगकर्ता को सेवा देने वाली कंपनी से लिंक करना है, तो यह तरीका अपनाएं:

await FirebaseAuth.instance.signInAnonymously();

final appleProvider = AppleAuthProvider();

if (kIsWeb) {
  await FirebaseAuth.instance.currentUser?.linkWithPopup(appleProvider);

  // You can also use `linkWithRedirect`
} else {
  await FirebaseAuth.instance.currentUser?.linkWithProvider(appleProvider);
}

// You're anonymous user is now upgraded to be able to connect with Sign In With Apple

सेवा देने वाली कंपनी से फिर से पुष्टि करना

इसी पैटर्न का इस्तेमाल reauthenticateWithProvider के साथ किया जा सकता है. इसका इस्तेमाल, संवेदनशील कार्रवाइयों के लिए नए क्रेडेंशियल पाने के लिए किया जा सकता है. इन कार्रवाइयों के लिए, हाल ही में लॉगिन करना ज़रूरी होता है.

final appleProvider = AppleAuthProvider();

if (kIsWeb) {
  await FirebaseAuth.instance.currentUser?.reauthenticateWithPopup(appleProvider);

  // Or you can reauthenticate with a redirection
  // await FirebaseAuth.instance.currentUser?.reauthenticateWithRedirect(appleProvider);
} else {
  await FirebaseAuth.instance.currentUser?.reauthenticateWithProvider(appleProvider);
}

// You can now perform sensitive operations