Zbiorczy import użytkowników
Importuj do 1000 użytkowników na partię za pomocą starszych skrótów haseł bcrypt lub nowoczesnych Argon2id. Przejrzysta aktualizacja do Argon2id przy następnym logowaniu.
Importowanie użytkowników z innej platformy#
Podczas migracji z Supabase, Firebase, Auth0 lub niestandardowej bazy danych uwierzytelniania użytkownicy oczekują, że ich istniejące hasła będą nadal działać bez globalnego resetowania hasła.
Aurabase zapewnia punkt końcowy importu zbiorczego o dużej przepustowości (POST /v1/auth/admin/users/import), który może pozyskać do 1000 użytkowników na żądanie. Operacja zwraca szczegółowy raport o stanie, dzięki czemu nieprawidłowe rekordy nie blokują reszty partii.
Obsługiwane skróty haseł i przejrzysta aktualizacja#
Punkt końcowy importu obsługuje następujące algorytmy mieszania haseł:
| Algorytm | Identyfikatory | Zachowanie |
|---|---|---|
| Argon2id | $argon2id$v=19$m=... | Weryfikacja bezpośrednio przy użyciu parametrów OWASP. |
| szyfrowanie | $2a$, $2b$, $2y$ | Zweryfikowane przy logowaniu i w przezroczysty sposób ponownie zakodowane do Argon2id po pierwszym pomyślnym uwierzytelnieniu. |
Jeżeli dla użytkownika nie podano password_hash, konto zostanie utworzone bez hasła. Użytkownik może uwierzytelnić się za pomocą Magic Links, OTP e-mail/SMS lub linku do resetowania hasła.
Punkt końcowy importu zbiorczego#
Wymaga autoryzacji administratora (klucz service_role).
curl -X POST "$AURABASE_URL/v1/auth/admin/users/import" \
-H "apikey: $AURABASE_SERVICE_ROLE_KEY" \
-H "Authorization: Bearer $AURABASE_SERVICE_ROLE_KEY" \
-H "Content-Type: application/json" \
-d '{
"users": [
{
"email": "alice@example.com",
"email_verified": true,
"password_hash": "$2b$12$e8kPM4QJ8a2x4K7hM0uL.OeQ7f...",
"name": "Alice Johnson",
"user_metadata": { "department": "Engineering" }
},
{
"email": "bob@example.com",
"email_verified": false,
"password_hash": "$argon2id$v=19$m=65536,t=3,p=4$..."
}
]
}'
Odpowiedź (200 OK)
W odpowiedzi wyszczególniono całkowitą liczbę przetworzonych rekordów wraz ze szczegółowym raportem:
{
"data": {
"created": 2,
"skipped": 0,
"errors": 0,
"report": [
{
"index": 0,
"email": "alice@example.com",
"status": "created",
"id": "e3b0c442-98fc-1c14-9afb-f4c599684824"
},
{
"index": 1,
"email": "bob@example.com",
"status": "created",
"id": "7d2b5129-3bdf-48bc-8919-4b684df69921"
}
]
}
}
Jeśli wiadomość e-mail już istnieje w projekcie, zostanie oznaczona jako skipped zamiast zgłaszać błąd krytyczny.
TypeScript SDK#
Użyj authAdmin.importUsers():
import { createClient } from '@aurabase/aurabase-js'
const aura = createClient(process.env.AURABASE_URL!, process.env.AURABASE_SERVICE_ROLE_KEY!)
const usersToImport = [
{
email: 'user1@example.com',
emailVerified: true,
passwordHash: '$2b$12$e8kPM4QJ8a2x4...',
name: 'User One',
userMetadata: { plan: 'pro' },
},
{
email: 'user2@example.com',
emailVerified: false,
passwordHash: '$argon2id$v=19$m=65536,t=3,p=4$...',
name: 'User Two',
},
]
const { data, error } = await aura.authAdmin.importUsers(usersToImport)
if (error) {
console.error('Import failed:', error.message)
} else {
console.log(`Import summary: ${data.created} created, ${data.skipped} skipped, ${data.errors} errors`)
for (const item of data.report) {
if (item.status === 'error') {
console.warn(`Row ${item.index} (${item.email}) error: ${item.error}`)
}
}
}
Importuj przez Aurabase Studio#
Możesz także importować użytkowników bezpośrednio przez interfejs sieciowy:
- Przejdź do Uwierzytelnianie > Użytkownicy w panelu projektu.
- Kliknij przycisk Importuj użytkowników na górnym pasku narzędzi.
- Wybierz format JSON lub CSV. Możesz kliknąć Wstaw próbkę, aby sprawdzić oczekiwany schemat.
- Wklej swoje dane i kliknij Rozpocznij import.
- Sprawdź podsumowanie partii i raport stanu wiersz po wierszu.