उपयोगकर्ताओं को प्रबंधित करें

Firebase एडमिन SDK, आपके Firebase Authentication उपयोगकर्ताओं को खास अधिकारों के साथ मैनेज करने के लिए एक एपीआई उपलब्ध कराता है. एडमिन उपयोगकर्ता मैनेजमेंट एपीआई की मदद से, सुरक्षित सर्वर इनवायरनमेंट से ये काम प्रोग्राम के ज़रिए पूरे किए जा सकते हैं:

• बिना किसी थ्रॉटलिंग या दर को सीमित किए नए उपयोगकर्ता बनाएं.
• उपयोगकर्ताओं को अलग-अलग शर्तों, जैसे कि uid, ईमेल या फ़ोन नंबर के आधार पर खोजें.
• किसी खास प्रोजेक्ट के सभी उपयोगकर्ताओं की सूची बैच में दें.
• उपयोगकर्ता का मेटाडेटा ऐक्सेस करें. इसमें खाता बनाने की तारीख और आखिरी बार साइन इन करने की तारीख शामिल है.
• उपयोगकर्ताओं को उनके मौजूदा पासवर्ड की ज़रूरत के बिना मिटाएं.
• उपयोगकर्ता के तौर पर साइन इन किए बिना, उपयोगकर्ता प्रॉपर्टी अपडेट करें. इनमें उपयोगकर्ता का पासवर्ड भी शामिल है.
• ईमेल की पुष्टि करने के लिए, अलग से कार्रवाई करने की ज़रूरत नहीं होती.
• इन बदलावों को रद्द करने के लिए, उपयोगकर्ता को ईमेल लिंक भेजे बिना उसका ईमेल पता बदलें.
• एसएमएस की मदद से पुष्टि किए बिना, फ़ोन नंबर के साथ नया उपयोगकर्ता बनाएं.
• एसएमएस से पुष्टि करने की प्रोसेस के बिना, उपयोगकर्ता का फ़ोन नंबर बदल सकते हैं.
• ऑफ़लाइन प्रावधान को उपयोगकर्ताओं के लिए बंद की गई स्थिति में सेट करें. इसके बाद, बाद में यह कंट्रोल करें कि उन्हें कब चालू किया जाए.
• उपयोगकर्ता के हिसाब से कंसोल बनाएं, जो किसी खास ऐप्लिकेशन के उपयोगकर्ता मैनेजमेंट सिस्टम के हिसाब से हों.

शुरू करने से पहले

Firebase Admin SDK टूल से दिए गए उपयोगकर्ता मैनेजमेंट एपीआई का इस्तेमाल करने के लिए, आपके पास सेवा खाता होना चाहिए. एडमिन SDK टूल को शुरू करने के तरीके के बारे में ज़्यादा जानने के लिए, सेटअप करने के निर्देशों का पालन करें.

उपयोगकर्ता का डेटा वापस पाना

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

Node.js

getAuth()
  .getUser(uid)
  .then((userRecord) => {
    // See the UserRecord reference doc for the contents of userRecord.
    console.log(`Successfully fetched user data: ${userRecord.toJSON()}`);
  })
  .catch((error) => {
    console.log('Error fetching user data:', error);
  });
manage_users.js

Java

UserRecord userRecord = FirebaseAuth.getInstance().getUser(uid);
// See the UserRecord reference doc for the contents of userRecord.
System.out.println("Successfully fetched user data: " + userRecord.getUid());

Python

from firebase_admin import auth

user = auth.get_user(uid)
print('Successfully fetched user data: {0}'.format(user.uid))

शुरू करें

// Get an auth client from the firebase.App
client, err := app.Auth(ctx)
if err != nil {
	log.Fatalf("error getting Auth client: %v\n", err)
}

u, err := client.GetUser(ctx, uid)
if err != nil {
	log.Fatalf("error getting user %s: %v\n", uid, err)
}
log.Printf("Successfully fetched user data: %v\n", u)
auth.go

C#

UserRecord userRecord = await FirebaseAuth.DefaultInstance.GetUserAsync(uid);
// See the UserRecord reference doc for the contents of userRecord.
Console.WriteLine($"Successfully fetched user data: {userRecord.Uid}");

यह तरीका, उपयोगकर्ता के लिए UserRecord ऑब्जेक्ट दिखाता है. यह ऑब्जेक्ट, इस तरीके में दिए गए uid से जुड़ा होता है.

अगर दिया गया uid किसी मौजूदा उपयोगकर्ता का नहीं है या किसी अन्य वजह से उपयोगकर्ता को फ़ेच नहीं किया जा सकता, तो ऊपर दिया गया तरीका गड़बड़ी दिखाता है. गड़बड़ी कोड की पूरी सूची देखने के लिए, एडमिन Auth API की गड़बड़ियां देखें. इसमें गड़बड़ी की जानकारी और उसे ठीक करने का तरीका भी शामिल है.

कुछ मामलों में, आपके पास उपयोगकर्ता के uid के बजाय उसका ईमेल पता होगा. Firebase Admin SDK टूल की मदद से, ईमेल पते से उपयोगकर्ता की जानकारी देखी जा सकती है:

Node.js

getAuth()
  .getUserByEmail(email)
  .then((userRecord) => {
    // See the UserRecord reference doc for the contents of userRecord.
    console.log(`Successfully fetched user data: ${userRecord.toJSON()}`);
  })
  .catch((error) => {
    console.log('Error fetching user data:', error);
  });
manage_users.js

Java

UserRecord userRecord = FirebaseAuth.getInstance().getUserByEmail(email);
// See the UserRecord reference doc for the contents of userRecord.
System.out.println("Successfully fetched user data: " + userRecord.getEmail());

Python

from firebase_admin import auth

user = auth.get_user_by_email(email)
print('Successfully fetched user data: {0}'.format(user.uid))

शुरू करें

u, err := client.GetUserByEmail(ctx, email)
if err != nil {
	log.Fatalf("error getting user by email %s: %v\n", email, err)
}
log.Printf("Successfully fetched user data: %v\n", u)
auth.go

C#

UserRecord userRecord = await FirebaseAuth.DefaultInstance.GetUserByEmailAsync(email);
// See the UserRecord reference doc for the contents of userRecord.
Console.WriteLine($"Successfully fetched user data: {userRecord.Uid}");

यह तरीका, दिए गए ईमेल पते से जुड़े उपयोगकर्ता के लिए UserRecord ऑब्जेक्ट दिखाता है.

अगर दिया गया ईमेल किसी मौजूदा उपयोगकर्ता का नहीं है या किसी अन्य वजह से उपयोगकर्ता को फ़ेच नहीं किया जा सकता, तो Admin SDK गड़बड़ी का मैसेज दिखाता है. गड़बड़ी के कोड की पूरी सूची देखने के लिए, एडमिन Authentication एपीआई की गड़बड़ियां देखें. इस सूची में, गड़बड़ी का ब्यौरा और उसे ठीक करने के तरीके भी बताए गए हैं.

चेतावनी: ईमेल लुकअप के लिए, सिर्फ़ मुख्य (टॉप लेवल) ईमेल खोजा जा सकता है. इसके अलावा, ईमेल सेवा देने वाली कंपनी के ईमेल नहीं खोजे जा सकते. उदाहरण के लिए, अगर किसी अलग ईमेल [e-mail] वाले Facebook खाते को, ईमेल [e-mail] वाले किसी मौजूदा उपयोगकर्ता से लिंक किया गया है, तो getUserByEmail("[e-mail]") को कॉल करने पर कोई नतीजा नहीं मिलेगा. हालांकि, getUserByEmail("[e-mail]") से कॉल करने पर, आपको वह उपयोगकर्ता दिखेगा. डिफ़ॉल्ट "हर ईमेल के लिए एक खाता" सेटिंग के मामले में, साइन इन करने के लिए इस्तेमाल किए गए पहले ईमेल पते का इस्तेमाल, टॉप लेवल ईमेल पते के तौर पर किया जाएगा. ऐसा तब तक होगा, जब तक उसमें बदलाव नहीं किया जाता. जब "हर ईमेल के लिए एक से ज़्यादा खाते" सेट होता है, तो मुख्य ईमेल सिर्फ़ तब सेट होता है, जब कोई उपयोगकर्ता पासवर्ड बनाया जाता है. ऐसा तब तक होता है, जब तक कि उपयोगकर्ता को मैन्युअल तरीके से अपडेट न किया जाए.

अन्य मामलों में, आपके पास उपयोगकर्ता के uid के बजाय उसका फ़ोन नंबर होगा. Firebase एडमिन SDK टूल की मदद से, फ़ोन नंबर की मदद से उपयोगकर्ता की जानकारी खोजी जा सकती है:

Node.js

getAuth()
  .getUserByPhoneNumber(phoneNumber)
  .then((userRecord) => {
    // See the UserRecord reference doc for the contents of userRecord.
    console.log(`Successfully fetched user data:  ${userRecord.toJSON()}`);
  })
  .catch((error) => {
    console.log('Error fetching user data:', error);
  });
manage_users.js

Java

UserRecord userRecord = FirebaseAuth.getInstance().getUserByPhoneNumber(phoneNumber);
// See the UserRecord reference doc for the contents of userRecord.
System.out.println("Successfully fetched user data: " + userRecord.getPhoneNumber());

Python

from firebase_admin import auth

user = auth.get_user_by_phone_number(phone)
print('Successfully fetched user data: {0}'.format(user.uid))

शुरू करें

u, err := client.GetUserByPhoneNumber(ctx, phone)
if err != nil {
	log.Fatalf("error getting user by phone %s: %v\n", phone, err)
}
log.Printf("Successfully fetched user data: %v\n", u)
auth.go

C#

UserRecord userRecord = await FirebaseAuth.DefaultInstance.GetUserByPhoneNumberAsync(phoneNumber);
// See the UserRecord reference doc for the contents of userRecord.
Console.WriteLine($"Successfully fetched user data: {userRecord.Uid}");

इस तरीके से, दिए गए फ़ोन नंबर से जुड़े उपयोगकर्ता के लिए UserRecord ऑब्जेक्ट लौटाता है.

अगर दिया गया फ़ोन नंबर किसी मौजूदा उपयोगकर्ता का नहीं है या किसी और वजह से उपयोगकर्ता को फ़ेच नहीं किया जा सकता, तो Admin SDK टूल गड़बड़ी का मैसेज दिखाता है. गड़बड़ी के कोड की पूरी सूची देखने के लिए, एडमिन Authentication एपीआई की गड़बड़ियां देखें. इस सूची में, गड़बड़ी का ब्यौरा और उसे ठीक करने के तरीके भी बताए गए हैं.

उपयोगकर्ता का डेटा एक साथ वापस पाना

Firebase Admin SDK टूल की मदद से, आपके दिए गए आइडेंटिफ़ायर के आधार पर उपयोगकर्ताओं की सूची भी वापस पाई जा सकती है. उपयोगकर्ताओं की पहचान उनके यूज़र आईडी, ईमेल या फ़ोन नंबर से की जा सकती है. एक बार में ज़्यादा से ज़्यादा 100 आइडेंटिफ़ायर दिए जा सकते हैं. आइडेंटिफ़ायर में अलग-अलग तरह के आइटम शामिल हो सकते हैं:

Node.js

getAuth()
  .getUsers([
    { uid: 'uid1' },
    { email: '[e-mail]' },
    { phoneNumber: '[phone]' },
    { providerId: 'google.com', providerUid: 'google_uid4' },
  ])
  .then((getUsersResult) => {
    console.log('Successfully fetched user data:');
    getUsersResult.users.forEach((userRecord) => {
      console.log(userRecord);
    });

    console.log('Unable to find users corresponding to these identifiers:');
    getUsersResult.notFound.forEach((userIdentifier) => {
      console.log(userIdentifier);
    });
  })
  .catch((error) => {
    console.log('Error fetching user data:', error);
  });
manage_users.js

Java

GetUsersResult result = FirebaseAuth.getInstance().getUsersAsync(Arrays.asList(
    new UidIdentifier("uid1"),
    new EmailIdentifier("[e-mail]"),
    new PhoneIdentifier("[phone]"),
    new ProviderIdentifier("google.com", "google_uid4"))).get();

System.out.println("Successfully fetched user data:");
for (UserRecord user : result.getUsers()) {
  System.out.println(user.getUid());
}

System.out.println("Unable to find users corresponding to these identifiers:");
for (UserIdentifier uid : result.getNotFound()) {
  System.out.println(uid);
}

Python

from firebase_admin import auth

result = auth.get_users([
    auth.UidIdentifier('uid1'),
    auth.EmailIdentifier('[e-mail]'),
    auth.PhoneIdentifier([phone]),
    auth.ProviderIdentifier('google.com', 'google_uid4')
])

print('Successfully fetched user data:')
for user in result.users:
    print(user.uid)

print('Unable to find users corresponding to these identifiers:')
for uid in result.not_found:
    print(uid)

शुरू करें

getUsersResult, err := client.GetUsers(ctx, []auth.UserIdentifier{
	auth.UIDIdentifier{UID: "uid1"},
	auth.EmailIdentifier{Email: "[e-mail]"},
	auth.PhoneIdentifier{PhoneNumber: "[phone]"},
	auth.ProviderIdentifier{ProviderID: "google.com", ProviderUID: "google_uid1"},
})
if err != nil {
	log.Fatalf("error retriving multiple users: %v\n", err)
}

log.Printf("Successfully fetched user data:")
for _, u := range getUsersResult.Users {
	log.Printf("%v", u)
}

log.Printf("Unable to find users corresponding to these identifiers:")
for _, id := range getUsersResult.NotFound {
	log.Printf("%v", id)
}

C#

GetUsersResult result = await FirebaseAuth.DefaultInstance.GetUsersAsync(
    new List<UserIdentifier>
    {
        new UidIdentifier("uid1"),
        new EmailIdentifier("[e-mail]"),
        new PhoneIdentifier("[phone]"),
        new ProviderIdentifier("google.com", "google_uid4"),
    });

Console.WriteLine("Successfully fetched user data:");
foreach (UserRecord user in result.Users)
{
    Console.WriteLine($"User: {user.Uid}");
}

Console.WriteLine("Unable to find users corresponding to these identifiers:");
foreach (UserIdentifier uid in result.NotFound)
{
    Console.WriteLine($"{uid}");
}

यह तरीका, इनपुट सूची के साइज़ के बराबर की सूची दिखाता है. इसमें हर एंट्री में, संबंधित UserRecord या गड़बड़ी की जानकारी होती है. इससे पता चलता है कि उस आइडेंटिफ़ायर को क्यों नहीं खोजा जा सका. गड़बड़ी के कोड की पूरी सूची देखने के लिए, एडमिन Authentication एपीआई से जुड़ी गड़बड़ियां देखें. इस सूची में, गड़बड़ी का ब्यौरा और उसे ठीक करने के तरीके भी बताए गए हैं.

उपयोगकर्ता बनाना

Admin SDK टूल, एक ऐसा तरीका उपलब्ध कराता है जिसकी मदद से नया Firebase Authentication उपयोगकर्ता बनाया जा सकता है. यह तरीका, ऐसे ऑब्जेक्ट को स्वीकार करता है जिसमें प्रोफ़ाइल की जानकारी होती है. इस जानकारी को नए उपयोगकर्ता खाते में शामिल किया जाता है:

Node.js

getAuth()
  .createUser({
    email: '[e-mail]',
    emailVerified: false,
    phoneNumber: '[phone]',
    password: 'secretPassword',
    displayName: 'John Doe',
    photoURL: 'http://www.example.com/12345678/photo.png',
    disabled: false,
  })
  .then((userRecord) => {
    // See the UserRecord reference doc for the contents of userRecord.
    console.log('Successfully created new user:', userRecord.uid);
  })
  .catch((error) => {
    console.log('Error creating new user:', error);
  });
manage_users.js

Java

CreateRequest request = new CreateRequest()
    .setEmail("[e-mail]")
    .setEmailVerified(false)
    .setPassword("secretPassword")
    .setPhoneNumber("[phone]")
    .setDisplayName("John Doe")
    .setPhotoUrl("http://www.example.com/12345678/photo.png")
    .setDisabled(false);

UserRecord userRecord = FirebaseAuth.getInstance().createUser(request);
System.out.println("Successfully created new user: " + userRecord.getUid());

Python

user = auth.create_user(
    email='[e-mail]',
    email_verified=False,
    phone_number='[phone]',
    password='secretPassword',
    display_name='John Doe',
    photo_url='http://www.example.com/12345678/photo.png',
    disabled=False)
print('Sucessfully created new user: {0}'.format(user.uid))

शुरू करें

params := (&auth.UserToCreate{}).
	Email("[e-mail]").
	EmailVerified(false).
	PhoneNumber("[phone]").
	Password("secretPassword").
	DisplayName("John Doe").
	PhotoURL("http://www.example.com/12345678/photo.png").
	Disabled(false)
u, err := client.CreateUser(ctx, params)
if err != nil {
	log.Fatalf("error creating user: %v\n", err)
}
log.Printf("Successfully created user: %v\n", u)
auth.go

C#

UserRecordArgs args = new UserRecordArgs()
{
    Email = "[e-mail]",
    EmailVerified = false,
    PhoneNumber = "[phone]",
    Password = "secretPassword",
    DisplayName = "John Doe",
    PhotoUrl = "http://www.example.com/12345678/photo.png",
    Disabled = false,
};
UserRecord userRecord = await FirebaseAuth.DefaultInstance.CreateUserAsync(args);
// See the UserRecord reference doc for the contents of userRecord.
Console.WriteLine($"Successfully created new user: {userRecord.Uid}");

डिफ़ॉल्ट रूप से, Firebase Authentication नए उपयोगकर्ता के लिए बिना किसी क्रम के uid जनरेट करेगा. अगर आपको नए उपयोगकर्ता के लिए अपना uid तय करना है, तो उसे उपयोगकर्ता बनाने के तरीके में पास किए गए आर्ग्युमेंट के तौर पर शामिल किया जा सकता है:

Node.js

getAuth()
  .createUser({
    uid: 'some-uid',
    email: '[e-mail]',
    phoneNumber: '[phone]',
  })
  .then((userRecord) => {
    // See the UserRecord reference doc for the contents of userRecord.
    console.log('Successfully created new user:', userRecord.uid);
  })
  .catch((error) => {
    console.log('Error creating new user:', error);
  });
manage_users.js

Java

CreateRequest request = new CreateRequest()
    .setUid("some-uid")
    .setEmail("[e-mail]")
    .setPhoneNumber("[phone]");

UserRecord userRecord = FirebaseAuth.getInstance().createUser(request);
System.out.println("Successfully created new user: " + userRecord.getUid());

Python

user = auth.create_user(
    uid='some-uid', email='[e-mail]', phone_number='[phone]')
print('Sucessfully created new user: {0}'.format(user.uid))

शुरू करें

params := (&auth.UserToCreate{}).
	UID(uid).
	Email("[e-mail]").
	PhoneNumber("[phone]")
u, err := client.CreateUser(ctx, params)
if err != nil {
	log.Fatalf("error creating user: %v\n", err)
}
log.Printf("Successfully created user: %v\n", u)
auth.go

C#

UserRecordArgs args = new UserRecordArgs()
{
    Uid = "some-uid",
    Email = "[e-mail]",
    PhoneNumber = "[phone]",
};
UserRecord userRecord = await FirebaseAuth.DefaultInstance.CreateUserAsync(args);
// See the UserRecord reference doc for the contents of userRecord.
Console.WriteLine($"Successfully created new user: {userRecord.Uid}");

इन प्रॉपर्टी का कोई भी कॉम्बिनेशन दिया जा सकता है:

टेबल 1. उपयोगकर्ता बनाने की सुविधा के साथ काम करने वाली प्रॉपर्टी

प्रॉपर्टी	टाइप	ब्यौरा
uid	स्ट्रिंग	नए उपयोगकर्ता को असाइन किया जाने वाला uid. यह एक ऐसी स्ट्रिंग होनी चाहिए जिसमें 1 से 128 वर्ण हों. अगर इस पैरामीटर को उपलब्ध नहीं कराया जाता है, तो रैंडम uid अपने-आप जनरेट हो जाएगा. कम अवधि वाले uid, बेहतर परफ़ॉर्मेंस देते हैं.
email	स्ट्रिंग	उपयोगकर्ता का प्राइमरी ईमेल पता. एक मान्य ईमेल पता होना चाहिए.
emailVerified	बूलियन	उपयोगकर्ता के प्राइमरी ईमेल पते की पुष्टि हुई है या नहीं. अगर यह एट्रिब्यूट नहीं दिया जाता है, तो डिफ़ॉल्ट रूप से false का इस्तेमाल किया जाता है.
phoneNumber	स्ट्रिंग	उपयोगकर्ता का मुख्य फ़ोन नंबर. यह E.164 स्पेसिफ़िकेशन का पालन करने वाला मान्य फ़ोन नंबर होना चाहिए.
password	स्ट्रिंग	उपयोगकर्ता का बिना हैश किया गया पासवर्ड. कम से कम छह वर्ण होने चाहिए.
displayName	स्ट्रिंग	उपयोगकर्ताओं का डिसप्ले नेम.
photoURL	स्ट्रिंग	उपयोगकर्ता की फ़ोटो का यूआरएल.
disabled	बूलियन	उपयोगकर्ता का खाता बंद है या नहीं. true बंद करने के लिए; false चालू करने के लिए. अगर इस पैरामीटर को उपलब्ध नहीं कराया जाता है, तो डिफ़ॉल्ट वैल्यू false होती है.

ध्यान दें: ऊपर दी गई सभी प्रॉपर्टी ज़रूरी नहीं हैं. अगर किसी प्रॉपर्टी के लिए वैल्यू नहीं दी गई है, तो उस प्रॉपर्टी की वैल्यू खाली रहेगी. ऐसा तब तक होगा, जब तक ऊपर दी गई टेबल में कोई डिफ़ॉल्ट वैल्यू नहीं दी जाती.

उपयोगकर्ता बनाने का तरीका, नए उपयोगकर्ता के लिए UserRecord ऑब्जेक्ट दिखाता है.

अगर दिया गया uid, ईमेल या फ़ोन नंबर किसी मौजूदा उपयोगकर्ता के ज़रिए पहले से इस्तेमाल किया जा रहा है या किसी अन्य वजह से उपयोगकर्ता को बनाया नहीं जा सकता, तो ऊपर दिया गया तरीका गड़बड़ी की वजह से काम नहीं करता. गड़बड़ी कोड की पूरी सूची देखने के लिए, एडमिन Authentication एपीआई से जुड़ी गड़बड़ियां देखें. इसमें गड़बड़ी की जानकारी और उसे ठीक करने का तरीका भी शामिल है.

उपयोगकर्ता की जानकारी अपडेट करना

Firebase Admin SDK टूल की मदद से, किसी मौजूदा उपयोगकर्ता के डेटा में बदलाव किया जा सकता है. आपको उस उपयोगकर्ता के लिए अपडेट की जाने वाली प्रॉपर्टी के साथ-साथ, uid की जानकारी देनी होगी:

Node.js

getAuth()
  .updateUser(uid, {
    email: '[e-mail]',
    phoneNumber: '[phone]',
    emailVerified: true,
    password: 'newPassword',
    displayName: 'Jane Doe',
    photoURL: 'http://www.example.com/12345678/photo.png',
    disabled: true,
  })
  .then((userRecord) => {
    // See the UserRecord reference doc for the contents of userRecord.
    console.log('Successfully updated user', userRecord.toJSON());
  })
  .catch((error) => {
    console.log('Error updating user:', error);
  });
manage_users.js

Java

UpdateRequest request = new UpdateRequest(uid)
    .setEmail("[e-mail]")
    .setPhoneNumber("[phone]")
    .setEmailVerified(true)
    .setPassword("newPassword")
    .setDisplayName("Jane Doe")
    .setPhotoUrl("http://www.example.com/12345678/photo.png")
    .setDisabled(true);

UserRecord userRecord = FirebaseAuth.getInstance().updateUser(request);
System.out.println("Successfully updated user: " + userRecord.getUid());

Python

user = auth.update_user(
    uid,
    email='[e-mail]',
    phone_number='[phone]',
    email_verified=True,
    password='newPassword',
    display_name='John Doe',
    photo_url='http://www.example.com/12345678/photo.png',
    disabled=True)
print('Sucessfully updated user: {0}'.format(user.uid))

शुरू करें

params := (&auth.UserToUpdate{}).
	Email("[e-mail]").
	EmailVerified(true).
	PhoneNumber("[phone]").
	Password("newPassword").
	DisplayName("John Doe").
	PhotoURL("http://www.example.com/12345678/photo.png").
	Disabled(true)
u, err := client.UpdateUser(ctx, uid, params)
if err != nil {
	log.Fatalf("error updating user: %v\n", err)
}
log.Printf("Successfully updated user: %v\n", u)
auth.go

C#

UserRecordArgs args = new UserRecordArgs()
{
    Uid = uid,
    Email = "[e-mail]",
    PhoneNumber = "[phone]",
    EmailVerified = true,
    Password = "newPassword",
    DisplayName = "Jane Doe",
    PhotoUrl = "http://www.example.com/12345678/photo.png",
    Disabled = true,
};
UserRecord userRecord = await FirebaseAuth.DefaultInstance.UpdateUserAsync(args);
// See the UserRecord reference doc for the contents of userRecord.
Console.WriteLine($"Successfully updated user: {userRecord.Uid}");

इन प्रॉपर्टी का कोई भी कॉम्बिनेशन दिया जा सकता है:

दूसरी टेबल. 'उपयोगकर्ता को अपडेट करें' कार्रवाई के साथ काम करने वाली प्रॉपर्टी

प्रॉपर्टी	टाइप	ब्यौरा
email	स्ट्रिंग	उपयोगकर्ता का नया प्राइमरी ईमेल पता. एक मान्य ईमेल पता होना चाहिए.
emailVerified	बूलियन	उपयोगकर्ता के प्राइमरी ईमेल पते की पुष्टि हुई है या नहीं. अगर यह एट्रिब्यूट नहीं दिया जाता है, तो डिफ़ॉल्ट रूप से false का इस्तेमाल किया जाता है.
phoneNumber	स्ट्रिंग	उपयोगकर्ता का नया प्राइमरी फ़ोन नंबर. यह E.164 स्टैंडर्ड के मुताबिक मान्य फ़ोन नंबर होना चाहिए. उपयोगकर्ता का मौजूदा फ़ोन नंबर मिटाने के लिए, इसे null पर सेट करें.
password	स्ट्रिंग	उपयोगकर्ता का बिना हैश किया गया नया पासवर्ड. यह कम से कम छह वर्णों का होना चाहिए.
displayName	स्ट्रिंग | null	उपयोगकर्ताओं का नया डिसप्ले नेम. उपयोगकर्ता के मौजूदा डिसप्ले नेम को हटाने के लिए, इसे null पर सेट करें.
photoURL	स्ट्रिंग | null	उपयोगकर्ता की नई फ़ोटो का यूआरएल. उपयोगकर्ता की मौजूदा फ़ोटो के यूआरएल को मिटाने के लिए, null पर सेट करें. अगर null नहीं है, तो यह एक मान्य यूआरएल होना चाहिए.
disabled	बूलियन	उपयोगकर्ता बंद है या नहीं. true बंद करने के लिए; false चालू करने के लिए.

ध्यान दें: ऊपर दी गई सभी प्रॉपर्टी ज़रूरी नहीं हैं. अगर कोई खास प्रॉपर्टी तय नहीं की गई है, तो उस प्रॉपर्टी की मौजूदा वैल्यू में कोई बदलाव नहीं होगा.

उपयोगकर्ता का अपडेट करने का तरीका, अपडेट पूरा होने पर अपडेट किया गया UserRecord ऑब्जेक्ट दिखाता है.

अगर दिया गया uid किसी मौजूदा उपयोगकर्ता से मेल नहीं खाता है, दिया गया ईमेल या फ़ोन नंबर पहले से ही किसी मौजूदा उपयोगकर्ता के पास है या किसी अन्य वजह से उपयोगकर्ता को अपडेट नहीं किया जा सकता, तो ऊपर दिया गया तरीका काम नहीं करता और गड़बड़ी का मैसेज दिखता है. गड़बड़ी कोड की पूरी सूची देखने के लिए, एडमिन Authentication एपीआई से जुड़ी गड़बड़ियां देखें. इसमें गड़बड़ी की जानकारी और उसे ठीक करने का तरीका भी शामिल है.

उपयोगकर्ता को हटाना

Firebase Admin SDK टूल की मदद से, मौजूदा उपयोगकर्ताओं को uid के हिसाब से मिटाया जा सकता है:

Node.js

getAuth()
  .deleteUser(uid)
  .then(() => {
    console.log('Successfully deleted user');
  })
  .catch((error) => {
    console.log('Error deleting user:', error);
  });
manage_users.js

Java

FirebaseAuth.getInstance().deleteUser(uid);
System.out.println("Successfully deleted user.");

Python

auth.delete_user(uid)
print('Successfully deleted user')

शुरू करें

err := client.DeleteUser(ctx, uid)
if err != nil {
	log.Fatalf("error deleting user: %v\n", err)
}
log.Printf("Successfully deleted user: %s\n", uid)
auth.go

C#

await FirebaseAuth.DefaultInstance.DeleteUserAsync(uid);
Console.WriteLine("Successfully deleted user.");

उपयोगकर्ता मिटाने का तरीका, मिटाने की प्रोसेस पूरी होने पर खाली नतीजा दिखाता है.

अगर दिया गया uid किसी मौजूदा उपयोगकर्ता से मेल नहीं खाता है या किसी अन्य वजह से उपयोगकर्ता को मिटाया नहीं जा सकता, तो उपयोगकर्ता को मिटाने का तरीका गड़बड़ी दिखाता है. गड़बड़ी कोड की पूरी सूची देखने के लिए, एडमिन Authentication एपीआई से जुड़ी गड़बड़ियां देखें. इसमें गड़बड़ी के बारे में जानकारी और उसे ठीक करने का तरीका भी शामिल है.

एक से ज़्यादा उपयोगकर्ताओं की जानकारी मिटाना

Firebase Admin SDK टूल, एक साथ कई उपयोगकर्ताओं को भी मिटा सकता है. हालांकि, ध्यान रखें कि एक से ज़्यादा उपयोगकर्ताओं को एक साथ मिटाने के लिए, deleteUsers(uids) जैसे तरीकों का इस्तेमाल करने पर, Cloud Functions for Firebase के लिए onDelete() इवेंट हैंडलर ट्रिगर नहीं होंगे. ऐसा इसलिए होता है, क्योंकि बैच मिटाने की सुविधा, हर उपयोगकर्ता के लिए उपयोगकर्ता खाता मिटाने का इवेंट ट्रिगर नहीं करती. अगर आपको मिटाए गए हर उपयोगकर्ता के लिए, उपयोगकर्ता मिटाने के इवेंट ट्रिगर करने हैं, तो एक-एक करके उपयोगकर्ताओं को मिटाएं.

Node.js

getAuth()
  .deleteUsers([uid1, uid2, uid3])
  .then((deleteUsersResult) => {
    console.log(`Successfully deleted ${deleteUsersResult.successCount} users`);
    console.log(`Failed to delete ${deleteUsersResult.failureCount} users`);
    deleteUsersResult.errors.forEach((err) => {
      console.log(err.error.toJSON());
    });
  })
  .catch((error) => {
    console.log('Error deleting users:', error);
  });

Java

DeleteUsersResult result = FirebaseAuth.getInstance().deleteUsersAsync(
    Arrays.asList("uid1", "uid2", "uid3")).get();

System.out.println("Successfully deleted " + result.getSuccessCount() + " users");
System.out.println("Failed to delete " + result.getFailureCount() + " users");
for (ErrorInfo error : result.getErrors()) {
  System.out.println("error #" + error.getIndex() + ", reason: " + error.getReason());
}

Python

from firebase_admin import auth

result = auth.delete_users(["uid1", "uid2", "uid3"])

print('Successfully deleted {0} users'.format(result.success_count))
print('Failed to delete {0} users'.format(result.failure_count))
for err in result.errors:
    print('error #{0}, reason: {1}'.format(result.index, result.reason))

शुरू करें

deleteUsersResult, err := client.DeleteUsers(ctx, []string{"uid1", "uid2", "uid3"})
if err != nil {
	log.Fatalf("error deleting users: %v\n", err)
}

log.Printf("Successfully deleted %d users", deleteUsersResult.SuccessCount)
log.Printf("Failed to delete %d users", deleteUsersResult.FailureCount)
for _, err := range deleteUsersResult.Errors {
	log.Printf("%v", err)
}

C#

DeleteUsersResult result = await FirebaseAuth.DefaultInstance.DeleteUsersAsync(new List<string>
    {
        "uid1",
        "uid2",
        "uid3",
    });

Console.WriteLine($"Successfully deleted {result.SuccessCount} users.");
Console.WriteLine($"Failed to delete {result.FailureCount} users.");

foreach (ErrorInfo err in result.Errors)
{
    Console.WriteLine($"Error #{err.Index}, reason: {err.Reason}");
}

उपयोगकर्ताओं की जानकारी मिटाने का तरीका, उन उपयोगकर्ताओं की सूची दिखाता है जिन्हें मिटाया नहीं जा सका. गड़बड़ी के कोड की पूरी सूची देखने के लिए, एडमिन Authentication एपीआई की गड़बड़ियां देखें. इस सूची में, गड़बड़ी का ब्यौरा और उसे ठीक करने के तरीके भी बताए गए हैं.

सभी उपयोगकर्ताओं की सूची बनाना

Firebase Admin SDK टूल की मदद से, उपयोगकर्ताओं की पूरी सूची को एक साथ वापस पाया जा सकता है:

Node.js

const listAllUsers = (nextPageToken) => {
  // List batch of users, 1000 at a time.
  getAuth()
    .listUsers(1000, nextPageToken)
    .then((listUsersResult) => {
      listUsersResult.users.forEach((userRecord) => {
        console.log('user', userRecord.toJSON());
      });
      if (listUsersResult.pageToken) {
        // List next batch of users.
        listAllUsers(listUsersResult.pageToken);
      }
    })
    .catch((error) => {
      console.log('Error listing users:', error);
    });
};
// Start listing users from the beginning, 1000 at a time.
listAllUsers();
manage_users.js

Java

// Start listing users from the beginning, 1000 at a time.
ListUsersPage page = FirebaseAuth.getInstance().listUsers(null);
while (page != null) {
  for (ExportedUserRecord user : page.getValues()) {
    System.out.println("User: " + user.getUid());
  }
  page = page.getNextPage();
}

// Iterate through all users. This will still retrieve users in batches,
// buffering no more than 1000 users in memory at a time.
page = FirebaseAuth.getInstance().listUsers(null);
for (ExportedUserRecord user : page.iterateAll()) {
  System.out.println("User: " + user.getUid());
}

Python

# Start listing users from the beginning, 1000 at a time.
page = auth.list_users()
while page:
    for user in page.users:
        print('User: ' + user.uid)
    # Get next batch of users.
    page = page.get_next_page()

# Iterate through all users. This will still retrieve users in batches,
# buffering no more than 1000 users in memory at a time.
for user in auth.list_users().iterate_all():
    print('User: ' + user.uid)

शुरू करें

// Note, behind the scenes, the Users() iterator will retrive 1000 Users at a time through the API
iter := client.Users(ctx, "")
for {
	user, err := iter.Next()
	if err == iterator.Done {
		break
	}
	if err != nil {
		log.Fatalf("error listing users: %s\n", err)
	}
	log.Printf("read user user: %v\n", user)
}

// Iterating by pages 100 users at a time.
// Note that using both the Next() function on an iterator and the NextPage()
// on a Pager wrapping that same iterator will result in an error.
pager := iterator.NewPager(client.Users(ctx, ""), 100, "")
for {
	var users []*auth.ExportedUserRecord
	nextPageToken, err := pager.NextPage(&users)
	if err != nil {
		log.Fatalf("paging error %v\n", err)
	}
	for _, u := range users {
		log.Printf("read user user: %v\n", u)
	}
	if nextPageToken == "" {
		break
	}
}
auth.go

C#

// Start listing users from the beginning, 1000 at a time.
var pagedEnumerable = FirebaseAuth.DefaultInstance.ListUsersAsync(null);
var responses = pagedEnumerable.AsRawResponses().GetAsyncEnumerator();
while (await responses.MoveNextAsync())
{
    ExportedUserRecords response = responses.Current;
    foreach (ExportedUserRecord user in response.Users)
    {
        Console.WriteLine($"User: {user.Uid}");
    }
}

// Iterate through all users. This will still retrieve users in batches,
// buffering no more than 1000 users in memory at a time.
var enumerator = FirebaseAuth.DefaultInstance.ListUsersAsync(null).GetAsyncEnumerator();
while (await enumerator.MoveNextAsync())
{
    ExportedUserRecord user = enumerator.Current;
    Console.WriteLine($"User: {user.Uid}");
}

नतीजों के हर बैच में उपयोगकर्ताओं की सूची और अगले पेज का टोकन होता है. इसका इस्तेमाल, उपयोगकर्ताओं के अगले बैच की सूची बनाने के लिए किया जाता है. जब सभी उपयोगकर्ता पहले से ही सूची में शामिल होते हैं, तो कोई pageToken नहीं दिखाया जाता.

अगर कोई maxResults फ़ील्ड नहीं दिया गया है, तो हर बैच में 1,000 उपयोगकर्ताओं की डिफ़ॉल्ट वैल्यू का इस्तेमाल किया जाता है. एक बार में ज़्यादा से ज़्यादा इतने उपयोगकर्ताओं को सूची में शामिल किया जा सकता है. ज़्यादा से ज़्यादा वैल्यू से ज़्यादा वैल्यू देने पर, आर्ग्युमेंट से जुड़ी गड़बड़ी दिखेगी. अगर कोई pageToken नहीं दिया गया है, तो ऑपरेशन में उपयोगकर्ताओं को uid के हिसाब से, शुरू से सूची में शामिल किया जाएगा.

गड़बड़ी कोड की पूरी सूची देखने के लिए, एडमिन Authentication एपीआई से जुड़ी गड़बड़ियां देखें. इसमें गड़बड़ी के बारे में जानकारी और उसे ठीक करने का तरीका भी शामिल है.

सूची में शामिल उपयोगकर्ताओं के पासवर्ड हैश

यह एपीआई, पासवर्ड का इस्तेमाल करने वाले उपयोगकर्ताओं के लिए, Firebase Auth बैकएंड से हैश किए गए passwordSalt और passwordHash को भी दिखाता है. हालांकि, ऐसा तब ही होता है, जब अनुरोध के लिए OAuth ऐक्सेस टोकन जनरेट करने वाले उपयोगकर्ता/सर्विस खाते के पास firebaseauth.configs.getHashConfig अनुमति हो. ऐसा न करने पर, passwordHash और passwordSalt को सेट नहीं किया जाएगा.

पासवर्ड हैश की संवेदनशील प्रकृति की वजह से, Firebase Admin SDK टूल के सेवा खाते के पास डिफ़ॉल्ट रूप से firebaseauth.configs.getHashConfig अनुमति नहीं होती. किसी उपयोगकर्ता/सेवा खाते में सीधे तौर पर अनुमति नहीं जोड़ी जा सकती. हालांकि, कस्टम आईएएम भूमिका बनाकर, सीधे तौर पर ऐसा किया जा सकता है.

कस्टम आईएएम भूमिका बनाने के लिए:

1. Google Cloud console में, IAM और एडमिन पैनल में भूमिकाएं पेज पर जाएं.
2. पेज पर सबसे ऊपर मौजूद ड्रॉप-डाउन से अपना प्रोजेक्ट चुनें.
3. भूमिका बनाएं पर क्लिक करें
4. अनुमतियां जोड़ें पर क्लिक करें
5. firebaseauth.configs.getHashConfig अनुमति खोजें और उस चेकबॉक्स को चुनें.
6. जोड़ें पर क्लिक करें
7. नई भूमिका बनाने के लिए, बनाएं पर क्लिक करें.

आईएएम पेज में, उपयोगकर्ता/सेवा खाते में बनाई गई कस्टम भूमिका जोड़ें:

1. आईएएम और एडमिन पैनल में, आईएएम चुनें
2. सदस्यों की सूची में से, बदलाव करने के लिए सेवा या उपयोगकर्ता खाता चुनें.
3. अन्य भूमिका जोड़ें पर क्लिक करें.
4. पहले बनाई गई नई कस्टम भूमिका खोजें.
5. सेव करें पर क्लिक करें.

चेतावनी: Editor भूमिका का इस्तेमाल, firebaseauth.configs.getHashConfig अनुमति जोड़ने के लिए न करें. इस अहम भूमिका से, ज़रूरत से ज़्यादा अनुमतियां मिलती हैं.