Kullanıcıları yönetin

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, aşağıdaki görevleri güvenli bir sunucu ortamından programlı bir şekilde tamamlama olanağı sağlar:

  • Herhangi bir kısıtlama veya hız sınırlaması olmadan yeni kullanıcılar oluşturun.
  • Kullanıcıları kullanıcı kimliği, e-posta veya telefon numarası gibi farklı kriterlere göre arayın.
  • Belirli bir projenin tüm kullanıcılarını gruplar halinde listeleyin.
  • Hesap oluşturma tarihi ve son oturum açma tarihi dahil olmak üzere kullanıcı meta verilerine erişin.
  • Kullanıcıları mevcut şifrelerine gerek 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ışı eylem akışlarından geçmek zorunda kalmadan e-postaları doğrulayın.
  • Bu değişiklikleri iptal etmek için kullanıcının e-postasını e-posta bağlantıları göndermeden 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 kullanıcının telefon numarasını değiştirin.
  • Kullanıcıların devre dışı durumdaki çevrimdışı temel hazırlığını yapın ve daha sonra bunların ne zaman etkinleştirileceğini 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. Admin SDK'nın nasıl başlatılacağı hakkında daha fazla bilgi için kurulum talimatlarını izleyin.

Kullanıcı verilerini al

Bir kullanıcıyı tanımlamanın birincil yolu, o kullanıcı için benzersiz bir tanımlayıcı olan kullanıcı uid kullanmaktır. Admin SDK, kullanıcıların profil bilgilerinin kullanıcı uid göre alınmasına olanak tanıyan bir yöntem sağlar:

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

Python

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, yönteme sağlanan uid karşılık gelen kullanıcı için bir UserRecord nesnesi döndürür.

Sağlanan uid mevcut bir kullanıcıya ait değilse veya kullanıcı başka bir nedenden dolayı getirilemiyorsa yukarıdaki yöntem hata atar. Açıklamalar ve çözüm adımları da dahil olmak üzere hata kodlarının tam listesi için Admin Auth API Errors (Yönetici Kimlik Doğrulama API'si Hataları) sayfasına bakın.

Bazı durumlarda, bir kullanıcının kullanıcı uid yerine e-postasına sahip olursunuz. Firebase Admin SDK, kullanıcı bilgilerinin bir e-postayla 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());

Python

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, sağlanan e-postaya karşılık gelen kullanıcı için bir UserRecord nesnesi döndürür.

Sağlanan e-posta mevcut bir kullanıcıya ait değilse veya kullanıcı başka bir nedenden dolayı getirilemiyorsa Yönetici SDK'sı bir hata verir. Açıklamalar ve çözüm adımları da dahil olmak üzere hata kodlarının tam listesi için bkz . Yönetici Kimlik Doğrulaması API Hataları .

Diğer durumlarda, kullanıcının kullanıcı uid yerine telefon numarasına sahip olursunuz. Firebase Admin SDK, kullanıcı bilgilerinin telefon numarasıyla 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());

Python

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, sağlanan telefon numarasına karşılık gelen kullanıcı için bir UserRecord nesnesi döndürür.

Sağlanan telefon numarası mevcut bir kullanıcıya ait değilse veya kullanıcı başka bir nedenden dolayı getirilemiyorsa Yönetici SDK'sı bir hata verir. Açıklamalar ve çözüm adımları da dahil olmak üzere hata kodlarının tam listesi için bkz . Yönetici Kimlik Doğrulaması API Hataları .

Kullanıcı verilerini toplu olarak al

Firebase Yönetici SDK'sı, sağladığınız tanımlayıcılara göre bir kullanıcı listesinin alınmasına da olanak tanır. Kullanıcıları kullanıcı kimliklerine, e-postalarına veya telefon numaralarına göre tanımlayabilirsiniz. Tek bir çağrıda maksimum 100 tanımlayıcı sağlanabilir. Tanımlayıcılar çeşitli 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);
}

Python

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, her girişin karşılık gelen UserRecord veya bu tanımlayıcının neden aranamadığını gösteren bir hatayı içerdiği, giriş listesiyle aynı boyutta bir liste döndürür. Açıklamalar ve çözüm adımları da dahil olmak üzere hata kodlarının tam listesi için Yönetici Kimlik Doğrulaması API Hataları bölümüne bakın.

Kullanıcı oluştur

Admin SDK, yeni bir Firebase Authentication kullanıcısı oluşturmanıza olanak tanıyan bir yöntem sağlar. Bu yöntem, yeni oluşturulan kullanıcı hesabına eklenecek 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());

Python

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

Firebase Authentication varsayılan olarak yeni kullanıcı için rastgele bir uid oluşturacaktır. Bunun yerine yeni kullanıcı için kendi uid belirtmek isterseniz, bunu kullanıcı oluşturma yöntemine iletilen bir argüman olarak ekleyebilirsiniz:

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

Python

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şleminin desteklediği özellikler

Mülk Tip Tanım
uid sicim Yeni oluşturulan kullanıcıya atanacak uid . 1-128 karakter uzunluğunda (dahil) bir dize olmalıdır. Sağlanmazsa rastgele bir uid otomatik olarak oluşturulacaktır. Daha kısa uid daha iyi performans sunar.
email sicim Kullanıcının birincil e-postası. Geçerli bir e-posta adresi olmalı.
emailVerified boolean Kullanıcının birincil e-postasının doğrulanıp doğrulanmadığı. Sağlanmazsa varsayılan değer false .
phoneNumber sicim Kullanıcının birincil telefon numarası. Geçerli bir E.164 spesifikasyonuna uygun telefon numarası olmalıdır.
password sicim Kullanıcının ham, karmalanmamış şifresi. 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 boolean Kullanıcının devre dışı olup olmadığı. engelliler için true ; etkin için false . Sağlanmazsa varsayılan değer false .

Kullanıcı oluşturma yöntemi, yeni oluşturulan kullanıcı için bir UserRecord nesnesi döndürür.

Sağlanan kullanıcı uid , e-posta veya telefon numarası mevcut bir kullanıcı tarafından zaten kullanılıyorsa veya kullanıcı başka bir nedenden dolayı oluşturulamıyorsa yukarıdaki yöntem bir hata vererek başarısız olur. Açıklamalar ve çözüm adımları da dahil olmak üzere hata kodlarının tam listesi için bkz . Yönetici Kimlik Doğrulaması API Hataları .

Kullanıcıyı güncelleme

Firebase Admin SDK, mevcut bir kullanıcının verilerinin değiştirilmesini kolaylaştırır. Bu kullanıcı için güncellenecek özelliklerle birlikte bir uid belirtmeniz gerekir:

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

Python

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şleminin desteklediği özellikler

Mülk Tip Tanım
email sicim Kullanıcının yeni birincil e-postası. Geçerli bir e-posta adresi olmalı.
emailVerified boolean Kullanıcının birincil e-postasının doğrulanıp doğrulanmadığı. Sağlanmazsa varsayılan değer false .
phoneNumber sicim Kullanıcının yeni birincil telefon numarası. Geçerli bir E.164 spesifikasyonuna uygun telefon numarası olmalıdır. Kullanıcının mevcut telefon numarasını temizlemek için null değerine ayarlayın.
password sicim Kullanıcının yeni ham, karmalanmamış şifresi. En az altı karakter uzunluğunda olmalıdır.
displayName dize | null Kullanıcıların yeni görünen adı. Kullanıcının mevcut görünen adını temizlemek için null değerine ayarlayın.
photoURL dize | null Kullanıcıların yeni fotoğraf URL'si. Kullanıcının mevcut fotoğraf URL'sini temizlemek için null değerine ayarlayın. null değilse geçerli bir URL olmalıdır.
disabled boolean Kullanıcının devre dışı bırakılıp bırakılmadığı. engelliler için true ; etkin için false .

Güncelleme kullanıcısı yöntemi, güncelleme başarıyla tamamlandığında güncellenmiş bir UserRecord nesnesini döndürür.

Sağlanan kullanıcı uid mevcut bir kullanıcıya karşılık gelmiyorsa, sağlanan e-posta veya telefon numarası mevcut bir kullanıcı tarafından zaten kullanılıyorsa veya kullanıcı başka bir nedenden dolayı güncellenemiyorsa yukarıdaki yöntem bir hata vererek başarısız olur. Açıklamalar ve çözüm adımları da dahil olmak üzere hata kodlarının tam listesi için bkz . Yönetici Kimlik Doğrulaması API Hataları .

Kullanıcıyı silme

Firebase Admin SDK, mevcut kullanıcıların uid göre silinmesine olanak tanır:

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

Python

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ı silme yöntemi boş bir sonuç döndürür.

Sağlanan uid mevcut bir kullanıcıya karşılık gelmiyorsa veya kullanıcı başka bir nedenden dolayı silinemiyorsa kullanıcı silme yöntemi bir hata atar. Açıklamalar ve çözüm adımları da dahil olmak üzere hata kodlarının tam listesi için bkz . Yönetici Kimlik Doğrulaması API Hataları .

Birden Çok Kullanıcıyı Sil

Firebase Yönetici SDK'sı aynı anda birden fazla kullanıcıyı da silebilir. Ancak, birden fazla kullanıcıyı aynı anda silmek için deleteUsers(uids) gibi yöntemlerin kullanılmasının, Firebase için Cloud Functions'a yönelik onDelete() olay işleyicilerini tetiklemeyeceğini unutmayın. 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 etkinliklerinin 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());
}

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

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 hataların bir listesini döndürür. Açıklamalar ve çözüm adımları da dahil olmak üzere hata kodlarının tam listesi için bkz . Yönetici Kimlik Doğrulaması API Hataları .

Tüm kullanıcıları listele

Firebase Yönetici SDK'sı, tüm kullanıcı listesinin toplu olarak 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());
}

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)

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 sonraki sayfa belirtecini içerir. Tüm kullanıcılar zaten listelendiğinde pageToken döndürülmez.

maxResults alanı belirtilmezse toplu iş başına varsayılan 1000 kullanıcı kullanılır. Bu aynı zamanda listelenmesine izin verilen maksimum kullanıcı sayısıdır. Maksimumdan daha büyük herhangi bir değer bir argüman hatasına neden olur. Herhangi bir pageToken belirtilmezse, işlem kullanıcıları baştan itibaren uid göre sıralayarak listeler.

Açıklamalar ve çözüm adımları da dahil olmak üzere hata kodlarının tam listesi için bkz . Yönetici Kimlik Doğrulaması API Hataları .

Listelenen kullanıcıların şifre karmaları

Bu API aynı zamanda, istek OAuth erişim belirtecini oluşturmak için kullanılan kullanıcı/hizmet hesabının firebaseauth.configs.getHashConfig iznine sahip olması durumunda, parola kullanıcıları için Firebase Auth arka ucu tarafından oluşturulan passwordSalt ve passwordHash değerlerini de döndürür. Aksi halde passwordHash ve passwordSalt ayarlanmayacaktır.

Şifre karmalarının hassas yapısı nedeniyle, Firebase Admin SDK hizmet hesabı varsayılan olarak firebaseauth.configs.getHashConfig iznine sahip değildir. Bir kullanıcı/hizmet hesabına doğrudan izin ekleyemezsiniz ancak bunu özel bir IAM rolü oluşturarak dolaylı olarak yapabilirsiniz.

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

  1. Google Cloud konsolundaki IAM ve yönetici panelindeki Roller sayfasına gidin.
  2. Sayfanın üst kısmındaki açılır menüden projenizi seçin.
  3. ROL OLUŞTUR'a tıklayın
  4. İZİN EKLE'yi tıklayın
  5. firebaseauth.configs.getHashConfig iznini arayın ve bu onay kutusunu seçin.
  6. EKLE'yi tıklayın
  7. Yeni rolü oluşturmayı tamamlamak için OLUŞTUR'a tıklayın.

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

  1. IAM ve yönetici panelinde IAM'yi seçin
  2. Düzenlemek üzere üye listesinden hizmeti veya kullanıcı hesabını seçin.
  3. BAŞKA BİR ROL EKLE seçeneğine tıklayın.
  4. Daha önce oluşturulan yeni özel rolü arayın.
  5. KAYDET'i tıklayın.