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 programatik olarak tamamlama olanağı sağlar:
- Herhangi bir kısıtlama veya oran 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 şifrelerini istemeden 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ı ile 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.
- Devre dışı durumdaki kullanıcılara çevrimdışı temel hazırlık yapın ve daha sonra bunların ne zaman etkinleştirileceğini kontrol edin.
- Belirli bir uygulamanın kullanıcı yönetim sistemine uygun hale getirilmiş ö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 uid
. Admin SDK, kullanıcıların profil bilgilerinin uid
tarafından alınmasına izin veren 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());
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, yönteme sağlanan kullanıcı kimliğine karşılık gelen uid
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 bir 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ı bölümüne bakın.
Bazı durumlarda, bir kullanıcının uid
yerine e-postasına sahip olursunuz. 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, 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 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ı bölümüne bakın.
Diğer durumlarda, kullanıcının kullanıcı kimliği yerine telefon numarasına sahip 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, 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 nedenle getirilemezse 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ı bölümüne bakın.
Kullanıcı verilerini toplu olarak al
Firebase Admin SDK, sağladığınız tanımlayıcılara göre bir kullanıcı listesi 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 aramada maksimum 100 tanımlayıcı sağlanabilir. Tanımlayıcılar, çeşitli türler 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, giriş listesiyle aynı boyutta bir liste döndürür ve her giriş ya karşılık gelen Kullanıcı Kaydı'nı ya da bu tanımlayıcının neden UserRecord
gösteren bir hata 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ı bölümüne bakın.
kullanıcı oluştur
Admin SDK, yeni bir Firebase Authentication kullanıcısı oluşturmanıza izin veren 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 uid
Authentication, yeni kullanıcı için rastgele bir kullanıcı kimliği oluşturacaktır. Bunun yerine yeni kullanıcı için kendi kullanıcı uid
belirtmek isterseniz, bunu kullanıcı oluşturma yöntemine iletilen bir bağımsız değişken olarak dahil edebilirsiniz:
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 | Yeni oluşturulan kullanıcıya atanacak uid . 1-128 karakter (dahil) uzunluğunda bir dize olmalıdır. uid , otomatik olarak rastgele bir kullanıcı kimliği oluşturulur. 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 | mantıksal | Kullanıcının birincil e-postasının doğrulanıp doğrulanmadığı. Sağlanmazsa, varsayılan değer false olur. |
phoneNumber | sicim | Kullanıcının birincil telefon numarası. Geçerli bir E.164 spesifikasyonu uyumlu telefon numarası olmalıdır. |
password | sicim | Kullanıcının ham, hash edilmemiş ş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 | mantıksal | Kullanıcının devre dışı bırakılıp bırakılmadığı. engelliler için true ; etkin için false . Sağlanmazsa, 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.
Sağlanan uid
, e-posta veya telefon numarası zaten mevcut bir kullanıcı tarafından kullanılıyorsa veya kullanıcı başka bir nedenle oluşturulamıyorsa, 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ı bölümüne bakın.
Bir kullanıcıyı güncelleme
Firebase Admin SDK, mevcut bir kullanıcının verilerini değiştirmeyi kolaylaştırır. O 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());
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-postası. Geçerli bir e-posta adresi olmalı. |
emailVerified | mantıksal | Kullanıcının birincil e-postasının doğrulanıp doğrulanmadığı. Sağlanmazsa, varsayılan değer false olur. |
phoneNumber | sicim | Kullanıcının yeni birincil telefon numarası. Geçerli bir E.164 spesifikasyonu uyumlu telefon numarası olmalıdır. Kullanıcının mevcut telefon numarasını silmek için null olarak ayarlayın. |
password | sicim | Kullanıcının yeni ham, hash edilmemiş şifresi. En az altı karakter uzunluğunda olmalıdır. |
displayName | dizi | 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 | dizi | 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 | mantıksal | 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ı yöntemi, güncelleme başarıyla tamamlandığında 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 veya telefon numarası zaten mevcut bir kullanıcı tarafından kullanılıyorsa veya kullanıcı başka bir nedenle güncellenemiyorsa 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.
Bir kullanıcıyı sil
Firebase Admin SDK, mevcut kullanıcıların uid
göre silinmesine izin verir:
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.");
Kullanıcı silme yöntemi, silme işlemi başarıyla tamamlandığında 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 nedenle silinemiyorsa, kullanıcıyı sil yöntemi 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ı bölümüne bakın.
Birden Çok Kullanıcıyı Sil
Firebase Admin SDK aynı anda birden çok kullanıcıyı da silebilir. Ancak birden çok kullanıcıyı tek seferde silmek için deleteUsers(uids)
gibi yöntemlerin kullanılmasının Cloud Functions for Firebase için onDelete()
olay işleyicilerini tetiklemeyeceğini unutmayın. Bunun nedeni, toplu silmenin her kullanıcıda bir kullanıcı silme olayını tetiklememesidir. Kullanıcı silme olaylarının silinen her kullanıcı için 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ı da dahil olmak üzere hata kodlarının tam listesi için Admin Authentication API Hataları bölümüne bakın.
Tüm kullanıcıları listele
Firebase Admin SDK, tüm kullanıcı listesinin toplu olarak alınmasına izin verir:
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 bir 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 zaten listelendiğinde, hiçbir pageToken
döndürülmez.
maxResults
alanı belirtilmezse toplu iş 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. Maksimum değerden büyük herhangi bir değer bir bağımsız değişken hatası verir. Herhangi bir pageToken
belirtilmezse, işlem, uid
tarafından sıralanan kullanıcıları 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ı bölümüne bakın.
Listelenen kullanıcıların parola karmaları
Bu API, 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 karma haline getirilen passwordSalt
ve passwordHash
de döndürür. Aksi takdirde passwordHash
ve passwordSalt
ayarlanmaz.
Parola karmalarının hassas doğası nedeniyle, Firebase Admin SDK hizmet hesabının varsayılan olarak firebaseauth.configs.getHashConfig
izni yoktur. Bir kullanıcı/hizmet hesabına doğrudan izin ekleyemezsiniz, ancak bunu özel bir IAM rolü oluşturarak dolaylı olarak yapabilirsiniz.
Özel IAM rolü oluşturmak için:
- Google Cloud Console'daki IAM ve yönetici panelindeki Roller sayfasına gidin.
- Sayfanın üst kısmındaki açılır listeden projenizi seçin.
- ROL OLUŞTUR'a tıklayın
- İZİN EKLE'ye tıklayın
-
firebaseauth.configs.getHashConfig
iznini arayın ve bu onay kutusunu seçin. - EKLE'ye tıklayın
- 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:
- IAM ve yönetici panelinde IAM'yi seçin
- Düzenlemek için üye listesinden hizmeti veya kullanıcı hesabını seçin.
- BAŞKA BİR ROL EKLE öğesini tıklayın.
- Önceden oluşturulmuş yeni özel rolü arayın.
- KAYDET'i tıklayın.