Kullanıcıları Yönetin

Firebase Admin SDK, Firebase Authentication ayrıcalıkları yükseltilmiş kullanıcılarınızı 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 sınırlama veya sıklık sınırlaması olmadan yeni kullanıcılar oluşturun.
  • Kullanıcıları UID, e-posta veya telefon numarası gibi farklı ölçütlere göre arayın.
  • Belirtilen projenin tüm kullanıcılarını gruplar halinde listeler.
  • Hesap oluşturma tarihi ve son oturum açma tarihi dahil olmak üzere kullanıcı meta verilerine erişme
  • Mevcut şifrelerini istemeden kullanıcıları silme
  • Kullanıcı olarak oturum açmak zorunda kalmadan kullanıcı özelliklerini (şifre 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 kullanıcının e-posta adresini değiştirme
  • 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ştirme.
  • Kullanıcıları devre dışı durumda çevrimdışı olarak sağlama ve daha sonra etkinleştirme zamanını kontrol etme
  • Belirli bir uygulamanın kullanıcı yönetim sistemine göre uyarlanmış özel kullanıcı konsolları oluşturun.

Başlamadan önce

Firebase Admin SDK tarafından sağlanan kullanıcı yönetimi API'sini kullanmak için hizmet hesabınızın olması gerekir. Yönetici SDK'sını başlatma hakkında daha fazla bilgi için kurulum talimatlarını uygulayın.

Kullanıcı verilerini alma

Bir kullanıcıyı tanımlamanın temel yolu, o kullanıcı için benzersiz bir tanımlayıcı olan uid'sını kullanmaktır. Yönetici SDK'sı, kullanıcıların profil bilgilerinin uid ile getirilmesine olanak tanıyan bir yöntem sunar:

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(f'Successfully fetched user data: {user.uid}')

Go

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

Bu yöntem, yönteme sağlanan uid ile eşleşen 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 nedenle getirilemiyorsa yukarıdaki yöntem hata verir. Açıklamalar ve çözüm adımları da dahil olmak üzere hata kodlarının tam listesi için Admin Auth API Hataları başlıklı makaleyi inceleyin.

Bazı durumlarda uid yerine kullanıcının e-posta adresini görürsünüz. Firebase Admin SDK, e-posta ile kullanıcı bilgilerini aramayı 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);
  });
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(f'Successfully fetched user data: {user.uid}')

Go

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

Bu yöntem, sağlanan e-postaya karşılık gelen kullanıcı için bir UserRecord nesnesi döndürür.

Belirtilen e-posta adresi mevcut bir kullanıcıya ait değilse veya kullanıcı başka bir nedenle getirilemiyorsa Admin SDK hata verir. Açıklamalar ve çözüm adımları da dahil olmak üzere hata kodlarının tam listesi için Admin Authentication API Hataları başlıklı makaleyi inceleyin.

Diğer durumlarda ise uid yerine kullanıcının telefon numarası gösterilir. Firebase Admin SDK, telefon numarasıyla kullanıcı bilgilerini aramayı 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);
  });
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(f'Successfully fetched user data: {user.uid}')

Go

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

Bu yöntem, sağlanan telefon numarasına karşılık gelen kullanıcı için bir UserRecord nesnesi döndürür.

Belirtilen telefon numarası mevcut bir kullanıcıya ait değilse veya kullanıcı başka bir nedenle getirilemiyorsa Admin SDK bir hata verir. Açıklamalar ve çözüm adımları da dahil olmak üzere hata kodlarının tam listesi için Admin Authentication API Hataları başlıklı makaleyi inceleyin.

Kullanıcı verilerini toplu olarak alma

Firebase Admin SDK, sağladığınız tanımlayıcılara göre kullanıcı listesi almayı da sağlar. Kullanıcıları kullanıcı kimlikleri, e-posta adresleri veya telefon numaralarıyla tanımlayabilirsiniz. Tek bir çağrıda en fazla 100 tanımlayıcı sağlanabilir. Tanımlayıcılar farklı 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);
  });
manage_users.js

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)

Go

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, giriş listesiyle aynı boyutta bir liste döndürür. Her giriş, karşılık gelen UserRecord değerini veya bu tanımlayıcının neden aranamadığını belirten bir hatayı içerir. Açıklamalar ve çözüm adımları da dahil olmak üzere hata kodlarının tam listesi için Admin Authentication API Hataları başlıklı makaleyi inceleyin.

Kullanıcı oluşturma

Yönetici SDK'sı, yeni bir Firebase Authentication kullanıcısı oluşturmanıza olanak tanıyan bir yöntem sunar. 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);
  });
manage_users.js

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(f'Sucessfully created new user: {user.uid}')

Go

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)
auth.go

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 Authentication yeni kullanıcı için rastgele bir uid oluşturur. Yeni kullanıcı için kendi uid değerinizi belirtmek istiyorsanız bunu kullanıcı oluşturma yöntemine iletilen bir bağımsız değişken 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);
  });
manage_users.js

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(f'Sucessfully created new user: {user.uid}')

Go

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)
auth.go

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

Özellik Tür Açıklama
uid dize Yeni oluşturulan kullanıcıya atanacak uid. 1-128 karakter uzunluğunda bir dize olmalıdır. Sağlanmazsa rastgele bir uid otomatik olarak oluşturulur. Daha kısa uidlar daha iyi performans sunar.
email dize Kullanıcının birincil e-posta adresi. Geçerli bir e-posta adresi olmalı.
emailVerified boolean Kullanıcının birincil e-posta adresinin doğrulanıp doğrulanmadığı Belirtilmezse varsayılan değer false olur.
phoneNumber dize Kullanıcının birincil telefon numarası. Geçerli bir E.164 spesifikasyonuna uygun telefon numarası olmalıdır.
password dize Kullanıcının ham, karma oluşturulmamış şifresi. En az altı karakter uzunluğunda olmalıdır.
displayName dize Kullanıcıların görünen adı.
photoURL dize Kullanıcının fotoğrafının URL'si.
disabled boolean Kullanıcının devre dışı bırakılıp bırakılmadığı Devre dışı bırakılmış için true; Etkinleştirilmiş için false. Belirtilmezse varsayılan değer false olur.

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

Belirtilen uid, e-posta veya telefon numarası zaten mevcut bir kullanıcı tarafından kullanılıyorsa ya da kullanıcı başka bir nedenle oluşturulamıyorsa yukarıdaki yöntem 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 Admin Authentication API Hataları bölümüne bakın.

Kullanıcı güncelleme

Firebase Admin SDK, mevcut bir kullanıcının verilerinin değiştirilmesini kolaylaştırır. 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);
  });
manage_users.js

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(f'Sucessfully updated user: {user.uid}')

Go

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)
auth.go

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

Özellik Tür Açıklama
email dize Kullanıcının yeni birincil e-posta adresi. Geçerli bir e-posta adresi olmalı.
emailVerified boolean Kullanıcının birincil e-posta adresinin doğrulanıp doğrulanmadığı Belirtilmezse varsayılan değer false olur.
phoneNumber dize 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 olarak ayarlayın.
password dize Kullanıcının yeni, işlenmemiş ve karma oluşturulmamış ş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 olarak 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 olarak 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ığı Devre dışı bırakılmış için true; Etkinleştirilmiş için false.

Güncelleme başarıyla tamamlandığında update user yöntemi, güncellenmiş bir UserRecord nesnesi döndürür.

Sağlanan uid mevcut bir kullanıcıya karşılık gelmiyorsa, sağlanan e-posta adresi veya telefon numarası mevcut bir kullanıcı tarafından zaten kullanılıyorsa ya da kullanıcı başka bir nedenle güncellenemiyorsa yukarıdaki yöntem bir hatayla başarısız olur. Açıklamalar ve çözüm adımları da dahil olmak üzere hata kodlarının tam listesi için Admin Authentication API Hataları başlıklı makaleyi inceleyin.

Kullanıcı 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);
  });
manage_users.js

Java

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

Python

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

Go

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

Silme işlemi başarıyla tamamlandığında delete user yöntemi boş bir sonuç döndürür.

Belirtilen uid mevcut bir kullanıcıya karşılık gelmiyorsa veya kullanıcı başka bir nedenden dolayı silinemiyorsa kullanıcıyı silme yöntemi hata verir. Açıklamalar ve çözüm adımları da dahil olmak üzere hata kodlarının tam listesi için Admin Authentication API Hataları başlıklı makaleyi inceleyin.

Birden Çok Kullanıcıyı Silme

Firebase Admin SDK, birden fazla kullanıcıyı aynı anda da silebilir. Ancak, deleteUsers(uids) gibi yöntemleri kullanarak birden fazla kullanıcıyı aynı anda silmenin Cloud Functions for Firebase için onDelete() etkinlik işleyicilerini tetiklemeyeceğini unutmayın. Bunun nedeni, toplu silme işleminin her kullanıcı için kullanıcı silme etkinliğini tetiklememesidir. Kullanıcı silme etkinliklerinin her silinen kullanıcı için tetiklenmesini istiyorsanız kullanıcıları tek tek 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(f'Successfully deleted {result.success_count} users')
print(f'Failed to delete {result.failure_count} users')
for err in result.errors:
    print(f'error #{result.index}, reason: {result.reason}')

Go

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ı silme yöntemi, silinemeyen kullanıcılarla ilgili başarısızlıkların listesini döndürür. Açıklamalar ve çözüm adımları da dahil olmak üzere hata kodlarının tam listesi için Admin Authentication API Hataları başlıklı makaleyi inceleyin.

Tüm kullanıcıları listeleme

Firebase Admin SDK, kullanıcıların tamamını gruplar halinde almayı sağlar:

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)

Go

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

Her sonuç grubu, kullanıcıların listesini ve sonraki kullanıcı grubunu listelemek için kullanılan sonraki sayfa jetonunu içerir. Tüm kullanıcılar zaten listelendiğinde pageToken döndürülür.

maxResults alanı belirtilmezse varsayılan olarak toplu işlem başına 1.000 kullanıcı kullanılır. Bu, aynı anda listelenebilecek maksimum kullanıcı sayısıdır. Maksimum değerden büyük herhangi bir değer, bağımsız değişken hatası verir. pageToken belirtilmezse işlem, kullanıcıları uid'ye göre sıralayarak baştan listeler.

Açıklamalar ve çözüm adımları da dahil olmak üzere hata kodlarının tam listesi için Admin Authentication API Hataları başlıklı makaleyi inceleyin.

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

Bu API, isteği oluşturmak için kullanılan kullanıcı/hizmet hesabının OAuth erişim jetonunun firebaseauth.configs.getHashConfig izni varsa şifre kullanıcıları için Firebase Auth arka ucu tarafından karma oluşturma işlemi uygulanmış passwordSalt ve passwordHash değerlerini de döndürür. Aksi takdirde passwordHash ve passwordSalt ayarlanmaz.

Şifre karmalarının hassas yapısı nedeniyle Firebase Admin SDK hizmet hesabında firebaseauth.configs.getHashConfig izni varsayılan olarak yoktur. Doğrudan bir kullanıcıya/hizmet hesabına izin ekleyemezsiniz ancak özel bir IAM rolü oluşturarak bunu dolaylı olarak yapabilirsiniz.

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

  1. Google Cloud konsolundaki IAM ve yönetici panelinde Roller sayfasına gidin.
  2. Sayfanın üst kısmındaki açılır listeden projenizi seçin.
  3. ROL OLUŞTUR'u tıklayın.
  4. İZİN EKLE'yi tıklayın.
  5. firebaseauth.configs.getHashConfig iznini arayın ve onay kutusunu seçin.
  6. EKLE'yi tıklayın.
  7. Yeni rolü oluşturmayı tamamlamak için OLUŞTUR'u 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 istediğiniz hizmeti veya kullanıcı hesabını üye listesinden seçin.
  3. BAŞKA BİR ROL EKLE'yi tıklayın.
  4. Daha önce oluşturulan yeni özel rolü arayın.
  5. KAYDET'i tıklayın.