Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

Kullanıcıları Yönet

Firebase Admin SDK, Firebase Authentication kullanıcılarınızı yükseltilmiş ayrıcalıklarla yönetmek için bir API sağlar. Yönetici kullanıcı yönetimi API'si, güvenli bir sunucu ortamından aşağıdaki görevleri programlı olarak tamamlamanıza olanak tanır:

  • Herhangi bir kısıtlama veya hız sınırlaması olmadan yeni kullanıcılar oluşturun.
  • Kullanıcı kimliği, e-posta veya telefon numarası gibi farklı kriterlere göre kullanıcıları arayın.
  • Belirli bir projenin tüm kullanıcılarını toplu olarak listeleyin.
  • Hesap oluşturma tarihi ve son oturum açma tarihi dahil olmak üzere kullanıcı meta verilerine erişin.
  • Kullanıcıları mevcut parolalarına ihtiyaç duymadan silin.
  • Kullanıcı olarak oturum açmak zorunda kalmadan kullanıcı özelliklerini (şifreleri dahil) güncelleyin.
  • E-postaları doğrulamak için bant dışı işlem akışlarından geçmek zorunda kalmadan e-postaları doğrulayın.
  • Bu değişiklikleri iptal etmek için e-posta bağlantıları göndermeden bir kullanıcının e-postasını değiştirin.
  • SMS doğrulama akışından geçmek zorunda kalmadan telefon numarasıyla yeni bir kullanıcı oluşturun.
  • SMS doğrulama akışından geçmek zorunda kalmadan bir kullanıcının telefon numarasını değiştirin.
  • Kullanıcıları devre dışı bırakılmış durumda çevrimdışı olarak sağlayın ve daha sonra ne zaman etkinleştireceklerini kontrol edin.
  • Belirli bir uygulamanın kullanıcı yönetim sistemine göre uyarlanmış özel kullanıcı konsolları oluşturun.

Sen başlamadan önce

Firebase Admin SDK tarafından sağlanan kullanıcı yönetimi API'sini kullanmak için bir hizmet hesabınızın olması gerekir. Takip kurulum talimatlarını Admin SDK başlatmak konusunda daha fazla bilgi için bkz.

Kullanıcı verilerini al

Bir kullanıcıyı tanımlamak için birincil yolu onların gereğidir uid , bu kullanıcı için benzersiz bir tanımlayıcı. Yönetici SDK, tarafından kullanıcıların profil bilgileri getirilirken sağlayan bir yöntem sağlar 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);
  });

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());

piton

from firebase_admin import auth

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

Gitmek

// 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)

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}");

Bu yöntem, bir döner UserRecord tekabül eden bir kullanıcı için bir nesne uid yöntemine sağladı.

Sağlanmışsa uid mevcut bir kullanıcıya ait olmayan ya da kullanıcı başka bir nedenden dolayı alınamadığından, yukarıdaki yöntemi hata verir. Açıklamaları ve çözüm adımları içeren hata kodları, tam listesi için bkz Yönetici Kimlik Doğrulama API'sı Hataları .

Bazı durumlarda, bir kullanıcının e-posta yerine onların olacak uid . Firebase Admin SDK, bir e-posta ile kullanıcı bilgilerinin aranmasını destekler:

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);
  });

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());

piton

from firebase_admin import auth

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

Gitmek

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)

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}");

Bu yöntem, bir döner UserRecord e-posta adresine tekabül eden bir kullanıcı için bir nesne.

Sağlanan e-posta mevcut bir kullanıcıya ait değilse veya başka bir nedenle kullanıcı getirilemezse, Yönetici SDK'sı bir hata verir. Açıklamaları ve çözüm adımları içeren hata kodları, tam listesi için bkz Yönetici Kimlik Doğrulama API Hataları .

Diğer durumlarda, bir kullanıcının telefon numarası yerine sahip olacak uid . Firebase Admin SDK, bir telefon numarasıyla kullanıcı bilgilerinin aranmasını destekler:

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);
  });

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());

piton

from firebase_admin import auth

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

Gitmek

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)

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}");

Bu yöntem, bir döner UserRecord telefon numarasına tekabül eden bir kullanıcı için bir nesne.

Sağlanan telefon numarası mevcut bir kullanıcıya ait değilse veya başka bir nedenle kullanıcı getirilemiyorsa Admin SDK hata verir. Açıklamaları ve çözüm adımları içeren hata kodları, tam listesi için bkz Yönetici Kimlik Doğrulama API Hataları .

Kullanıcı verilerini toplu olarak al

Firebase Admin SDK, sağladığınız tanımlayıcılara dayalı olarak bir kullanıcı listesinin alınmasına da olanak tanır. Kullanıcıları kullanıcı kimliği, e-posta adresi veya telefon numarasına göre tanımlayabilirsiniz. Tek bir aramada maksimum 100 tanımlayıcı sağlanabilir. Tanımlayıcılar, aşağıdaki türlerin bir karışımını içerebilir:

Node.js

getAuth()
  .getUsers([
    { uid: 'uid1' },
    { email: 'user2@example.com' },
    { phoneNumber: '+15555550003' },
    { 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);
  });

Java

GetUsersResult result = FirebaseAuth.getInstance().getUsersAsync(Arrays.asList(
    new UidIdentifier("uid1"),
    new EmailIdentifier("user2@example.com"),
    new PhoneIdentifier("+15555550003"),
    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);
}

piton

from firebase_admin import auth

result = auth.get_users([
    auth.UidIdentifier('uid1'),
    auth.EmailIdentifier('user2@example.com'),
    auth.PhoneIdentifier(+15555550003),
    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)

Gitmek

getUsersResult, err := client.GetUsers(ctx, []auth.UserIdentifier{
	auth.UIDIdentifier{UID: "uid1"},
	auth.EmailIdentifier{Email: "user@example.com"},
	auth.PhoneIdentifier{PhoneNumber: "+15555551234"},
	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("user2@example.com"),
        new PhoneIdentifier("+15555550003"),
        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}");
}

Bu yöntem, karşılık gelen birini ihtiva eden her bir giriş ile bir liste girişi listesi olarak aynı boyutta döner UserRecord veya tanımlayıcı bakılması gereken mümkün değildi neden belirten bir hata. Açıklamaları ve çözüm adımları içeren hata kodları, tam listesi için bkz Yönetici Kimlik Doğrulama API Hataları .

Kullanıcı oluştur

Yönetici SDK'sı, yeni bir Firebase Kimlik Doğrulama kullanıcısı oluşturmanıza olanak tanıyan bir yöntem sağlar. Bu yöntem, yeni oluşturulan kullanıcı hesabına dahil edilecek profil bilgilerini içeren bir nesneyi kabul eder:

Node.js

getAuth()
  .createUser({
    email: 'user@example.com',
    emailVerified: false,
    phoneNumber: '+11234567890',
    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);
  });

Java

CreateRequest request = new CreateRequest()
    .setEmail("user@example.com")
    .setEmailVerified(false)
    .setPassword("secretPassword")
    .setPhoneNumber("+11234567890")
    .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());

piton

user = auth.create_user(
    email='user@example.com',
    email_verified=False,
    phone_number='+15555550100',
    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))

Gitmek

params := (&auth.UserToCreate{}).
	Email("user@example.com").
	EmailVerified(false).
	PhoneNumber("+15555550100").
	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)

C#

UserRecordArgs args = new UserRecordArgs()
{
    Email = "user@example.com",
    EmailVerified = false,
    PhoneNumber = "+11234567890",
    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}");

Varsayılan olarak, Firebase Kimlik rastgele üretecektir uid yeni kullanıcı için. Bunun yerine kendi belirtmek istiyorsanız uid yeni kullanıcı için, bunu kullanıcı oluşturma yöntemine geçirilen argümanı şunları içerebilir:

Node.js

getAuth()
  .createUser({
    uid: 'some-uid',
    email: 'user@example.com',
    phoneNumber: '+11234567890',
  })
  .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);
  });

Java

CreateRequest request = new CreateRequest()
    .setUid("some-uid")
    .setEmail("user@example.com")
    .setPhoneNumber("+11234567890");

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

piton

user = auth.create_user(
    uid='some-uid', email='user@example.com', phone_number='+15555550100')
print('Sucessfully created new user: {0}'.format(user.uid))

Gitmek

params := (&auth.UserToCreate{}).
	UID(uid).
	Email("user@example.com").
	PhoneNumber("+15555550100")
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)

C#

UserRecordArgs args = new UserRecordArgs()
{
    Uid = "some-uid",
    Email = "user@example.com",
    PhoneNumber = "+11234567890",
};
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}");

Aşağıdaki özelliklerin herhangi bir kombinasyonu sağlanabilir:

Tablo 1. Kullanıcı oluşturma işlemi tarafından desteklenen özellikler

Mülk Tip Açıklama
uid sicim uid yeni oluşturulan kullanıcıya atanacak. 1 ile 128 karakter uzunluğunda bir dize olmalıdır. Sağlanmazsa takdirde rastgele uid otomatik olarak oluşturulur.
email sicim Kullanıcının birincil e-posta adresi. Geçerli bir e-posta adresi olmalı.
emailVerified boole Kullanıcının birincil e-posta adresinin doğrulanıp doğrulanmadığı. Sağlanmazsa, varsayılan bir false .
phoneNumber sicim Kullanıcının birincil telefon numarası. Geçerli bir E.164 spec uyumlu telefon numarası olmalıdır.
password sicim Kullanıcının ham, karma olmayan parolası. En az altı karakter uzunluğunda olmalıdır.
displayName sicim Kullanıcıların görünen adı.
photoURL sicim Kullanıcının fotoğraf URL'si.
disabled boole Kullanıcının devre dışı olup olmadığı. true engelliler için; false için etkinleştirilmiş. Sağlanmazsa, varsayılan bir false .

Kullanıcı oluşturma yöntemi, bir döner UserRecord yeni oluşturulan kullanıcı için bir nesne.

Sağlanmışsa uid , e-posta veya telefon numarası var olan bir kullanıcı tarafından zaten kullanılıyor veya kullanıcı başka bir sebeple oluşturulamaz, yukarıdaki yöntem bir hata ile sonlandı. Açıklamaları ve çözüm adımları içeren hata kodları, tam listesi için bkz Yönetici Kimlik Doğrulama API Hataları .

Bir kullanıcıyı güncelle

Firebase Admin SDK, mevcut bir kullanıcının verilerini değiştirmeyi kolaylaştırır. Bir belirtmek gerekir uid bu kullanıcı için güncelleme özelliklerle birlikte:

Node.js

getAuth()
  .updateUser(uid, {
    email: 'modifiedUser@example.com',
    phoneNumber: '+11234567890',
    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);
  });

Java

UpdateRequest request = new UpdateRequest(uid)
    .setEmail("user@example.com")
    .setPhoneNumber("+11234567890")
    .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());

piton

user = auth.update_user(
    uid,
    email='user@example.com',
    phone_number='+15555550100',
    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))

Gitmek

params := (&auth.UserToUpdate{}).
	Email("user@example.com").
	EmailVerified(true).
	PhoneNumber("+15555550100").
	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)

C#

UserRecordArgs args = new UserRecordArgs()
{
    Uid = uid,
    Email = "modifiedUser@example.com",
    PhoneNumber = "+11234567890",
    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}");

Aşağıdaki özelliklerin herhangi bir kombinasyonu sağlanabilir:

Tablo 2. Kullanıcı güncelleme işlemi tarafından desteklenen özellikler

Mülk Tip Açıklama
email sicim Kullanıcının yeni birincil e-posta adresi. Geçerli bir e-posta adresi olmalı.
emailVerified boole Kullanıcının birincil e-posta adresinin doğrulanıp doğrulanmadığı. Sağlanmazsa, varsayılan bir false .
phoneNumber sicim Kullanıcının yeni birincil telefon numarası. Geçerli bir E.164 spec uyumlu telefon numarası olmalıdır. Ayarlayın null kullanıcının mevcut telefon numarasını silmek için.
password sicim Kullanıcının yeni ham, karma olmayan parolası. En az altı karakter uzunluğunda olmalıdır.
displayName dize | null Kullanıcıların yeni görünen adı. Ayarlayın null kullanıcının mevcut ekran adını temizlemek için.
photoURL dize | null Kullanıcıların yeni fotoğraf URL'si. Ayarlayın null kullanıcının mevcut fotoğraf URL'sini temizlemek için. Olmayan ise null , geçerli bir URL olmalıdır.
disabled boole Kullanıcının devre dışı bırakılıp bırakılmadığı. true engelliler için; false için etkinleştirilmiş.

Güncelleştirme kullanıcı yöntemi güncelleştirilmiş döndürür UserRecord güncelleme başarıyla tamamlandığında nesneyi.

Sağlanmışsa uid mevcut bir kullanıcıya karşılık gelmez, verilen e-posta veya telefon numarası var olan bir kullanıcı tarafından zaten kullanılıyor veya kullanıcı başka bir nedenle güncellenmiş edilemez, yukarıdaki yöntem bir hata ile sonlandı. Açıklamaları ve çözüm adımları içeren hata kodları, tam listesi için bkz Yönetici Kimlik Doğrulama API Hataları .

Bir kullanıcıyı sil

Firebase Yönetici SDK, tarafından mevcut kullanıcıları silme sağlar uid :

Node.js

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

Java

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

piton

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

Gitmek

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

C#

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

Silme işlemi başarıyla tamamlandığında, kullanıcıyı sil yöntemi boş bir sonuç döndürür.

Sağlanmışsa uid mevcut bir kullanıcıya karşılık gelmeyen veya kullanıcı başka bir sebeple silinemez, silme kullanıcı yöntemi hata verir. Açıklamaları ve çözüm adımları içeren hata kodları, tam listesi için bkz Yönetici Kimlik Doğrulama API Hataları .

Birden Fazla Kullanıcıyı Sil

Firebase Admin SDK, aynı anda birden çok kullanıcıyı da silebilir. Ancak, nota gibi yöntemlerle bu deleteUsers(uids) Aynı anda birden fazla kullanıcıyı silmek için tetiklemez onDelete() Firebase için Bulut Fonksiyonlar için olay işleyicileri. Bunun nedeni toplu silme işleminin her kullanıcıda bir kullanıcı silme olayını tetiklememesidir. Silinen her kullanıcı için kullanıcı silme olaylarının tetiklenmesini istiyorsanız, kullanıcıları birer birer silin.

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());
}

piton

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))

Gitmek

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}");
}

Kullanıcıları sil yöntemi, silinemeyen kullanıcılar için bir hata listesi döndürür. Açıklamaları ve çözüm adımları içeren hata kodları, tam listesi için bkz Yönetici Kimlik Doğrulama API Hataları .

Tüm kullanıcıları listele

Firebase Admin SDK, tüm kullanıcı listesinin toplu halde alınmasına olanak tanır:

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();

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());
}

piton

# 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)

Gitmek

// 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
	}
}

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}");
}

Her sonuç grubu, bir kullanıcı listesi ve bir sonraki kullanıcı grubunu listelemek için kullanılan bir sonraki sayfa belirtecini içerir. Tüm kullanıcıların zaten listelenmiştir, hiçbir pageToken döndürülür.

Hayır ise maxResults alan belirtilirse, parti başına varsayılan 1000 kullanıcı kullanılır. Bu aynı zamanda bir seferde listelenmesine izin verilen maksimum kullanıcı sayısıdır. Maksimumdan büyük herhangi bir değer, bir argüman hatası verecektir. Hayır ise pageToken belirtilmişse, operasyon tarafından sipariş başından kullanıcıları listeler uid .

Açıklamaları ve çözüm adımları içeren hata kodları, tam listesi için bkz Yönetici Kimlik Doğrulama API Hataları .

Listelenen kullanıcıların parola karmaları

Bu API döndüren passwordSalt ve passwordHash kullanıcı / hizmet hesabı vardır belirteç isteği OAuth erişimini oluşturmak için kullanılan eğer şifre kullanıcıları için Firebase Auth arka uç tarafından karma firebaseauth.configs.getHashConfig izni. Aksi takdirde passwordHash ve passwordSalt ayarlanmaz.

Nedeniyle şifre sağlamalarının hassas olması Firebase Yönetici SDK hizmet hesabı yok firebaseauth.configs.getHashConfig varsayılan olarak izin. Bir kullanıcı / hizmet hesabına doğrudan bir iznini ekleyin değil, ancak bunu dolaylı yapabilirsiniz özel bir IAM rol oluşturarak .

Özel IAM rolünü oluşturmak için:

  1. Google Bulut Konsolu IAM & yönetici panelinde Roller sayfasına gidin.
  2. Sayfanın üst kısmındaki açılır menüden projenizi seçin.
  3. Tıklayın ROLÜ CREATE
  4. ADD PERMISSIONS tıklayın
  5. Ara firebaseauth.configs.getHashConfig izni ve bu onay kutusunu işaretleyin.
  6. tıklayın ADD
  7. Yeni bir rol oluşturmayı tamamlamak için CREATE tıklayın.

Oluşturulan özel rolü, IAM sayfasındaki kullanıcı/hizmet hesabına ekleyin:

  1. IAM & yönetici panelinde, IAM seçin
  2. Düzenlemek için üye listesinden hizmeti veya kullanıcı hesabını seçin.
  3. BAŞKA ROL ADD tıklayın.
  4. Önceden oluşturulmuş yeni özel rolü arayın.
  5. KAYDET'i tıklayın.