Kullanıcıları Yönetin

Firebase Admin SDK, Üst düzey ayrıcalıklara sahip Firebase Authentication kullanıcı var. Yönetici kullanıcı yönetimi API'si aşağıdaki görevleri bir program aracılığıyla programlı bir şekilde güvenli sunucu ortamı:

  • Kısıtlama veya hız sınırlaması olmadan yeni kullanıcılar oluşturun.
  • Kullanıcıları farklı kriterlere göre (ör. kullanıcı kimliği, e-posta veya telefon numarası) arayın.
  • Belirli bir projenin tüm kullanıcılarını gruplar halinde listeleyin.
  • Hesap oluşturma ve son oturum açma tarihi gibi kullanıcı meta verilerine erişme.
  • Kullanıcıları, mevcut şifrelerine gerek kalmadan silin.
  • Kullanıcı özelliklerini (şifreleri dahil) oturum açmak zorunda kalmadan güncelleme bir liste hazırladı.
  • E-postaları, bant dışı işlem akışlarına geçmek zorunda kalmadan doğrulayın. doğrulayabilirsiniz.
  • 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 üzerinden işlem yapmanıza gerek kalmadan telefon numarasıyla yeni bir kullanıcı oluşturma doğrulama akışı.
  • Bir kullanıcının telefon numarasını SMS doğrulamasından geçmek zorunda kalmadan değiştirme akışı sağlar.
  • Çevrimdışı temel hazırlığı devre dışı bırakılmış durumda olan kullanıcıların temel hazırlığı, daha sonra bunların ne zaman yapılacağını kontrol eder bunları etkinleştirebilirsiniz.
  • Belirli bir uygulamanın kullanıcısına özel olarak tasarlanmış özel kullanıcı konsolları oluşturun sistemidir.

Başlamadan önce

Firebase Admin SDK'sı tarafından sağlanan User Management API'yi kullanmak için hizmet hesabı olmalıdır. Kurulum talimatlarını uygulayın. inceleyebilirsiniz.

Kullanıcı verilerini alma

Kullanıcıları tanımanın birincil yolu, benzersiz bir tanımlayıcı olan uid söz konusu kullanıcıdır. Yönetici SDK'sı, profilin getirilmesini sağlayan bir yöntem sağlar uid bazında kullanıcı bilgileri:

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

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)

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

Sağlanan uid mevcut bir kullanıcıya ait değilse veya kullanıcı getirildiğinde, yukarıdaki yöntemde hata verilir. Açıklamaları ve raporları da içeren hata kodlarının tam listesi için Admin Auth API Hataları bölümüne bakın.

Bazı durumlarda kullanıcının uid yerine kullanıcının e-posta adresi size ait olur. Firebase Admin SDK, e-posta üzerinden 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());

Python

from firebase_admin import auth

user = auth.get_user_by_email(email)
print('Successfully fetched user data: {0}'.format(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)

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öntemUserRecord ilgili kullanıcı adını tıklayın.

Sağlanan e-posta adresi mevcut bir kullanıcıya ait değilse ya da kullanıcı başka bir nedenle getirildiğinde Yönetici SDK'sı hata verir. Açıklamalar da dahil olmak üzere hata kodlarının tam listesi için ve çözüm adımları için Yönetici Authentication API Hataları bölümüne bakın.

Bazı durumlarda ise kullanıcının uid yerine telefon numarası kullanılır. İlgili içeriği oluşturmak için kullanılan Firebase Admin SDK'sı, 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);
  });

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

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)

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öntemUserRecord telefon numarasına karşılık gelen bir kullanıcı oluşturun.

Sağlanan telefon numarası mevcut bir kullanıcıya veya kullanıcıya ait değilse başka bir nedenle getirilemiyorsa Admin SDK'sı hata verir. Açıklamalar da dahil olmak üzere hata kodlarının tam listesi için ve çözüm adımları için Yönetici Authentication API Hataları bölümüne bakın.

Kullanıcı verilerini toplu al

Firebase Admin SDK, kullanabilirsiniz. Kullanıcıları kullanıcı kimliği, e-posta adresi veya telefon numarası. Tek bir çağrıda en fazla 100 tanımlayıcı sağlanabilir. Tanımlayıcılar 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)

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, her bir giriş için giriş listesiyle aynı boyutta bir liste döndürür veya ilgili UserRecord ya da bunun nedenini belirten bir hata tanımlayıcı için arama yapılamadı. Hata kodlarının tam listesi için açıklamaları ve çözüm adımları için Admin Authentication API'sine bakın Hatalar.

Kullanıcı oluşturma

Admin SDK, yeni bir Firebase Authentication kullanıcısı oluşturmanıza olanak tanır. Bu yöntem bir yeni oluşturulan öğeye eklenecek profil bilgilerini içeren nesne kullanıcı hesabı:

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

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)

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. Eğer Bunun yerine yeni kullanıcı için kendi uid belirlemek isterseniz bunu ekleyebilirsiniz olarak değiştirin:

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

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)

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

Özellik Tür Açıklama
uid dize Yeni oluşturulan kullanıcıya atanacak uid. Bir dize (1-128 karakter dahil) olmalıdır. Sağlanmamışsa rastgele uid otomatik olarak oluşturulacak. Daha kısa uid daha iyi performans sunar.
email dize Kullanıcının birincil e-postası. Geçerli bir e-posta adresi olmalı.
emailVerified boolean Kullanıcının birincil e-posta adresinin doğrulanıp doğrulanmadığı. Sağlanmamışsa varsayılan değer false.
phoneNumber dize Kullanıcının birincil telefon numarası. Geçerli bir E.164 spesifikasyonuna uygun olmalıdır telefon numarası.
password dize Kullanıcının işlenmemiş, karma olmayan ş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 URL'si.
disabled boolean Kullanıcının devre dışı olup olmadığı. Devre dışı olanlar için true; Etkin olanlar için false. Sağlanmazsa varsayılan false

Kullanıcı oluşturma yöntemiUserRecord yeni oluşturulan kullanıcı olabilir.

Sağlanan uid e-posta adresi veya telefon numarası mevcut bir hesap tarafından zaten kullanılıyorsa veya kullanıcı başka bir nedenle oluşturulamıyorsa yukarıdaki yöntem başarısız olur bir hata içeriyor. Aşağıdakiler dahil olmak üzere hata kodlarının tam listesi için: açıklamalar ve çözüm adımları için bkz. Admin Authentication API Hatalar.

Bir kullanıcıyı güncelleyin

Firebase Admin SDK'sı, mevcut bir kullanıcının verilerinde değişiklik yapılmasını kolaylaştırır. İhtiyacınız olanlar kullanarak ilgili kullanıcı için güncellenecek özelliklerle birlikte bir uid belirtin:

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

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)

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

Özellik Tür Açıklama
email dize Kullanıcının yeni birincil e-postası. Geçerli bir e-posta adresi olmalı.
emailVerified boolean Kullanıcının birincil e-posta adresinin doğrulanıp doğrulanmadığı. Sağlanmamışsa varsayılan değer false.
phoneNumber dize Kullanıcının yeni birincil telefon numarası. Geçerli bir E.164 spesifikasyonuna uygun olmalıdır telefon numarası. Kullanıcının mevcut verilerini temizlemek için null olarak ayarlayın telefon numarası.
password dize Kullanıcının yeni, karma ve işlenmemiş ş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ınnull mevcut görünen adı kullanabilirsiniz.
photoURL dize | null Kullanıcıların yeni fotoğraf URL'si. Kullanıcınınnull mevcut fotoğraf URL'sini ekleyin. null değilse geçerli bir URL olmalıdır.
disabled boolean Kullanıcının devre dışı olup olmadığı. Devre dışı olanlar için true; Etkin olanlar için false.

Aşağıdaki durumlarda, kullanıcı güncelleme yöntemi güncellenmiş bir UserRecord nesnesi döndürür: güncelleme başarıyla tamamlandı.

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ıyordur ya da kullanıcı yukarıdaki yöntem başka bir nedenle güncellenirse, hatası. Açıklamaları ve çözümleri de dahil olmak üzere hata kodlarının tam listesi için daha fazla bilgi için Yönetici Authentication API Hataları bölümüne bakın.

Kullanıcı silme

Firebase Admin SDK, mevcut kullanıcıların uid bazında 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')

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)

C#

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

Kullanıcı silme yöntemi, silme işlemi tamamlandığında boş bir sonuç döndürür. bahsettik.

Sağlanan uid mevcut bir kullanıcıya karşılık gelmiyorsa veya kullanıcı herhangi bir nedenle silindiğinde, kullanıcı silme yöntemi bir hata verir. Açıklamalar da dahil olmak üzere hata kodlarının tam listesi için ve çözüm adımları için Yönetici Authentication API Hataları bölümüne bakın.

Birden Çok Kullanıcıyı Sil

Firebase Admin SDK'sı da tek seferde birden çok kullanıcıyı silebilir. Ancak, Şu adreste birden fazla kullanıcıyı silmek için deleteUsers(uids) gibi yöntemler kullanıldığında: bir kez Cloud Functions for Firebase için onDelete() etkinlik işleyicileri tetiklemez. Bunun nedeni, toplu silme işleminin şurada bir kullanıcı silme etkinliğini tetiklememesidir: her bir kullanıcıya oluşturabilirsiniz. Kullanıcıları tek bir yerden silin kullanıcı silme etkinliklerinin silinen her kullanıcı için tetiklenmesini istediğiniz zaman.

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

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, aynı etkiye sahip olan kullanıcılar için silinemedi. Açıklamalar da dahil olmak üzere hata kodlarının tam listesi için ve çözüm adımları için Yönetici Authentication API Hataları bölümüne bakın.

Tüm kullanıcıları listele

Firebase Admin SDK, kullanıcı listesinin tamamının gruplar halinde alınmasını 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();

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

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ç grubunda, kullanıcıların bir listesi ve bir sonraki kullanıcı grubunu listelemektir. Tüm kullanıcılar listelenmişse pageToken döndürüldü.

maxResults alanı belirtilmezse grup başına varsayılan 1.000 kullanıcı kullanılır. Bu aynı zamanda, tek seferde listelenmesine izin verilen maksimum kullanıcı sayısıdır. Herhangi biri değeri maksimum değerden büyük olursa bir bağımsız değişken hatası verilir. pageToken belirtilmezse işlemde Başlangıcı, uid ölçütüne göre sıralanmış.

Açıklamalar da dahil olmak üzere hata kodlarının tam listesi için ve çözüm adımları için Yönetici Authentication API Hataları bölümüne bakın.

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

Bu API,passwordSaltpasswordHash Kullanıcı/hizmet hesabı daha önce şu işlemleri yapmışsa şifre kullanıcıları için Firebase Auth arka ucu: OAuth erişim jetonunun şuna sahip olduğunu oluştur: firebaseauth.configs.getHashConfig izni. Aksi halde passwordHash ve passwordSalt ayarlanmayacak.

Şifre karmalarının hassas yapısı nedeniyle Firebase Admin SDK hizmeti, hesap, firebaseauth.configs.getHashConfig iznine sahip değil. varsayılandır. Doğrudan bir kullanıcı/hizmet hesabına izin ekleyemezsiniz ancak dolaylı yoldan ya da özel IAM rolü oluşturma hakkında daha fazla bilgi edinin.

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

  1. IAM ve Yönetici panelinde Google Cloud konsolu.
  2. Sayfanın üst kısmındaki açılır menüden projenizi seçin.
  3. ROL OLUŞTUR'u tıklayın.
  4. İZİN EKLE'yi tıklayın.
  5. firebaseauth.configs.getHashConfig iznini aratıp seçin onay kutusunu işaretleyin.
  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ında kullanıcı/hizmet hesabına ekleyin:

  1. IAM ve Yönetici panelinde IAM'yi seçin
  2. Düzenlemek için üye listesinden hizmeti veya kullanıcı hesabını seçin.
  3. BAŞKA BİR ROL EKLE'yi tıklayın.
  4. Önceden oluşturulan yeni özel rolü arayın.
  5. KAYDET'i tıklayın.
ziyaret edin.